zhuyongxin
92ab8d27ee
- 新增 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
59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
# 文档管理页面开发 - 项目概要
|
||
|
||
## 项目信息
|
||
- **日期**: 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 集成, 状态监控, 纯静态页面
|