makemd/docs/SERVICES/_index.md

# 服务地图索引

> **入口**: [../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)