# unishop **Repository Path**: haiming236/unishop ## Basic Information - **Project Name**: unishop - **Description**: 私域外卖平台,适合学校,超市附件自配送,支持多校区。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-05-23 - **Last Updated**: 2026-05-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 以下是为你整理的完整 MySQL DDL 建表脚本。脚本中包含了完整的字段类型、主外键索引优化、自增主键以及详细的 `COMMENT` 备注,可直接复制到数据库工具(如 Navicat、DataGrip 或 phpMyAdmin)中运行。 为了保证轻量和高扩展性,脚本中使用了高效的 `KEY` 索引代替了强外键物理约束(这也是互联网开发中常用的做法,靠业务代码保证一致性,并发性能更好)。 ```sql CREATE DATABASE IF NOT EXISTS `private_delivery` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE `private_delivery`; -- ---------------------------- -- 1. 店铺表 (merchant) -- ---------------------------- DROP TABLE IF EXISTS `merchant`; CREATE TABLE `merchant` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '店铺ID', `name` varchar(100) NOT NULL COMMENT '店铺名称', `logo` varchar(255) DEFAULT NULL COMMENT '店铺图片URL', `announcement` varchar(500) DEFAULT NULL COMMENT '店铺公告', `phone` varchar(20) DEFAULT NULL COMMENT '联系电话', `longitude` decimal(10,7) DEFAULT NULL COMMENT '经度 (用于计算配送距离)', `latitude` decimal(10,7) DEFAULT NULL COMMENT '纬度 (用于计算配送距离)', `delivery_radius` decimal(10,2) DEFAULT '0.00' COMMENT '配送距离(km),超出不允许下单', `delivery_fee` decimal(10,2) DEFAULT '0.00' COMMENT '基础配送费', `free_threshold` decimal(10,2) DEFAULT '0.00' COMMENT '满免配送费金额,0表示不免', `store_discount` decimal(3,2) DEFAULT NULL COMMENT '全店折扣 (如0.85表示85折, NULL/1.00为无折扣)', `discount_start` datetime DEFAULT NULL COMMENT '全店折扣开始时间', `discount_end` datetime DEFAULT NULL COMMENT '全店折扣结束时间', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='店铺基础配置表'; -- ---------------------------- -- 2. 商品分类表 (category) -- ---------------------------- DROP TABLE IF EXISTS `category`; CREATE TABLE `category` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '分类ID', `merchant_id` int NOT NULL COMMENT '所属店铺ID', `name` varchar(50) NOT NULL COMMENT '分类名称 (如: 休闲零食、饮品雪糕)', `sort_order` int DEFAULT '0' COMMENT '排序数字,越小越靠前', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), KEY `idx_merchant_id` (`merchant_id`) COMMENT '店铺ID普通索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='商品分类表'; -- ---------------------------- -- 3. 商品表 (product) -- ---------------------------- DROP TABLE IF EXISTS `product`; CREATE TABLE `product` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '商品ID', `merchant_id` int NOT NULL COMMENT '所属店铺ID', `category_id` int NOT NULL COMMENT '所属分类ID', `name` varchar(100) NOT NULL COMMENT '商品名称', `image` varchar(255) DEFAULT NULL COMMENT '商品图片URL', `status` tinyint DEFAULT '1' COMMENT '上下架状态:1-上架,0-下架', `base_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '基础原价 (无规格商品以此为准/有规格时做首页展示)', `prod_discount` decimal(3,2) DEFAULT NULL COMMENT '单品折扣 (如0.90表示9折, NULL/1.00为无折扣)', `discount_start` datetime DEFAULT NULL COMMENT '单品折扣开始时间', `discount_end` datetime DEFAULT NULL COMMENT '单品折扣结束时间', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`), KEY `idx_merchant_cat` (`merchant_id`,`category_id`) COMMENT '店铺与分类联合索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='商品表'; -- ---------------------------- -- 4. 商品规格表 (product_spec) -- ---------------------------- DROP TABLE IF EXISTS `product_spec`; CREATE TABLE `product_spec` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '规格ID', `product_id` int NOT NULL COMMENT '所属商品ID', `spec_name` varchar(50) NOT NULL COMMENT '规格名称 (如: 大杯、500g、单件)', `price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '该规格的实际原价', `stock` int DEFAULT '0' COMMENT '规格库存', PRIMARY KEY (`id`), KEY `idx_product_id` (`product_id`) COMMENT '商品ID普通索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='商品规格表'; -- ---------------------------- -- 5. 用户表 (user) -- ---------------------------- DROP TABLE IF EXISTS `user`; CREATE TABLE `user` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '用户ID', `nickname` varchar(50) DEFAULT NULL COMMENT '微信昵称/用户昵称', `avatar` varchar(255) DEFAULT NULL COMMENT '头像URL', `phone` varchar(20) DEFAULT NULL COMMENT '用户手机号', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '注册时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='客户端用户表'; -- ---------------------------- -- 6. 用户收货地址表 (user_address) -- ---------------------------- DROP TABLE IF EXISTS `user_address`; CREATE TABLE `user_address` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '地址ID', `user_id` int NOT NULL COMMENT '所属用户ID', `consignee` varchar(50) NOT NULL COMMENT '收货人姓名', `phone` varchar(20) NOT NULL COMMENT '收货电话', `address_name` varchar(100) NOT NULL COMMENT '定位地址 (如: 某某大学3号楼 / 某某小区东门)', `detail` varchar(100) NOT NULL COMMENT '详细地址 (如: 402室 / 1号门面)', `longitude` decimal(10,7) NOT NULL COMMENT '定位经度 (用于下单时计算是否超出配送范围)', `latitude` decimal(10,7) NOT NULL COMMENT '定位纬度 (用于下单时计算是否超出配送范围)', `is_default` tinyint DEFAULT '0' COMMENT '是否为默认地址:1-是,0-否', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`), KEY `idx_user_id` (`user_id`) COMMENT '用户ID普通索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='用户收货地址表'; -- ---------------------------- -- 7. 订单主表 (order_info) -- ---------------------------- DROP TABLE IF EXISTS `order_info`; CREATE TABLE `order_info` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '订单ID', `order_sn` varchar(32) NOT NULL COMMENT '唯一业务订单号 (时间戳+随机数)', `user_id` int NOT NULL COMMENT '下单用户ID', `merchant_id` int NOT NULL COMMENT '接单店铺ID', `total_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '商品总原价 (未打折前的纯商品总价)', `discount_price` decimal(10,2) DEFAULT '0.00' COMMENT '优惠总金额 (折扣减免的金额)', `delivery_fee` decimal(10,2) DEFAULT '0.00' COMMENT '实际配送费 (根据满免规则计算后的最终费用)', `pay_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '实际支付金额 (pay_price = total_price - discount_price + delivery_fee)', `status` tinyint NOT NULL DEFAULT '1' COMMENT '订单状态:1:待接单(已付款), 2:配送中, 3:已完成, 4:商家已拒绝(已退款)', `consignee` varchar(50) NOT NULL COMMENT '收货人快照 (防止用户改地址影响历史订单)', `phone` varchar(20) NOT NULL COMMENT '联系电话快照', `address` varchar(255) NOT NULL COMMENT '完整收货地址快照 (定位+详细地址)', `remark` varchar(200) DEFAULT NULL COMMENT '订单备注/买家留言', `paid_at` datetime DEFAULT NULL COMMENT '付款时间', `accepted_at` datetime DEFAULT NULL COMMENT '商家接单/拒绝时间', `delivered_at` datetime DEFAULT NULL COMMENT '开始配送时间', `completed_at` datetime DEFAULT NULL COMMENT '送达完成时间', `created_at` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '订单创建时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_order_sn` (`order_sn`) COMMENT '订单号唯一索引', KEY `idx_user_merchant` (`user_id`,`merchant_id`) COMMENT '用户与店铺联合查询索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='订单主表'; -- ---------------------------- -- 8. 订单明细表 (order_item) -- ---------------------------- DROP TABLE IF EXISTS `order_item`; CREATE TABLE `order_item` ( `id` int NOT NULL AUTO_INCREMENT COMMENT '明细ID', `order_id` int NOT NULL COMMENT '关联的主订单ID', `product_id` int NOT NULL COMMENT '商品ID', `product_name` varchar(100) NOT NULL COMMENT '下单时商品名称快照', `spec_id` int NOT NULL COMMENT '规格ID', `spec_name` varchar(50) NOT NULL COMMENT '下单时规格名称快照 (如:大杯)', `original_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '下单时该商品规格的原价单价', `actual_price` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '下单时该商品规格的实际折后单价', `quantity` int NOT NULL DEFAULT '1' COMMENT '购买数量', PRIMARY KEY (`id`), KEY `idx_order_id` (`order_id`) COMMENT '订单ID普通索引' ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='订单明细表'; ``` ### 💡 针对你提到的几个特定功能点的技术补充: 1. **多店铺默认分类的快速生成(常见模版):** 当后台有新商家注册成功(往 `merchant` 插入一条记录)后,你可以让后端在代码里循环执行如下语句,直接帮新商家把常用的初始分类生成好: ```sql INSERT INTO `category` (`merchant_id`, `name`, `sort_order`) VALUES (新店铺ID, '新鲜水果', 1), (新店铺ID, '休闲零食', 2), (新店铺ID, '日用百货', 3), (新店铺ID, '饮品雪糕', 4); ``` 2. **折扣二选一(全店 vs 单品):** 在查询商品列表或计算订单价格时,通过 SQL 或后端逻辑判断时间: * 如果 `product.prod_discount` 不为空,且当前时间在 `product.discount_start` 和 `product.discount_end` 之间,优先应用**单品折扣**。 * 否则,再去检查 `merchant.store_discount` 是否在有效期内,如果在,则应用**全店折扣**。 token 双 Token + 无感刷新 ✅ 最好 ✅ 最好 推荐 Access Token + Refresh Token(双 Token) 3. **距离超限拦截:** 用户选择地址后,前端(或后端下单接口)根据 `user_address` 中的 `longitude, latitude` 和 `merchant` 表中的 `longitude, latitude` 进行经纬度直线距离计算。如果计算出的公里数大于 `merchant.delivery_radius`,前端直接置灰下单按钮,或者后端接口直接抛出 `“超出商家自配送范围”` 错误。