cjw/geMoldInsight
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
344 Commits 1 Branch 0 Tags
eb0a4005e1254d41c76ca688458c181e0ccaf368
Commit Graph

9 Commits

Author SHA1 Message Date
cjw b03431b511 📝 docs(deploy): 明确裸 up 不重建已有镜像 + 修正 build.sh 三步描述 
- DEPLOYMENT §1.2 / LINUX_SETUP §11 / README / OPERATIONS 补充：
  docker compose up -d 对本地已有同名镜像不会自动重建，更新代码后
  需 up -d --build 或先 build（部署机实测复用旧镜像后澄清）
- build.sh 描述由四步修正为 base → backend → frontend 三步（celery
  复用 backend 镜像，随 Dockerfile.celery 移除的文档收尾）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-24 17:05:01 +08:00
cjw 2fd1b3da21 🐛 fix(deploy): 修干净机器首次构建两处必挂——.dockerignore 排除 deploy/ + celery 并行构建依赖 
部署机首次 docker compose up -d 实测暴露：

- .dockerignore 自"重写独立dockerfile"起排除整个 deploy/，而
  Dockerfile.frontend COPY deploy/nginx/frontend.conf、Dockerfile.moldinsight
  COPY deploy/requirements-*.txt → COPY not found。历史一直有旧镜像兜底未暴露；
  BuildKit 不支持重包含被排除目录的子文件，直接移除该行
- Dockerfile.celery FROM gemold-backend:latest 在 compose 并行构建下引用
  尚不存在的本地镜像必挂 → 删除 Dockerfile.celery，moldinsight-celery 改为
  与 API 服务同一 build 声明 + 同一 gemold-backend:latest tag（compose 去重
  只构建一次），celery 仅以 command: 覆盖启动 worker，参数语义不变
- build.sh/.bat 移除 gemold-celery 构建步骤；OPERATIONS / OCC_THROUGHPUT /
  TECH_DEBT / .env.example 的 Dockerfile.celery 指向同步改写；STATUS 补录

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-24 16:18:44 +08:00
cjw 4373fafd55 🐛 fix(deploy): 移除服务 profiles——裸 up / 裸 -f 恢复一键可用 
compose 规则：声明了 profiles 的服务在不带 --profile 时永远不会被选中。
拆分首版保留 profiles（双保险设计）导致部署机实测 docker compose up -d
与 -f <file> up -d 均报 "no service selected"，与"一键部署、换文件名换
模式"的核心诉求互斥，故彻底移除：

- 三个 compose 文件的全部 services 去掉 profiles 块，模式切换唯一入口 = -f 文件名
- 历史 --profile full/moldinsight/inventory 写法随之失效（目标服务本就已
  移出默认文件，兼容无意义）；文档/构建脚本提示/STATUS 日志同步改为失效声明
- frontend/README 移除"仅起前端"用法（前端反代依赖 unified backend，推荐整栈）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-24 16:09:26 +08:00
cjw a548623ea5 📦 build(deploy): Compose 按部署模式拆分三文件——换文件名即换模式一键部署 
- docker-compose.yml（unified 默认入口）/ docker-compose.moldinsight.yml / docker-compose.inventory.yml 三文件一一对应三种部署模式，profiles 字段保留（--profile 旧命令双保险可用）
- 修复两个既有部署隐患：moldinsight-only 场景 celery depends_on 悬空；moldinsight service image 统一为 gemold-backend:latest 与 Dockerfile.celery FROM 对齐（废弃 gemold-moldinsight tag）
- gemold_network / uploads_data / html_data 固定 name 命名；inventory-only 不声明卷避免空卷；每文件内 x-base-env anchor 收敛重复 environment（SECRET_KEY/ADMIN_PASSWORD fail-fast 保留）
- 文档同步 11 处：DEPLOYMENT §1.1 一键部署总表 + §2 三模式命令、LINUX_SETUP §6/§11、README、OPERATIONS §4、build.sh/.bat 提示、PORT_CONFIG / DEPLOY_PORT / STORAGE_SETUP / frontend/README
- STATUS.md 补 2026-09-24 批次日志

验证：三文件 YAML 结构静态校验通过；5 个 service environment 键与拆分前逐一比对零丢失（39/39、34/34、39/39、34/34、20/20）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-24 15:28:13 +08:00
cjw 79441a8a87 批次6：D4文档治理收口 + D13锁文件流程固化 
D4 文档/规划/历史混放收口：
- docs/TECH_DEBT.md §2 由'按批次回顾'精简为'按主题摘要'，
  与§3重复内容（批次0-4详细展开）整体迁入
  docs/archive/2026-09_governance_batches.md
- docs/STATUS.md 顶部 2026-09-17 之前条目迁入
  docs/archive/2026-09_status_history.md，仅保留指针
- D2 历史口径补齐为 2026-09-18 批次4后续专项清偿
- D4 标已清偿
- AGENTS.md / docs/archive/README.md 同步导航

D13 锁文件流程固化（镜像引入主体已清偿，仅剩锁文件落盘）：
- 新增 deploy/generate_lockfiles.{sh,bat}：在 moldinsight conda
  环境（仅项目依赖）执行 pip freeze --exclude pythonocc-core，
  产出 deploy/requirements-{base,moldinsight}.lock.txt
- deploy/Dockerfile.moldinsight 注释改为指向生成脚本
- docs/OPERATIONS.md §2.1 增加完整流程说明
- tests/test_lockfile_generation.py 加锁文件存在性+体积契约；
  tests/conftest.py 注册 --run-lockfile-check 选项，
  默认 skip（仓库单测不阻塞），CI 镜像构建 job 显式启用 fail-fast

遗留：锁文件本身尚未落盘（本机Miniforge跨项目开发栈混装，
污染严重不能直接 pip freeze）；待 CI / 生产首次构建时按流程落锁。

测试基线：126 passed, 9 skipped（默认4原有skip + D13新增5skip；
启用 --run-lockfile-check 时严格断言2项锁文件契约）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-23 09:59:02 +08:00
cjw e728dcd226 批次4后续专项完成：D11清偿 + OCC方案B实施 + 部署参数 + D2诚实标注 + CI门禁 
① D11 HTML 报告 RustFS 单源化（TECH_DEBT P2 清偿）：可视化产物写任务临时目录后
   裸传报告键 html/reports/{filename}（文件名寻址），/html StaticFiles 挂载删除，
   新增 html_report_router 根路径代理（报告键→遗留 JSON 包装→本地卷兜底→404，
   防穿越）；URL 形状 /html/{filename} 不变，持久化引用零迁移；celery 摘除
   html_data 卷，镜像不再烤入陈旧报告；顺带删除 get_stp_file_with_data 死数据块
② OCC 方案 B（D10 清偿）：run_occ(op_name, payload) 契约 + 常驻工作进程池
   （occ_process_pool + occ_worker 操作注册表），超时/崩溃 terminate 换新补位、
   任务级超时 recover 整体重建，残留线程泄漏根治；TopoDS 不跨进程（generate_cavity
   分模 + 方案 STEP 持久化全在子进程内，返回 export_manifest）；删除内存形状缓存链、
   CADExporter.export_mold_results、shape_loader（→ stp_materializer）
③ OCC 方案 A 部署参数：CELERY_CONCURRENCY / CELERY_MAX_TASKS_PER_CHILD 进
   Dockerfile.celery + compose + .env.example
④ D2 诚实标注：铝价响应带 source: "simulated"，前端按来源渲染标注（原硬编码
   "上海期货交易所"属虚假声明），死代码 getAluminumPrice 删除
⑤ CI 门禁：.gitea/workflows/ci.yml 三 job（pytest / 前端构建含 vue-tsc /
   openapi 漂移检测）

接口变更三件套随批完成（openapi 76→77 paths + gen:api + 前端构建通过；方案 B
接口面零变化）。测试基线 143 passed, 0 skipped（新增 16 项）。文档六处同步。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-18 17:22:01 +08:00
cjw 0e6b3b1811 后端设计治理：批次 0-4 全部完成（安全/部署/一致性/结构/架构） 
按 ROADMAP §3.1 治理批次推进的后端设计审查整改：

- 批次 0（安全）：/api/status/{task_id} 补 JWT 鉴权与任务归属校验；
  pythonocc_available 真实探测；bcrypt 超 72 字节显式拒绝；
  SECRET_KEY/RUSTFS_* 惰性校验，代码侧弱默认移除
- 批次 1（部署正确性）：主处理链路改走 RustFS（分派入参 stp_file_id 化，
  worker 按 object_key 下载）；AUTO_MIGRATE 开关 + 迁移目录 alembic/→migrations/
  修复包遮蔽（自动迁移此前从未真正生效）；OCC 镜像改 conda 原生执行 +
  基础镜像 tag 锁定；compose 关键项改 ${VAR:?} 强制显式配置
- 批次 2（任务一致性）：删除 Redis 进程内存回退，PG 为任务状态单一事实源；
  批量元数据入库（processing_tasks.batch_id，迁移 a3f8c2d91e47）；
  型腔失败任务标 failed 不再静默 completed；事务边界收口
  （数据本体写 flush-only、失败先回滚再置 failed、进度更新保留即时 commit）
- 批次 3（API 与代码结构）：592 行 advanced_router 拆为 design/cost/machining/
  export 四子路由，请求体全量 Pydantic 化；ROUTE_MODULES + route_registry
  （/api/health 呈现 degraded，DEBUG fail fast）；纯计算端点统一 to_thread；
  StorageIntegrationService 按职责三拆；MAX_FILE_SIZE 接线生效、
  celery 复用 Settings.redis_url；管理员重置密码改 JSON body（端到端断裂修复）；
  openapi.json 重导出（76 paths）+ 前端 gen:api
- 批次 4（架构演进）：共享 ORM 按模块拆分（shared/models/base.py + identity.py、
  moldinsight/models/、inventory/models/，删除三条无使用方的跨模块
  relationship，跨模块桥接收敛为裸 FK 硬规则，无兼容 facade）；
  OCC executor 重建补 cancel_futures=True（消除旧队列被慢恢复线程
  并行消化的数据竞争）；OCC 吞吐方案设计先行
  （docs/topics/performance/OCC_THROUGHPUT.md）；顺手清偿 D15
  （vite.config.ts 未用参数致 npm run build 失败）

测试基线：125 passed, 2 skipped（pytest + sqlite+aiosqlite；归属边界、
路由契约、配置治理、鉴权回归等随批新增）
文档同步：STATUS / TECH_DEBT / ROADMAP / ARCHITECTURE / API_CONTRACT /
OPERATIONS / AGENTS

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-09-17 16:15:49 +08:00
cjw 4537faf2c4 优化 2026-09-16 17:55:04 +08:00
cjw 6464e89942 文档 2026-09-15 18:02:25 +08:00