# 数据库表结构说明

## 连接信息验证
数据库连接信息已验证有效：
- 主机: 129.211.213.226
- 端口: 9527
- 用户名: root
密码：aiotAiot123!
- 数据库: niumall

## 表结构详情

### 1. users 表（用户表）
```sql
CREATE TABLE `users` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `openid` varchar(64) NOT NULL UNIQUE,
  `nickname` varchar(50) NOT NULL,
  `avatar` varchar(255),
  `gender` enum('male','female','other'),
  `birthday` datetime,
  `phone` varchar(20) UNIQUE,
  `email` varchar(100) UNIQUE,
  `uuid` varchar(36) UNIQUE,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

### 2. orders 表（订单表）
```sql
CREATE TABLE `orders` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `order_no` varchar(32) NOT NULL UNIQUE,
  `user_id` bigint(20) NOT NULL,
  `supplier_id` bigint(20) NOT NULL,
  `cattle_type` varchar(50) NOT NULL,
  `cattle_breed` varchar(50) NOT NULL,
  `cattle_count` int(11) NOT NULL,
  `expected_weight` decimal(10,2) NOT NULL,
  `actual_weight` decimal(10,2),
  `unit_price` decimal(10,2) NOT NULL,
  `total_amount` decimal(15,2) NOT NULL,
  `paid_amount` decimal(15,2) NOT NULL DEFAULT '0.00',
  `remaining_amount` decimal(15,2) NOT NULL,
  `status` enum('pending','confirmed','preparing','shipping','delivered','accepted','completed','cancelled','refunded') NOT NULL DEFAULT 'pending',
  `delivery_address` varchar(200) NOT NULL,
  `expected_delivery_date` datetime NOT NULL,
  `actual_delivery_date` datetime,
  `notes` text,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

### 3. payments 表（支付表）
```sql
CREATE TABLE `payments` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `order_id` bigint(20) NOT NULL,
  `user_id` bigint(20) NOT NULL,
  `amount` decimal(15,2) NOT NULL,
  `paid_amount` decimal(15,2),
  `payment_type` enum('wechat','alipay','bank') NOT NULL,
  `payment_method` enum('mini_program','app','web') NOT NULL,
  `payment_no` varchar(50) NOT NULL UNIQUE,
  `third_party_id` varchar(100),
  `status` enum('pending','paid','failed','refunded') DEFAULT 'pending',
  `paid_time` datetime,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

### 4. transports 表（运输表）
```sql
CREATE TABLE `transports` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `order_id` bigint(20) NOT NULL,
  `driver_id` bigint(20) NOT NULL,
  `vehicle_id` bigint(20) NOT NULL,
  `start_location` varchar(255) NOT NULL,
  `end_location` varchar(255) NOT NULL,
  `scheduled_start_time` datetime NOT NULL,
  `actual_start_time` datetime,
  `scheduled_end_time` datetime NOT NULL,
  `actual_end_time` datetime,
  `status` enum('scheduled','in_transit','completed','cancelled') DEFAULT 'scheduled',
  `estimated_arrival_time` datetime,
  `cattle_count` int(11) NOT NULL,
  `special_requirements` text,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_order_id` (`order_id`),
  KEY `idx_driver_id` (`driver_id`),
  KEY `idx_vehicle_id` (`vehicle_id`)
);
```

### 5. suppliers 表（供应商表）
```sql
CREATE TABLE `suppliers` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL,
  `code` varchar(20) NOT NULL UNIQUE,
  `contact` varchar(50) NOT NULL,
  `phone` varchar(20) NOT NULL UNIQUE,
  `address` varchar(200) NOT NULL,
  `business_license` varchar(255),
  `qualification_level` varchar(10) NOT NULL,
  `certifications` json,
  `cattle_types` json,
  `capacity` int(11),
  `rating` decimal(3,2),
  `cooperation_start_date` datetime,
  `status` enum('active','inactive','suspended') DEFAULT 'active',
  `region` varchar(20) NOT NULL,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

### 6. vehicles 表（车辆表）
```sql
CREATE TABLE `vehicles` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `license_plate` varchar(20) NOT NULL UNIQUE,
  `vehicle_type` varchar(50) NOT NULL,
  `capacity` int(11) NOT NULL,
  `driver_id` bigint(20) NOT NULL,
  `status` enum('available','in_use','maintenance','retired') DEFAULT 'available',
  `last_maintenance_date` datetime,
  `next_maintenance_date` datetime,
  `insurance_expiry_date` datetime,
  `registration_expiry_date` datetime,
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

### 7. admins 表（管理员用户表）
```sql
CREATE TABLE `admins` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(50) NOT NULL UNIQUE,
  `password_hash` varchar(255) NOT NULL,
  `phone` varchar(20) NOT NULL UNIQUE,
  `email` varchar(100),
  `user_type` enum('client','supplier','driver','staff','admin') NOT NULL,
  `status` enum('active','inactive','locked') DEFAULT 'active',
  `created_at` datetime NOT NULL,
  `updated_at` datetime NOT NULL,
  `deleted_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
);
```

## 表索引信息

### users 表索引
- PRIMARY: 主键索引 (id)
- openid: 唯一索引
- phone: 唯一索引
- email: 唯一索引
- uuid: 唯一索引

### orders 表索引
- PRIMARY: 主键索引 (id)
- order_no: 唯一索引
- orders_order_no: 唯一索引
- orders_user_id: 普通索引
- orders_supplier_id: 普通索引
- orders_status: 普通索引
- orders_created_at: 普通索引

### payments 表索引
- PRIMARY: 主键索引 (id)
- payment_no: 唯一索引

### suppliers 表索引
- PRIMARY: 主键索引 (id)
- code: 唯一索引
- phone: 唯一索引

### transports 表索引
- PRIMARY: 主键索引 (id)
- idx_order_id: 普通索引
- idx_driver_id: 普通索引
- idx_vehicle_id: 普通索引

### vehicles 表索引
- PRIMARY: 主键索引 (id)
- license_plate: 唯一索引

### admins 表索引
- PRIMARY: 主键索引 (id)
- username: 唯一索引
- phone: 唯一索引

## 表关系说明

1. `users` 表与 `orders` 表通过 `user_id` 字段关联
2. `suppliers` 表与 `orders` 表通过 `supplier_id` 字段关联
3. `orders` 表与 `payments` 表通过 `order_id` 字段关联
4. `users` 表与 `payments` 表通过 `user_id` 字段关联
5. `orders` 表与 `transports` 表通过 `order_id` 字段关联
6. `users` 表与 `transports` 表通过 `driver_id` 字段关联
7. `vehicles` 表与 `transports` 表通过 `vehicle_id` 字段关联
8. `users` 表与 `vehicles` 表通过 `driver_id` 字段关联

## 数据示例

### orders 表数据示例
```json
[
  {
    "id": 1,
    "order_no": "ORD20240520001",
    "user_id": 2,
    "user_name": "采购商",
    "supplier_id": 3,
    "supplier_name": "供应商",
    "trader_id": null,
    "trader_name": null,
    "cattle_breed": "西门塔尔牛",
    "cattle_count": 10,
    "expected_weight": "5000.00",
    "actual_weight": null,
    "unit_price": "35.00",
    "total_amount": "175000.00",
    "paid_amount": "50000.00",
    "remaining_amount": "125000.00",
    "status": "pending",
    "delivery_address": "北京市朝阳区某某路123号",
    "expected_delivery_date": "2024-06-01T00:00:00.000Z",
    "actual_delivery_date": null,
    "notes": "请按时交货，质量要保证",
    "created_at": "2025-09-18T15:04:29.000Z",
    "updated_at": "2025-09-18T15:04:29.000Z",
    "deleted_at": null
  }
]
```

### suppliers 表数据示例
```json
{
  "id": 3,
  "name": "内蒙古草原牧业有限公司",
  "code": "NM001",
  "contact": "张牧",
  "phone": "13800000001",
  "address": "内蒙古自治区呼和浩特市草原牧场1号",
  "business_license": "",
  "qualification_level": "A",
  "certifications": "[]",
  "cattle_types": "[\"西门塔尔牛\",\"夏洛莱牛\"]",
  "capacity": 1000,
  "rating": "0.00",
  "cooperation_start_date": "2025-09-18T15:25:05.000Z",
  "status": "active",
  "region": "north",
  "created_at": "2025-09-18T15:25:05.000Z",
  "updated_at": "2025-09-18T15:25:05.000Z",
  "deleted_at": null
}
```

### admins 表数据示例
```json
{
  "id": 1,
  "username": "admin",
  "password_hash": "$2a$10$yQ2odJuDRDjPwiyT6v/NuO/V0wjTaUx9DlDmHqXwa.hMQ9km0cWPe",
  "phone": "13800138001",
  "email": "admin@niumall.com",
  "user_type": "admin",
  "status": "active",
  "created_at": "2025-09-18T15:04:28.000Z",
  "updated_at": "2025-09-18T15:04:28.000Z",
  "deleted_at": null
}
```

## 使用建议

1. **数据初始化**：当前数据库中已有一些基础数据，包括5个供应商、3个管理员用户和2个订单。在开发过程中可以直接使用这些数据进行测试。

2. **权限管理**：admins 表中包含了不同角色的用户（admin、client、supplier），可以通过 user_type 字段进行权限控制。

3. **订单状态管理**：orders 表中的 status 字段包含了完整的订单状态流程，从 pending（待确认）到 completed（已完成）或 cancelled（已取消）。

4. **索引优化**：已为 `transports` 表添加了 `order_id`、`driver_id`、`vehicle_id` 等字段的索引以提高查询性能。建议继续为经常查询的字段添加索引，如 `orders.status`、`orders.created_at` 等。

5. **字段命名统一**：已完成统一使用下划线命名法，所有字段均采用下划线命名规范，保持了命名一致性。

6. **数据完整性**：可以添加外键约束来保证数据完整性，例如在 `orders` 表中添加外键约束关联 `users` 表和 `suppliers` 表。

7. **扩展性考虑**：已为所有表添加了软删除字段 `deleted_at` 以支持数据恢复功能。

8. **字段类型优化**：部分字段可以考虑使用更合适的类型，例如 `orders.status` 可以使用 TINYINT 类型配合枚举值映射来节省存储空间。