85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
# 服务地图索引
|
||
|
||
> **入口**: [../README.md](../README.md)
|
||
|
||
---
|
||
|
||
## 服务文件分类
|
||
|
||
| 分类 | 目录 | 包含服务 |
|
||
|------|------|----------|
|
||
| 认证服务 | auth/ | 认证、权限、用户管理相关服务 |
|
||
| 合规服务 | compliance/ | 合规检查、证书管理、安全合规相关服务 |
|
||
| 财务服务 | finance/ | 财务、支付、结算、货币相关服务 |
|
||
| 库存服务 | inventory/ | 库存管理、仓储、补货相关服务 |
|
||
| 营销服务 | marketing/ | 广告、营销、策略相关服务 |
|
||
| 订单服务 | order/ | 订单管理、售后、退货相关服务 |
|
||
| 商品服务 | product/ | 商品管理、采集、刊登相关服务 |
|
||
| 安全服务 | security/ | 安全、风控、加密相关服务 |
|
||
| 租户服务 | tenant/ | 租户管理、层级管理相关服务 |
|
||
| 工具服务 | utils/ | 缓存、日志、审计、事件总线相关服务 |
|
||
|
||
---
|
||
|
||
## 服务文件
|
||
|
||
| 文件 | 内容 | 大小 |
|
||
|------|------|------|
|
||
| [product.md](product.md) | 商品域服务 | ~300行 |
|
||
| [order.md](order.md) | 订单域服务 | ~300行 |
|
||
| [inventory.md](inventory.md) | 库存域服务 | ~200行 |
|
||
| [finance.md](finance.md) | 财务域服务 | ~200行 |
|
||
| [marketing.md](marketing.md) | 营销域服务 | ~200行 |
|
||
| [collection.md](collection.md) | 采集域服务 | ~200行 |
|
||
|
||
---
|
||
|
||
## 服务命名规范
|
||
|
||
| 后缀 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| Service | 业务服务 | ProductService |
|
||
| Repository | 数据访问 | ProductRepository |
|
||
| Connector | 平台连接 | ShopifyConnector |
|
||
| Orchestrator | 编排器 | PublishOrchestrator |
|
||
|
||
---
|
||
|
||
## 🚫 常见问题与预防措施
|
||
|
||
### 服务文件管理问题
|
||
|
||
| 问题 | 症状 | 预防措施 |
|
||
|------|------|----------|
|
||
| 服务文件过多 | 目录结构混乱，难以查找 | 按功能分类到子目录，定期清理冗余文件 |
|
||
| 服务功能重叠 | 代码重复，维护困难 | 任务启动前审查，确认功能边界 |
|
||
| 导入路径错误 | 服务移动后编译失败 | 统一使用相对路径，移动后更新所有引用 |
|
||
| 命名不规范 | 难以理解服务职责 | 严格遵循命名规范，使用Service后缀 |
|
||
| 代码质量差 | 可读性差，bug多 | 遵循代码审查机制，确保代码质量 |
|
||
|
||
### 服务开发预防措施
|
||
|
||
1. **任务启动前**
|
||
- 检查是否与现有服务功能重叠
|
||
- 确认服务文件的分类位置
|
||
- 验证是否需要创建新文件
|
||
|
||
2. **开发过程中**
|
||
- 保持服务功能单一，职责明确
|
||
- 遵循编码规范和命名约定
|
||
- 实现完整的错误处理和异常管理
|
||
|
||
3. **任务完成后**
|
||
- 验证功能实现完整性
|
||
- 检查代码质量和性能
|
||
- 确认测试覆盖率
|
||
- 更新服务映射文档
|
||
|
||
---
|
||
|
||
## 🔗 相关文档
|
||
|
||
- [规则中心](../RULES/_index.md)
|
||
- [架构设计](../ARCH/_index.md)
|
||
- [业务闭环](../LOOPS/_index.md)
|