Blame

a6a726 sijie 2026-11-15 03:14:08
新增用户教程与Wiki方案、车队系统性能测试方案页面 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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
- [车队系统性能测试方案](车队系统性能测试方案)