Schema
資料模型草案
主要 Entity
| Entity | 用途 |
|---|
| Project | 專案主檔。 |
| WorkflowNode | 專案流程節點。 |
| BomDocument | BOM 文件與版本。 |
| ProcurementItem | 採購品項。 |
| ImportedDocument | 報價單、採購單、BOM 或其他匯入檔案。 |
| NotificationEvent | 通知事件。 |
| ProgressReport | 部門回報紀錄。 |
| AuditLog | 操作紀錄。 |
採購品項欄位
- caseCode
- documentNo
- bomType
- productCode
- productName
- quantity
- unit
- supplier
- expectedDeliveryDate
- procurementStatus
- ownerDepartment
- updatedAt
狀態初版
未採購
叫貨中
已採購
已到貨
異常
採購部正式模型草稿
採購部作為第一個完整部門模組，資料模型先拆成來源單據、採購品項、狀態歷程與案件採購摘要。完成採購部模型後，再用相同方式擴展到其他部門。
| 資料表 | 用途 | 來源 |
|---|
| procurement_source_document | 匯入報價單 / 採購單來源。 | 目前 import_backups 的 source_file 與備份 JSON。 |
| procurement_item | 採購品項明細。 | purchase_import.records[]。 |
| procurement_status_history | 採購狀態異動紀錄。 | 品項狀態修改事件。 |
| project_procurement_summary | 案件採購摘要，可即時計算或快取。 | procurement_item 彙總。 |
採購部 API 草稿
| API | 用途 |
|---|
| GET /api/projects/{caseCode}/procurement | 取得案件採購總覽、來源單據與摘要。 |
| GET /api/projects/{caseCode}/procurement/source-documents | 取得案件底下來源單據。 |
| GET /api/procurement/source-documents/{sourceDocumentId}/items | 取得來源單據底下品項。 |
| PATCH /api/procurement/items/{itemId}/status | 更新單一品項採購狀態。 |
| PATCH /api/procurement/items/status | 批次更新品項採購狀態。 |
| POST /api/procurement/imports | 匯入來源單據並建立採購品項。 |