简介

Fago 是用 Go 编写的企业后台。后端按能力拆成多个模块，前端使用 Vben 5 的 web-antd。一次部署选择一种业务库，当前可以运行的是 MySQL 与 PostgreSQL。

到 2026-10-28，M0–M4 本地工程已完成，其中 M1/M2 已获用户人工验收确认。M5 已实现数据范围、字典参数、通用 S3 文件、Event/Redis 可靠任务、受限代码生成、多用户多终端和 OIDC SSO；真实双应用登录、故障补偿与签名退出已验证。文件也可以使用单机预建目录，多副本共享盘未认证。M5 本地工程与自动化验收已完成，证据见 M5 实施记录。2026-11-09 的仓库已到 schema v52：表单与流程原稿、受控 BPMN、审批任务和不可变文档版本可以本地运行，M6 / R3 尚未结项。当前没有生产环境，尚未执行生产部署；其他数据库、消息后端、任意 IdP 和完整生产工作流仍未认证。

M4 证据与部署边界见 实施记录。

功能是否已经能用，以 功能列表 为准。字典、文件、可靠任务、受限代码生成模板和身份管理已有对应操作手册；浏览器与原生 SSO 已有操作手册，未认证数据库/消息后端和生产工作流仍在后续范围。

文档怎么读

左侧是同一本手册里的四个分册：

分册	用来做什么
快速开始	了解范围、把前后端在本机跑起来、知道合同和目录在哪
后端手册	按已经落地的能力说明配置、登录、权限、组织和数据怎么工作
前端手册	说明本地页面、菜单路由、请求合同和按钮权限
规划备查	保留架构、数据模型、路线图、决策和里程碑验收记录

手册页只写现在可以照着做的事。设计依据和验收证据放在规划备查，例如 项目总览 与 分期与验收。

接下来

1. 看 功能列表，确认要做的事是否已经交付。
2. 按 快速启动（后端） 和 快速启动（前端） 在本机打开工作台。
3. 要改某一块已有能力时，进入对应的后端或前端手册页，再按页末链接查看规划备查。

初始化子模块与探测 API 是否已监听（在外层仓库根目录）：

git submodule update --init --recursive
curl -sS "http://127.0.0.1:8081/api/health/live"

live 返回 200 只表示进程在运行；数据库与 Redis 就绪见 GET /api/health/ready（见 功能列表）。