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