# Team C 编码实现 - 交付清单

## 基本信息

| 项目 | 内容 |
|------|------|
| 阶段 | Phase 1 - 基础设施与用户体系 |
| 里程碑 | M3 - 编码实现 |
| 交付日期 | 2026-05-30 |
| 编译状态 | BUILD SUCCESS (mvn compile) |

## 交付文件清单

### 1. 主启动类 (1个)

| 文件 | 说明 |
|------|------|
| `CrrcApplication.java` | Spring Boot 主启动类 |

### 2. 配置类 (4个)

| 文件 | 说明 |
|------|------|
| `config/MyBatisConfig.java` | MyBatis MapperScan 配置 |
| `config/WebMvcConfig.java` | MVC 配置（拦截器、CORS） |
| `config/GlobalExceptionHandler.java` | 全局异常处理器 |

### 3. 拦截器 (2个)

| 文件 | 说明 |
|------|------|
| `interceptor/JwtInterceptor.java` | 小程序端 JWT 认证拦截器 |
| `interceptor/AdminAuthInterceptor.java` | 后台管理端认证拦截器 |

### 4. 实体类 (7个)

| 文件 | 对应表 | 说明 |
|------|--------|------|
| `entity/SysUser.java` | sys_user | 用户表实体 |
| `entity/UserIdentity.java` | user_identity | 用户身份表实体 |
| `entity/SysRole.java` | sys_role | 角色表实体 |
| `entity/SysPermission.java` | sys_permission | 权限表实体 |
| `entity/SysDict.java` | sys_dict | 字典表实体 |
| `entity/AuditLog.java` | audit_log | 审核日志表实体 |
| `entity/OperationLog.java` | operation_log | 操作日志表实体 |

### 5. Mapper 接口 (7个)

| 文件 | 说明 |
|------|------|
| `mapper/SysUserMapper.java` | 用户数据访问 |
| `mapper/UserIdentityMapper.java` | 用户身份数据访问 |
| `mapper/SysRoleMapper.java` | 角色数据访问 |
| `mapper/SysPermissionMapper.java` | 权限数据访问 |
| `mapper/SysDictMapper.java` | 字典数据访问 |
| `mapper/AuditLogMapper.java` | 审核日志数据访问 |
| `mapper/OperationLogMapper.java` | 操作日志数据访问 |

### 6. MyBatis XML 映射文件 (7个)

| 文件 | 说明 |
|------|------|
| `mapper/SysUserMapper.xml` | 用户表 SQL 映射 |
| `mapper/UserIdentityMapper.xml` | 用户身份表 SQL 映射 |
| `mapper/SysRoleMapper.xml` | 角色表 SQL 映射 |
| `mapper/SysPermissionMapper.xml` | 权限表 SQL 映射 |
| `mapper/SysDictMapper.xml` | 字典表 SQL 映射 |
| `mapper/AuditLogMapper.xml` | 审核日志表 SQL 映射 |
| `mapper/OperationLogMapper.xml` | 操作日志表 SQL 映射 |

### 7. Service 类 (3个)

| 文件 | 说明 |
|------|------|
| `service/AuthService.java` | 认证服务（微信登录、后台登录、身份选择） |
| `service/SysService.java` | 系统管理服务（角色、权限、字典、操作日志） |
| `service/AuditService.java` | 审核服务（审核列表、审核操作） |

### 8. Controller 类 (5个)

| 文件 | 路径前缀 | 说明 |
|------|----------|------|
| `controller/wx/AuthController.java` | /api/wx/auth | 小程序端认证接口 |
| `controller/wx/HomeController.java` | /api/wx/home | 小程序端首页接口 |
| `controller/admin/AuthController.java` | /api/admin/auth | 后台管理认证接口 |
| `controller/admin/SysController.java` | /api/admin/system | 后台系统管理接口 |
| `controller/admin/AuditController.java` | /api/admin/audit | 后台审核管理接口 |

### 9. 工具类 (4个)

| 文件 | 说明 |
|------|------|
| `util/JwtUtil.java` | JWT Token 生成与验证 |
| `util/AesUtil.java` | AES 加密解密（手机号加密） |
| `util/Sha256Util.java` | SHA-256 哈希（手机号哈希查询） |
| `util/ResultUtil.java` | 统一响应结果封装 |

## 统计

| 类型 | 数量 |
|------|------|
| Java 源文件 | 32 |
| MyBatis XML | 7 |
| **总计** | **39** |

## API 端点覆盖

| 模块 | 端点数 | 状态 |
|------|--------|------|
| 认证模块 (/api/wx/auth, /api/admin/auth) | 5 | 已实现 |
| 用户模块 (/api/wx/user) | 0 | 后续阶段 |
| 系统管理 (/api/admin/system) | 8 | 已实现 |
| 审核管理 (/api/admin/audit) | 3 | 已实现 |
| 首页模块 (/api/wx/home) | 5 | 已实现（占位） |
| **总计** | **21** | - |

## 待后续处理 (TODO)

1. **AuthService**: 微信接口调用实现（`getOpenidFromWechat`）
2. **AuthService**: BCrypt 密码验证实现（`verifyPassword`）
3. **HomeController**: 首页数据查询实现（行情、招工、统计）
4. **数据库初始化**: 需执行 DDL 创建 7 张核心表
5. **外部服务配置**: MySQL、Redis、OSS、短信、微信小程序配置

## 编译验证

```
mvn compile → BUILD SUCCESS
编译文件数: 32
编译耗时: 0.914s
```