数据库建表设计稿(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 '...' | 独立注释语句 |
四、通用约定
- 主键统一
bigint identity;业务可读编号另设code varchar(32) unique。 - 所有可变业务表必须带
created_at timestamptz not null default now()与updated_at timestamptz not null default now(),并配before update触发器。 - 软删除统一
deleted_at timestamptz,查询默认过滤。 - 金额字段一律
numeric(14,2),币种字段currency char(3) default 'CNY'。 - 状态字段用
text+check,取值与前端状态机一一对应,禁止前端自造状态。 - 所有对外暴露的表必须开启行级权限控制;公开可读表只开放
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`)
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允许为空,界面显示「待提交」,不伪造下载地址。 - 资金托管、支付回执、短信通知相关表不在本稿范围。

