- 新增 documents.html 文档管理页面 - 文档列表展示(支持筛选和分页) - 文档上传功能(带元信息表单) - 文档详情查看(右侧滑出面板) - 文档删除功能 - 状态统计卡片(待处理/处理中/已索引/失败) - 新增 documents.css 和 documents.js - 纯静态页面实现,无需额外框架 - 与现有 index.html 保持一致的设计风格 - 修复列表滚动问题(覆盖 body overflow 设置) - 修复时间字段显示 NaN 问题(增加 Invalid Date 检查) - 在 index.html 侧边栏添加文档管理入口 - 归档项目文档到 devflow 和 openspec - devflow/projects/2026-06-25-doc-management-ui/ - openspec/changes/doc-management-ui/ - 更新 devflow/index.md
1.5 KiB
1.5 KiB
文档管理页面开发 - 项目概要
项目信息
- 日期: 2026-06-25
- Slug: doc-management-ui
- 领域: 前端开发/文档管理
- 状态: 已完成(未经过完整 sm-flow)
背景
项目已有后端 API(DocumentController),需要开发前端文档管理页面,用于管理 API 文档的上传、查询、删除和状态监控。
目标
开发一个独立的文档管理页面(documents.html),提供:
- 文档列表展示(支持筛选和分页)
- 文档上传(带元信息表单)
- 文档详情查看
- 文档删除
- 状态监控(统计卡片)
范围
In Scope:
- 纯静态页面(HTML + CSS + JavaScript)
- 完整的 CRUD 功能
- 与现有 index.html 一致的设计风格
- 在侧边栏添加入口链接
Out of Scope:
- 自动轮询状态更新
- 批量操作
- 文档内容预览
- 完整的分页导航
技术方案
- 前端技术栈: 纯静态页面,无需额外框架
- 后端 API: 基础路径
/api/documents - 样式设计: 复用 styles.css + 少量定制(documents.css)
- 文件结构:
- documents.html(主页面)
- documents.css(样式)
- documents.js(逻辑)
实现结果
已创建:
src/main/resources/static/documents.htmlsrc/main/resources/static/documents.csssrc/main/resources/static/documents.js
已修改:
src/main/resources/static/index.html(添加文档管理入口)
关键字
前端, 文档管理, CRUD, API 集成, 状态监控, 纯静态页面