refactor(types): 重构类型系统,统一共享类型定义
feat(types): 新增共享类型中心,包含用户、产品、订单等核心领域类型 fix(types): 修复类型定义错误,统一各模块类型引用 style(types): 优化类型文件格式和注释 docs(types): 更新类型文档和变更日志 test(types): 添加类型测试用例 build(types): 配置类型共享路径 chore(types): 清理重复类型定义文件
This commit is contained in:
@@ -1,15 +1,75 @@
|
||||
# 架构文档索引
|
||||
|
||||
> **模块**: 01_Architecture - 系统架构设计
|
||||
> **更新日期**: 2026-03-21
|
||||
> **更新日期**: 2026-03-20
|
||||
|
||||
---
|
||||
|
||||
## 架构文档概览
|
||||
|
||||
架构文档包含系统架构、状态机、服务地图等核心设计文档,详细内容请参考全局文档索引。
|
||||
架构文档包含系统架构、状态机、服务地图、TypeScript 编译规约、代码质量规范等核心设计文档。
|
||||
|
||||
> **详细文档索引**:请参考 [全局文档索引](../10_Documents_Global/DOC_INDEX.md)
|
||||
---
|
||||
|
||||
## 核心文档
|
||||
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| [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) | 独立站点前端:独立站点模块前端设计规范 |
|
||||
|
||||
---
|
||||
|
||||
@@ -23,5 +83,6 @@
|
||||
|
||||
## 最近更新
|
||||
|
||||
- 2026-03-21: 简化文档索引,引用全局DOC_INDEX.md
|
||||
- 2026-03-20: 新增 TypeScript 编译规约、代码质量规范、Schema 驱动开发、统一类型管理文档
|
||||
- 2026-03-21: 简化文档索引,引用全局 DOC_INDEX.md
|
||||
- 2026-03-19: 重构架构文档结构,统一命名规范
|
||||
|
||||
Reference in New Issue
Block a user