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。