# 6. Components

基于架构模式、技术栈和数据模型，识别全栈中的主要逻辑组件/服务：

## 6.1 认证服务 (AuthService)

**责任：** 处理用户认证、注册、JWT令牌生成和验证
**关键接口：**
- `login(email: string, password: string): Promise<AuthResponse>`
- `register(userData: RegisterData): Promise<AuthResponse>`
- `verifyToken(token: string): Promise<User>`
- `logout(token: string): Promise<void>`
**依赖：** UserService、Redis（令牌管理）
**技术栈：** Hono中间件、bcrypt、jsonwebtoken、Redis客户端

## 6.2 用户服务 (UserService)

**责任：** 管理用户CRUD操作、权限验证和用户状态管理
**关键接口：**
- `getUsers(query: UserQuery): Promise<User[]>`
- `getUserById(id: string): Promise<User>`
- `createUser(userData: CreateUserData): Promise<User>`
- `updateUser(id: string, updates: Partial<User>): Promise<User>`
- `deleteUser(id: string): Promise<void>`
**依赖：** 数据库（TypeORM）、RoleService
**技术栈：** TypeORM Repository模式、数据验证

## 6.3 通用CRUD服务 (GenericCRUDService)

**责任：** 提供通用的CRUD操作基类，支持快速创建实体服务
**关键接口：**
- `findAll(query: PaginationQuery): Promise<Entity[]>`
- `findById(id: string): Promise<Entity>`
- `create(data: CreateDTO): Promise<Entity>`
- `update(id: string, data: UpdateDTO): Promise<Entity>`
- `delete(id: string): Promise<void>`
**依赖：** TypeORM Repository、Zod验证
**技术栈：** TypeORM泛型、类继承、装饰器模式

## 6.4 通用CRUD路由 (GenericCRUDRouter)

**责任：** 自动生成标准RESTful路由，支持通用CRUD操作
**关键接口：**
- `GET /entity` - 获取列表（支持分页、过滤、排序）
- `GET /entity/:id` - 获取单个实体
- `POST /entity` - 创建实体
- `PUT /entity/:id` - 更新实体
- `DELETE /entity/:id` - 删除实体
**依赖：** GenericCRUDService、Zod验证
**技术栈：** Hono路由工厂、OpenAPI自动生成

## 6.5 组件关系图

```mermaid
flowchart TB
    Frontend[前端应用] --> APIGateway[API网关]

    APIGateway --> AuthService[认证服务]
    APIGateway --> UserService[用户服务]
    APIGateway --> RoleService[角色服务]

    AuthService --> Redis[Redis缓存]
    UserService --> DB[(MySQL数据库)]
    RoleService --> DB

    AuthService --> UserService
    UserService --> RoleService
```