docs(项目启动): SRS/SDD 文档入库 + README/PROGRESS + 仓库初始化

PROGRESS.md

@@ -0,0 +1,49 @@
+# 项目进度追踪
+
+> 最后更新: 2026-08-23
+
+## 服务运行状态
+
+| 服务 | 节点 | 状态 | 说明 |
+|------|------|------|------|
+| Nginx | 美国服务器（待申请） | ⏳ 未部署 | HTTPS 反向代理层 |
+| LobeChat | 美国服务器（待申请） | ⏳ 未部署 | 前端对话界面 |
+| One-API | 美国服务器（待申请） | ⏳ 未部署 | 网关聚合层 |
+| MySQL | 美国服务器（待申请） | ⏳ 未部署 | One-API 数据存储 |
+
+## 2026-08-23 项目启动：文档入库 + 仓库初始化
+
+- **决策**：采用成熟开源组件（Nginx + LobeChat + One-API + MySQL）容器化搭建，不重复造轮子；网关对外统一暴露 `auto-vision` / `auto-text` 两个聚合模型名。
+- **文档**：`docs/01-软件需求文档-SRS.md`（V1.0）+ `docs/02-软件设计文档-SDD.md`（V1.0）入库；README 汇总架构/服务器访问信息/提交规范。
+- **安全**：Gemini 与 NVIDIA 的旧 API Key 不写入仓库（将申请新值）；所有 Key 计划通过服务器 `.env` 管理（已加入 .gitignore）。
+- **仓库**：本地初始化，推送 Gitea `http://192.168.50.64:3000/ericwyuan/NexusAI`。
+
+## 任务进度
+
+### 已完成
+
+| # | 任务 | 日期 |
+|---|------|------|
+| 1 | 软件需求文档（SRS V1.0）入库 | 2026-08-23 |
+| 2 | 软件设计文档（SDD V1.0）入库 | 2026-08-23 |
+| 3 | README（架构/服务器信息/提交规范） | 2026-08-23 |
+| 4 | 仓库初始化 + 推送 Gitea | 2026-08-23 |
+
+### 待完成
+
+| # | 任务 | 依赖 | 优先级 |
+|---|------|------|--------|
+| 1 | 申请美国服务器（网关部署目标） | - | 高 |
+| 2 | 申请新 Gemini / NVIDIA API Key | - | 高 |
+| 3 | 生成部署骨架（docker-compose.yml / nginx.conf / .env.example） | 文档 | 高 |
+| 4 | 实际部署 + One-API 渠道配置（5 家）+ Failover 验证 | 服务器/Key | 高 |
+| 5 | HTTPS 域名与证书 | 服务器 | 中 |
+| 6 | 确认 Server-Side 模式 / 管理端口访问方式 / 监控方案 | 决策 | 中 |
+
+## 技术决策记录
+
+1. **不重复造轮子** - 网关用 One-API、前端用 LobeChat，仅做配置层工作；前端、网关、各 AI 渠道间均走 OpenAI 兼容接口，任一组件可替换
+2. **模型映射** - 前端只感知 `auto-vision`（图文）与 `auto-text`（纯文本）两个聚合模型名，多渠道不同模型映射到统一对外模型名
+3. **优先级路由** - 渠道优先级数字越小越优先，同优先级内按权重轮询分摊负载
+4. **冷却恢复** - 渠道连续失败超阈值（5 次/5 分钟）进入冷却禁用，冷却期（10 分钟）后自动恢复参与路由
+5. **最小暴露面** - 仅 Nginx 80/443 对公网暴露，One-API 后台与 MySQL 端口仅容器内网可访问