更新说明文档
大石头 authored at 2022-04-16 15:30:05
6.15 KiB
YuQue
# 新生命官网功能清单 > 版本:v1.0 | 日期:2026-09-02 > 状态标记:✅ 已完成 | 🟡 部分完成 | ❌ 未开始 | — 不适用 > 需求对应:[需求文档](/NewLife/YuQue/Blob/master/Doc/需求文档.md) | 架构设计:[架构设计](/NewLife/YuQue/Blob/master/Doc/架构设计.md) **拆分规则**:前后端拆为独立功能点。本项目为存量官网(内容站),功能点以页面/能力为粒度。 ## 拆分决策表 | 需求项 | 原因 | 拆分结果 | |--------|:----:|---------| | 文章搜索 | 前后端 | CONTENT-2 搜索接口 + WEB-4 搜索结果页 | | 产品宣传页 | 前后端 | PROD-1 产品页发布机制(后台)+ WEB-5 产品页展示(前台) | | 语雀同步 | 前后端 | CONTENT-1 同步服务(后台调度)+ CONTENT-3 HTML 规则处理 | ## WEB 官网前台 ### 父需求:首页 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | WEB-1a | 首页-巨幕横幅 | 前端 | ✅ | ✅ | ✅ | Nav"巨幕"树驱动,绿色渐变 + 统计 | | WEB-1b | 首页-核心产品区 | 前端 | ✅ | ✅ | ✅ | Nav"推荐"树驱动,无树自动隐藏 | | WEB-1c | 首页-分类网格 | 前端 | ✅ | ✅ | ✅ | Book 表驱动,彩色图标卡片 | | WEB-1d | 首页-最新文章 | 前端 | ✅ | ✅ | ✅ | Document.GetLatest 取最新 6 篇 | > 父需求状态:✅(全部完成) ### 父需求:文章列表页 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | WEB-2a | 列表页-面包屑与分类头 | 前端 | ✅ | ✅ | ✅ | 名称/简介/文章数/更新时间 | | WEB-2b | 列表页-文章卡片与置顶徽标 | 前端 | ✅ | ✅ | ✅ | Sort≥100 显示置顶徽标 | | WEB-2c | 列表页-分页 | 前端 | ✅ | ✅ | ✅ | 自定义分页 + 省略号 | > 父需求状态:✅(全部完成) ### 父需求:文章详情页 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | WEB-3a | 详情页-标题与元信息 | 前端 | ✅ | ✅ | ✅ | 作者/发布/浏览 | | WEB-3b | 详情页-正文渲染 | 前端 | ✅ | ✅ | ✅ | 语雀 HTML + 自有正文样式 | | WEB-3c | 详情页-目录树滚动高亮 | 前端 | ✅ | ✅ | ✅ | site.js scrollspy | | WEB-3d | 详情页-上一篇/下一篇 | 后端 | ✅ | ✅ | ✅ | Detail 按 Sort 相邻查询 | > 父需求状态:✅(全部完成) ### 父需求:搜索结果页 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | CONTENT-2 | 搜索接口 | 后端 | ✅ | ✅ | ✅ | Document.Search 多字段 LIKE(空格拆词词间 AND) | | WEB-4a | 搜索页-回显与高亮 | 前端 | ✅ | ✅ | ✅ | 关键词 mark 高亮(防 XSS,逐词) | | WEB-4b | 搜索页-空态与分页 | 前端 | ✅ | ✅ | ✅ | 空结果提示 + 无页码路由 | > 父需求状态:✅(全部完成) ### 父需求:产品宣传页 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | WEB-5 | 产品页-全宽渲染 | 前端 | ✅ | ✅ | ✅ | Format=product 无目录/元信息,保留导航页尾 | | PROD-1 | 产品页-后台发布机制 | 后端 | ✅ | ✅ | ✅ | 保存钩子处理 BodyHtml + 发布指南文档 | > 父需求状态:✅(全部完成) ## SYS 站点配置 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | SYS-1 | 顶部导航(Nav 头部树) | 后端 | ✅ | ✅ | ✅ | 支持下拉/外链/移动折叠,显式按 Sort 排序 | | SYS-2 | 页尾(Nav 尾部树) | 后端 | ✅ | ✅ | ✅ | 多列链接 + 版权/备案 | | SYS-3 | 巨幕横幅(Nav 巨幕树) | 后端 | ✅ | ✅ | ✅ | 标题 + 副标题(Remark) | | SYS-4 | 首页核心产品(Nav 推荐树) | 后端 | ✅ | ✅ | ✅ | 名称/链接/简介/排序 | > 父需求状态:✅(全部完成) ## CONTENT 内容管理 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | CONTENT-1 | 语雀定时同步 | 后端 | ✅ | ✅ | ✅ | SyncService 后台调度(存量能力) | | CONTENT-3 | HTML 规则处理 | 后端 | ✅ | ✅ | ✅ | 图片抓取/链接替换/文本替换(存量能力) | > 父需求状态:✅(全部完成) ## UI 设计系统 | 编码 | 功能 | 类型 | 实现 | 测试 | 注释 | 说明 | |------|------|:----:|:----:|:----:|:----:|------| | UI-1 | 设计系统 site.css | 前端 | ✅ | ✅ | ✅ | 新生命绿令牌 + 组件,wwwroot/css/site.css | | UI-2 | 前端脚本 site.js | 前端 | ✅ | ✅ | ✅ | 移动菜单/下拉/滚动高亮/搜索提交 | | UI-3 | 布局与导航重构 | 前端 | ✅ | ✅ | ✅ | 脱离 Bootstrap 3,lake 样式仅过渡 | | UI-4 | 设计稿(Doc/Design) | 前端 | ✅ | — | ✅ | 5 页静态稿 + 设计系统,作视觉基线 | > 父需求状态:✅(全部完成) ## 统计 ### 子功能统计 | 模块 | 标识 | 功能点数 | 实现完成 | 测试通过 | 注释覆盖 | 综合完成率 | |------|------|:-------:|:--------:|:--------:|:--------:|:---------:| | 官网前台 | WEB | 13 | 13 | 13 | 13 | 100% | | 站点配置 | SYS | 4 | 4 | 4 | 4 | 100% | | 内容管理 | CONTENT | 3 | 3 | 3 | 3 | 100% | | 产品宣传 | PROD | 1 | 1 | 1 | 1 | 100% | | 设计系统 | UI | 4 | 4 | 3 | 4 | 100% | | **总计** | **5** | **25** | **25** | **24** | **25** | **96%** | ### 父需求完成度 | 父需求 | 子项数 | 已完成 | 状态 | 说明 | |--------|:-----:|:-----:|:----:|------| | 首页 | 4 | 4/4 | ✅ | 全部完成 | | 文章列表页 | 3 | 3/3 | ✅ | 全部完成 | | 文章详情页 | 4 | 4/4 | ✅ | 全部完成 | | 搜索结果页 | 3 | 3/3 | ✅ | 全部完成 | | 产品宣传页 | 2 | 2/2 | ✅ | 全部完成 | | 站点配置 | 4 | 4/4 | ✅ | 全部完成 | | 内容管理 | 2 | 2/2 | ✅ | 全部完成 | | 设计系统 | 4 | 4/4 | ✅ | 全部完成 | > 测试说明:UI-4 设计稿为静态稿(无自动化测试),其余后端逻辑已有单元测试/集成测试;测试中 14 个语雀 API 用例因未配置 Token 失败(环境问题,非代码缺陷)。