主题
信息管理 · 需求分析文档
文档版本：0.10 ｜ 最近核对日期：2026-09-21
本文面向业务确认、产品设计、实现和验收，是信息管理模块六类交付文档中的正式需求分析文件。本模块尚无页面原型，本文只记录可从《信息管理功能架构需求清单》直接得到的事实、平台既有工程契约和已核对的平台能力；由此推导的页面结构、字段与规则一律标注依据，凡来源不足或存在多种合理解释的事项统一列入待确认事项，不用行业经验补齐。表名、接口参数与类名进入后续设计文档，本文不复制。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 信息管理 |
| 实现进度说明 | 本轮只建立需求与概要设计两份正式资料，代码与数据库尚未开始；模块本体在代码库中当前不存在，见 S-IM-006 |
| 编写日期 | 2026-09-21 |
| 受测代码状态 | 不适用（本轮为文档编制，无受测代码；模块实现尚未开始，无提交号可记） |
| 业务确认人 | 待确认 |
| 原型或资料来源 | 《信息管理功能架构需求清单》（2026-09-17）：思维导图《信息管理功能架构需求清单》与同名表格《信息管理功能架构-20260917》，两者内容一致；原功能架构图历史规划（工程部讨论版，2026-08-26）（信息管理为 12 月上线批次，功能目录为标准文件管理、工程文件管理、资料移交备案、文件基本配置） |
| 关联文档 | 概要设计；平台规则 软件交付文档、公共开发约定、业务地图 |
本轮只完成资料编制，页面、接口与数据库均未实现，本文「验收标准」一节的条目是待验证口径、不是已通过的结论。
1. 背景与目标
1.1 业务背景
- 当前问题：工程标准文件与工程文件分散在各参建单位与业务系统中，缺少集中登记与统一共享入口，文件按项目与文档分类的口径不统一；对外提供文件依赖线下传递，缺少对外部访问的可控手段；工程文件向公司档案系统归档缺少平台侧的统一出口；工程档案资料的移交备案依赖线下清单整理。
- 产生原因：本模块实施前，平台只有统一的文件对象服务（上传、下载、对象引用），没有承载业务语义的文件档案、目录分类、版本、访问授权与移交备案；代码库中不存在信息管理模块的前后端实现（核对见 S-IM-006）。
- 影响对象：建设单位与施工单位资料员、项目与部门资料管理员、档案管理员、系统授权管理员、需要查阅文件的业务人员，以及被授权访问文件的外部单位人员。
1.2 建设目标
- 在「信息管理」业务域下建立 4 个业务入口：标准文件管理、工程文件管理、资料移交备案、文件基本配置。
- 建立集中登记的文件档案事实源：文件按项目与文档分类归口，保存版本、标签与来源，支持文件名、标签和全文关键字等多维检索（全文检索为清单明确能力，检索实现依赖待确认，Q-IM-003）。
- 建立文件访问控制：以目录级与文件级的多层级授权控制用户与角色的访问，并以可回收的安全外链控制外部用户的访问。
- 打通工程文件与公司档案系统的归档出口：以「预归档」标记与接口登记承载工程文件向档案系统移交前的准备与推送结果。
- 支撑工程档案资料移交备案的线上化：登记移交资料、生成移交清单，替代线下清单整理。
- 完成后的可观察结果：任一登记文件可追溯到目录、版本、上传人、登记时间与操作留痕；未授权用户访问受限文件被服务端拒绝；已签发的外链在回收后立即失效；工程文件的预归档推送结果（成功或失败原因）可查；移交备案单提交后可生成并导出移交清单。
2. 建设范围
2.1 本期包含
- 标准文件管理：登记、编辑、删除（含批量）、查询、预览、查看详情、版本升级、历史记录、移动（含批量）、导出选中、导出全部；
- 工程文件管理：在标准文件管理的能力之上增加预归档与接口管理；
- 资料移交备案：登记、编辑、删除、查询、查看详情、提交，以及移交清单生成与导出；
- 文件基本配置：标准目录与工程文件目录清单配置、标签与多维度搜索配置、用户/角色文件访问权限的多层级配置、关联、导入、导出；目录/文件关联层级与授权粒度待确认（Q-IM-007、Q-IM-008）；
- 文件访问控制：需求清单明确多层级权限管理及安全外链实时控制与回收；具体授权对象层级、访问权限集合、外链入口和策略参数待确认（Q-IM-004、Q-IM-007）；
- 文件历史留痕：版本历史与操作历史；应记录哪些操作事件、历史保留期限待确认（Q-IM-010、Q-IM-019）；
- 菜单、三段式权限码、字典、模块数据表与页面；本模块不导入任何流程定义（依据 S-IM-004）。
2.2 明确不做
- 不建设审批流程：需求清单「系统审批流程」列对标准文件管理、工程文件管理、资料移交备案均标注「无流程，仅创建上传登记台账」，文件基本配置为目录清单配置功能，因此本模块不导入 Warm-Flow 流程定义、不建立办理页与待办；
- 不新建文件存储与文件服务：文件实体的上传、下载、存储与对象引用沿用平台既有文件服务，本模块只保存对象引用与业务语义；
- 公司档案系统对接属于需求清单明确的建设目标。接口、数据映射、鉴权与联调条件尚未提供，具体实现及验收受 Q-IM-005 依赖，不据此将该目标排除出本期范围；
- 全文关键字检索（XF-023）属于需求清单明确的能力。正文解析、索引、更新和检索接口尚未确认（Q-IM-003），不将其缩减为仅文件名和标签检索；
- 当前需求来源未要求迁移既有业务模块附件，也未要求将 BIM/GIS 模型文件、公文或协同文件纳入本模块。不得把这些内容扩展为本期范围；若需迁移或统一归档，应另行明确来源与范围；
- 站内信/短信通知、移动端页面未见于当前需求清单，本基线不将其列为已确认功能。
2.3 已确认的技术约束
- 复用平台既有底座：文件对象服务与
sys_oss、菜单与三段式权限码、字典、用户/角色/部门、项目主数据与工程结构、分页与导出能力；平台提供通用逻辑删除机制，但本模块删除保留语义待 Q-IM-020 定稿；不新增独立审批、权限或文件体系。 - 权限码统一为
information:<资源>:<动作>三段式，后端注解、菜单权限串与前端指令三处逐字一致；禁止两段式。 - 大整数 ID 前端保持
string | number原值，禁用Number()、parseInt()与一元+；后端 Long 沿用项目 JSON 映射。 - 数据库查询、结构检查、DDL 与验证统一通过项目 MCP 访问开发库；仓库不保存业务 SQL 文件。
- 数据库可迁移性是硬约束：当前运行库的方言集中到 Mapper/XML，不扩散到 Controller、Service。
- 文件格式与大小上限沿用平台统一文件策略，不在本模块硬编码另一套限制（具体上限见 Q-IM-015）。
3. 用户角色与使用场景
需求清单明确了施工单位在线填报资产赋值清单，但未系统列出其余业务角色及各角色的职责、授权人和数据范围。下表为便于评审的角色提案，不作为已确认权限；需按 Q-IM-014、Q-IM-018 核实。
| 建议角色 | 使用目的 | 前置条件 | 主要结果 |
|---|---|---|---|
| 建设单位/施工单位资料员 | 登记标准文件与工程文件、上传文件、移动归类、版本升级 | 具备经确认的文件档案维护权限 | 形成文件档案、版本记录与操作留痕 |
| 施工单位填报经办人 | 在线填报资产赋值清单并上传附件（XF-022，来源明确） | 具备经确认的工程文件填报权限 | 资产赋值清单在工程文件管理中登记并可查 |
| 项目/部门资料管理员 | 维护标准目录与工程文件目录清单、标签与搜索配置、导入导出 | 具备经确认的配置维护权限 | 目录清单、标签与搜索配置生效 |
| 文件授权管理员 | 执行文件访问权限的多层级分配、回收安全外链 | 具备经确认的授权管理权限 | 授权记录生效，受限文件的访问按授权控制 |
| 档案管理员 | 工程文件预归档、维护档案系统接口信息 | 具备经确认的预归档和接口管理权限 | 预归档状态与对接结果可查 |
| 查阅人员 | 列表查询、预览、查看详情 | 具备经确认的查询权限，且满足文件访问授权 | 在授权范围内查阅文件 |
| 外部单位人员 | 通过安全外链访问指定文件 | 持有有效外链；访问权限由外链策略决定 | 按确认后的外链策略访问，相关行为留痕 |
| 审计人员 | 查看文件历史记录与访问留痕 | 具备经确认的查询权限 | 版本历史与操作记录可追溯 |
4. 核心业务场景
4.1 标准文件的登记与共享
- 资料员在标准文件管理中登记文件，录入文件名称、所属项目、所属目录、标签，并上传文件；登记后形成 1 条文件档案与版本号 1 的版本记录；
- 需要更新内容时执行「版本升级」，上传新版本并填写版本说明，原版本保留为历史版本，当前版本指向最新版本；
- 通过「移动」（含批量）调整文件的所属目录，通过「编辑」调整文件元数据；
- 目录级与文件级授权决定哪些用户与角色可以查询、预览、下载；未获授权的用户访问受限文件时由服务端拒绝；
- 需要对外提供时签发安全外链，外部用户在有效期内通过该地址访问该文件；回收后该地址立即失效；
- 详情页可查看版本历史与操作历史；预览、下载、外链、版本升级、移动、权限变更等事件均为留痕范围提案，具体事件与留存期限待 Q-IM-019 定稿。
4.2 工程文件登记、预归档与档案系统对接
- 工程文件的登记、版本升级、移动、导出与标准文件一致，差异在于归属工程与预归档能力；
- 需要向公司档案系统移交时执行「预归档」，文件进入预归档状态并形成预归档记录；
- 需求目标包括与公司档案系统对接；推送结果、回执和失败处理应按对接契约定义，但结果字段、重试语义和事务边界尚待确认（Q-IM-005）；
- 「接口管理」是清单明确的工程文件管理动作。接口需要维护哪些信息、如何鉴权与实际调用尚未核对（Q-IM-005、Q-IM-006）；档案系统对接未从本期目标中排除；
- 质量管理文件的在线备案与备查（XF-085）、资产赋值清单的施工单位在线填报（XF-022）均以工程文件登记的方式承载，不另建独立单据。
4.3 文件目录清单与搜索配置
- 资料管理员在文件基本配置中维护标准目录与工程文件目录清单：目录支持多级、支持启停，被文件或子目录引用的目录不可删除；
- 维护标签与多维度搜索配置：配置文件名、标签、全文关键字等检索维度（全文索引依赖 Q-IM-003）；标签启停为设计提案；
- 目录清单与标签支持导入与导出；
- 数据的「关联」动作的对象口径待确认（Q-IM-008），可能为目录与项目范围的多对多关联或文件与目录的归属关联。
4.4 资料移交备案与清单生成
- 资料员登记移交备案单，录入移交单位、接收单位、所属项目，并逐条录入或引用移交文件形成移交清单明细；
- 「提交」后应支持移交清单生成与导出（XF-091）；状态名称、提交后的修改规则、是否需要接收方确认/回执和重复提交行为均需确认（Q-IM-009）；
- 草稿可编辑/删除、提交后只读及重复提交幂等是当前状态模型提案，须与业务方确认后才能作为规则实现。
4.5 文件访问权限与外链回收
- 授权管理员按需求清单支持的用户/角色主体配置多层级访问权限；对象层级（目录/文件）、权限级别（如查看、下载、编辑、外链）尚未定稿（Q-IM-007）；
- 授权变更后，受限文件的查询、预览、下载与外链签发由服务端按授权记录判定，前端隐藏按钮不代替鉴权；
- 安全外链须可被控制和回收；服务端令牌、有效期、访问次数上限及回收立即生效均为安全设计提案，具体策略待确认（Q-IM-004）；
- 外链访问行为留痕，记录访问时间与结果；接口与日志不输出对象存储的真实地址；外链的入口位置待确认（Q-IM-004）。
5. 业务规则与状态
5.1 业务规则
| 编号 | 规则 | 来源 | 状态 |
|---|---|---|---|
| R-IM-001 | 「信息管理」业务域下设 4 个业务入口：标准文件管理、工程文件管理、资料移交备案、文件基本配置 | 需求清单根节点与功能目录行、原功能架构图历史规划（工程部讨论版，2026-08-26） | 已确认 |
| R-IM-002 | 本模块不导入任何流程定义：标准文件管理、工程文件管理、资料移交备案按登记台账实现，文件基本配置为目录清单配置功能；四者均不建立流程实例、待办与办理页 | 需求清单「系统审批流程」列（3 个模块标注「无流程，仅创建上传登记台账」，文件基本配置标注「标准目录、工程文件目录清单配置功能」） | 已确认 |
| R-IM-003 | 标准文件管理与工程文件管理共用文件档案与版本模型，差异在于工程文件管理另有预归档与接口管理能力 | 需求清单动作清单（工程文件管理在标准文件管理动作之上多出预归档、接口管理） | 已确认 |
| R-IM-004 | 标准文件管理与工程文件管理的页面动作为新增、编辑、删除（批量）、查询、预览、查看详情、版本升级、历史记录、移动（批量）、导出选中、导出全部；功能区动作为新增、查询、重置、批量删除、批量移动、导出选中、导出全部；数据行动作为编辑、删除、预览、查看详情、版本升级、移动；详情页动作为历史记录、关闭 | 需求清单动作清单 | 已确认 |
| R-IM-005 | 资料移交备案的动作为新增、编辑、删除、查询、查看详情、提交；功能区为新增、查询、重置、导出；数据行为编辑、删除、查看详情、提交；详情页不设动作 | 需求清单动作清单 | 已确认 |
| R-IM-006 | 文件基本配置的动作为新增、编辑、删除、查询、查看详情、权限分配、关联、导入、导出；功能区为导入、导出、新增、查询、重置；数据行为编辑、删除、查看详情、权限分配、关联；详情页动作为关闭 | 需求清单动作清单 | 已确认 |
| R-IM-007 | 文件基本配置承载标准目录与工程文件目录清单配置，以及文件名/标签/全文关键字等多维度搜索配置（XF-023）；权限分配在该页作为系统配置功能提供 | 需求清单「系统审批流程」列与价值描述 | 已确认 |
| R-IM-008 | 版本升级产生新版本并保留原版本，文件档案的当前版本指向最新版本；版本号在文件档案内连续递增，同一档案的版本号唯一 | 需求清单动作「版本升级」与「历史记录」；版本号规则待 Q-IM-010 核对 | 合理假设 |
| R-IM-009 | 需求清单包含文件与目录删除动作，但未定义逻辑删除/物理删除、恢复、版本与外链关联处理及保留期限；服务端必须复核删除权限与范围 | 需求清单删除动作、平台服务端鉴权约束 | 删除能力已列入来源范围；删除数据语义待确认（Q-IM-020） |
| R-IM-010 | 移动调整文件的所属目录，支持批量移动；目标目录必须存在且启用，不得移动到自身或其子目录 | 需求清单动作「移动（批量）」；校验细节待 Q-IM-008 与详细设计确认 | 合理假设 |
| R-IM-011 | 导出分「导出选中」（按勾选记录）与「导出全部」（按当前查询条件的全量）两种口径，导出数据的筛选与权限范围与列表一致 | 需求清单动作「导出选中、导出全部」；平台既有导出能力按查询条件导出，导出选中为本次新增口径 | 合理假设 |
| R-IM-012 | 文件访问权限按目录级与文件级多层级配置，授权主体为用户、角色或部门，权限级别区分查看、下载、编辑与外链签发 | 需求清单文件基本配置价值描述（用户角色与文件访问权限的多层级配置与分配、保障文件安全访问控制）；粒度与级别集合待 Q-IM-007 确认 | 合理假设 |
| R-IM-013 | 安全外链由服务端签发令牌，带有效期与可选的访问次数上限，可被回收；回收、过期或超次数后访问被拒绝；外链只对单个文件生效，不暴露对象存储地址 | 需求清单标准文件管理与工程文件管理价值描述（安全外链实时控制外部用户访问与回收）；平台当前无文件分享/令牌外链能力（既有「是否外链」字段是菜单属性，与此无关），形态待 Q-IM-004 确认 | 合理假设 |
| R-IM-014 | 工程文件预归档、接口管理及与公司档案系统对接是来源明确的目标；状态、回执字段、推送结果、失败重试与事务语义属设计提案，须依赖接口及数据映射核对，不得据此排除实际对接 | 需求清单工程文件管理价值描述（与公司档案管理系统无缝对接）与动作「预归档、接口管理」 | 对接目标已确认；实现与验收依赖待确认（Q-IM-005、Q-IM-006） |
| R-IM-015 | 资料移交备案的「提交」动作可触发移交清单生成；备案状态、提交后能否编辑/撤销、重复提交行为、接收方确认或回执均待确认 | 需求清单资料移交备案动作「提交」与价值描述（资料的上传与清单生成） | 提交及清单生成目标已确认；状态与后续语义待 Q-IM-009 定稿 |
| R-IM-016 | 资料移交备案状态编码为设计提案，暂拟草稿/已提交两类；不预设提交后只读、终态或重用平台流程态 | 本模块无流程（R-IM-002）；具体状态及提交后处理见 Q-IM-009 | 设计提案，待确认 |
| R-IM-017 | 文件与标签为多对多关系，标签为可配置主数据并带启停；参与检索的维度可配置 | 需求清单「标签」「多维度搜索配置」 | 合理假设 |
| R-IM-018 | 预览、下载、外链签发与外链访问、版本升级、移动、权限变更均写入操作留痕；留痕记录操作者、时间、对象与动作，不记录凭据与对象存储真实地址 | 需求清单价值描述（安全外链实时控制外部用户访问与回收）、平台日志口径 | 合理假设 |
| R-IM-019 | 权限码统一为 information:<资源>:<动作>，资源为标准文件管理、工程文件管理、资料移交备案与文件基本配置，动作含列表、查询、新增、修改、删除、移动、版本升级、预归档、接口管理、提交、导入、导出、权限分配；资源与动作的最终码值按实现期菜单回读收敛，后端注解、菜单权限串与前端指令三处仍须逐字一致 | 工程契约（三段式权限码）、需求清单动作清单 | 合理假设（权限码取值待与菜单回读核对，见 Q-IM-017） |
| R-IM-020 | 文件档案与移交备案的可见范围需通过服务端权限判定；需求清单未确定单位、项目、部门或工程范围规则，不能推定有页面权限即可查询全部记录 | 需求清单权限价值描述、平台业务地图的部门/工程数据范围约定 | 待确认（Q-IM-014） |
| R-IM-021 | 草稿编辑者、管理者、提交后可否修改，以及文件动作权限与文件访问授权如何叠加均需定稿；服务端必须执行最终鉴权 | 需求清单动作清单、平台权限契约 | 权限校验为平台约束；记录级规则待确认（Q-IM-009、Q-IM-014、Q-IM-018） |
| R-IM-022 | 文件格式与大小上限沿用平台统一文件策略，本模块不硬编码另一套限制 | 平台既有文件策略 | 已确认 |
| R-IM-023 | 「关联」与「安全外链入口」两项在需求清单中出现在动作或价值描述里，但未给出业务含义、承载页面或操作入口，本期不按猜测实现，待确认后展开；「接口管理」是工程文件管理的明确页面动作，属本期范围，其承载方式按 Q-IM-006 确认 | 需求清单（动作清单未列外链入口；「关联」未说明对象；「接口管理」为功能 2 页面动作） | 待确认（见 Q-IM-004、Q-IM-006、Q-IM-008） |
5.2 状态流转
下列状态编码与转换均为设计提案，需求清单只明确相关功能动作，没有确定备案单终态、预归档回执状态、失败重试方式或外链状态名。须按 Q-IM-004、Q-IM-005、Q-IM-009 定稿后，才能作为实现与验收规则。
text
资料移交备案：草稿(draft) --提交--> 已提交(submitted)（候选状态；提交后能否编辑/撤销、是否终态待 Q-IM-009 确认）
工程文件预归档：未预归档(none) --预归档--> 已预归档(pending) --推送--> 已推送(pushed)
|--推送失败--> 推送失败(failed) --重试--> 已推送
安全外链：有效(active) --回收--> 已回收(revoked)
--到期--> 已过期(expired)
--超访问次数--> 已回收(revoked)
文件档案：无业务状态机；以「当前版本号 + 预归档状态」表达当前事实，删除语义待 Q-IM-020 确认草稿：资料移交备案登记后未提交，仅创建者或具备管理权限者可编辑、删除、提交；已提交（候选状态）：提交已生成移交清单；是否只读、可否撤销或修改，以及回执要求按 Q-IM-009 定稿（本模块无审批流程）；未预归档：工程文件尚未执行预归档；已预归档(pending)：已标记预归档、尚未取得档案系统回执；已推送(pushed)/推送失败(failed)：预归档推送的结果状态；失败可重试，重试不改写原记录的失败历史；- 安全外链的状态取值、版本升级后的指向，以及关联文件删除时外链如何处理，均为设计提案，分别按 Q-IM-004、Q-IM-020 定稿。
中文状态名只用于展示，数据库只存稳定枚举值。
6. 权限、异常与非功能要求
6.1 权限与数据范围
- 菜单与按钮权限码为
information:<资源>:<动作>，资源取标准文件管理、工程文件管理、资料移交备案、文件基本配置，动作含列表、查询、新增、修改、删除、移动、版本升级、预归档、接口管理、提交、导入、导出、权限分配；后端注解、菜单权限串与前端指令三处必须逐字一致。 - 前端隐藏按钮不代替鉴权：文件的预览、下载、移动、删除、版本升级、外链签发，以及目录维护、权限分配与档案系统接口管理的最终判定均在服务端执行。
- 访问控制是两层叠加：动作权限决定用户能否使用该功能，文件访问授权决定用户能否访问该目录或文件；两层都通过才可访问受限文件。
- 数据范围：按经确认的单位、项目、部门、工程范围和文件访问授权执行服务端过滤（Q-IM-014）；登记单位、登记人、所属项目与目录是否作为过滤条件按业务口径定稿。
- 记录级权限：备案草稿编辑者、提交后能否修改，以及文件动作权限与文件授权的叠加关系均需定稿；服务端须执行最终鉴权（Q-IM-009、Q-IM-014、Q-IM-018）。
- 外部访问按安全外链目标设计；令牌、有效期、访问次数、访问对象与授权联动等策略依 Q-IM-004 定稿。实现须由服务端鉴权并避免暴露对象存储地址。
6.2 异常场景
| 场景 | 系统行为 | 用户提示或补救 |
|---|---|---|
| 未授权用户查询/预览/下载受限目录或文件 | 服务端按授权记录拒绝，不返回文件地址 | 提示无该文件的访问权限，联系授权管理员 |
| 未授权用户调用外链签发 | 服务端拒绝 | 提示无外链签发权限 |
| 外链已回收、已过期或超出访问次数 | 服务端拒绝访问，不重定向到文件 | 提示链接已失效，请联系签发人重新签发 |
| 外链令牌被篡改或不存在 | 服务端拒绝，不泄露文件是否存在 | 提示链接无效 |
| 重复提交同一资料移交备案单 | 重复提交及清单去重策略按 Q-IM-009 确认；未定稿前不预设幂等键或状态行为 | 按确认后的规则提示与处理 |
| 提交时移交清单明细为空 | 空清单是否允许提交按备案规则确认（Q-IM-009）；未经确认不固化为验收口径 | 按确认后的清单完整性规则提示 |
| 删除被文件或子目录引用的目录 | 处理须保持目录引用一致；删除、停用或调整引用的语义按 Q-IM-020 确认 | 提示受影响的文件或子目录，并按确认后的规则处理 |
| 批量移动包含目标目录自身或其子目录 | 服务端拒绝该批移动 | 指出不合法记录，其余按事务处理 |
| 并发版本升级 | 版本号唯一约束保证不重号，失败重试 | 提示版本冲突，重新上传 |
| 上传过程中断或对象写失败 | 清理临时对象，不写入档案与版本记录 | 提示上传失败，可重试 |
| 预归档推送档案系统失败 | 记录平台侧与外部系统结果；失败状态、错误信息、重试与补偿口径按接口契约定稿（Q-IM-005） | 对接方需提供失败响应与重试约定；未联通真实接口前不模拟推送成功 |
| 档案系统接口未配置时执行预归档 | 处理方式与预归档标记如何变化按接口管理和业务规则定稿（Q-IM-005、Q-IM-006） | 提示具体配置缺项，不写入成功结果 |
| 全文抽取或索引失败、格式不支持 | 索引状态及失败原因按全文检索方案定稿；不得静默表现为“无搜索结果”（Q-IM-003） | 提示索引不可用或格式不支持；补偿/重试策略待检索方案确定 |
| 导入文件不符合模板 | 逐行校验并返回错误行与原因 | 修正后重新导入；部分成功的处理策略待确认（Q-IM-012） |
| 导出范围为全部时数据量过大 | 按查询条件分页读取并生成导出文件 | 提示缩小查询范围 |
| 删除已签发外链的文件 | 文件删除与关联外链的处理按 Q-IM-004、Q-IM-020 定稿；不得留下绕过服务端授权的可用访问路径 | 执行前说明影响，并按已确认规则处理 |
6.3 非功能要求
- 列表使用数据库分页；导出的筛选与数据范围与列表一致；文件档案量大，目录、项目、类别、名称、标签与登记时间等检索维度需要索引支撑。
- 预归档推送、外链签发与回收、权限分配、批量移动与批量删除在事务边界内保持一致，失败回滚；推送为跨系统动作，文件侧状态与推送结果分列保存，不因推送失败丢失业务数据。
- 关键动作可追溯：版本升级、移动、权限变更、外链签发/访问/回收、预归档推送均留痕，日志包含对象标识、动作、操作者与结果，不记录凭据与对象存储真实地址。
- 预览与下载复用平台既有文件能力（前端已具备基于 KKFileView 的预览抽屉与预览入口，见 S-IM-006）；大小与格式策略沿用平台统一口径；大文件的预览与下载不得阻塞列表查询。
- 页面按平台既有列表页、表单页与详情页模式组装，不新造审批中心或独立文件浏览器。
- 外链入口为免登录路径时，必须在平台安全放行清单中按精确路径登记，不放行整个文件服务路径。
- 文件名/标签及全文关键字检索均属当前需求目标；全文索引方式、支持格式、索引时效、权限过滤和响应目标待 Q-IM-003、Q-IM-019 定稿，平台检索组件当前未启用不能作为缩减需求的理由。
7. 验收标准
| 编号 | 角色 | 前置条件 | 操作 | 预期结果 | 证据 |
|---|---|---|---|---|---|
| AC-IM-001 | 资料员 | 具备标准文件管理登记与版本升级权限 | 登记一条标准文件并上传，随后执行版本升级 | 形成 1 条文件档案与版本号 1、2 两条版本记录，当前版本为最新；原版本仍可查看与下载 | 页面、接口、数据库 |
| AC-IM-002 | 资料员 | 列表中存在多条文件 | 勾选记录执行批量移动与批量删除，再分别执行导出选中与导出全部 | 移动后目录归属更新；删除结果、档案留痕、版本与外链处置按 Q-IM-020、Q-IM-004 确认值验收；导出选中只含勾选记录，导出全部含当前查询条件下全部记录 | 页面、接口、数据库 |
| AC-IM-003 | 未授权用户 / 已授权用户 | 目标文件已限制为仅特定角色可访问 | 分别以两个角色查询、预览、下载该文件 | 未授权用户的服务端请求被拒绝且不返回文件地址；已授权用户正常访问 | 页面、接口 |
| AC-IM-004 | 授权管理员与外部人员 | 已对某文件签发外链且未回收 | 外部人员通过外链访问，随后管理员回收该外链并再次访问 | 回收前可访问且留下访问留痕；回收后立即不可访问 | 页面、接口、数据库 |
| AC-IM-005 | 档案管理员 | 工程文件已登记；档案系统接口及数据映射已核对 | 执行预归档，并核对档案系统接收结果；按约定覆盖失败/重试路径 | 平台状态、推送记录与档案系统实际结果一致；接口契约核对前只能验证已明确的本地能力，不能据此判定对接目标验收通过（Q-IM-005） | 页面、接口、数据库、外部系统回执 |
| AC-IM-006 | 资料员 | 具备资料移交备案登记与提交权限，提交规则已按 Q-IM-009 确认 | 登记备案单并录入明细后提交；按已确认的重复提交、撤销/修改和接收确认规则操作 | 生成可导出的移交清单；状态、提交后修改规则、重复提交与回执预期按 Q-IM-009 确认值判定，确认前不作为固定验收结论 | 页面、接口、数据库；如有回执则含外部证据 |
| AC-IM-007 | 资料管理员 | 具备文件基本配置的维护权限 | 维护标准目录与工程文件目录清单、标签与搜索维度，并执行导入导出 | 目录与标签配置生效并被文件登记页引用；被引用目录的删除/停用结果按 Q-IM-020 确认值验收；导入导出结果与配置一致 | 页面、接口、数据库 |
| AC-IM-008 | 查阅人员 | 文件已登记、含可检索的正文和标签；检索维度已配置 | 按文件名、标签与全文关键字检索 | 命中结果与检索维度及已确认的文件格式、索引更新规则一致；索引能力未落实时仅能记录部分验证，不得宣称全文检索通过（Q-IM-003） | 页面、接口 |
| AC-IM-009 | 无权限用户 | 仅具备查看权限 | 直接调用文件删除、移动或外链签发接口 | 服务端全部拒绝，不产生数据变更 | 接口、数据库 |
8. 需求来源与待决项
8.1 关键结论来源
| 编号 | 结论 | 来源 | 最近核对日期 |
|---|---|---|---|
| S-IM-001 | 模块范围与 4 个业务入口：标准文件管理、工程文件管理、资料移交备案、文件基本配置 | 《信息管理功能架构需求清单》根节点与功能目录行；原功能架构图历史规划（工程部讨论版，2026-08-26） 12 月上线批次 | 2026-09-21 |
| S-IM-002 | 业务域命名：需求清单以「工程文件监管」为业务域名，平台功能目录以「信息管理」为一级业务域，两者为同一业务域，模块资料按「信息管理」组织 | 需求清单图与表格；原功能架构图历史规划（工程部讨论版，2026-08-26） | 2026-09-21 |
| S-IM-003 | 各功能的页面动作、功能区动作与数据行动作清单（R-IM-004、R-IM-005、R-IM-006） | 《信息管理功能架构需求清单》动作清单；清单图与表格两份内容一致 | 2026-09-21 |
| S-IM-004 | 本模块无审批流程：标准文件管理、工程文件管理、资料移交备案均标注「无流程，仅创建上传登记台账」，文件基本配置为目录清单配置功能 | 《信息管理功能架构需求清单》「系统审批流程」列 | 2026-09-21 |
| S-IM-005 | 能力归属：工程文件管理承载文件名/标签/全文关键字快速搜索（XF-023）、多类型附件在线预览（XF-076）、质量管理文件在线备案备查（XF-085）、资产赋值清单施工单位在线填报（XF-022）与档案系统对接；资料移交备案承载资料上传与清单生成（XF-091）；文件基本配置承载搜索与权限的多维度配置 | 《信息管理功能架构需求清单》各功能价值描述 | 2026-09-21 |
| S-IM-006 | 模块本体在代码库中当前不存在，可复用能力为平台文件对象服务（上传、下载、对象引用与私有桶短时效签名地址）、基于 KKFileView 的既有文件预览能力（预览抽屉组件与预览入口已在前端存在并按环境变量配置预览服务地址）、菜单与三段式权限码、字典、用户角色部门、项目主数据与工程结构、导出与分页；当前缺失的是通用文件档案版本（平台只有业务单据版本先例，如规划成果版本与 BIM 模型版本）、文件标签、全文检索（检索组件模块存在但未启用、无业务索引）、文件分享/令牌外链、批量移动与导出选中 | 代码库核对（后端控制器与实体、前端页面与组件与预览组件、环境变量、平台安全放行清单、公共模块与配置） | 2026-09-21 |
| S-IM-007 | 需求清单图与随附表格（信息管理功能架构-20260917.csv，实为 Excel 97-2003 工作簿，仅 1 个工作表）逐格内容一致，两者互为同一来源，不构成两份独立依据 | 清单文件解析核对 | 2026-09-21 |
8.2 待确认事项
| 编号 | 问题 | 影响 | 当前建议 | 状态 |
|---|---|---|---|---|
| Q-IM-001 | 清单根节点名称为「工程文件监管」，功能目录为「信息管理」；系统菜单名称、一级/目录层级、父级归属与排序未由来源确定 | 菜单结构、路由前缀与权限串的父级归属 | 以功能目录作为业务域名称；后台菜单树与业务确认核实后再定，不预设「信息管理」为系统一级菜单，也不预设中间目录层 | 待确认 |
| Q-IM-002 | 原型缺项：本模块尚无页面原型，列表列、表单录入项、详情页信息分组、目录树交互与权限分配交互均未定义 | 详细设计与验收标准的具体口径 | 按动作清单最小推导页面结构（见概设的「页面与路由清单」一节）；取得原型后按原型调整，推导内容不作为确认口径 | 待核对（阻塞详细设计） |
| Q-IM-003 | 全文关键字检索（XF-023）为明确目标，但对象存储内容无法直接查询，平台检索组件当前未启用且无本业务索引；需定全文抽取与索引方案、格式覆盖、更新/删除同步、结果权限过滤、性能与失败恢复 | 全文检索的可交付范围、平台/模块责任、索引运行依赖及验收 | 保留全文检索目标，不缩减为只查文件名/标签；实现路径按代码能力评估并由业务/技术共同定稿 | 待确认 |
| Q-IM-004 | 安全外链的形态与入口：需求动作清单未给出外链入口；有效期上限、是否设访问码、是否允许下载、是否限次 | 外链的签发/回收入口、页面设计与安全策略 | 按服务端签发限时令牌 + 可回收 + 可限次实现，令牌入口为免登录精确路径；入口位置与策略参数待确认 | 待确认 |
| Q-IM-005 | 公司档案管理系统对接模式与调用方向、端点、协议、鉴权、数据映射、推送触发、回执字段、失败重试、测试环境和对接方均未核实；该目标与工程变更监管需求分析 Q-EC-007 为同一外部依赖，其概要设计记为 Q-EC-006，上游编号不一致且范围口径需协同 | 档案系统对接实现、双方数据契约、依赖责任、实施先后、测试环境与端到端验收 | 对接目标保留在本期需求范围；取得接口资料并与工程变更监管统一依赖口径后，再裁决集成模式、双方责任、实施顺序与验收证据，不以本地状态登记替代实际对接 | 待核对 |
| Q-IM-006 | 「接口管理」的业务含义与承载方式：是档案系统接口的配置页面、接口注册清单，还是其他含义 | 页面清单与数据模型是否包含接口登记表 | 按档案系统接口登记与配置实现并预留启停与最近同步字段 | 待确认 |
| Q-IM-007 | 文件访问权限分配的粒度与主体：目录级与文件级是否都支持、主体是否为用户/角色/部门、权限级别集合、是否需要审批 | 授权表结构、鉴权判定与页面交互 | 按目录级与文件级两级、主体为用户/角色/部门、级别为查看/下载/编辑/外链实现 | 待确认 |
| Q-IM-008 | 「关联」动作的对象：目录与项目的多对多关联、文件与目录的归属关联，或目录间的层级关联；以及移动的目标目录校验细节 | 是否新增目录-项目关联表、目录树交互 | 按目录与项目范围多对多关联预留；确认后收敛 | 待确认 |
| Q-IM-009 | 资料移交备案清单输出物与后续环节：格式、清单编号、明细从文件档案引用还是独立登记、提交后能否修改/撤销、是否需接收方确认或回执 | 清单生成、备案状态、权限与重复提交验收 | 来源只确认清单生成和导出动作；清单形式与提交后状态需业务确认，不预设只读终态或不需要回执 | 待确认 |
| Q-IM-010 | 版本升级语义：以新版本替换文件内容，还是复制为新档案；版本号规则、历史版本是否保留下载、可保留版本数上限 | 文件与版本表结构、版本升级交互 | 按同一档案内版本号递增、历史版本保留可查看与下载实现 | 待确认 |
| Q-IM-011 | 预览的入口形态与格式覆盖：平台已有基于 KKFileView 的预览抽屉组件与预览入口（前端环境变量配置预览服务地址），可复用；待确认的是本模块预览的进入方式（弹层或抽屉）与 Office 等工程资料格式在该预览服务下的实际可用性 | 预览页面交互与格式覆盖范围 | 复用平台既有预览组件，不新建预览层；格式覆盖按预览服务实测结果确认 | 待确认 |
| Q-IM-012 | 「导入」的对象与模板：目录清单、标签或其他；导入失败时是否允许部分成功 | 导入实现与异常处理策略 | 按目录清单与标签导入实现，模板随实现给出；失败逐行报错、整批回滚 | 待确认 |
| Q-IM-013 | 是否需要站内信/短信通知（如预归档推送失败、外链被访问、备案单被查阅） | 提醒方式与集成范围 | 本期不做通知，留待业务确认 | 待确认 |
| Q-IM-014 | 数据范围：文件与备案记录是否按单位、项目、部门或工程范围隔离；是否需要继承目录授权；文件动作权限和记录可见权限如何叠加 | 查询、预览、下载、导出和外链的服务端过滤与授权验收 | 结合平台部门/工程数据范围与需求中的多层级文件授权共同核实；不默认仅凭页面权限即可查询全部数据 | 待确认 |
| Q-IM-015 | 文件格式与大小上限、单条档案可附文件数、外链有效期上限与保留版本数上限 | 上传校验、页面提示与存储压力 | 沿用平台统一策略，模块不另设限制；如有业务上限再补 | 待确认 |
| Q-IM-016 | 与规划管理的目录引用衔接：规划管理的成果文件为「文件目录引用」预留了来源类型与目录标识字段，当前只写入直接上传；本模块目录体系落地后是否回填为目录引用 | 跨模块一致性、规划管理 R-PL-015 的预留口径 | 回填规则待本模块目录能力及跨模块契约明确后确定；不阻塞独立的文件登记与访问控制 | 待确认 |
| Q-IM-017 | 表名、路由与权限码的建议取值需与实现时的数据库及菜单回读核对：本模块当前无数据表、无菜单行 | 概要设计第 4、5、9 节建议取值的最终确认 | 实现时按项目 MCP 与菜单回读核对，不一致处以回读结果为准并同步资料 | 待核对 |
| Q-IM-018 | 除清单明确的施工单位填报资产赋值清单外，文件登记、目录配置、授权分配、备案提交、接口管理、审核与查阅分别由哪些岗位/组织承担，角色之间如何授权 | 用户角色、菜单/操作权限、记录级权限及测试角色 | 本文角色表仅作分析提案；需由业务提供职责与组织映射后定稿 | 待确认 |
| Q-IM-019 | 非功能目标未提供：文件数量/容量增长、全文索引时效与检索响应、并发上传/下载、可用性、审计留存、备份恢复及安全扫描要求 | 架构容量、服务指标、存储成本、运维与正式验收门槛 | 先套用平台通用安全与运行要求；业务规模、SLO 和留存期限需由业务/运维共同提供或裁决 | 待确认 |
| Q-IM-020 | 文件与目录删除虽列在需求动作清单中，但未说明逻辑删除或物理删除、恢复能力、删除后版本/对象引用/安全外链处理与数据保留期限 | 删除接口、表字段、唯一性约束、外链权限和档案留痕 | 删除动作保留在需求范围；存储策略、关联影响与保留周期均不预设，须由业务/档案管理与技术共同确认后定稿 | 待确认 |
8.3 变更记录
| 版本 | 日期 | 变更 | 确认人 |
|---|---|---|---|
| v1.0 | 2026-09-21 | 依据《信息管理功能架构需求清单》（2026-09-17）与平台代码、功能目录核对结果，建立正式需求分析文档 | 待确认 |
| v1.1 | 2026-09-21 | 独立复核后的修正版，共修正 12 处：①预览能力事实有误——平台已有基于 KKFileView 的预览抽屉组件与预览入口（前端环境变量配置预览服务地址），原稿「代码库中无实现」的判断作废，Q-IM-011 改为入口形态与格式覆盖待确认，并在 6.3 与 S-IM-006 记为可复用能力；②「接口管理」是工程文件管理的明确页面动作，原 R-IM-023 把它与「关联」「外链入口」一并列为不实现属过度收缩，已改为本期范围、承载方式按 Q-IM-006 确认；③AC-IM-005 原要求验证真实跨系统推送与重试，与「本期不实现实际调用」冲突，已改为验证预归档状态与本地记录，推送路径明确标注为接口核对前不构成已验证范围；④R-IM-004 补齐功能 1、功能 2 的详情页动作（历史记录、关闭）；⑤R-IM-012 删去误挂在权限分配上的 XF-023 标注；⑥「编号」检索维度无来源，已从 1.2、2.2、4.3、Q-IM-003 移除；⑦R-IM-002 原写「4 个功能均按登记台账实现」，与来源中功能 4 的目录清单配置口径不符，已改正；⑧5.2「安全外链的四个取值」实际只定义三个，已改正；⑨Q-IM-005 的跨模块引用改为工程变更监管需求分析 Q-EC-007，并注明其概设文档记为 Q-EC-006、上游编号本身不一致；⑩「平台无外链能力」「无正文解析与检索引擎」表述过宽，已分别限定为无文件分享/令牌外链、检索组件未启用且无业务索引；⑪R-IM-019 与 6.1 的动作清单补入列表类动作，并注明资源与动作的最终码值按菜单回读收敛；⑫S-IM-006 补充预览能力可复用，并把「无文件版本」限定为无通用文件档案版本 | 待确认 |
| v1.2 | 2026-09-21 | 复核源清单及概要设计一致性：保留全文检索与公司档案系统对接为本期目标，补齐对接模式、数据契约、责任、依赖和验收证据待决项；修正菜单层级待确认口径；将删除语义、备案提交后规则及非功能目标明确为待确认，避免把设计假设写成既定规则 | 待确认 |