Infra 文档首页

定位：Infra 文档站首页（入口 + 导航 + 场景） 在线站点：https://wangzitian0.github.io/infra2/ 源码入口：本仓库 docs/ 目录

---

命令示例默认使用 invoke；未激活虚拟环境时请使用 uv run invoke。

你是谁？

• 应用开发者：从 5 分钟快速开始入门，按场景接入数据库/密钥/SSO。
• 基础设施维护者：先看 SSOT Core + Ops Standards，再进入 Bootstrap / Platform 目录操作。
• 文档/项目协作：查看 Project Portfolio，按模板记录变更和 TODO。

---

🚀 开发者接入路径 (Onboarding)

按顺序完成以下场景：

1. 5 分钟快速开始 - 了解平台能力与基本流程
2. 部署第一个应用 - 端到端发布流程
3. 使用数据库 - PostgreSQL/Redis 接入
4. 管理密钥 - Vault 获取与管理
5. 接入 SSO - Authentik OIDC
6. 监控和分析 - 规划中
7. 新增服务 SOP - 新服务上线检查清单

---

📖 SSOT 技术真理源

需要理解架构与规范时，优先查阅 SSOT：

• SSOT Index - 话题入口与索引
• 核心架构 - 分层与依赖
• 变量与密钥 - 变量契约与密钥流转
• 运维规范 - 防御性规则与约束
• 恢复 SOP - 故障恢复路径

---

🧭 项目治理

• Project Portfolio - 全量项目索引
• 进行中项目：docs/project/Infra-XXX.*.md
• 归档项目：docs/project/archive/

---

🧭 返回入口

• 工程入口：README.md
• SSOT 索引：docs/ssot/README.md
• 项目追踪：docs/project/README.md
• AI 行为准则：AGENTS.md
• 文档索引：docs/README.md

---

🧰 基础设施维护入口

• Bootstrap (L1)：local · GitHub
• Platform (L2)：local · GitHub
• Tools (env_tool)：local · GitHub

---

✍️ 文档维护

• 构建文档站：mkdocs build --config-file docs/mkdocs.yml
• Project 模板：docs/project/project_template.md
• TODOWRITE 模板：docs/project/todowrite_template.md
• SSOT 模板：docs/ssot/template.md

---

Last updated: 2025-12-30