merge: complete DEMO-014 branded admin console
This commit is contained in:
commit
fe9d85b6da
File diff suppressed because it is too large
Load Diff
@ -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>
|
||||
|
||||
@ -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` 仍为
|
||||
可选项,不因本状态记录自动进入范围。
|
||||
|
||||
可选:
|
||||
|
||||
|
||||
@ -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 文件并提交;
|
||||
|
||||
@ -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 或数据库,不重复调用真实资源验收。
|
||||
|
||||
@ -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
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user