项目结构

外层仓库组织运行脚本、合同、部署和文档。前后端统一在唯一的 fago Git 子模块中维护。

demo/
  fago/                 统一Git子模块
    fago-server/        后端Go workspace
      apps/fago-cli/    CLI应用（fago-cli 二进制）
    fago-vben5/         前端workspace，应用在 apps/web-antd
  fago-doc/             在线文档站
  api/openapi.yaml      HTTP 合同
  deploy/compose/       本地 MySQL、Redis，以及 poc profile 的 PostgreSQL
  deploy/proxy/         生产反向代理模板
  docs/                 手册与规划的编辑来源
  scripts/              fago.sh、web.sh 和检查脚本

后端 fago/fago-server/go.work 当前组装 26 个成员，全部位于后端仓库内部：

路径	作用
apps/fago-server	API、worker 的装配入口
apps/fago-cli	同仓独立Go模块；迁移、初始化与运维命令
modules/fago-contracts	窄契约
modules/fago-framework	配置、日志、HTTP、事务端口
modules/fago-security	JWE 与脱敏
modules/fago-identity	身份、会话
modules/fago-tenancy	租户上下文与隔离
modules/fago-system	用户、部门、岗位、角色、菜单与审计查询；提供同库授权/审计窄桥接
modules/fago-infra	字典参数、文件、文档版本、通知与任务；通过应用注入的 TenantGate 协作
modules/fago-bpm	表单设计原稿、富字段编译和发布
modules/fago-workflow-approval	人工任务与候选快照，由工作流内核调用
modules/fago-codegen	元数据读取与代码生成协作；受限模板M5本地验收通过
modules/fago-messaging	outbox/inbox、可靠消息与worker窄契约
adapters/messaging/fago-event	Event通知传输
adapters/messaging/fago-redis	Redis Streams传输
adapters/storage/fago-local	预建绝对目录上的对象读写，不替代禁用状态
adapters/storage/fago-s3	显式endpoint的通用S3适配
modules/fago-ops	显式初始化与运维用例，供 CLI 装配
modules/fago-workflow-core	工作流内核、流程原稿编译与发布；R3 未结项
modules/fago-workflow-resource	文件、文档和业务资源接入端口；通用资源认证未完成
adapters/database/fago-mysql	MySQL
adapters/database/fago-postgres	PostgreSQL
adapters/database/fago-dm	达梦适配；版本认证边界以数据库文档为准
fago-migrations	三种方言的追加式迁移脚本
poc/fago-database	商业库探针，默认 API 不引入
poc/fago-oidc	历史OIDC试验；正式运行面在identity与server

目录名使用 fago- 前缀，Go 包名使用 fago 前缀。三个进程入口保留 package main。

总体架构 中独立授权、文档和其他数据库适配模块仍是目标结构；infra已交付字典与参数、文件、通知与定时任务，本地验收范围见M5记录。不要按目标树创建尚未立项的模块。

当前 schema 为 v52。2026-10-28 的模块检查记录在 docs/evidence/2026-10-28-fullstack-monorepo.json，只说明当时的检查，不覆盖此后的工作流增量。本次文档同步没有重跑完整应用套件。