merge: complete DEMO-014 branded admin console

This commit is contained in:
d-robotics 2026-09-02 15:28:59 +08:00
commit fe9d85b6da
6 changed files with 992 additions and 189 deletions

File diff suppressed because it is too large Load Diff

View File

@ -15,26 +15,33 @@
<div class="app-shell">
<aside class="sidebar" aria-label="管理控制台导航">
<a class="brand" href="/admin/upload" aria-label="Enterprise Knowledge Platform 首页">
<span class="brand-mark" aria-hidden="true">EK</span>
<svg class="brand-mark" viewBox="0 0 48 36" aria-hidden="true">
<path d="M15 3h17a15 15 0 0 1 0 30H15v-9h17a6 6 0 0 0 0-12H15z" />
<circle cx="11" cy="18" r="8" />
</svg>
<span>
<strong>Enterprise Knowledge</strong>
<small>Demo Console</small>
<strong>地瓜机器人</strong>
<small>Knowledge Platform</small>
</span>
</a>
<div class="workspace-label">
<span>CONTROL DESK</span>
<strong>企业知识运营台</strong>
</div>
<nav class="primary-nav">
<a data-nav="upload" href="/admin/upload">
<span aria-hidden="true">+</span>上传文档
<span aria-hidden="true">01</span>上传文档
</a>
<a data-nav="documents" href="/admin/documents">
<span aria-hidden="true">▤</span>文档列表
<span aria-hidden="true">02</span>文档列表
</a>
<a data-nav="search" href="/admin/search">
<span aria-hidden="true">⌕</span>Search Lab
<span aria-hidden="true">03</span>Search Lab
</a>
</nav>
<div class="sidebar-foot">
<span class="environment-dot" aria-hidden="true"></span>
Demo Environment
DEMO ENVIRONMENT
</div>
</aside>
@ -44,17 +51,21 @@
<p class="eyebrow">KNOWLEDGE OPERATIONS</p>
<h1 id="page-title">上传文档</h1>
</div>
<a class="api-link" href="/api/v1/docs" target="_blank" rel="noreferrer">
API 文档 <span aria-hidden="true">↗</span>
</a>
<div class="topbar-actions">
<span class="system-state"><i aria-hidden="true"></i>API FIRST · V1</span>
<a class="api-link" href="/api/v1/docs" target="_blank" rel="noreferrer">
API 文档 <span aria-hidden="true">↗</span>
</a>
</div>
</header>
<div class="signal-line" aria-hidden="true"><span></span><span></span><span></span></div>
<div id="notice" class="notice" role="status" aria-live="polite" hidden></div>
<section id="upload-page" class="page" data-page="upload" aria-labelledby="page-title">
<div class="page-heading">
<div>
<p class="section-label">INGESTION</p>
<p class="section-label">01 / INGESTION</p>
<h2>让知识进入检索链路</h2>
<p>上传一个 PDF、DOCX、TXT 或 Markdown 文件,系统将同步完成解析、切分与索引。</p>
</div>
@ -70,8 +81,8 @@
required
/>
<span class="upload-icon" aria-hidden="true">↑</span>
<strong>点击选择文件</strong>
<span>单次上传一个文件</span>
<strong>选择知识文件</strong>
<span>支持 PDF、DOCX、TXT、Markdown · 单次一个文件</span>
<span id="selected-file" class="selected-file">尚未选择文件</span>
</label>
<button id="upload-button" class="primary-button" type="submit">上传并处理</button>
@ -79,7 +90,7 @@
<article id="upload-result" class="result-card" hidden>
<div>
<p class="section-label">LATEST UPLOAD</p>
<p class="section-label">LATEST SIGNAL</p>
<h3 id="upload-filename"></h3>
</div>
<span id="upload-status" class="status-pill"></span>
@ -95,7 +106,7 @@
<section id="documents-page" class="page" data-page="documents" aria-labelledby="page-title" hidden>
<div class="page-heading heading-row">
<div>
<p class="section-label">DOCUMENTS</p>
<p class="section-label">02 / DOCUMENTS</p>
<h2>文档列表</h2>
<p>查看知识文档的状态、元数据并管理 Demo 数据。</p>
</div>
@ -115,7 +126,7 @@
<th>类型</th>
<th>上传时间</th>
<th>状态</th>
<th><span class="sr-only">操作</span></th>
<th aria-label="操作"></th>
</tr>
</thead>
<tbody id="document-rows"></tbody>
@ -132,7 +143,7 @@
<section id="search-page" class="page" data-page="search" aria-labelledby="page-title" hidden>
<div class="page-heading">
<div>
<p class="section-label">RETRIEVAL</p>
<p class="section-label">03 / RETRIEVAL</p>
<h2>Search Lab</h2>
<p>输入问题,检查 Dense 召回与 Reranker 精排后的 Top-K 来源。</p>
</div>

View File

@ -369,11 +369,13 @@ DEMO-007 Dense Retrieval
DEMO-008 Reranker + Source Result
DEMO-009 Document/Search REST API
DEMO-010 简单 Admin Console
DEMO-014 地瓜机器人品牌化前端优化(用户新增)
ARCH-001~006 Provider 架构迁移与真实验收
```
实施状态(2026-09-02):`DEMO-001~DEMO-010` 与 `ARCH-001~ARCH-006` 均已按顺序完成并
通过当前 Scope 的闭环验收。`DEMO-011~DEMO-013` 仍为可选项,不因本状态记录自动进入范围。
实施状态(2026-09-02):`DEMO-001~DEMO-010`、用户新增的 `DEMO-014` 与
`ARCH-001~ARCH-006` 均已完成并通过当前 Scope 的闭环验收。`DEMO-011~DEMO-013` 仍为
可选项,不因本状态记录自动进入范围。
可选:

View File

@ -21,6 +21,16 @@ make run
`/admin` 默认展示上传页。OpenAPI 文档仍位于 `/api/v1/docs`。
## 品牌视觉基线
DEMO-014 参考地瓜机器人公开官网的设计语言,使用品牌橙 `#FF3C00`、黑白高对比、中文
无衬线标题、紧凑数据字体、低圆角容器和宽松留白。贯穿页面标题的“计算信号轨”是唯一的
强调性图形,序号对应上传、文档、检索三步真实操作顺序。
品牌图形使用仓库内的代码原生 SVG/CSS 绘制,不复制或热链官网图片、字体和脚本;页面
运行时不依赖品牌官网。前端设计方法参考 GitHub `anthropics/skills` 的 Apache-2.0
`frontend-design` Skill,并以现有 Demo 信息架构、可访问性和业务正确性为优先约束。
## Demo 操作闭环
1. 在上传页选择一个 PDF、DOCX、TXT 或 Markdown 文件并提交;

View File

@ -1,13 +1,13 @@
# 项目进度
当前阶段:Retrieval Demo 闭环完成
当前阶段:Retrieval Demo 与品牌界面闭环完成
已完成:DEMO-001~DEMO-010、ARCH-001~ARCH-006
已完成:DEMO-001~DEMO-010、DEMO-014、ARCH-001~ARCH-006
进行中:无
阻塞:无
下一任务:无。`docs/demo/DEMO_SCOPE.md` 当前批准的必做任务已经完成;可选 DEMO-011~013
或 V1 backlog 需在明确选定新 Task 后再开始。
下一任务:无。`docs/demo/DEMO_SCOPE.md` 当前批准的必做任务和 DEMO-014 已经完成;可选
DEMO-011~013 或 V1 backlog 需在明确选定新 Task 后再开始。
Provider 架构迁移按 `ARCH-001 → ARCH-002 → ARCH-003 → ARCH-004 → ARCH-005 → ARCH-006`
执行并已完成。DEMO-010 在迁移闭环验收后实施,未扩大为完整 V1 Admin Console。
@ -250,3 +250,20 @@ Provider 架构迁移按 `ARCH-001 → ARCH-002 → ARCH-003 → ARCH-004 → AR
作为底层链路基线。
- 已知非阻塞风险保持不变:配置清单中的历史 test 凭据仍应轮换;真实 Provider 瞬时失败的
重试、限流与告警留待后续明确 Task。Demo Console 本身没有新增凭据或生产 Endpoint。
### DEMO-014(已完成)
- 将 DEMO-010 通用绿色界面升级为地瓜机器人品牌化 Admin Console,使用唯一品牌强调色
`#FF3C00`、黑白高对比、无衬线中文排版、低圆角工业组件和与三步操作对应的计算信号轨;
没有增加页面、接口或业务能力。
- 品牌标记由内联 SVG 与 CSS 原生绘制,不下载、复制或热链官网资产。页面没有新增外部
Runtime、字体请求或第三方脚本,继续保持原生 HTML/CSS/JS 和同源 `/api/v1` 调用。
- GitHub 调研确认官方 `openai/skills` 当前没有通用前端设计 Skill;选择并安装了 Apache-2.0
的 `anthropics/skills/skills/frontend-design`。该 Skill 只影响视觉策划和自检方法,不进入
项目运行依赖或仓库产物。
- 浏览器使用本地确定性 Provider 再次完成 README 上传 → Ready → 文档列表 → Top5 检索;
1440px 桌面端和移动端均无根页面横向溢出、无前端警告或错误。复验中发现隐藏表头将移动
页面撑宽至 503px,已改为 `aria-label`,最终根宽度与 463px 视口一致,表格只在容器内滚动。
- 完整验证结果:Ruff Format/Lint、Mypy、JavaScript 语法与 Git diff 通过;Unit、Integration
和 RAG Evaluation 合计 `155 passed`;Alembic Head 与离线升级通过。本任务不修改 API、
检索算法、Provider 或数据库,不重复调用真实资源验收。

View File

@ -35,11 +35,16 @@ def test_admin_console_contains_only_demo_pages_and_versioned_api_calls(
with TestClient(create_app(Settings(app_env="test"))) as client:
html = client.get("/admin").text
script = client.get("/admin/assets/app.js").text
stylesheet = client.get("/admin/assets/styles.css").text
assert all(label in html for label in ("上传文档", "文档列表", "Search Lab"))
assert "地瓜机器人" in html
assert all(page_id in html for page_id in ("upload-page", "documents-page", "search-page"))
assert all(label not in html for label in ("权限管理", "任务管理", "Compiled Knowledge"))
assert 'const API_BASE = "/api/v1"' in script
assert "innerHTML" not in script
assert all(endpoint in script for endpoint in ('"/documents"', '"/search"'))
assert all(field in script for field in ("Page", "Section", "Dense Score", "Rerank Score"))
assert "--brand: #FF3C00" in stylesheet
assert "prefers-reduced-motion" in stylesheet
assert "https://" not in html