用户教程与 Wiki 方案
结论
继续使用 Gollum(ty-wiki-portal)作为用例与教程的协作编辑入口,Git 仓库为唯一事实源;正式交付的教程站与 PDF/DOCX 从同一仓库由 CI 构建。
GitLab Wiki 仓库(唯一事实源) ▲ push/pull(sync.sh,每 2 分钟) ▲ MR / push Gollum 网页编辑(系统账号登录) VS Code / Obsidian / Typora 本地编辑 └─ CI:Markdown → VitePress 教程站 / PDF / DOCX(正式交付、可白标)
待补齐:登录与审计
- oauth2-proxy 放在 Gollum 前面,接统一身份源(车队/仓库系统账号,如 Supabase Auth OIDC 或 Keycloak/Authentik),按用户组限制可登录人员。
config.rbRack 中间件:读取X-Forwarded-User/X-Forwarded-Email,写入session['gollum.author'],使每次网页编辑的 Git 提交作者为真实用户;缺少请求头的请求一律拒绝。- 读写分离:只读实例(
--no-edit)与可编辑实例指向同一仓库。
外部文档联动
- 技术人员克隆仓库直接编辑并推送。
- 客户 DOCX 由 CI 用 Pandoc 转为 Markdown 入库;反向导出 DOCX/PDF 交付。
- 截图由 Playwright 脚本在测试环境自动生成,界面变化后重跑更新。
