diff --git a/.env.example b/.env.example index fa30f57..7380dde 100644 --- a/.env.example +++ b/.env.example @@ -21,4 +21,6 @@ AI_RUN_RETENTION_DAYS=90 MINIO_ROOT_USER=minio MINIO_ROOT_PASSWORD=minio123 -VITE_API_BASE_URL=http://localhost:8000/api +VITE_API_BASE_URL=/api +API_PROXY_TARGET=http://backend:8000 +API_PROXY_ORIGIN=http://localhost:8000 diff --git a/docs/development/ai-platform-demo-acceptance.md b/docs/development/ai-platform-demo-acceptance.md index 1b6ab97..5d859a6 100644 --- a/docs/development/ai-platform-demo-acceptance.md +++ b/docs/development/ai-platform-demo-acceptance.md @@ -1,14 +1,15 @@ # AI 平台配置演示版验收 -更新日期:2026-07-14 +更新日期:2026-07-16 ## 验收状态 | 检查项 | 状态 | 证据 | |---|---|---| -| 后端自动化 | 已通过 | 71 项 pytest;Ruff、迁移漂移与 Django system check 通过 | +| 后端自动化 | 已通过 | 79 项 pytest;Ruff、迁移漂移与 Django system check 通过 | | 全新数据库迁移 | 已通过 | 测试配置下从空库应用全部迁移 | -| 前端自动化 | 已通过 | 15 项 Vitest;覆盖异步轮询、失败态、发布、运行详情和取消;ESLint、类型检查与生产构建通过 | +| 前端自动化 | 已通过 | 38 项 Vitest;覆盖异步轮询、失败态、发布、运行详情、取消、应用壳层、个人中心和本地 Agent 面板;ESLint、类型检查与生产构建通过 | +| 本地界面人工验收 | 已通过 | 桌面端管理工作台由项目验收人确认正常 | | 真实模型三步运行 | 待执行 | 凭证仅允许管理员在本地录入,不进入仓库 | 真实模型三步运行通过前,本演示版只能描述为“实现完成、真实渠道验收待完成”。 diff --git a/docs/development/local-setup.md b/docs/development/local-setup.md index 637f5a1..31ceefb 100644 --- a/docs/development/local-setup.md +++ b/docs/development/local-setup.md @@ -39,6 +39,12 @@ Backend: Frontend: - App: http://localhost:5173 +- 局域网访问: `http://<宿主机局域网 IP>:5173` + +前端默认通过同源 `/api` 代理后端:宿主机直接运行 Vite 时代理到 +`http://localhost:8000`,Docker Compose 中通过 `API_PROXY_TARGET` 代理到 +`http://backend:8000`。因此局域网访问时无需把浏览器 API 地址配置为 +`localhost:8000`。 默认管理员: diff --git a/docs/product/capability-status.md b/docs/product/capability-status.md index 61a4e8f..783ea13 100644 --- a/docs/product/capability-status.md +++ b/docs/product/capability-status.md @@ -1,6 +1,6 @@ # AI 工单平台能力状态 -更新日期:2026-07-14 +更新日期:2026-07-16 状态定义: @@ -27,15 +27,18 @@ | AI 平台 | Skill 草稿、发布、Schema 和回滚 | 真实 | 受限模板、JSON Schema、不可变发布版本、克隆草稿和按版本回滚已实现 | | AI 平台 | Agent 版本、有序执行和运行轨迹 | 真实 | 草稿沙箱、发布校验、Celery 有序执行、失败终止、结构修复、取消、快照和运行详情已实现 | | AI 平台 | MCP | 缺失 | 不在本次演示范围 | -| 前端 | 工单工作台概念方案 | 演示 | 保留在 `/concept` 设计实验室,不计为真实功能 | +| 前端 | 研发管理工作台、两级导航、页面标签、个人中心 | 真实 | 使用真实治理与业务 API;桌面端人工验收已通过 | +| 前端 | 全局 Agent 助手面板 | 演示 | 仅做本地交互演示,页面持续显示演示标识,不写业务数据 | | 部署 | PostgreSQL、Redis、MinIO 本地基础设施 | 真实 | `infra/docker-compose.local.yml` | | 部署 | Celery worker 与 Beat | 真实 | 模型测试、Agent 运行与每日留存清理使用 Celery;本地完整编排包含 Redis worker 和 Beat | ## 当前质量基线 -- 后端测试:71 项通过;Ruff、迁移检查、Django system check 和全新数据库迁移通过。 -- 前端测试:15 项通过;ESLint、TypeScript 类型检查和生产构建通过。 -- 前端生产入口包约 626 KB,存在 Vite 体积告警;后续按路由懒加载拆包。 +- 后端测试:79 项通过;Ruff、迁移检查、Django system check 和全新数据库迁移通过。 +- 前端测试:38 项通过;ESLint、TypeScript 类型检查和生产构建通过。 +- 前端已按路由懒加载拆包,生产主入口约 479.90 KB,无 Vite 体积告警。 +- `/concept` 设计实验室及其 Mock 数据已按产品决策删除;正式路由测试禁止重新引入概念页面。 +- 本地桌面端界面人工验收已通过。 - 真实模型渠道的三步端到端脚本尚未执行,因为凭证必须由管理员在本地提供;在该步骤通过前,不声明演示里程碑验收完成。 能力状态只依据已验证代码更新。页面存在、类型定义存在或 Mock 可交互,不视为真实能力。