架构与后端服务

更完整的架构说明、功能与接口约定见 系统设计说明。

进程与端口（默认）

服务	端口	职责
Gateway	3000	JWT 校验；按路径转发到 Sys / Acc；统一响应 { code, message, data }；/api/no-check/... 等免 JWT 规则见网关配置
Sys	3001	认证、用户、站点、角色、权限等系统域 API
Acc	3002	进销存、生产、结算等记账域 API
Frontend	5173	Vite 开发服务器；/api 代理到网关

浏览器只访问前端；不要直接依赖 Acc 的 WebSocket 经同一 Vite 代理暴露给生产（开发期按项目实际配置为准）。

请求路径约定（摘要）

• /api/sys/* → Sys（默认需 JWT）
• /api/acc/* → Acc（默认需 JWT）
• /api/no-check/sys/*、/api/no-check/acc/* → 对应下游，不校验 JWT

网关上游表与环境变量见 backend/src/apps/gateway/config/ 与 backend/MICROSERVICES.md。

ZenStack 与权限

• Schema 位于 backend/zenstack/schema.zmodel，生成物在 backend/zenstack/。
• 策略与 AuthContext（用户 id、站点、角色等）在模型中声明，运行时由 ZenStack 插件与 $setAuth 配合。

健康检查

• 网关：GET /api/health
• 经网关探活下游：例如 POST /api/no-check/sys/health/page（body 可为 {}），详见 MICROSERVICES.md。