科技项目与活动功能需求.md 15KB
科技项目与活动 — 功能需求
1. 文档说明
| 项 | 说明 |
|---|---|
| 模块名称 | 科技项目与活动（科技项目指南） |
| 目标 | 在业务后台维护科技项目申报指南，支持录入、查询、发布与下架，为申报方提供规范、可检索的项目信息 |
| 关联系统 | 业务后台；面向公众或申报端的展示入口由产品统一规划，本模块侧重指南内容的后台维护与发布控制 |
| 修订依据 | 同目录 科技项目与活动-草稿.md、原型图 科技项目与活动.png |
本文档仅描述功能需求与业务规则，不涉及库表结构、接口路径、请求体字段命名、HTTP 报文及技术栈选型。
2. 术语与枚举
2.1 项目类型（资讯类别编码，单选）
项目类型持久化与接口传参均为 资讯类别编码（varchar）。可选范围由资讯类别 parentCode=002（科技项目指南）的直接下级维护：
| 编码 | 名称（示例） |
|---|---|
002001 |
高新技术 |
002002 |
农业科技 |
002003 |
社会发展 |
002004 |
基础研究 |
新增/修改时编码须在上述接口返回的有效集合内；列表筛选为 编码精确匹配。
2.2 发布状态
每条指南独立维护发布状态，与业务字段内容无关：
| 取值 | 含义概要 |
|---|---|
| 未发布 | 新建保存、或下架回流后的状态；仅后台可见（或按产品约定对内部角色可见）；可编辑、可删除、可执行发布 |
| 已发布 | 已对外生效的指南；不可修改、不可删除，须先下架后再维护 |
下架后回到 未发布，可再次编辑、删除或发布，无须新建一条记录。
2.3 申报时间
- 由 申报开始日期、申报截止日期 两个自然日组成，格式均为 YYYY-MM-DD。
- 业务含义： 仅在该闭区间内（含起止日，除非产品另行约定「截止日不含当日」）受理申报；区间外指南仍可展示为「已结束申报」或隐藏申报入口，由对外展示规则单独定义。
- 校验： 申报截止日期 ≥ 申报开始日期。
2.4 记录说明
本模块管理对象为一条科技项目指南，包含项目基本信息、申报说明、负责人与联系方式，以及可选的附件与封面。指南通过 §2.2 发布状态 控制是否对外展示及后台改删权限。
3. 功能范围
- 科技项目指南的新增、修改、删除、分页列表查询、详情查看
- 项目类型、申报时间、文本与附件/封面等字段的录入与校验
- 发布、下架及发布状态约束下的操作权限
- 按项目名称模糊、项目类型精确匹配的列表筛选
- 面向使用方的业务错误与校验提示（见第 8 章）
不在本模块范围（除非后续单独立项）： 在线申报表单、审批流、申报人数统计、消息推送、与补贴发放等业务单据的自动关联等。
4. 业务流程概览
flowchart TD
A[新增指南] --> B{保存方式}
B -->|仅保存| C[未发布]
B -->|保存并发布| D[已发布]
C --> E[列表查询/筛选]
D --> E
E --> F[查看详情]
E --> G[修改]
E --> H[删除]
E --> I[发布]
E --> J[下架]
G --> C
H --> E
I --> D
J --> C
C --> I
D --> J
F --> E
- 新建： 填写指南信息 → 仅保存则处于 未发布；若在表单选择 保存并发布 且校验通过，则直接进入 已发布 并记录发布日期。
- 维护： 仅 未发布 指南可修改全部可编辑字段；保存后仍为未发布（除非再次执行发布）。
- 发布： 未发布 且数据完整合法 → 已发布，记录发布日期（见 §5.6）。
- 下架： 已发布 → 未发布，结束对外展示，可再编辑、再发布。
- 查询： 按项目名称、项目类型筛选，分页浏览。
- 删除： 仅 未发布 可删；已发布 须先下架。
5. 详细功能需求
5.1 新增科技项目指南
| 字段 | 规则 |
|---|---|
| 项目名称 | 必填；长度 1～20 个字符（按字符计，与项目全局一致） |
| 项目类型 | 必填；单选，取值限定为 §2.1 |
| 项目简介 | 必填；长度 1～50 个字符 |
| 申报对象 | 必填；说明面向的申报主体（如企业、合作社、科研院所等）；长度建议 1～200 个字符（若产品需更长，单独评审后调整上限） |
| 申报开始日期 | 必填；格式 YYYY-MM-DD |
| 申报截止日期 | 必填；格式 YYYY-MM-DD；须 ≥ 申报开始日期（§2.3） |
| 项目周期 | 必填；说明项目实施或执行周期（如「12 个月」「2026-01 至 2026-12」）；长度建议 1～50 个字符 |
| 申报条件 | 必填；多行文本；无字数上限（界面宜提示过长内容的影响） |
| 申报流程 | 必填；多行文本；无字数上限 |
| 负责人 | 必填；长度 1～10 个字符 |
| 联系方式 | 必填；须为合法中国大陆手机号（11 位、1 开头等，与项目全局手机号规则一致） |
| 附件材料 | 选填；单个文件上传；允许后缀：pdf、md、doc、docx、xls、xlsx、ppt、pptx；单文件 ≤ 30 MB |
| 封面 | 选填；单个图片上传；允许后缀：jpg、jpeg、png（可扩展 webp）；单文件 ≤ 10 MB |
保存方式（与原型一致）：
| 操作 | 行为 |
|---|---|
| 确定 / 保存 | 校验通过后保存，发布状态为未发布；不写入对外发布日期（或发布日期为空） |
| 发布（表单内，如橙色按钮） | 校验通过后保存，发布状态为已发布，并记录发布日期为操作当日（§5.6） |
| 取消 | 关闭表单，不保存 |
必填字段汇总： 项目名称、项目类型、项目简介、申报对象、申报开始日期、申报截止日期、项目周期、申报条件、申报流程、负责人、联系方式。
校验摘要：
| 规则 | 说明 |
|---|---|
| 长度 | 各字段超出上限时拒绝保存并提示 |
| 枚举 | 项目类型须为 §2.1 有效资讯类别编码之一 |
| 申报时间 | 开始、截止日期格式合法；截止 ≥ 开始 |
| 手机号 | 不符合规则时拒绝保存 |
| 附件/封面 | 后缀、大小不符时拒绝上传或拒绝保存；未上传附件/封面时允许保存（选填） |
保存结果： 生成一条指南记录，初始为 未发布（仅保存）或 已发布（保存并发布），可被列表查询、查看；未发布记录可继续修改、删除或发布。
5.2 查询科技项目指南列表
- 项目名称： 模糊匹配；未输入则不过滤。
- 项目类型： 精确匹配；未选择则不过滤。
- 发布状态（建议）： 精确匹配（未发布 / 已发布）；未选择则不过滤；便于运营区分待发布与已上线指南。
- 分页： 默认 每页 20 条，首页为第一页；单页条数上限与项目列表通用规范一致。
- 排序： 默认按 发布日期倒序（已发布且日期较新者靠前）；未发布记录可按 创建时间倒序 排在已发布之后，或统一按 创建时间倒序（产品择一，全文一致）。
列表宜展示： 项目名称、项目类型、申报对象、申报开始日期、申报截止日期、项目周期、负责人、联系方式、发布日期（未发布可为「—」或空）、发布状态，以及操作列。
操作列与 §6 矩阵一致：
| 发布状态 | 行内操作 |
|---|---|
| 未发布 | 查看、发布、编辑、删除 |
| 已发布 | 查看、下架 |
5.3 修改科技项目指南
- 状态约束： 仅 未发布 指南允许进入编辑并保存。
- 已发布： 不可修改任何业务字段；须先 下架（§5.6）。
- 可修改项： 与 §5.1 相同（含替换附件、封面）。
- 保存约束： 提交时须重新满足 §5.1 全部校验；必填项不得为空。
- 附件/封面替换： 更换并保存成功后，宜删除被替换的旧文件，避免存储残留（实现阶段约定）。
- 编辑表单按钮： 未发布状态下通常仅提供 保存、取消；若产品允许在编辑页直接 发布，行为同 §5.6，发布后变为已发布。
5.4 删除科技项目指南
- 允许删除： 未发布 且具备删除权限的记录。
- 不允许删除： 已发布 记录；须先 下架。
- 删除后果： 记录从列表移除；关联附件、封面文件一并清理（若有）。
- 确认： 删除前宜二次确认；支持批量删除时须提示选中条数。
5.5 查看科技项目指南详情
- 展示内容： §5.1 全部业务字段（含附件下载/预览入口、封面预览）、发布状态、发布日期；宜含创建人/创建时间、修改人/修改时间（若系统有审计字段）。
- 交互：
- 未发布： 只读详情，可提供 编辑、发布、删除 入口（与列表操作等价）。
- 已发布： 只读详情，可提供 下架 入口；不提供编辑、删除。
- 未发布： 只读详情，可提供 编辑、发布、删除 入口（与列表操作等价）。
- 附件： 已上传时展示文件名与下载/打开能力；未上传时展示「无」或「—」。
5.6 发布与下架
发布
| 项 | 说明 |
|---|---|
| 入口 | 列表行内「发布」、详情页「发布」、新增表单「发布」按钮（与「仅保存」区分） |
| 前置 | 当前为 未发布；§5.1 必填项与校验均已满足 |
| 结果 | 发布状态变为 已发布；记录 发布日期 为操作当日（自然日 YYYY-MM-DD） |
| 重复发布 | 已发布记录不可再次发布 |
下架
| 项 | 说明 |
|---|---|
| 入口 | 列表行内「下架」、详情页「下架」 |
| 前置 | 当前为 已发布 |
| 结果 | 发布状态变为 未发布；对外展示结束；不删除记录与附件、封面；可再编辑、再发布 |
| 发布日期 | 下架后是否保留历史上次发布日期用于审计，或清空，由产品确认（建议保留上次发布日期只读展示，并记录下架操作时间若系统支持） |
6. 状态与操作矩阵（汇总）
在已授权前提下（菜单与按钮级权限按项目角色配置）：
| 当前发布状态 | 查看 | 新增 | 修改 | 发布 | 下架 | 删除 |
|---|---|---|---|---|---|---|
| 未发布 | ✓ | — | ✓ | ✓ | — | ✓ |
| 已发布 | ✓ | — | ✗ | — | ✓ | ✗ |
| 列表/global | — | ✓ | — | — | — | — |
- 「新增」为列表工具栏入口，新建记录初始为 未发布（除非表单选择保存并发布）。
- 下架后按 未发布 行权限执行。
7. 列表筛选与业务约束补充
| 约束 | 说明 |
|---|---|
| 枚举展示 | 项目类型、发布状态在列表/详情中展示为中文标签，与 §2.1、§2.2 一致 |
| 申报期展示 | 列表可同时展示「申报开始」「申报截止」两列；详情可合并展示为「YYYY-MM-DD ～ YYYY-MM-DD」 |
| 同名项目 | 不强制项目名称全局唯一；若运营需要唯一性，另文约定并在保存时校验 |
| 已发布内容一致性 | 已发布指南对外展示内容应与发布时保存内容一致；下架后修改再发布，以外部可见最新发布版本为准 |
| 并发 | 同一条指南连续保存时，以后一次提交为准；发布、下架宜防重复点击（前端禁用或二次确认） |
8. 错误与提示约定
面向使用方的提示宜语义明确、可区分，例如：
| 场景 | 提示方向（示例） |
|---|---|
| 必填项缺失 | 标明缺失项（如「请填写项目名称」） |
| 字数超限 | 「项目名称不能超过 20 字」「项目简介不能超过 50 字」 |
| 申报截止日期早于开始日期 | 「申报截止日期不能早于开始日期」 |
| 手机号不合法 | 「请输入正确的手机号码」 |
| 项目类型非法 | 「项目类型不在可选范围内」 |
| 附件类型或大小不符 | 「仅支持 pdf、doc… 格式」「附件不能超过 30MB」 |
| 封面类型或大小不符 | 「仅支持 jpg、png 格式」「封面不能超过 10MB」 |
| 已发布不可编辑/删除 | 「已发布指南须先下架后再修改/删除」 |
| 删除确认取消 | 不执行删除，无成功提示 |
本文档不约定 HTTP 状态码、错误码字段名及接口报文结构（如 code、msg、data）。
9. 非功能需求（建议）
| 类别 | 建议 |
|---|---|
| 权限 | 查询、新增、修改、删除、发布、下架是否分角色（如仅科技管理员可发布） |
| 审计 | 新增、修改、删除、发布、下架记操作日志 |
| 附件安全 | 上传文件病毒扫描、访问鉴权（若附件含敏感说明） |
| 双语 | 后台字段标签与提示与项目 i18n 规范一致（汉语 + 藏文，若适用） |
10. 修订说明（相对草稿）
| 草稿条目 | 优化处理 |
|---|---|
| 第 6、7 条：未发布/已发布操作 | 固化为 §2.2、§5.6、§6 矩阵；明确已发布不可改删 |
第 7 条：异常返回 code/msg/data |
移出本文档 |
| 第 8 条：技术栈 | 移出本文档 |
| 检出率、疫情等无关表述 | 无；本模块不涉及 |
附件 ppt 笔误 |
统一为 ppt、pptx |
| 项目简介 50 字、项目名称 20 字 | 写入 §5.1 并补充下限 1 字 |
| 申报时间「开始～结束」 | 拆为两字段并增加 §2.3 日期关系校验 |
| 附件、封面 | 明确为选填及格式、大小上限 |
| 表单「发布」与「确定」 | 区分 仅保存（未发布） 与 保存并发布（已发布） |
| 列表「发布日期」 | 与发布操作绑定，未发布展示为空或「—」 |
| 无流程图与矩阵 | 增补 §4、§6 |
11. 与相关文档关系
| 文档 | 关系 |
|---|---|
科技项目与活动-草稿.md |
初稿功能列表 |
科技项目与活动.png |
列表与新增表单原型参考 |
| 《科技项目与活动技术方案》（待编） | 库表、接口、权限标识 |
| 《科技项目与活动管理测试用例》（待编） | 用例与本文档章节对应 |
| 《科技项目与活动前端技术方案》（待编） | 前端页面、路由、i18n |