# IAM Service

身份与访问管理服务（Identity and Access Management），P2 身份阶段交付。

## 职责

- 用户注册 / 登录 / 刷新令牌
- 角色（Role）与权限（Permission）管理
- Access / Refresh Token 签发与校验
- 用户信息查询（供 BFF / Gateway 聚合）

## 技术栈

- NestJS 10 + TypeScript（ESM）
- Drizzle ORM + MySQL
- bcrypt 密码哈希
- jsonwebtoken（P2 骨架使用 HS256，后续切 RS256）
- pino 日志 / prom-client 指标 / OpenTelemetry 链路

## 端口

默认 `3002`，通过 `PORT` 环境变量覆盖。

## API

| Method | Path            | 说明                              |
| ------ | --------------- | --------------------------------- |
| POST   | `/iam/register` | 注册                              |
| POST   | `/iam/login`    | 登录                              |
| POST   | `/iam/refresh`  | 刷新令牌                          |
| GET    | `/iam/me`       | 当前用户信息（需 `x-user-id` 头） |

## 健康检查

| 端点           | 用途                                              | 鉴权 |
| -------------- | ------------------------------------------------- | ---- |
| `GET /healthz` | 存活探针（liveness），仅返回进程状态，不检查依赖  | 无   |
| `GET /readyz`  | 就绪探针（readiness），检查 DB 连接，失败返回 503 | 无   |

实现见 `src/shared/health/health.controller.ts`，5 个 NestJS 服务（iam/core-edu/content/msg/classes）一致。

## 数据表

`iam_users` / `iam_roles` / `iam_user_roles` / `iam_permissions` / `iam_role_permissions` / `iam_refresh_tokens`