# 项目介绍

XControl Account Service（账号服务）负责用户注册、登录、会话管理、MFA、订阅状态与管理员权限矩阵等能力，同时提供与 Xray 节点协同的代理模式与跨区域数据同步工具。

## 解决的问题

- 统一账号体系：注册/登录/会话/密码重置
- 安全增强：邮件验证、TOTP 多因素认证
- 运营支持：订阅状态管理、用户指标统计
- 运维协同：Agent 模式同步 Xray 配置与状态
- 跨区数据：导入/导出与同步工具（`migratectl` / `syncctl`）

## 关键特性（基于当前代码）

- HTTP API：基于 Gin，默认端口 `:8080`，健康检查 `GET /healthz`
- 用户体系：用户名、邮箱、角色/等级、权限组
- 邮件能力：SMTP 可选；未配置 SMTP 时自动关闭邮件验证
- 会话管理：服务进程内存会话（非持久化）
- JWT 令牌服务：可选启用（public/access/refresh）
- 管理能力：管理员权限矩阵、用户指标与 Agent 状态接口
- Xray 侧同步：定期生成 Xray 配置并可触发校验/重启

## 运行模式

- `server`：仅启动账号 API 服务
- `agent`：仅启动 Agent，同步 Xray 配置并上报状态
- `server-agent` / `all` / `combined`：服务 + Agent 同时运行

## 代码位置速览

- 入口：`cmd/accountsvc/main.go`
- API：`api/`
- 配置：`config/`
- 数据库：`sql/`
- 工具：`cmd/migratectl`、`cmd/syncctl`、`cmd/createadmin`
- 运行脚本：`scripts/`

下一步：阅读 `getting-started/quickstart.md` 完成最小启动示例。