DocuMan：AI 驱动的需求管理工作空间

DocuMan 是一个开源的 AI 驱动系统工程与需求管理平台，旨在将复杂的工程规范自动转换为符合 MIL-STD-498 及 IEEE/ISO 标准的技术文档。它通过多轮 AI 推理、实时架构图渲染、跨需求功能合成和双向追溯链接管理，帮助工程团队在极短时间内交付军用级系统设计。

传统工程文档推导往往需要数周时间，DocuMan 的三阶段 AI 推导引擎可在几分钟内生成合规的派生文档。第一阶段进行全局文档分析，生成执行摘要、提取领域词汇表并将父需求分组为系统功能（如 Fn-001、Fn-002）。第二阶段预先建立架构基线，覆盖范围与标识、引用文档、架构/运行/安全决策等章节。第三阶段生成详细的第 5.2 节功能架构表，包含功能名称、描述、带子字段的输入输出列表及上游需求引用。

DocuMan 还支持实时可视化：内嵌 Mermaid.js 引擎可在编辑界面中直接渲染组件分解图和子系统数据流图，并支持在 SVG 图形和可编辑代码之间切换，导出的 PDF 和 HTML 中包含矢量图，确保印刷和审阅时的清晰度。智能功能分组不再简单克隆需求，而是将相关需求（如 SSS-001、SSS-002、SSS-005）合成为具有固定四行格式的系统功能，每个功能包含功能名称、功能描述、输入/输出参数列表（含复合数据子字段）以及上游需求引用。

接口摘要与信号数据字典能够自动提取跨文档层的系统接口。第 4.3 节系统接口汇总表列出源/目标子系统、协议总线和交换数据；第 5.3 节信号数据字典表则详细呈现消息帧和信号参数，包括信号 ID、名称、数据类型与范围、有效载荷子字段、更新速率及上游 SSS 需求。

双向需求追溯让工程师可以建立 DERIVED_FROM、SATISFIES 和 RELATED_TO 关系。当上游规范被修改时，受影响的下游链接会立即被标记为 SUSPECT，提醒工程师核验合规性。所有生成的表格和视图均以人类可读的需求编号（如 SSS-001）而非原始数据库键来引用。

DocuMan 支持从 PDF、DOCX、TXT 导入需求并自动提取分层次编号（如 1.1.1），一键导出带自定义样式、封面、目录和 Mermaid 图的 PDF/HTML。文档审批生命周期覆盖 DRAFT、REVIEW、PUBLISHED 状态，并支持主/次版本快照。平台内置对 MIL-STD-498 及对应 IEEE/ISO 标准（如 SSS、SSDD、SRS、SDD、IRS、IDD、STP）的开箱即用支持，涵盖国防与航空航天文档基线。

技术栈方面，DocuMan 基于 Next.js 15（App Router、React 19 Server Actions）、Mermaid.js、Prisma ORM（SQLite/PostgreSQL）、Vercel AI SDK 以及 OpenAI 兼容的大模型接口。快速启动只需克隆仓库、配置环境变量（数据库 URL、模型 API 地址和密钥）、执行 npm run db:push 与 npm run dev，即可在本地运行。验证与构建命令包括 npx tsc --noEmit 和 npm run build。