aijianhua/docs/数据库设计文档.md

# 爱鉴花项目数据库设计文档

## 1. 数据库概述
本项目使用MySQL 8.0+作为主数据库，存储用户、商品、订单、识别记录等核心业务数据。

## 2. 数据库表结构

### 2.1 用户表 (users)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 用户ID | 主键，自增 |
| username | varchar(50) | 用户名 | 唯一索引 |
| email | varchar(100) | 邮箱 | 唯一索引 |
| phone | varchar(20) | 手机号 | 唯一索引 |
| password | varchar(255) | 密码（bcrypt加密） | 非空 |
| real_name | varchar(50) | 真实姓名 | 可空 |
| avatar_url | varchar(255) | 头像URL | 可空 |
| user_type | enum | 用户类型 | 非空 |
| status | tinyint | 状态 | 默认1 |
| last_login | timestamp | 最后登录时间 | 可空 |
| created_at | timestamp | 创建时间 | 默认当前时间 |
| updated_at | timestamp | 更新时间 | 自动更新 |

### 2.2 商品分类表 (categories)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | int | 分类ID | 主键，自增 |
| name | varchar(100) | 分类名称 | 非空 |
| parent_id | int | 父分类ID | 默认0 |
| sort_order | int | 排序 | 默认0 |
| status | tinyint | 状态 | 默认1 |
| created_at | timestamp | 创建时间 | 默认当前时间 |
| updated_at | timestamp | 更新时间 | 自动更新 |

### 2.3 商品表 (products)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 商品ID | 主键，自增 |
| name | varchar(200) | 商品名称 | 非空 |
| category_id | int | 分类ID | 索引 |
| price | decimal(10,2) | 价格 | 非空 |
| stock | int | 库存 | 默认0 |
| image | varchar(255) | 图片URL | 可空 |
| description | text | 商品描述 | 可空 |
| status | tinyint | 状态 | 默认1 |
| created_at | timestamp | 创建时间 | 默认当前时间 |
| updated_at | timestamp | 更新时间 | 自动更新 |

### 2.4 订单表 (orders)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 订单ID | 主键，自增 |
| user_id | bigint | 用户ID | 非空，索引 |
| total_amount | decimal(10,2) | 订单总额 | 非空 |
| payment_status | tinyint | 支付状态 | 默认0 |
| shipping_status | tinyint | 配送状态 | 默认0 |
| shipping_address | text | 配送地址 | 可空 |
| created_at | timestamp | 创建时间 | 默认当前时间 |
| updated_at | timestamp | 更新时间 | 自动更新 |

### 2.5 订单商品表 (order_items)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 订单项ID | 主键，自增 |
| order_id | bigint | 订单ID | 非空，索引 |
| product_id | bigint | 商品ID | 非空，索引 |
| quantity | int | 数量 | 非空 |
| unit_price | decimal(10,2) | 单价 | 非空 |

### 2.6 识别记录表 (identifications)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 记录ID | 主键，自增 |
| user_id | bigint | 用户ID | 非空，索引 |
| image_url | varchar(255) | 图片URL | 非空 |
| result | text | 识别结果 | 可空 |
| confidence | decimal(5,4) | 置信度 | 可空 |
| created_at | timestamp | 创建时间 | 默认当前时间 |

### 2.7 收货地址表 (addresses)
| 字段名 | 类型 | 说明 | 约束 |
|--------|------|------|------|
| id | bigint | 地址ID | 主键，自增 |
| user_id | bigint | 用户ID | 非空，索引 |
| recipient | varchar(100) | 收货人 | 非空 |
| phone | varchar(20) | 手机号 | 非空 |
| address | text | 详细地址 | 非空 |
| is_default | tinyint | 是否默认 | 默认0 |
| created_at | timestamp | 创建时间 | 默认当前时间 |
| updated_at | timestamp | 更新时间 | 自动更新 |

## 3. 索引设计

### 3.1 唯一索引
- users.phone: 手机号唯一索引
- users.email: 邮箱唯一索引
- users.username: 用户名唯一索引

### 3.2 普通索引
- products.category_id: 商品分类索引
- orders.user_id: 订单用户索引
- orders.created_at: 订单时间索引
- identifications.user_id: 识别记录用户索引
- identifications.created_at: 识别时间索引
- addresses.user_id: 地址用户索引

## 4. 测试数据统计

已插入的测试数据：
- 用户数据: 3条
- 商品分类: 7条
- 商品数据: 5条
- 订单数据: 3条
- 订单商品: 4条
- 识别记录: 3条
- 收货地址: 3条

## 5. 数据库变更记录

### 2024-03-15 更新
- 修复用户表缺少last_login字段的问题
- 密码字段使用password，采用bcrypt加密存储
- 增加数据库初始化脚本，包含默认管理员账号（admin/admin123）

## 5. 数据库连接信息

**生产环境**:
- 主机: 129.211.213.226:9527
- 数据库: ajhdata
- 用户名: root
- 密码: aiotAiot123!

**连接池配置**:
- 最大连接数: 200
- 最小连接数: 20
- 超时时间: 30秒

## 6. 字符编码和时区
- 字符编码: UTF8MB4（支持emoji表情）
- 时区设置: 东八区（+08:00）

---
*本文档最后更新: 2024-03-15*
*数据库版本: MySQL 8.0+*