# 数据字典

## 通用字段

| 字段 | 含义 | 迁移说明 |
| --- | --- | --- |
| `schema_version` | 字段版本 | 当前为 `fact-ledger-v1` |
| `created_at` | 创建时间 | ISO 时间格式 |
| `updated_at` | 更新时间 | ISO 时间格式 |
| `record_status` | 记录状态 | `draft`、`confirmed`、`corrected`、`void` |
| `sensitivity_level` | 敏感级别 | `public`、`internal`、`private`、`restricted` |
| `source_path` | 证据路径 | 优先相对项目路径 |
| `source_sha256` | 证据文件哈希 | 可后补，用于迁移校验 |
| `notes` | 备注 | 不放大段合同原文 |

## contracts.csv

| 字段 | 含义 |
| --- | --- |
| `contract_id` | 合同稳定 ID，主键 |
| `title` | 合同标题或脱敏主题 |
| `party_id` | 主要相关方 ID，可扩展为多方表 |
| `contract_type` | 采购、销售、补充协议、委托等 |
| `sign_date` | 签署日期 |
| `effective_date` | 生效日期 |
| `status` | 草稿、有效、已终止、待确认等 |
| `related_item_ids` | 关联货品 ID，多个用分号分隔 |
| `related_movement_ids` | 关联进出记录 ID，多个用分号分隔 |

## items.csv

| 字段 | 含义 |
| --- | --- |
| `item_id` | 货品稳定 ID，主键 |
| `current_name` | 当前名称 |
| `category` | 品类 |
| `spec` | 规格 |
| `unit` | 默认单位 |
| `aliases` | 别名，多个用分号分隔 |
| `status` | 在用、停用、待确认等 |

## parties.csv

| 字段 | 含义 |
| --- | --- |
| `party_id` | 相关方稳定 ID，主键 |
| `display_name` | 脱敏或简称显示名 |
| `party_type` | 供应商、客户、个人、仓库、平台等 |
| `contact_masked` | 脱敏联系方式 |

## goods_movements.csv

| 字段 | 含义 |
| --- | --- |
| `movement_id` | 进出记录稳定 ID，主键 |
| `item_id` | 货品 ID |
| `contract_id` | 关联合同 ID，可为空 |
| `direction` | 入、出、借出、归还、私用、调拨、报废 |
| `scenario` | 采购、销售、个人使用、样品、赠品等 |
| `quantity` | 数量 |
| `unit` | 单位 |
| `movement_date` | 发生日期 |
| `from_party_id` | 来源方 ID |
| `to_party_id` | 去向方 ID |
| `storage_location` | 存放位置或仓库 |
| `verification_status` | 待确认、已确认、有争议 |