下载中心/改写规则与表清单

改写规则与表清单

下载原文件

数据库建表设计稿(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 KEYid bigint generated by default as identity primary key自增改为 identity 列
VARCHAR(n)varchar(n)语义一致,保留长度约束
TEXT / LONGTEXTtextPG 无区分
DATETIME / TIMESTAMPtimestamptz统一带时区,避免跨时区错位
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'))避免类型迁移成本
JSONjsonb支持索引与包含查询
col "col"反引号改双引号;字段名统一小写下划线
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4直接删除PG 无表引擎与字符集概念
ON UPDATE CURRENT_TIMESTAMPbefore 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`)

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 允许为空,界面显示「待提交」,不伪造下载地址。
  • 资金托管、支付回执、短信通知相关表不在本稿范围。