shanxia2.0/openspec/changes/dibang-migration/proposal.md

Why

原地磅系统（simple-dibang-xiaoshou）与 shanxia2.0 一体化门户分离部署，存在独立用户体系、主数据重复（货物/往来单位）和 UI 规范不一致问题。CRM、报销已成功迁入门户，地磅后端同为 Python FastAPI，具备同类移植条件。现需将地磅核心业务迁入本仓库，实现统一登录、租户隔离与 Fresh Mint 管理端体验。

What Changes

• 新增 4 张地磅业务表（db_purchase_plan、db_weighing_slip、db_inbound_outbound、db_vehicle），对齐 database-conventions 公共字段
• 不移植 cargos、companies、users 表；产品/客户通过 CRM 下拉选名称文本（方案 A，无 FK）
• 新增后端 db 子域：计划、地磅单、出入库、车辆、仪表盘 API 及地磅→计划→出入库联动逻辑
• 新增定时任务：计划按月自动生成（原 auto-create-plan 逻辑）
• 新增 web-admin 五页：仪表盘、计划管理、出入库管理、地磅单管理、车牌管理
• 新增菜单与权限配置；门户 sys_user 替代原地磅用户体系
• 提供 dibang 历史数据迁移脚本（int ID → UUID）
• 更新 ecosystem-landscape：地磅业务代码归属 shanxia2.0 本仓库

Capabilities

New Capabilities

• dibang-schema: 地磅四表 DDL、字段规范改造及历史数据迁移脚本
• dibang-backend: 地磅后端 API、Service、联动事务与定时任务
• dibang-frontend: 地磅 web-admin 五模块页面、API 层与菜单注册

Modified Capabilities

• ecosystem-landscape: 地磅系统从「独立系统、非本仓库 backend」更新为「已迁入门户，代码在 shanxia2.0/backend + web-admin」

Impact

• 数据库: docs/sql/shanxia2.0.sql 新增 db_* 表；可选增量脚本 docs/sql/db_tables.sql
• 后端: 新建 app/models/db_models.py、app/api/db/、app/services/db/、app/tasks/db_auto_plan.py；app/main.py、app/api/__init__.py 注册路由
• 前端: 新建 web-admin/src/views/db/**、web-admin/src/api/db/**；路由与菜单配置
• 依赖: 只读依赖已有 crm_product、crm_customer API；不修改 CRM 表结构
• 源系统: simple-dibang-xiaoshou 保留只读参考，迁移完成后可退役独立部署