# devpulse-prototype

**Repository Path**: chen-shijie00/devpulse-prototype

## Basic Information

- **Project Name**: devpulse-prototype
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-10
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevPulse 智能问答助手

把团队文档、课程资料和常见问题整理成可检索、可追溯、可反馈的知识库，通过检索增强生成技术提供可信回答的 Web 应用。

> 福州大学 2601_FZU_SE《软件工程实践》团队项目 · 团队 DevPulse · 2026 年 10 月

本仓库保存**界面原型**。原型共 **10 个页面 + 4 种状态**，主链路的 5 个页面按高保真绘制，下面按页面顺序展示全部截图。

可交互版本见课程博客第六章的「界面原型设计链接」。

---

## 主链路

| 登录与选择知识库 | 上传文档并完成解析 |
| --- | --- |
| ![登录与注册](shots/01-登录与注册.png) | ![知识库列表](shots/02-知识库列表.png) |
| **P01 登录 / 注册** | **P02 知识库列表** |

| 知识库详情与文档管理 | 文档上传与解析 |
| --- | --- |
| ![文档管理](shots/03-文档管理.png) | ![上传与解析](shots/04-上传与解析.png) |
| **P03 知识库详情与文档管理** | **P04 文档上传与解析** |

## 核心页面

### P05 智能问答

提问与回答左右分栏，关键结论后带编号引用标记，答案下方固定展示引用卡片。

![智能问答](shots/05-智能问答.png)

### P06 引用溯源

点击引用标记展开原文抽屉，给出原文片段、所在章节、相似度与文档更新时间。

![引用溯源](shots/06-引用溯源.png)

### P07 反馈评价

反馈的原因选项会直接进入知识缺口清单，形成闭环。

![反馈评价](shots/07-反馈评价.png)

## 管理端

| 知识缺口分析 | 成员与权限管理 |
| --- | --- |
| ![知识缺口](shots/08-知识缺口.png) | ![成员与权限](shots/09-成员与权限.png) |
| **P08 知识缺口分析** | **P09 成员与权限管理** |

| 个人中心与设置 | |
| --- | --- |
| ![个人设置](shots/10-个人设置.png) | **P10 个人中心与设置** |

## 状态设计

界面完整度主要体现在异常状态上，四种状态在原型中都已落地。

| 空态 | 加载态 |
| --- | --- |
| ![空态](shots/11-状态-空态.png) | ![加载态](shots/12-状态-加载态.png) |
| **知识库中没有文档时的引导** | **模型流式生成中的反馈** |

| 错误态 | 无权限态 |
| --- | --- |
| ![错误态](shots/13-状态-错误态.png) | ![无权限态](shots/14-状态-无权限.png) |
| **模型超时后的提示与重试** | **访问未授权知识库时的提示** |

## 页面清单

### 线框级原型图

除上面按页面顺序排列的高保真截图外，另有一套线框级原型图。它去掉视觉细节，只保留信息层级、字段与操作位置，便于讨论结构改动。两套画面来自同一个界面设计规范。

| | |
| --- | --- |
| ![原型图总览](wireframes/原型图-00-总览.png) | **十页总览** |

单页原图放在 `wireframes/` 目录，共 11 张：`原型图-00-总览.png` 到 `原型图-10-个人设置.png`。

| 编号 | 页面 | 保真度 |
| --- | --- | --- |
| P01 | 登录 / 注册 | 中保真 |
| P02 | 知识库列表 | 高保真 |
| P03 | 知识库详情与文档管理 | 高保真 |
| P04 | 文档上传与解析 | 高保真 |
| P05 | 智能问答 | 高保真 |
| P06 | 引用溯源抽屉 | 高保真 |
| P07 | 反馈评价 | 中保真 |
| P08 | 知识缺口分析 | 中保真 |
| P09 | 成员与权限管理 | 中保真 |
| P10 | 个人中心与设置 | 中保真 |
| S01 至 S04 | 空态、加载态、错误态、无权限态 | 状态设计 |

## 设计规范

| 类别 | 规范 |
| --- | --- |
| 主色 | 深蓝，用于主按钮、选中态与关键强调元素 |
| 辅助色 | 灰阶建立文本层级；绿色表示成功，橙色表示警告，红色表示错误 |
| 字体与字号 | 无衬线字体；页面标题 20 px，区块标题 16 px，正文 14 px，辅助说明 12 px |
| 间距 | 8 px 基准栅格，卡片内间距 16 px，模块之间 24 px |
| 引用组件 | 统一为文档名、章节、相似度、片段摘要四段式结构 |

## 相关交付物

| 交付物 | 位置 |
| --- | --- |
| 需求规格说明书（Word 与 PDF） | 华为云 CodeArts 仓库 `DevPulse_2` 的 `docs/` 目录 |
| 需求分析报告 PPT（14 页） | 同仓库 `slides/` 目录 |
| 界面原型设计答辩 PPT（13 页） | 同仓库 `slides/` 目录 |
| 原型的 HTML 源码与生成脚本 | 同仓库 `prototype/` 目录 |

## 团队

| 学号 | 姓名 | 分工 |
| --- | --- | --- |
| 102400135 | 郑宇凌 | 需求规格说明书主笔，类图建模与关系说明 |
| 102400210 | 陈仕杰 | 界面原型设计主责，界面原型设计答辩 PPT |
| 102400335 | 郑栋兴 | 需求规格说明书协作，需求分析报告 PPT |
| 102400334 | 张幼 | 界面原型协作，需求规格说明书排版与图表统一 |
| 152402114 | 郑天一 | 博客撰写与发布，两份评审表，需求追溯核对 |

## 说明

本仓库是**界面原型**，用于需求阶段的方案确认与课堂答辩，不包含后端实现与模型调用。原型的页面都是静态 HTML，不依赖任何服务端环境。