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