35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
## 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` 保留只读参考，迁移完成后可退役独立部署
|