# 数据库建表设计稿（MySQL 原文 → PostgreSQL 改写）

版本：v1.0　日期：2026-11-18　适用站点：PCB之家（Max Edition）

## 一、这份文档是什么

需求方提供的建表语句以 MySQL 方言书写（`ENGINE=InnoDB`、`AUTO_INCREMENT`、`DATETIME`、`TINYINT(1)`、反引号、`ON UPDATE CURRENT_TIMESTAMP`）。平台运行在 PostgreSQL 之上，因此本包把同一套业务表**逐条改写为 PostgreSQL 语法**，只作为设计与评审依据。

## 二、重要边界（请先阅读）

- 本包内 SQL **仅为设计稿，不会也不应被直接执行**。
- 本站点真实建表只能通过平台内置能力完成，不接受手工执行 SQL，也无法提供数据库控制台入口。
- 稿件中的字段名、类型、索引与约束用于对齐前后端契约与验收口径；实际上线以平台生成的结构为准。
- 涉及资金结算、支付通道、短信/邮件投递的表，仅保留结构示意，不作为可交付能力承诺。

## 三、方言换算规则

| MySQL 写法 | PostgreSQL 改写 | 说明 |
| --- | --- | --- |
| `INT AUTO_INCREMENT PRIMARY KEY` | `id bigint generated by default as identity primary key` | 自增改为 identity 列 |
| `VARCHAR(n)` | `varchar(n)` | 语义一致，保留长度约束 |
| `TEXT` / `LONGTEXT` | `text` | PG 无区分 |
| `DATETIME` / `TIMESTAMP` | `timestamptz` | 统一带时区，避免跨时区错位 |
| `TINYINT(1)` 布尔语义 | `boolean` | 如 `is_active`、`deleted` |
| `TINYINT` 枚举语义 | `smallint` + `check (... in (...))` | 保留取值约束，不引入 PG 自定义枚举，便于后续扩展 |
| `DECIMAL(12,2)` | `numeric(12,2)` | 金额一律 numeric，禁用浮点 |
| `ENUM('a','b')` | `text check (col in ('a','b'))` | 避免类型迁移成本 |
| `JSON` | `jsonb` | 支持索引与包含查询 |
| `` `col` `` | `"col"` | 反引号改双引号；字段名统一小写下划线 |
| `ENGINE=InnoDB DEFAULT CHARSET=utf8mb4` | 直接删除 | PG 无表引擎与字符集概念 |
| `ON UPDATE CURRENT_TIMESTAMP` | `before update` 触发器 | 平台规范禁止 `moddatetime` 扩展 |
| `KEY idx_x (col)` | `create index idx_x on t (col)` | 索引独立语句 |
| `UNIQUE KEY uk_x (a,b)` | `constraint uk_x unique (a,b)` | 表内约束 |
| `COMMENT '...'` | `comment on column t.c is '...'` | 独立注释语句 |

## 四、通用约定

1. 主键统一 `bigint identity`；业务可读编号另设 `code varchar(32) unique`。
2. 所有可变业务表必须带 `created_at timestamptz not null default now()` 与 `updated_at timestamptz not null default now()`，并配 `before update` 触发器。
3. 软删除统一 `deleted_at timestamptz`，查询默认过滤。
4. 金额字段一律 `numeric(14,2)`，币种字段 `currency char(3) default 'CNY'`。
5. 状态字段用 `text` + `check`，取值与前端状态机一一对应，禁止前端自造状态。
6. 所有对外暴露的表必须开启行级权限控制；公开可读表只开放 `select`，写入走登录身份。

## 五、表清单（按域拆分）

| 域 | 表 | 说明 |
| --- | --- | --- |
| 身份 | `profiles` | 用户档案，与平台认证主体一一对应 |
| 撮合 | `rfq_bids` | 标单主体，含预算、交期、状态 |
| 撮合 | `rfq_quotes` | 报价单，含价格、交期、质保月数 |
| 撮合 | `rfq_orders` | 中标订单，含履约状态与金额 |
| 撮合 | `rfq_order_milestones` | 履约节点：开工 / 在制 / 质检 / 交付 / 验收 |
| 撮合 | `rfq_order_deliverables` | 交付物留痕：确认单、质检报告、出货单、签收单 |
| 信任 | `provider_credit_logs` | 信用分变更流水，扣分与评价均落一条 |
| 信任 | `risk_intercepts` | 站外导流拦截记录，含命中词与扣分 |
| 内容 | `posts` / `post_categories` | 论坛与资讯 |
| 工具 | `impedance_calc_records` | 阻抗计算记录，含叠层方案编号 |

## 六、核心表结构（节选，完整见 `schema_design.sql`）

```sql
create table rfq_order_milestones (
  id bigint generated by default as identity primary key,
  order_id bigint not null references rfq_orders (id) on delete cascade,
  stage text not null check (stage in ('created','in_progress','production','testing','shipping','signed','completed','disputed','cancelled')),
  note text,
  occurred_at timestamptz not null default now(),
  created_at timestamptz not null default now(),
  updated_at timestamptz not null default now()
);

create index idx_rfq_order_milestones_order on rfq_order_milestones (order_id, occurred_at);

create table rfq_order_deliverables (
  id bigint generated by default as identity primary key,
  order_id bigint not null references rfq_orders (id) on delete cascade,
  stage text not null,
  deliverable_type text not null check (deliverable_type in ('开工确认单','质检报告','出货单','签收单','其他')),
  file_name text not null,
  file_url text,
  note text,
  created_at timestamptz not null default now(),
  updated_at timestamptz not null default now()
);
```

## 七、验收口径

- 同一订单下履约节点时间严格递增，不允许同一时间戳出现两个节点。
- 进入某阶段时自动生成对应交付物占位记录，服务商上传后 `file_url` 有值，需求方与平台可下载。
- 信用分每次变更必须同时写一条流水，流水 `delta` 之和等于当前分与初始分之差。
- 站外导流拦截单次固定扣 10 分，7 天内累计 3 次暂停接单，前端展示值必须与流水一致。

## 八、遗留说明

- 对象存储通道未开通前，`file_url` 允许为空，界面显示「待提交」，不伪造下载地址。
- 资金托管、支付回执、短信通知相关表不在本稿范围。