概述

EBAOZU 系统使用 MySQL 数据库（>= 8.0），数据库表前缀默认为 eb_。本文档汇总核心业务数据表结构分类、关键表字段及关联关系。

---

数据库配置

数据库连接参数位于 config/database.php，实际环境变量通过根目录 .env 文件读取：

[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = ebaozu_v4
USERNAME = root
PASSWORD = root
HOSTPORT = 3306
CHARSET = utf8mb4
PREFIX = eb_
DEBUG = true

---

核心数据表分类

用户域核心表

表名	说明
eb_user	用户主表（账号、手机、余额、积分、等级等）
eb_user_address	用户收货地址表
eb_user_bill	用户账单明细表
eb_user_brokerage	用户佣金流水记录表
eb_user_money	用户余额变动流水表
eb_user_extract	用户提现申请与记录表
eb_user_recharge	用户充值记录表
eb_user_level	用户等级配置表

商品域核心表

表名	说明
eb_store_product	商品主表（名称、价格、总库存、分类、上下架状态等）
eb_store_product_attr	商品规格项表（如颜色、尺码）
eb_store_product_attr_value	商品规格属性值表（SKU 级别：库存、价格、条码、唯一标识）
eb_store_product_cate	商品与分类关联表
eb_store_product_description	商品富文本图文详情表
eb_store_product_reply	商品用户评价表
eb_store_category	商品分类表
eb_store_brand	商品品牌表

订单域核心表

表名	说明
eb_store_order	订单主表（订单号、支付状态、订单状态、金额、配送信息等）
eb_store_order_cart_info	订单快照商品详情表
eb_store_order_status	订单状态流转日志表
eb_store_order_refund	订单售后退款记录表
eb_store_cart	用户购物车表

系统与权限核心表

表名	说明
eb_system_admin	后台管理员账号表
eb_system_role	管理员角色与权限配置表
eb_system_menus	后台功能菜单与 API 权限规则表
eb_system_config	系统动态配置表
eb_system_config_tab	系统配置分类表
eb_system_store	门店基础信息表
eb_system_supplier	供应商基础信息表

---

核心数据关系

用户与订单关系

eb_user (用户主表)
    ├── eb_user_address (收货地址)
    ├── eb_user_bill (账单记录)
    └── eb_store_order (订单主表)
            ├── eb_store_order_cart_info (商品快照)
            ├── eb_store_order_status (流转日志)
            └── eb_store_order_refund (售后退款)

商品与规格 SKU 关系

eb_store_product (商品主表)
    ├── eb_store_product_attr (规格项)
    ├── eb_store_product_attr_value (SKU 明细: stock, price, unique)
    └── eb_store_product_description (商品图文详情)

---

开发与数据库规范

1. 字符集与排序规则：统一采用 utf8mb4 与 utf8mb4_general_ci，确保全面支持 Emoji 与多字节文字。
2. 时间存储：时间戳字段统一使用整型 int(11) 存储 Unix 时间戳（个别特定扩展表根据业务定义）。
3. 金额字段：所有涉及金额、价格、成本的字段必须使用 decimal(10,2)，严禁使用浮点型。
4. 软删除规范：使用 is_del（tinyint）标识软删除，0 表示正常，1 表示已删除。
5. SQL 变更记录：任何二次开发涉及的数据库表结构或数据变更，必须追加至 db_sql/zyl.sql。