init

docs/database/07-return/wms_return_order.sql

@@ -0,0 +1,23 @@
+-- 表：wms_return_order
+-- 用途：退货单。客户退回仓库的单据。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：良品重新入库与报废都通过库存流水入账，biz_type 分别为 return_restock、scrap，不另建报废单。
+
+CREATE TABLE `wms_return_order` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `return_no` VARCHAR(64) NOT NULL COMMENT '退货单号，租户内唯一',
+  `warehouse_code` VARCHAR(32) NOT NULL COMMENT '仓库编码',
+  `customer_code` VARCHAR(32) NOT NULL COMMENT '货主编码',
+  `order_no` VARCHAR(64) NULL COMMENT '原订单号，无原单退货为 NULL',
+  `status` VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT 'draft 草稿，receiving 收货中，qc 质检中，completed 已完成，cancelled 已取消',
+  `remark` VARCHAR(500) NOT NULL DEFAULT '' COMMENT '备注',
+  `created_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '创建人 user_code，系统任务为空',
+  `updated_by` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '更新人 user_code',
+  `created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  `updated_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_tenant_return_no` (`tenant_code`, `return_no`),
+  KEY `idx_tenant_wh_status` (`tenant_code`, `warehouse_code`, `status`),
+  KEY `idx_tenant_order` (`tenant_code`, `order_no`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='退货单';

docs/database/07-return/wms_return_order_item.sql

@@ -0,0 +1,25 @@
+-- 表：wms_return_order_item
+-- 用途：退货明细。退货数量、质检结论和处置方式。
+-- 约定：InnoDB / utf8mb4 / 无外键，表间按业务编码关联。详见 docs/database/00-conventions.md
+-- 说明：重新入库增加良品库位 available；报废增加 damaged 或直接按报废出账，两种都写流水。
+
+CREATE TABLE `wms_return_order_item` (
+  `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '内部主键',
+  `tenant_code` VARCHAR(32) NOT NULL COMMENT '租户编码',
+  `return_no` VARCHAR(64) NOT NULL COMMENT '退货单号',
+  `line_no` INT UNSIGNED NOT NULL COMMENT '行号',
+  `sku_code` VARCHAR(64) NOT NULL COMMENT 'SKU 编码',
+  `sku_name` VARCHAR(128) NOT NULL DEFAULT '' COMMENT 'SKU 名称快照',
+  `qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '预报退货数量',
+  `received_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '实收数量',
+  `qc_result` VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT 'pending 待检，good 良品，damaged 残损',
+  `disposition` VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT 'pending 待定，restock 重新入库，scrap 报废',
+  `restock_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '已重新入库数量',
+  `scrap_qty` DECIMAL(16,4) NOT NULL DEFAULT 0.0000 COMMENT '已报废数量',
+  `created_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) COMMENT '创建时间',
+  `updated_at` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3) COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_tenant_return_line` (`tenant_code`, `return_no`, `line_no`),
+  KEY `idx_tenant_sku` (`tenant_code`, `sku_code`),
+  CONSTRAINT `chk_return_item_qty` CHECK (`qty` >= 0 AND `received_qty` >= 0 AND `restock_qty` >= 0 AND `scrap_qty` >= 0 AND `restock_qty` + `scrap_qty` <= `received_qty`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='退货明细';