1.4 KiB
1.4 KiB
架构
本页是共享双语架构细页的中文入口。
当前架构一句话
accounts.svc.plus 是一个以 Gin 为入口的 Go 服务，同时承担：
- 账号与会话管理，
- 管理员控制面，
- agent / Xray 配置控制，
- 使用量与计费读面。
真实启动链路集中在 cmd/accountsvc/main.go：主 store.Store、GORM 管理面 DB、可选 mailer、可选 token service、agent registry、可选 Xray periodic syncer 都在这里装配完成，然后统一进入 api.RegisterRoutes。
建议阅读顺序
- 架构总览 看主启动链路、请求路径、session 状态持有、agent 上报与 Xray 配置生成。
- 组件职责图 看按包划分的 owning responsibility、输入输出与依赖方向。
- 设计决策 看当前真实取舍，而不是只看结构。
当前架构主题
- Session first，JWT optional。
store.Store是主业务持久化抽象边界。- GORM 只用于 admin settings、homepage video、sandbox binding、tenant / XWorkmate 模型。
agentserver.Registry负责把 agent 凭据、身份和状态投影成控制面读视图。- Xray 配置以
xrayconfig.Generator+PeriodicSyncer为核心收敛模型。