wurenzhi
427becbc8f
feat(types): 新增共享类型中心，包含用户、产品、订单等核心领域类型 fix(types): 修复类型定义错误，统一各模块类型引用 style(types): 优化类型文件格式和注释 docs(types): 更新类型文档和变更日志 test(types): 添加类型测试用例 build(types): 配置类型共享路径 chore(types): 清理重复类型定义文件
3.5 KiB
3.5 KiB
架构文档索引
模块: 01_Architecture - 系统架构设计
更新日期: 2026-03-20
架构文档概览
架构文档包含系统架构、状态机、服务地图、TypeScript 编译规约、代码质量规范等核心设计文档。
核心文档
| 文档 | 说明 |
|---|---|
| 01_System.md | 系统架构：后端、前端、插件架构设计及依赖规则 |
| 03_Domain_Model.md | 领域模型：核心领域对象和关系定义 |
| 06_State_Machine.md | 状态机：商户、用户、店铺、订单等状态机定义 |
| 07_SEMANTIC_HUB.md | 语义中心：统一全局语义定义，确保AI开发一致性 |
TypeScript 与代码质量
| 文档 | 说明 |
|---|---|
| 13_TypeScript_Standards.md | TypeScript 编译规约：TypeScript 编译零错误规约体系、tsconfig 配置、代码规约 |
| 14_Code_Quality_Standards.md | 代码质量规范：ESLint 配置、Prettier 配置、代码风格规范、测试规范 |
| 15_Schema_Driven_Development.md | Schema 驱动开发：zod 使用指南、Schema 组织、类型推导、数据验证 |
| 16_Unified_Type_Management.md | 统一类型管理：类型中心架构、类型层次、类型转换、版本管理 |
业务规则与权限
| 文档 | 说明 |
|---|---|
| 08_BILLING_RULES.md | 计费规则：订阅计费、功能计费、API 计费规则 |
| 09_PERMISSION_RULES.md | 权限规则：RBAC 权限模型、角色定义、权限校验规则 |
系统设计
| 文档 | 说明 |
|---|---|
| 02_System_Interoperability.md | 系统互通架构：系统各组件之间的互通机制和通信规范 |
| 04_Service_Map.md | 服务地图：后端服务接口映射和依赖关系 |
| 05_Module_Blueprints.md | 模块蓝图：OMS, WMS, Finance, MKT 等模块的前端集成蓝图 |
专项架构
| 文档 | 说明 |
|---|---|
| 10_Currency_Management.md | 货币管理：多货币支持、汇率管理、货币转换 |
| 11_Mock_Architecture.md | Mock 架构：低侵入 Mock 方案，支持 DataSource 内联和 MSW 网络层两种方式 |
| 12_Operation_Agent.md | 运营 Agent：运营自动化、Agent 设计、任务调度 |
前端架构
| 文档 | 说明 |
|---|---|
| frontend/01_Product.md | 产品前端：产品模块前端设计规范 |
| frontend/02_Orders.md | 订单前端：订单模块前端设计规范 |
| frontend/03_Ad.md | 广告前端：广告模块前端设计规范 |
| frontend/04_IndependentSite.md | 独立站点前端：独立站点模块前端设计规范 |
关联模块
最近更新
- 2026-03-20: 新增 TypeScript 编译规约、代码质量规范、Schema 驱动开发、统一类型管理文档
- 2026-03-21: 简化文档索引，引用全局 DOC_INDEX.md
- 2026-03-19: 重构架构文档结构，统一命名规范