feat(doc-management): 添加文档管理前端页面

- 新增 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
This commit is contained in:
zhuyongxin
2026-06-25 15:05:48 +08:00
parent 125e8281e7
commit 92ab8d27ee
11 changed files with 3263 additions and 2 deletions
@@ -0,0 +1,58 @@
# 文档管理页面开发 - 项目概要
## 项目信息
- **日期**: 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.html`
- `src/main/resources/static/documents.css`
- `src/main/resources/static/documents.js`
已修改:
- `src/main/resources/static/index.html`(添加文档管理入口)
## 关键字
前端, 文档管理, CRUD, API 集成, 状态监控, 纯静态页面