Fago 文档 Fago 文档
首页
快速开始
后端手册
前端手册
规划备查
文档维护
首页
快速开始
后端手册
前端手册
规划备查
文档维护
  • 快速开始

    • 简介
    • 功能列表
    • 快速启动(后端)
    • 快速启动(前端)
    • 技术选型
    • 项目结构
    • 接口与错误码
  • 后端手册

    • 配置与环境
    • 登录与会话
    • 功能权限与菜单
    • 数据权限
    • 用户、部门、岗位与角色
    • 租户与安全策略
    • 异常处理与错误码
    • 参数、分页与响应
    • 数据库迁移
    • 日志、脱敏与请求加密
    • 平台租户与套餐
    • fago-cli 常用命令
    • 发布验证与恢复演练
    • 字典与参数配置
    • 文件与对象存储
    • 站内通知与执行恢复
    • 定时任务与运行恢复
    • 可靠消息后端与积压观测
    • 身份客户端与设备会话
    • 会员认证与账号管理
    • 服务账号与 scope
    • OIDC 提供方与外部绑定
    • 原生 SSO 验收客户端
    • 账号认证模式
    • 工作流 API 与运行目录
  • 前端手册

    • 本地启动
    • 菜单与路由
    • 请求合同
    • 页面与按钮权限
    • 浏览器单点登录
    • 审批中心与表单发起
    • 工作流定义与运行管理
  • 规划备查

    • Fago:架构与实施方案
    • 总体架构
    • 身份、权限与租户设计
    • Vben 5 前端与 API 合同
    • 数据库与消息后端适配
    • 纯 Go 通用工作流:文件、文档与业务流程
    • 核心数据模型
    • 分期、工作包与验收
    • 架构决策与风险
    • 参考来源与基线
    • 网络安全等级保护二级合规要求
    • M0 实施与验收
    • M1 身份与导航实施及验收
    • 项目配置、API 内容加密与敏感数据脱敏
    • M2 系统管理实施记录
    • M3 平台与 SaaS 实施记录
    • fago-cli 功能规划
    • 生产传输层 WARN 变更范围(2026-10-23)
    • M4 发布实施与验收
    • M4 加固检查归档(本地工程环境)
    • M5 通用平台与身份实施
    • M6 R3.1 正式工作流核心与基础审批

功能列表

# 功能列表

状态只表示当前仓库里读者能否按手册操作。规划中的能力不提供操作步骤。

能力 现在可以做什么 状态
后端启动、迁移、初始化 准备 MySQL 或 PostgreSQL、Redis,执行迁移和显式初始化,启动 API 已实现
前端工作台 用 Vben 连接本机 API,打开工作台 已实现
健康检查 GET /api/health/live 看进程,GET /api/health/ready 看数据库、schema 和 Redis 已实现
登录、刷新、退出、改密、会话撤销 租户身份与平台身份分开;连续失败锁定;必须改密 已实现
身份客户端与设备会话 平台维护客户端、期限/会话上限、配置停用与版本fencing、本人全设备退出 已实现,双库与当前来源验证通过
OIDC提供方与外部绑定 部署信任档案、平台配置、三域隔离绑定与停用历史 已实现,真实双Web应用SSO与签名退出通过
服务账号与 scope 独立机器凭据、轮换、scope与字典只读消费者 已实现,双库验证
会员认证与账号管理 独立会员主体/会话、管理员再鉴别、首次改密、刷新重放、会话撤销与本人注销 已实现,双库验证
菜单与按钮权限 服务端发布菜单和权限码,前端按同一权限码显示按钮 已实现
部门、岗位、用户、角色 租户内增删改查、版本冲突检查、保留角色保护 已实现
数据权限 按具体权限合并本人、本部门、部门子树、自选部门或本租户全部 已实现
租户安全策略 继承或覆盖口令、锁定、空闲和有效期;解锁账号 已实现
操作日志、登录日志 按权限只读查询,出口脱敏,当前持续保留 已实现
配置、脱敏、生产内容加密 环境 YAML;开发默认明文 JSON;生产强制 JWE 已实现
平台租户与套餐管理 待初始化创建、幂等初始化、停用恢复、到期续期、能力/权限上限、账号配额与平台审计 已实现,双库自动验收通过
字典与参数配置 平台公共标准/模板与私有参数、公开默认模板;租户版本复制后独立CRUD,敏感值不回显 已实现,双库专项通过
文件与对象存储 租户内 5 MiB 上传/授权下载、版本删除、后台恢复清理;通用 S3 endpoint,或单机预建目录 已实现。S3 已做双库及 RustFS 本地联调;local 驱动有目录隔离测试,多副本共享盘未认证
站内通知与执行恢复 模板/发送快照、幂等、本人收件箱、死信管理与正式 Event worker 已实现,双库本地工程基线与组合恢复通过
定时任务与运行恢复 仅Cron/时区/错过策略/预览;租户通知、平台统计及独立租户子运行、人工命令与恢复 已实现,双库本地工程基线与组合恢复通过
代码生成 受限tenant-crud-v1同包双库迁移/HTTP/真实浏览器验收通过,生成包评审后接入 受限模板本地工程验收通过
Excel 尚未实现通用导入/导出 后续阶段
原生SSO验收客户端 系统浏览器PKCE、内存会话、刷新与本地/RP退出;macOS三协议真实IdP通过 有限验收命令已实现,macOS真实浏览器通过
账号认证模式 三主体口令/混合/仅SSO策略、最后绑定与恢复管理员保护、版本及会话撤销 v26已实现,双库验证
浏览器单点登录 Vben登录/来源绑定刷新/重载/本地与RP退出;真实双应用SSO、IdP故障补偿与签名统一退出通过 本地工程与M5最终回归通过
WebSocket 实时通道 规划
消息适配 Event/Redis Streams 正式运行入口、引用保留、同库待办指标;RabbitMQ/Kafka/RocketMQ 待接入 分适配器验证,未作统一认证
Oracle、SQL Server、达梦等 目标数据库。达梦只有开发实例行为 PoC,默认运行时未装配 未认证
工作流API与运行目录 显式目录登记、实际API/worker池、表单/定义目录、本人草稿/发起/投票已办/非投票操作、发起与审批受理/进度查询/继续、正文审批及外部动作管理。另有表单与流程原稿、受控 BPMN 画布和发布 已接入审批、发起、定义与运行管理以及设计原稿页面;schema v52。浏览器与完整 R3.1 验收仍进行中
文档版本 确认本人已上传文件为不可变内容版,保留留存、legal hold 和精确引用 建设中,尚未单独成册

Redis 已经用于登录限流和请求内容加密的请求号去重。权限的权威数据在业务主库,这里不把 Redis 权限缓存写成独立操作说明。

验收范围见 M1 身份与导航 、M2 系统管理 和 M3 平台与 SaaS。

M4 已提供 发布验证、运行指标与恢复演练 入口,生产发布仍以 实际门槛 为准。

M5 本地工程与自动化验收已完成;各 R2 工作包证据及未认证范围见 M5 实施记录。

就绪探针示例(无需登录;地址与 快速启动(后端) 中 APP_HTTP_ADDR 一致):

curl -sS "http://127.0.0.1:8081/api/health/live"
curl -sS "http://127.0.0.1:8081/api/health/ready"

ready 在依赖不可用时返回 HTTP 503 与业务码 503001。

首批工作流用户页面的前置权限、操作与失败处理见审批中心与表单发起;浏览器验收仍待执行,不以组件测试代替。

最后更新: 2026/11/3 09:09:29
简介
快速启动(后端)

← 简介 快速启动(后端)→

Theme by Vdoing | Copyright © 2026-2026 Fago 项目文档
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式