Files
2026-09-29 13:08:21 +08:00

2.6 KiB
Raw Permalink Blame History

WMS SaaS 项目文档索引

本目录由根目录 README.md(项目总提示词)按主题拆分而来,是项目设计与开发的约束来源。

文档 内容 对应原 README 章节
00-overview.md 项目定位、最终目标 开头、四十
01-tech-stack.md 前端 / 后端 / 数据库 / Python 技术栈 一 ~ 四
02-architecture.md 总体架构、职责边界、Redis、避免过度设计 五、二十一、二十八
03-multi-tenancy.md SaaS 多租户、tenant_code、TenantContext 六、七
04-domain-model.md 业务编码、业务模块、订单模型、第三方平台、状态机 八、十二 ~ 十五
05-inventory.md 库存模型、库存流水、并发安全 九 ~ 十一
06-backend-laravel.md Laravel 代码分层与目录结构 十六、后端框架结构
07-api.md API 路由规范与统一返回格式 十七、十八
08-queue-scheduler.md 队列与定时任务 十九、二十
09-database.md 数据库设计要求与规范 三、二十七
10-frontend.md 前端框架、目录、Element Plus、权限 一、二十三 ~ 二十五
11-py-service.md Python AI / Data Service(py-service/)边界与结构 四、二十二
12-security-audit.md 日志审计与安全要求 二十六、三十五
13-docker.md Docker 开发环境 二十九
14-testing.md 测试要求 三十四
15-development-workflow.md 开发原则、代码质量、Cursor 工作方式、禁止事项 三十、三十六 ~ 三十九
16-roadmap.md 设计先行、Phase 开发顺序、第一步任务 三十一 ~ 三十三、现在开始
database/ 数据库表结构设计(按领域分文件) —

核心原则

简单、清晰、可维护、可扩展、业务优先。

  • Laravel 是唯一的核心业务系统,MySQL 是业务事实数据源。
  • 所有核心业务数据按 tenant_code 隔离,由 TenantContext 统一处理。
  • 库存余额是结果,库存流水是事实;库存变更必须并发安全、可追溯。
  • Python 只做 AI / 数据分析,只通过 API 与 Laravel 交互。
  • 分阶段开发,每个 Phase 先说明方案、再实施、再验证。