docs/00-overview.md

docs/16-roadmap.md

@@ -0,0 +1,92 @@
+# 16 开发路线图
+
+## 第一阶段必须先做设计
+
+在写大量代码之前，先输出：
+
+1. 系统架构
+2. 模块划分
+3. 数据库 ER 关系
+4. 核心数据表
+5. 租户隔离方案
+6. 库存模型
+7. 入库流程
+8. 出库流程
+9. 订单模型
+10. 权限模型
+11. API 设计
+12. Queue / Scheduler 设计
+13. Python Service 边界
+14. Docker 开发环境
+15. 项目目录结构
+
+## 第一阶段不要直接实现业务
+
+先在 `docs/` 目录下生成以下设计文档及目录结构说明：
+
+- ARCHITECTURE.md
+- database/（数据库总览、ER 关系与表结构设计，入口 `database/README.md`）
+- API.md
+- DEVELOPMENT.md
+- DOCKER.md
+
+确认架构合理之后，再开始数据库和代码。建议优先产出 `docs/database/` 中的表结构设计，把租户、仓库、库位、SKU、库存、库存流水、入库、出库这几个核心模型定死。
+
+## 开发顺序
+
+严格按照以下顺序：
+
+| Phase | 内容 |
+| --- | --- |
+| 1 | 项目架构设计 |
+| 2 | Laravel 基础项目 |
+| 3 | Vue 3 + Element Plus Admin |
+| 4 | SaaS 租户 / 用户 / RBAC |
+| 5 | 仓库 / 库区 / 库位 |
+| 6 | 商品 / SKU / 客户 |
+| 7 | 库存核心模型 |
+| 8 | 库存流水 / 库存并发 |
+| 9 | 入库 |
+| 10 | 出库 |
+| 11 | 拣货 / 波次 / 打包 / 发货 |
+| 12 | 物流 |
+| 13 | 报表 |
+| 14 | 第三方订单接口 |
+| 15 | Python AI / Data Service |
+| 16 | 测试 / 性能 / 安全 |
+| 17 | Docker / Production |
+
+## 每个 Phase 开始前
+
+先说明本阶段：
+
+- 目标
+- 涉及模块
+- 数据库变化
+- API 变化
+- 前端变化
+- 测试方案
+- 风险
+
+然后再实施。
+
+## 第一步任务
+
+不要写业务代码。先检查当前工作区，然后输出：
+
+1. 当前项目状态
+2. 推荐的最终目录结构
+3. 系统架构图
+4. Laravel / Vue / Python 三者职责边界
+5. SaaS 多租户方案
+6. WMS 核心领域模型
+7. 核心数据库表清单
+8. 库存模型设计
+9. 入库 / 出库流程
+10. API 分层设计
+11. Queue / Scheduler 设计
+12. Python Service 设计
+13. Docker 开发环境设计
+14. Phase 1 实施计划
+
+**暂时不要创建大量代码文件，先完成架构设计。**