docs: 文档/配置/测试同步 NAS :8124 生产现状,清除 Node.js 与甲骨文残留

背景:文档停在 Node.js 时代或甲骨文 8123 部署,与生产(NAS :8124 + Flask +
auth-hub + ai-gateway)严重脱节,曾导致凭旧记忆误判'无线上环境'。

- CLAUDE.md 重写:技术栈/结构/命令/部署事实/关键坑(F7 button、UTC 日期、
  429 退避以 DB 为准、迁移幂等、AI 生成耗时)
- docs/ARCHITECTURE.md 重写为 Flask 蓝图+services+可插拔数据层 + NAS 部署
- docs/DEVELOPMENT.md 重写为 Flask/CRA 开发指南 + push.sh 部署流程
- docs/REQUIREMENTS.md:部署条目改 NAS 8124;补 auth-hub/AI 教练/新修复
- docs/AUTH_HUB_INTEGRATION.md 新增(补 .env.example 悬空引用)
- README.md:技术栈/DB/auth-hub/API 清单/部署节修正
- backend/config.py 与 .env.example:AUTH_HUB_REDIRECT_URI 默认 8123→8124,
  MariaDB 注释 Oracle→NAS
- tests:GatewayCourtesy 并发测试对齐 MAX_CONCURRENT(AI_JOB_CONCURRENCY=2);
  conftest 禁用 create_app 后台队列线程,修整库测试 flaky(585 passed)
This commit is contained in:
ericwyuan
2026-09-02 19:34:32 +08:00
parent 68363957ec
commit 2d9a2be185
12 changed files with 609 additions and 496 deletions

View File

@@ -42,7 +42,7 @@
- [x] 身体年龄计算(`services/fitness_age.py`
- [x] 运动详情与全天曲线同步(`services/extras.py`
- [x] 运动详情与全天曲线同步(`services/garmin_extras.py`
- [x] 可插拔数据层(`db.py`,支持 SQLite ↔ MariaDB 切换)
@@ -109,7 +109,7 @@
- [x] 前端:今日页 AI 晨报卡片(后台生成 + 轮询升级)、全局 Copilot 浮窗、
指标详情页 AI 归因面板;`features.ts``ai` 开关已打开
- [x] 接入自建 ai-gateway`https://oracle.zichuan.xyz/ai/v1`),实测走通
- [x] 接入自建 ai-gateway`https://ai.zichuan.xyz/v1`),实测走通
- [x] 生产者/消费者队列(`services/jobs.py`):优先级队列 + 多 worker 互斥锁
@@ -122,6 +122,16 @@
> 流式 139 秒后返回「所有模型均不可用」,阻塞则成功,因此 `stream_chat()`
> 在流式无输出时会对同一模型退回非流式重试。
### Copilot 浮窗 UI 修复与文档同步2026-09-02
- [x] Copilot 浮窗 UI 修复Framework7 全局 `button { width: 100% }` 把面板内
✕ / 发送按钮拉满父容器,挤坏 flex 布局(输入框缩到 21px、✕ 跑到面板中间)。
`Copilot.css` 显式 `width: auto` 覆盖,重构产物已部署到 NAS :8124 验证。
- [x] 文档与代码对齐生产现状CLAUDE.md / README.md / docs/\* 全部更新为
Python/Flask + NAS :8124 + auth-hub + ai-gateway清除 Node.js 时代与
甲骨文 8123 的过时描述);`config.py` / `.env.example` 默认值同步。
## 待办
### 功能完善
@@ -135,7 +145,9 @@
- [ ] 多用户支持完善
### 运维
- [x] `deploy.sh` 自动复制前端构建到 `backend/static/`,避免部署旧版
- [ ] 监控与告警
- [ ] 日志轮转与清理
@@ -146,9 +158,11 @@
### 文档
- [x] ARCHITECTURE.md 需更新(当前仍为 Node.js 架构描述
- [x] ARCHITECTURE.md 已重写为 Python/Flask 架构 + NAS :8124 部署2026-09-02
- [x] DEVELOPMENT.md 需更新(当前仍为 Node.js 开发指南
- [x] DEVELOPMENT.md 已重写为 Flask/CRA 开发指南2026-09-02
- [x] REQUIREMENTS.md 更新
- [x] REQUIREMENTS.md 更新部署位置与新增需求2026-09-02
- [x] CLAUDE.md / README.md 同步为最新技术栈与部署现状2026-09-02