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