Prechádzať zdrojové kódy

📝 docs(database): add order_record table documentation

- add SQL definition for order_record table
- add detailed field descriptions for each column
- add index explanation including primary key and regular indexes
- document order_status field values (0-未处理,1-已完成)
- include soft delete support with is_deleted field
yourname 8 mesiacov pred
rodič
commit
b7aab2d5d7
1 zmenil súbory, kde vykonal 45 pridanie a 1 odobranie
  1. 45 1
      docs/new_db.md

+ 45 - 1
docs/new_db.md

@@ -252,4 +252,48 @@ CREATE TABLE logfile (
 6. **状态字段**:
 6. **状态字段**:
    - 使用TINYINT类型存储状态信息
    - 使用TINYINT类型存储状态信息
    - 在注释中明确说明状态取值含义
    - 在注释中明确说明状态取值含义
-   - 统一添加is_deleted字段支持逻辑删除
+   - 统一添加is_deleted字段支持逻辑删除
+
+## 订单记录表 (order_record)
+
+```sql
+CREATE TABLE `order_record` (
+  `id` int unsigned NOT NULL AUTO_INCREMENT COMMENT '记录ID',
+  `company_name` varchar(255) NOT NULL COMMENT '公司名称',
+  `order_number` varchar(50) NOT NULL COMMENT '订单编号',
+  `contact_person` varchar(50) NOT NULL COMMENT '联系人',
+  `order_date` date NOT NULL COMMENT '下单日期',
+  `delivery_date` date DEFAULT NULL COMMENT '交单日期',
+  `advance_payment` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '预付款',
+  `order_amount` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '订单金额',
+  `order_status` tinyint NOT NULL DEFAULT '0' COMMENT '订单状态(0-未处理,1-已完成)',
+  `salesperson` varchar(50) NOT NULL COMMENT '业务员',
+  `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '录入时间',
+  `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  `is_deleted` tinyint NOT NULL DEFAULT '0' COMMENT '删除状态(0-未删除,1-已删除)',
+  PRIMARY KEY (`id`),
+  KEY `idx_order_number` (`order_number`),
+  KEY `idx_company_name` (`company_name`),
+  KEY `idx_order_date` (`order_date`),
+  KEY `idx_order_status` (`order_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单记录表';
+```
+
+### 字段说明
+- `id`: 自增主键ID
+- `company_name`: 客户公司名称
+- `order_number`: 订单编号,业务系统生成的唯一编号
+- `contact_person`: 客户联系人姓名
+- `order_date`: 下单日期
+- `delivery_date`: 交单日期,可为空
+- `advance_payment`: 预付款金额,默认0.00
+- `order_amount`: 订单总金额,默认0.00
+- `order_status`: 订单状态,0表示未处理,1表示已完成
+- `salesperson`: 负责的业务员姓名
+- `created_at`: 记录创建时间(录入时间)
+- `updated_at`: 记录更新时间
+- `is_deleted`: 软删除标志,0表示未删除,1表示已删除
+
+### 索引说明
+- 主键索引: `id`
+- 普通索引: `order_number`(订单编号), `company_name`(公司名称), `order_date`(下单日期), `order_status`(订单状态)