Files
zhuyongxin 92ab8d27ee 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
2026-06-25 15:05:48 +08:00

1.5 KiB
Raw Permalink Blame History

文档管理页面开发 - 项目概要

项目信息

  • 日期: 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 集成, 状态监控, 纯静态页面