# 核心数据表设计（摘要）

版本：V1.2 摘要
说明：本文件为业务模型摘要，字段以中文说明为主；正式落地按平台数据库规范评审后建表，统一保留 `created_at`、`updated_at`、`is_deleted`，所有可变表使用本地更新时间触发器。

## 1. 客户域

### customer 客户主体
`customer_id`、`enterprise_name`、`enterprise_type`、`industry`、`contact_person`、`phone`、`email`、`address`、`tax_no`、`customer_level(A/B/C/D)`、`health_score`、`credit_limit`、`credit_status`、`risk_tag`、`is_secrecy_client`
关联：customer_user、customer_bill、order_task

### customer_user 客户子账号
`user_id`、`customer_id`、`username`、`role(采购/工程师/财务/管理员)`、`permission_scope`、`is_price_visible`、`last_login_time`
用途：工程师账号默认屏蔽价格，配合脱敏规则。

## 2. 工程域

### bom 单据
`bom_id`、`customer_id`、`user_id`、`bom_name`、`bom_file_path`、`bom_status(草稿/解析中/解析完成/失效)`、`total_lines`、`parse_result`、`risk_summary`

### bom_item 明细行
`item_id`、`bom_id`、`part_no`、`part_name`、`spec`、`package`、`quantity`、`brand`、`substitute_part_no`、`risk_flag`

### gerber 工程文件
`gerber_id`、`customer_id`、`user_id`、`gerber_name`、`file_path`、`layer_info`、`drc_result`、`dfm_report_path`、`board_thickness`、`layer_count`、`min_trace`、`min_space`

## 3. 交易域

### inquiry 询价单
`inquiry_id`、`customer_id`、`bom_id`、`gerber_id`、`inquiry_type(PCB/元器件/SMT/混合)`、`require_qty`、`delivery_require`、`inquiry_status`、`expire_time`

### quotation 报价单
`quotation_id`、`inquiry_id`、`supplier_id`、`price_info`、`delivery_time`、`process_limit`、`unit_price`、`total_price`、`valid_time`、`quotation_status`

### order_task 订单主表
`order_id`、`inquiry_id`、`customer_id`、`supplier_id`、`order_type`、`order_status`、`total_amount`、`prepay_amount`、`credit_amount`、`deposit_withhold`、`delivery_date`、`sign_time`

### order_item 订单明细
`item_id`、`order_id`、`product_type`、`spec`、`qty`、`unit_price`、`sub_amount`、`split_rate`

### payment 支付流水
`pay_id`、`order_id`、`pay_channel`、`pay_amount`、`pay_status`、`transaction_no`、`refund_flag`、`refund_amount`
说明：平台不接入在线收款，本表仅作记录模型，落地前需评估支付能力边界。

### settlement 结算与 invoice 发票
结算：`settle_id`、`order_id`、`supplier_id`、`settle_amount`、`withhold_warranty`、`release_warranty`、`settle_status`、`invoice_id`
发票：`invoice_id`、`settle_id`、`invoice_type`、`invoice_no`、`invoice_amount`、`invoice_file`、`invoice_status`

## 4. 供应域

### supplier 供应商主体
`supplier_id`、`supplier_name`、`supplier_type(L1/L2/L3)`、`contact`、`qualification_files`、`audit_report`、`deposit_amount`、`supplier_level(S/A/B/C)`、`performance_score`、`status(正常/整改/冻结/淘汰)`

### supplier_user 供应商子账号
`supplier_user_id`、`supplier_id`、`role`、`permission`

### supplier_performance 绩效记录
`perf_id`、`supplier_id`、`stat_month`、`quality_score`、`delivery_score`、`service_score`、`price_score`、`total_score`、`grade`、`deduction_reason`

## 5. 品质域

### car 客诉工单
`car_id`、`order_id`、`supplier_id`、`customer_id`、`fault_type`、`fault_desc`、`pic_path`、`responsibility(客户/供应商/物流)`、`car_status(新建/处理中/待验证/闭环)`、`8d_file`、`close_time`、`deduction_score`

### knowledge_case 失效案例
`case_id`、`car_id`、`fault_type`、`root_cause`、`countermeasure`、`ipc_standard`、`case_tag`、`is_visible`

## 6. 运营域

### message 消息
`msg_id`、`receiver_id`、`receiver_type`、`msg_type`、`title`、`content`、`jump_url`、`channel`、`read_status`、`expire_time`

### coupon 优惠券
`coupon_id`、`customer_id`、`coupon_type`、`amount`、`condition`、`valid_start`、`valid_end`、`use_status`、`order_id`

### audit_log 审计日志
`log_id`、`operator_id`、`operator_type`、`operate_type`、`operate_object`、`object_id`、`before_value`、`after_value`、`ip`、`operate_time`
约束：敏感修改（授信、金额、权限）必须记录前后值，不可删除。

## 7. 落库注意

- 金额统一 `numeric(14,4)`，币种单列 `currency`，避免浮点误差。
- 状态字段统一 `text` + 检查约束，禁止中文枚举值直接入库。
- 所有附件字段只存地址或文件名，不存二进制。
- 软删除统一 `is_deleted`，查询默认过滤。
- 行级权限按属主字段（customer_id / supplier_id / buyer_id）判定，名称字段仅作展示。