主题
信息管理 · 概要设计文档
文档版本：0.11 ｜ 最近核对日期：2026-11-09
本文面向设计评审、实现和验收，只确定模块在平台中的定位、模块边界与相邻模块关系、模块分解、页面与路由、数据模型概览、流程口径、权限方案和关键技术决策，不展开字段级、参数级与类级实现。字段矩阵、接口参数与目录树/授权判定的实现细节进入数据库设计与详细设计。
本模块尚无页面原型，页面结构、表单录入项与交互均按需求清单的动作清单最小推导，属设计建议而非确认口径；推导内容与缺项统一列入文末「待确认事项」一节，取得原型后按原型调整，不把本节推导当作业务确认结果。
文档控制
| 项目 | 内容 |
|---|---|
| 模块名称 | 信息管理 |
| 实现进度说明 | 本轮只建立需求与概要设计两份正式资料，代码与数据库尚未开始；表名、路由与权限码为本设计的建议取值，实现时以数据库与菜单回读为准 |
| 编写日期 | 2026-09-21 |
| 受测代码状态 | 不适用（本轮为文档编制，无受测代码；模块实现尚未开始，无提交号可记） |
| 业务确认人 | 待确认 |
| 关联需求分析 | 信息管理需求分析 |
| 需求来源 | 《信息管理功能架构需求清单》（2026-09-17） |
v1.2 为本轮复核修正版：保留全文检索和档案系统对接这两项来源明确的目标，将实现契约缺失标为依赖；不把建议角色、数据范围、流程状态与权限层级写成已确认规则。修正明细见需求分析的变更记录。
1. 模块在平台中的定位与复用
信息管理对应需求清单中的「工程文件监管」功能组；原功能架构图历史规划（工程部讨论版，2026-08-26）将其列为 12 月上线批次，功能目录为标准文件管理、工程文件管理、资料移交备案、文件基本配置。菜单层级以 Q-IM-001 核实。模块不新建用户、组织、权限、文件或流程体系，全部沿用平台既有能力：
| 复用能力 | 复用内容 | 本模块的使用方式 |
|---|---|---|
| 文件对象服务 | 文件上传、下载、对象引用、私有桶与短时效访问地址、跨模块文件查询 | 文件档案与版本只保存对象引用与文件元数据；文件实体生命周期由平台文件服务负责 |
| 权限体系 | 三段式权限码、菜单与按钮权限、角色授权 | information:<资源>:<动作>；后端注解、菜单权限串、前端指令三处逐字一致 |
| 用户、角色与部门 | 用户、角色、部门与岗位数据 | 文件访问授权的授权主体（用户/角色/部门）与登记人、登记单位解析 |
| 字典 | 业务状态、类别、权限级别等枚举 | 数据库只存稳定枚举值，展示层由字典映射为中文 |
| 项目主数据与工程结构 | 业务项目、工程结构树节点 | 文件按项目与工程节点归口，保存名称/编码快照 |
| 平台页面与组件 | 列表页模板、表单页模板、详情页模式、用户与角色选择、文件上传、字典标签、分页与导出 | 4 个功能的页面按既有模式组装，不新造文件浏览器或审批中心 |
| 文件预览 | 基于 KKFileView 的既有预览抽屉组件与预览入口（预览服务地址按前端环境变量配置） | 文件预览复用既有组件与配置，不新建预览层；本模块预览的入口形态待 Q-IM-011 确认 |
| 审计与删除支持 | 创建/更新审计字段与平台通用逻辑删除机制 | 审计字段按平台约定复用；本模块文件、目录删除的保留与关联语义待 Q-IM-020 确认，不预设逻辑删除 |
模块自身承担的部分：文件档案与版本的事实源、文件目录（标准目录与工程文件目录清单）配置、标签与检索维度配置、文件访问授权判定、安全外链控制、资料移交备案单与移交清单、工程文件预归档状态与档案系统对接、文件操作留痕。全文关键字检索（XF-023）和档案系统对接均为来源明确的目标；索引方案及外部接口/数据映射未核实，见 Q-IM-003、Q-IM-005。
与相邻模块的关键差异：本模块不使用 Warm-Flow。需求清单「系统审批流程」列对标准文件管理、工程文件管理、资料移交备案均标注「无流程，仅创建上传登记台账」，文件基本配置为目录清单配置功能，因此本模块不导入流程定义、不建立办理页与待办，状态由业务动作直接推进（见「流程概览」一节）。
2. 模块边界与相邻模块关系
本模块负责：
- 标准文件与工程文件的档案登记、元数据维护、目录归类、移动（含批量）、删除（含批量）、查询、导出、预览、详情与历史记录；
- 文件版本：版本升级、版本历史与当前版本指向；
- 文件目录（标准目录、工程文件目录清单）的多级配置与启停、标签主数据与文件标签关联、检索维度配置；
- 文件访问授权：目录级与文件级的多层级分配，以及授权变更留痕；
- 安全外链：签发、访问校验、访问留痕、回收与失效；
- 资料移交备案单与移交清单明细的登记、提交、清单生成与导出；
- 工程文件的预归档状态推进、预归档推送结果记录与重试，以及档案系统接口信息的登记与启停；
- 文件操作留痕（预览、下载、外链、版本升级、移动、权限变更、预归档推送）。
本模块不负责：
- 文件实体的存储、下载地址签发与对象生命周期（属平台文件服务）；
- 用户、角色、部门、岗位与菜单授权维护（属系统设置）；
- 项目主数据与工程结构树的维护（属工程基础管理）；
- 流程引擎、待办与办理工作台（本模块无流程，不使用该能力）；
- 当前来源未要求将既有业务附件迁移到本模块，也未要求纳管 BIM/GIS 模型、公文或协同文件；若有此类迁移或归口要求，须另行明确来源和范围。
与相邻对象的关系：
| 相邻对象 | 关系 |
|---|---|
| 规划管理、工程变更监管、招投标监管、开投安质环监管 | 同级业务模块；本模块不反向修改其业务数据。规划管理的成果文件为「文件目录引用」预留了来源字段与目录标识，本模块目录体系落地后的回填口径见文末「待确认事项」的 Q-IM-016 |
| 工程变更监管 | 其资料归档依赖「工程文件管理归档接口」（需求分析记为 Q-EC-007，概要设计记为 Q-EC-006）；与本模块档案系统对接为同一外部依赖，需协调数据契约、责任与实施顺序；本地状态登记不等同于完成档案系统对接 |
| 平台文件服务 | 双向弱耦合：本模块调用上传、下载与对象查询能力，文件服务不感知文件的业务语义；本模块不管理文件实体生命周期 |
| 项目主数据与工程结构 | 只读引用，保存名称/编码快照，不做维护 |
| 系统设置（用户、角色、部门） | 只读引用，作为授权主体与登记人来源 |
| 公司档案管理系统 | 外部系统；实际对接属于需求目标，接口契约和联调条件待 Q-IM-005 核实，不能以本地状态或接口登记替代对接验收 |
3. 模块分解
| 子模块/能力 | 职责 | 上游输入 | 下游输出 |
|---|---|---|---|
| 文件档案（标准文件与工程文件共用主实体） | 文件元数据、类别、所属项目与目录、标签、当前版本号、预归档状态、登记信息 | 登记表单、目录与标签选项、项目与工程节点 | 文件档案记录 |
| 文件版本 | 版本升级、版本说明、当前版本指向与历史版本保留 | 新版本文件与版本说明 | 版本记录与版本历史 |
| 文件目录与标签配置 | 标准目录与工程文件目录清单的多级维护与启停；标签主数据与文件标签关联；检索维度配置 | 目录与标签维护表单、导入文件 | 目录树、标签选项与检索维度配置 |
| 文件访问授权 | 目录级与文件级的授权分配、授权变更留痕与访问判定 | 授权主体与权限级别 | 授权记录，供查询/预览/下载/外链判定 |
| 安全外链 | 令牌签发、有效期与次数校验、访问留痕、回收与失效 | 文件与版本、有效期与次数上限 | 外链地址、访问记录、回收结果 |
| 资料移交备案 | 备案单与移交清单明细的登记、提交、清单生成与导出 | 项目、移交/接收单位、移交文件明细 | 备案单、移交清单编号与导出文件 |
| 预归档与接口登记 | 预归档状态推进、推送结果与失败原因记录、重试；档案系统接口信息登记与启停 | 工程文件、接口配置 | 预归档记录与接口登记 |
| 文件操作留痕 | 预览、下载、外链、版本升级、移动、权限变更、预归档推送的留痕与查询 | 各能力的动作事件 | 操作记录，供详情页历史记录与审计使用 |
| 页面与路由 | 4 个业务页面族、免登录外链访问页与待确认入口 | 菜单与静态路由注册 | 可操作的业务页面 |
4. 页面与路由清单
4 个功能按「列表页 → 新增/编辑 → 详情」三页模型组织，不设审核页与办理页（本模块无流程）。标准文件管理与工程文件管理共用同一套页面组件，按类别参数开启预归档与接口管理相关入口。
| 菜单/入口 | 路由 | 组件 | 说明 |
|---|---|---|---|
| 信息管理导航根（层级待核实） | /information（建议值） | — | 清单根节点为「工程文件监管」，功能目录为「信息管理」；系统菜单名称、父子关系与路由根路径待 Q-IM-001 核实 |
| 标准文件管理 | /information/standardFile | business/information/standardFile/index | 列表 + 新增/编辑 + 详情（版本历史与操作历史）+ 预览弹层；详情页动作为历史记录、关闭 |
| 工程文件管理 | /information/projectFile | business/information/projectFile/index | 与标准文件管理同构，另有预归档动作与接口管理入口 |
| 资料移交备案 | /information/handover | business/information/handover/index | 列表 + 新增/编辑（含移交清单明细）+ 详情 + 提交；详情页不设动作 |
| 文件基本配置 | /information/config | business/information/config/index | 目录清单配置（标准目录、工程文件目录清单）+ 标签与检索维度配置 + 权限分配 + 导入/导出；详情页动作为关闭 |
| 接口管理（入口待确认） | /information/projectFile/interface（建议值） | business/information/projectFile/interface | 由工程文件管理进入；是配置页、抽屉还是独立页面待确认（Q-IM-006） |
| 外链签发与回收（入口待确认） | 弹层，随文件列表/详情页挂载（建议值） | 复用文件列表与详情组件 | 需求动作清单未给出外链入口，入口位置待确认（Q-IM-004） |
| 免登录外链访问 | /information/share/:token | business/information/share/index | 免登录精确路径：服务端校验令牌的有效期、状态与访问次数后展示或重定向；必须在平台安全放行清单中按精确路径登记，不放行整个文件服务路径 |
路由注册约定：普通业务页面由后端菜单驱动（菜单组件路径对应源码目录）；免登录外链访问页与后续确认的内部跳转入口按平台固定路由方式在前端路由中登记，不依赖菜单授权，并按平台安全放行清单（security.excludes）以精确路径放行，不放行整个文件服务路径；本模块不涉及流程办理页注册。
页面职责分工：列表与工具栏由统一的文件列表组件承载，按类别参数开启预归档、接口管理、批量移动与导出选中；登记表单组件负责新增与编辑；详情页承载版本历史与操作历史；预览复用平台既有预览抽屉/预览入口组件；权限分配为独立抽屉，从文件基本配置的数据行进入（对象为目录或文件，待 Q-IM-007 确认）。
5. 数据模型概览
当前模型暂拟 14 张业务表（biz_info_*，表名、表数与字段均为设计提案；目录关联及档案接口管理落表方式依 Q-IM-008、Q-IM-005、Q-IM-006 核实，最终字段矩阵与约束在数据库设计文档中回读定稿）：
| 表 | 职责（一句话） |
|---|---|
BIZ_INFO_CATALOG | 文件目录树，区分标准目录与工程文件目录清单；多级、启停与同级名称唯一性均为待确认的模型提案 |
BIZ_INFO_FILE | 文件档案主表，标准文件与工程文件共用，以类别字段区分；含所属项目、目录、当前版本号、预归档状态与登记信息 |
BIZ_INFO_FILE_VERSION | 文件版本，保存文件对象引用、文件元数据与版本说明，当前版本指向本表最新版本 |
BIZ_INFO_FILE_TAG | 标签主数据，可配置并支持启停 |
BIZ_INFO_FILE_TAG_REL | 文件与标签的多对多关联 |
BIZ_INFO_FILE_ACCESS | 目录级/文件级访问授权记录的模型提案；对象粒度、授权主体、权限级别与授权流程待 Q-IM-007 确认 |
BIZ_INFO_SHARE_LINK | 安全外链登记的模型提案；令牌、文件/版本绑定、有效期、访问次数与回收策略待 Q-IM-004 确认 |
BIZ_INFO_SHARE_ACCESS_LOG | 外链访问记录（访问时间、结果、来源标识；不保存对象存储真实地址） |
BIZ_INFO_HANDOVER | 资料移交备案单模型提案；单据号、状态、清单编号及提交后语义待 Q-IM-009 确认 |
BIZ_INFO_HANDOVER_ITEM | 移交清单明细模型提案；序号、文件引用、名称、备注和输出口径待按 XF-091 与 Q-IM-009 确认 |
BIZ_INFO_PRE_ARCHIVE_RECORD | 预归档记录模型提案；文件、接口、推送结果、失败与重试字段依 Q-IM-005 的对接模式和数据映射定稿 |
BIZ_INFO_ARCHIVE_INTERFACE | 档案系统接口登记候选模型；是否单独落表及字段待 Q-IM-005、Q-IM-006 确认，不把建议字段视为已取得接口契约 |
BIZ_INFO_SEARCH_CONFIG | 检索维度配置模型提案；全文抽取、索引与可配置项待 Q-IM-003 确认 |
BIZ_INFO_FILE_LOG | 文件操作留痕（动作、对象、操作者、时间、结果） |
设计要点：
- 复用对象服务、不复制文件实体：档案与版本表只保存对象引用与文件元数据（文件名、后缀、大小），不保存文件内容，也不新建存储；文件实体生命周期由平台文件服务负责。
- 标准文件与工程文件共用模型：以
BIZ_INFO_FILE的类别字段区分，两套页面对应同一批表，差异由类别与动作权限控制；预归档相关字段只在工程文件类别下使用，避免为近似功能维护两套表。 - 版本与唯一性：版本号在同一档案内连续递增并按「档案 + 版本号」唯一为设计提案（Q-IM-010）；外链令牌全局唯一为安全实现建议（Q-IM-004）。目录同级名称唯一性及删除后名称能否复用尚未由来源确定，按 Q-IM-002、Q-IM-020 留待数据库设计定稿。
- 动作权限与访问授权分列判定：动作权限决定功能是否可用，授权记录决定用户能否访问该目录或文件；两层都在服务端判定，前端隐藏按钮不代替鉴权。
- 外链安全设计提案：不暴露存储地址；评估由服务端签发令牌并校验状态、有效期与访问次数。令牌形态、访问策略和入口需按 Q-IM-004 确认，不作为既定业务规则。
- 无流程即无流程侧表：不建流程实例登记、审批记录与阶段记录表；状态由业务动作直接推进并写入留痕（见「流程概览」与「核心运行流程与状态模型」两节）。
- 留痕按维度分表：文件操作留痕按对象与动作组织，外链访问记录独立成表，便于分别按文件维度与按外链维度查询，避免把访问日志混入业务操作记录。
- 目录与项目的关联待确认：若「关联」动作确认为目录与项目范围的多对多关系，需增设目录-项目关联表（Q-IM-008）；本设计暂不列入表清单，避免在语义未定时提前建表。「接口管理」动作及档案系统对接目标属于来源明确的本期目标，但接口登记功能由何处承载、是否单独落表以及对接字段均待 Q-IM-005、Q-IM-006 核实。
6. 流程概览
本模块不导入任何流程定义：需求清单「系统审批流程」列对 3 个登记类功能标注「无流程，仅创建上传登记台账」，文件基本配置为标准目录与工程文件目录清单配置功能。据此确定以下口径：
| 功能 | 状态推进方式 | 是否产生流程实例 | 是否产生待办 |
|---|---|---|---|
| 标准文件管理 | 登记即生效；版本升级、移动、删除由业务动作直接改写业务数据 | 否 | 否 |
| 工程文件管理 | 登记即生效；预归档推进为业务动作，推送为跨系统调用 | 否 | 否 |
| 资料移交备案 | 登记状态与提交后状态待 Q-IM-009 定稿；提交目标包括生成清单 | 否 | 否 |
| 文件基本配置 | 配置维护，无状态推进 | 否 | 否 |
设计约束：业务表不携带流程实例字段、不建立审批记录表，避免为「可能以后要审批」预留无来源的结构；若业务方后续要求为移交备案增加审批，按平台既有方式新增流程定义与办理页，并在详细设计中补充业务与流程的关联字段，不改写既有业务数据。
跨系统的预归档推送不是流程动作。预归档及档案系统对接是需求目标，但调用接口、回执、错误语义和失败重试依赖 Q-IM-005；表中状态与记录方式为待接口核对的设计提案，不能用本地记录替代对接结果。
7. 核心运行流程与状态模型
以下状态图和状态名是设计提案。需求清单确认了预归档、接口管理、备案提交、清单生成与安全外链等动作，但未确定状态枚举、回执、重试、备案提交后修改或外链策略；这些事项以 Q-IM-004、Q-IM-005、Q-IM-009 为准。
| 业务状态 | 适用对象 | 进入条件 | 可执行动作 | 离开条件 |
|---|---|---|---|---|
| 草稿 | 资料移交备案 | 登记后未提交 | 编辑、删除、提交 | 提交校验通过后生成清单 |
| 已提交（提案） | 资料移交备案 | 提交成功并生成清单 | 查看；是否可编辑、撤销及需不需要接收方回执待确认 | 是否为终态及提交后状态依 Q-IM-009 定稿 |
| 未预归档 | 工程文件档案 | 登记后默认 | 编辑、移动、版本升级、预归档 | 执行预归档 |
| 已预归档（待回执） | 工程文件档案 | 已执行预归档、尚无推送结果 | 重试推送、查看 | 推送成功或失败 |
| 已推送 | 工程文件档案 | 档案系统推送成功 | 查看 | 终态（允许重新预归档时按详细设计处理） |
| 推送失败 | 工程文件档案 | 推送失败并记录原因 | 重试推送、查看失败原因 | 重试成功 |
| 有效 / 已回收 / 已过期 | 安全外链 | 签发成功为有效；回收、到期或超出次数后失效 | 回收（仅有效状态） | 失效为终态 |
| 无状态机 | 文件档案本体 | — | 以「当前版本号 + 预归档状态」表达当前事实 | — |
业务数据与流程引擎无关：本模块不存在流程实例，业务状态由业务动作在事务内直接改写；状态枚举的中文名只用于展示，数据库只存稳定编码。
8. 接口职责概览
| 能力 | 调用方 | 接口职责 | 关键输入/输出 | 权限边界 |
|---|---|---|---|---|
| 文件列表与详情 | 文件列表页、详情页 | 按类别、目录、项目、标签、名称等条件分页查询；详情装配版本、标签、授权与留痕摘要 | 查询条件、文件标识 | 列表/查询权限 + 文件访问授权 |
| 文件登记与编辑 | 登记表单页 | 保存档案元数据与初始版本（含对象引用），维护标签关联 | 登记表单、对象标识集合 | 新增/修改权限 |
| 删除（含批量） | 列表页 | 按确认后的删除保留与关联处理规则执行，并复核范围；逻辑/物理删除、恢复及外链处理待 Q-IM-020、Q-IM-004 定稿 | 文件标识集合 | 删除权限 + 文件级授权 |
| 移动（含批量） | 列表页 | 校验目标目录合法后改写目录归属 | 文件标识集合、目标目录 | 移动权限 + 文件级授权 |
| 版本升级 | 列表页、详情页 | 追加新版本、更新当前版本指向与版本说明 | 文件标识、新对象标识、版本说明 | 版本升级权限 + 文件级授权 |
| 版本历史与操作历史 | 详情页 | 返回版本列表与操作留痕 | 文件标识 | 查询权限 + 文件级授权 |
| 预览与下载 | 列表页、详情页 | 校验访问授权后按平台文件能力提供预览或下载 | 文件标识、版本号、访问方式 | 查看/下载级别授权 |
| 外链签发、访问与回收 | 文件页、免登录访问页 | 签发令牌；免登录校验有效期/状态/次数并留痕；回收后立即失效 | 文件与版本、有效期与次数；令牌 | 外链签发权限；外链访问免登录但受令牌校验 |
| 目录与标签配置 | 文件基本配置页 | 目录树维护与启停、标签维护、检索维度配置，含导入导出 | 目录与标签表单、导入文件 | 配置类动作权限 |
| 权限分配 | 文件基本配置页 | 分配或撤销目录级/文件级授权并留痕 | 授权对象、主体、权限级别 | 权限分配权限 |
| 资料移交备案 | 备案列表页与表单页 | 备案单与清单明细的登记、编辑、删除、查询、提交与清单生成 | 备案单表单、明细集合 | 备案类动作权限 |
| 移交清单导出 | 备案列表页、详情页 | 按备案单生成并导出移交清单 | 备案单标识 | 导出权限 |
| 预归档与推送 | 工程文件列表页、详情页 | 推进预归档状态；推送档案系统并记录结果与失败原因；支持重试 | 文件标识、接口标识 | 预归档权限 |
| 档案系统接口管理 | 接口管理入口 | 接口信息的登记、修改、启停与最近同步时间查询 | 接口表单 | 接口管理权限 |
| 导出（选中/全部） | 文件列表页 | 导出选中记录或当前查询条件下的全量记录，范围与权限与列表一致 | 文件标识集合或查询条件 | 导出权限 + 文件访问授权 |
接口路径、字段校验、目录树与授权判定的实现方式在详细设计中展开。
9. 权限与安全边界
- 权限码统一为
information:<资源>:<动作>，资源为标准文件管理、工程文件管理、资料移交备案、文件基本配置，动作含列表、查询、新增、修改、删除、移动、版本升级、预归档、接口管理、提交、导入、导出、权限分配；后端注解、菜单权限串与前端指令三处必须逐字一致，前端隐藏按钮不代替鉴权。权限码取值为本设计建议，实现时须与菜单回读核对（R-IM-019、Q-IM-017）。 - 访问控制为两层叠加：动作权限决定功能可用性，
BIZ_INFO_FILE_ACCESS的授权记录决定数据可见性；受限文件的查询、预览、下载、移动、删除、版本升级与外链签发都必须通过服务端判定，不接受前端传入的授权结论。 - 记录级权限：资料移交备案的草稿编辑者、提交后能否修改，以及文件动作权限和访问授权的叠加方式待 Q-IM-009、Q-IM-014、Q-IM-018 定稿；服务端最终鉴权是工程约束。
- 外部访问按安全外链目标实现；令牌、有效期、可吊销/限次、可下载性与授权联动方式待 Q-IM-004 定稿。不得以可枚举文件标识绕过服务端访问控制。
- 外链访问页是免登录入口，必须在平台安全放行清单中按精确路径登记，不放行整个文件服务路径，也不把对象存储地址直接下发前端。
- 预归档推送涉及外部系统：接口地址、鉴权凭据与推送内容按公共开发约定与其他外部集成的既有做法配置，凭据不进入文档站、日志、截图或交付材料，日志不输出完整文件地址与外部凭据。
- 数据范围：需按已确认的单位、项目、部门、工程范围及文件授权规则在服务端过滤（Q-IM-014）；不得推定有页面权限即可查看全部记录。
- 模块依赖的平台权限（文件查询等）需随角色一并授予；权限按用户缓存，补授必须经角色授权保存触发缓存失效。
10. 异常、事务与幂等
- 登记与上传分离：文件对象先落平台文件服务，再在同一事务内写入档案与版本记录；任一环节失败不留下半成品档案。
- 版本升级在事务内完成版本追加与当前版本指向更新；版本号唯一约束兜底并发，冲突时重试或要求用户重新提交。
- 批量移动与批量删除在事务内按勾选集合执行，服务端复核每条记录的合法性与授权，任一条不合法即整批拒绝并指出记录。
- 资料移交备案提交在一个事务内完成状态改写、清单编号生成与明细固化；重复提交按幂等处理，不生成第二份清单。
- 预归档推送为跨系统动作；调用与本地状态的先后、失败记录、重试及补偿语义依档案系统接口契约定稿（Q-IM-005）。未取得接口契约前，以上状态持久化与重试方式仅是设计提案，不得模拟真实推送成功。
- 外链访问校验与访问计数在同一事务内完成，避免并发访问击穿次数上限；回收操作与访问校验互斥，回收后到达的请求一律拒绝。外链有效期与访问时下发给对象存储的短时效签名地址是两个概念：前者由本模块控制且可回收，后者只是完成单次访问的技术手段，不因后者到期而失效外链本身。
- 权限分配变更为即时生效的写操作并留痕；授权撤销后已签发的外链不受影响（外链按签发时状态判定，回收另行操作），该口径待详细设计复核。
- 平台文件服务、项目主数据或组织数据不可用时拒绝相应操作并给出提示，不写入占位成功记录。
- 日志包含对象标识、动作、操作者与结果，不记录凭据或完整敏感附件地址。
11. 与设计稿的关系与关键设计来源
本文依据《信息管理功能架构需求清单》（2026-09-17）及本轮代码核对，按正式交付口径确定模块定位、边界、页面路由建议、数据模型与流程口径；表名、路由与权限码均为建议取值，实现时以数据库与菜单回读为准，差异记录在文末「待确认事项」一节。
| 来源 | 用途 |
|---|---|
| 《信息管理功能架构需求清单》思维导图与随附表格（2026-09-17） | 模块范围、4 个功能的功能目录、各功能的页面/功能区/数据行动作清单、价值描述中的能力归属、无流程口径 |
| 原功能架构图历史规划（工程部讨论版，2026-08-26） | 业务域归属与建设批次；确认「信息管理」为一级业务域名称 |
| 代码库核对（2026-09-21） | 平台可复用能力清单与能力缺口：文件对象服务、基于 KKFileView 的预览组件与预览服务配置、权限码、字典、项目主数据、导出与分页可用；通用文件档案版本、标签、全文检索（检索组件模块存在但未启用）、文件分享/令牌外链、批量移动与导出选中当前不存在 |
| 公共开发约定、业务地图、系统架构 | 三段式权限码、大整数 ID、项目与工程主数据、权限模型、数据库可迁移性等跨模块契约 |
| 需求分析 | 业务范围、规则条目、验收标准与待确认事项 |
12. 实施依赖与验证重点
标准文件登记与访问控制涉及文件档案与版本模型、目录树复用、动作权限与文件访问授权的服务端判定。实现这些行为时，按受影响范围验证真实菜单与页面、登记和版本升级接口、目录与标签数据、未授权访问的拒绝路径，以及适用的预览与下载行为。工程文件、预归档、安全外链、移交备案和导入导出按各自依赖与实现范围推进，不以前述验证完成作为统一前置条件。
全文关键字检索（XF-023）与公司档案系统对接仍是本期目标。全文索引方案缺失（Q-IM-003）只阻塞依赖索引契约的检索实现；对接模式、数据映射和验收环境缺失（Q-IM-005）只阻塞实际对接实现与通过声明。其他不依赖这些结论的设计和实现继续推进，不能以本地状态登记代替对接验收。
13. 待确认事项
问题正文、来源与确认状态只在需求分析维护；下表仅说明本设计受影响的位置和当前设计处理，提案不等于已获业务确认。
| 关联问题 | 受影响设计点 | 当前设计处理（以需求侧状态为准） |
|---|---|---|
| Q-IM-001 | 菜单结构、路由前缀与权限串父级归属 | 清单根节点称「工程文件监管」，功能目录称「信息管理」；后台菜单名称、层级与排序按现有菜单树及业务确认核实，不预设父级 |
| Q-IM-002 | 「页面与路由清单」「接口职责概览」及后续详细设计 | 按动作清单最小推导；取得原型后按原型调整，推导内容不作为确认口径 |
| Q-IM-003 | 全文检索的可交付范围、平台/模块责任、索引运行依赖及验收 | 保留全文检索目标，不缩减为只查文件名/标签；实现路径按代码能力评估并由业务/技术共同定稿 |
| Q-IM-004 | 外链页面入口、「数据模型概览」外链表字段与安全策略 | 按服务端签发限时令牌 + 可回收 + 可限次设计，免登录精确路径放行；入口与参数待确认 |
| Q-IM-005 | 预归档推送实现、双方数据契约、依赖责任、实施先后、测试环境与端到端验收 | 对接目标保留在本期需求范围；取得接口资料并与工程变更监管统一依赖口径后，再裁决集成模式、责任、实施顺序与验收证据，不以本地状态登记替代实际对接 |
| Q-IM-006 | 「页面与路由清单」的接口管理入口与「数据模型概览」的接口登记表 | 接口管理动作属本期范围；页面承载、是否单表、配置范围及字段不作为已确认结论，须与 Q-IM-005 的实际接口契约协同定稿 |
| Q-IM-007 | 「数据模型概览」授权表结构、「权限与安全边界」鉴权判定与权限分配交互 | 按两级对象 + 用户/角色/部门主体 + 查看/下载/编辑/外链级别设计 |
| Q-IM-008 | 是否增设目录-项目关联表、目录树交互 | 暂不列入表清单，按目录与项目多对多预留；确认后收敛 |
| Q-IM-009 | 「数据模型概览」备案表字段与「核心运行流程与状态模型」 | 来源只确认清单生成和导出动作；清单形式与提交后状态需业务确认，不预设只读终态或不需要回执 |
| Q-IM-010 | 「数据模型概览」档案与版本表结构、版本升级交互 | 按同一档案内版本号递增、历史版本保留可查看与下载设计 |
| Q-IM-011 | 预览页面交互与格式覆盖范围 | 复用平台既有预览组件，不新建预览层；入口形态与格式实测结果待确认 |
| Q-IM-012 | 导入实现与「异常、事务与幂等」 | 按目录清单与标签导入设计，逐行报错、整批回滚 |
| Q-IM-013 | 提醒方式与集成范围 | 本期不做通知 |
| Q-IM-014 | 查询、预览、下载、导出和外链的服务端过滤与授权验收 | 结合平台部门/工程数据范围与需求中的多层级文件授权共同核实；不默认仅凭页面权限即可查询全部数据 |
| Q-IM-015 | 上传校验、页面提示与存储压力 | 沿用平台统一策略，模块不另设限制 |
| Q-IM-016 | 跨模块一致性、规划管理 R-PL-015 的预留口径 | 回填规则待本模块目录能力及跨模块契约明确后确定；不阻塞独立的文件登记与访问控制 |
| Q-IM-017 | 「页面与路由清单」「数据模型概览」「权限与安全边界」建议值的最终确认 | 实现时按 MCP 与菜单回读核对，不一致处以回读结果为准并同步本文 |
| Q-IM-018 | 用户角色、菜单/操作权限、记录级权限及测试角色 | 本文角色表仅作分析提案；需由业务提供职责与组织映射后定稿 |
| Q-IM-019 | 架构容量、服务指标、存储成本、运维与正式验收门槛 | 先套用平台通用安全与运行要求；业务规模、SLO 和留存期限需由业务/运维共同提供或裁决 |
| Q-IM-020 | 删除接口、表字段、唯一性约束、外链权限和档案留痕 | 删除动作保留在需求范围；存储策略、关联影响与保留周期均不预设，须由业务/档案管理与技术共同确认后定稿 |