commit 540935ed47637a324b35b0599e0a5d4a289e7aca Author: bid-docs <bid-docs@localhost> Date: 2026-01-21T11:08:50+08:00 Initialize docs and viewer diff --git a/docs/06-domain-model-and-data-dictionary.md b/docs/06-domain-model-and-data-dictionary.md new file mode 100644 index 0000000..4096a96 --- /dev/null +++ b/docs/06-domain-model-and-data-dictionary.md @@ -0,0 +1,92 @@ +# 领域模型与数据字典 (Domain Model & Data Dictionary) + +## 1. 核心实体 (Core Entities) +- **Project**：项目主实体，贯穿全生命周期 +- **Notice**：公告类数据（招标/采购/结果/更正） +- **Tender**：招标标段或包件 +- **Award**：中标结果 +- **Contract**：合同与履约记录 +- **Organization**：采购方/供应商/代理机构 +- **Person/Expert**：评标专家（若可获取） +- **Source**：数据源 +- **User/Role**：用户与权限 +- **Subscription**：订阅与推送策略 +- **Attachment**：公告附件与标书 + +## 2. 关系概览 (Relations) +- Project 1..N Notice +- Project 1..N Tender +- Tender 0..1 Award +- Award 0..1 Contract +- Organization 与 Project/Tender/Award 多对多 +- User 1..N Subscription + +## 3. 数据字典 (Key Fields) +### 3.1 Project +- `project_id` (UUID) +- `project_name` +- `project_code` (招标编号) +- `project_stage` (intent/notice/prequal/award/contract/fulfillment) +- `budget_amount`、`currency` +- `region_code`、`industry_code` +- `buyer_org_id` +- `start_date`、`end_date` + +### 3.2 Notice +- `notice_id` +- `notice_type` (tender/award/correction/intent) +- `publish_time` +- `title` +- `content_raw` +- `attachments` (list) +- `source_id`、`source_url` + +### 3.3 Tender +- `tender_id` +- `tender_name` +- `package_no` +- `qualification_requirements` +- `bid_open_time` +- `bid_deadline` + +### 3.4 Award +- `award_id` +- `winner_org_id` +- `award_amount` +- `award_time` +- `evaluation_method` + +### 3.5 Contract +- `contract_id` +- `contract_amount` +- `sign_date` +- `delivery_deadline` +- `performance_status` + +### 3.6 Organization +- `org_id` +- `org_name` +- `org_type` (buyer/supplier/agency) +- `credit_code` (统一社会信用代码) +- `region_code` +- `contact_phone` (脱敏) + +### 3.7 Subscription +- `subscription_id` +- `user_id` +- `keywords`、`regions`、`industries` +- `channels` (email/sms/wecom) +- `schedule` (realtime/daily/weekly) + +### 3.8 Source +- `source_id` +- `source_name` +- `source_type` +- `access_method` +- `update_frequency` + +## 4. 统一分类体系 +- 行业分类：支持 2~4 级，兼容国家标准行业分类 +- 地区分类：省/市/区三级行政区划 +- 采购方式：公开招标/邀请招标/竞争性谈判/询价等 +