# PCBJIA Mall 商城与权限建表设计稿（MySQL → PostgreSQL 改写）

版本：v1.0　日期：2026-11-18　对应：需求方商城 10 张业务表 + RBAC 5 张权限表

## 一、边界说明

- 本包为**设计稿**，方言由 MySQL 8.0 改写为 PostgreSQL，用于评审与前后端契约对齐。
- 本站点真实建表由平台内置能力完成，本包不提供执行入口，也不会被直接执行。
- 商城中的支付、授信额度实际扣减、供应商结算打款、发票开具属于平台与资金边界之外的能力，表结构仅作预留示意。

## 二、方言换算要点

| MySQL | PostgreSQL |
| --- | --- |
| `bigint unsigned auto_increment` | `bigint generated by default as identity` |
| `tinyint` 状态位 | `smallint` + `check` |
| `tinyint(1)` 布尔 | `boolean` |
| `decimal(18,4)` | `numeric(18,4)` |
| `datetime` | `timestamptz` |
| `ON UPDATE CURRENT_TIMESTAMP` | `before update` 触发器 |
| `text` 存 JSON | `jsonb` |
| `is_deleted tinyint` | `is_deleted boolean default false` |
| `KEY idx_x` | 独立 `create index` |

## 三、业务表清单

| # | 表 | 用途 | 归属域 |
| --- | --- | --- | --- |
| 1 | `customer` | 客户主档、分层与授信 | 客户 |
| 2 | `supplier` | 供应商主档、L1-L4 分级 | 供应链 |
| 3 | `component` | 元器件料库、阶梯价 | 商城 |
| 4 | `pcb_quote_template` | PCB 工艺报价模板 | 报价 |
| 5 | `bom_order` | BOM 配单主单 | 商城 |
| 6 | `bom_item` | BOM 明细行 | 商城 |
| 7 | `mall_order` | 统一订单（PCB/BOM/SMT） | 交易 |
| 8 | `settle_bill` | 供应商结算分账 | 财务 |
| 9 | `car_record` | CAR 品质异常单 | 品质 |
| 10 | `message_center` | 统一消息中心 | 消息 |
| 11 | `sys_menu` | 菜单与权限点 | 权限 |
| 12 | `sys_role` | 角色 | 权限 |
| 13 | `sys_role_menu` | 角色-权限 | 权限 |
| 14 | `sys_user` | 平台内部账号 | 权限 |
| 15 | `sys_user_role` | 用户-角色 | 权限 |

## 四、关键设计口径

1. **软删除**：全部业务表保留 `is_deleted`，查询默认过滤；唯一键需与 `is_deleted` 组合，避免删除后编号无法复用。
2. **金额**：一律 `numeric(18,4)`；`credit_limit`、`credit_balance` 差额即剩余授信，展示为「可用授信」。
3. **阶梯价**：`component.price_json` 使用 `jsonb`，形如 `[{"qty":100,"price":0.12}]`，按数量升序取值。
4. **订单状态**：`mall_order.order_status` 与履约节点保持同一套语义（待确认 → 排产 → 生产 → 发货 → 完成），前端不得自造状态。
5. **CAR**：`car_record.status` 与 8D 阶段对应，关闭必须填写 `root_cause` 与 `correct_action`。
6. **消息**：`receiver_type + receiver_id` 建联合索引；未读计数以 `is_read=false` 聚合，不做冗余计数列。
7. **权限**：`permission_key` 命名 `域:资源:动作`；角色仅做授权集合，实际判定以服务端权限点为准。
8. **密码**：`sys_user.password` 存 bcrypt 哈希；平台侧真实登录使用邮箱或短信验证码，本表仅作内部账号设计参考。

## 五、验收口径

- 每张表具备主键、必要唯一键与查询索引。
- 所有可变表具备 `updated_at` 与更新触发器。
- 订单、结算、CAR 三表可按单号、客户、供应商三向检索。
- 消息未读数、授信余额可由明细推导，不依赖页面缓存。

## 六、完整结构

见同目录 `mall_schema.sql`（PostgreSQL 方言，含触发器与初始化角色数据）。