dealerhub/PROGRESS_AGI_ITERATION_5.md

AGI 迭代第 5 轮 · 可运行闭环与回归收口

日期：2026-09-11

本轮完成

构建与部署基线

• 修复 backend/infra/scripts/run_dev.sh 工作目录解析，脚本从任意调用目录都能定位 backend/manage.py。
• backend/infra/docker/Dockerfile.backend 改为 Node + Python 多阶段构建，镜像内自动执行 npm ci / npm run build，不再依赖宿主机预生成 backend/frontend_dist。
• 修正 backend/infra/docker/docker-compose.yml 的构建上下文与 Dockerfile 路径。
• 新增根目录 .dockerignore，排除 SQLite、日志、缓存、node_modules 和本地构建产物。
• 对齐 requirements.in / requirements.txt，补齐 python-dateutil，统一 psycopg 安装声明。
• 修复 PostgreSQL 准备脚本把探测到的密码传入迁移阶段的问题。
• 清理 apps/finance/management/__init__.py 中重复的 management command 实现。

演示数据

• seed_demo --reset 现在会清理商城订单、订单行、商城账号和商品授权，避免重建残留。
• 演示账龄数据补齐 0-30、31-60、61-90、91-180、181-365、365+ 六个桶。
• 回归测试覆盖完整 storefront reset 和六桶账龄。

交易与库存

• 销售页保留用户手工改价，不因数量/客户刷新而覆盖；重新取价改为显式操作。
• 最低售价统一按基本单位价格比较，修复 source unit 重复换算。
• 采购页使用成本价而非销售价，并按录入单位显示金额，提交 source_quantity。
• 商品单位接口为换算单位返回对应 cost_price，同时保留销售价。
• 批次页近效期筛选改为后端过滤并重置分页；新增 near_expiry / expiry_days 参数。
• 新增前端 src/utils/transaction.js 和 Node 原生单测，固定单位换算、金额和边界校验口径。

通知与会话

• 通知列表只返回当前租户广播和当前用户通知。
• mark-read 不能修改其他用户的私有通知。
• mark-all-read 只处理广播和当前用户通知，不再批量改动其他用户状态。
• 普通登录和退出时清理演示只读、商城会话状态；主布局监听 storage 变化，租户/只读标签不再陈旧。

开放平台与表单

• 商品新增表单增加必填与正价格校验。
• API Key 管理页显示过期时间并支持确认吊销。
• 前端增加 npm test，覆盖交易金额、换算和边界校验。

验证结果

backend: 460 passed, 4 skipped
frontend: npm run build ✅
frontend: npm test ✅ (3 tests)
Django check ✅
makemigrations --check --dry-run ✅
bash -n backend/infra/scripts/run_dev.sh ✅

4 个跳过用例是 PostgreSQL 并发测试，需要 config.settings.pgtest 与可用的 PostgreSQL 实例；本轮未伪造该环境结果。Dockerfile/Compose 配置已通过静态路径与插值检查，完整镜像构建需启动 Docker Desktop。

下一轮最高价值项

1. 为用户—租户增加服务端 membership/授权关系，补跨租户切换回归。 ✅ 已完成（见 PROGRESS_AGI_ITERATION_6.md：权限分层 + tests/test_membership.py 8 用例，全量 0 failed）。
2. 把收款/付款分配 service 接入 REST action，并补 API 集成测试。
3. 在 PostgreSQL 上执行并发过账、库存和核销测试，审查 EXPLAIN ANALYZE。
4. 补齐前端 Voucher、Channel、StorefrontAdmin 的完整表单校验与分页。
5. 实现审计日志保留/归档策略和正式部署 readiness gate。