# glass-v2 到 glass 迁移分析

## 📊 项目对比

### glass（主项目）
**已完成**:
- ✅ 多租户核心架构
- ✅ SuperAdmin 独立后台
- ✅ 权限管理系统（Spatie + Shield）
- ✅ 客户管理（Customer + Prescription）
- ✅ 订单管理（Order + OrderItem）
- ✅ 简化版产品管理（Product）
- ✅ 供应商管理（Supplier）

### glass-v2（功能增强版）
**额外功能**:
- ✅ 产品分类管理（ProductCategory）
- ✅ 品牌管理（Brand）
- ✅ 采购订单管理（PurchaseOrder + PurchaseOrderItem）
- ✅ 库存流水管理（InventoryTransaction）
- ✅ 员工排班管理（StaffSchedule + Calendar Widget）

---

## 🎯 需要迁移的功能模块

### 1. 产品分类管理 🟢

**迁移文件**:
- `app/Models/ProductCategory.php`
- `app/Filament/Resources/ProductCategories/ProductCategoryResource.php`
- `app/Filament/Resources/ProductCategories/Pages/ManageProductCategories.php`
- `database/migrations/2026_01_31_105640_create_product_categories_table.php`

**数据库表结构**:
```sql
product_categories
- id (bigint, PK)
- name (string, 分类名称)
- slug (string, URL友好标识)
- icon (string, Heroicon图标)
- color (string, 颜色)
- description (text, 描述)
- sort_order (integer, 排序)
- is_active (boolean, 是否启用)
- timestamps
```

**特性**:
- Heroicon 图标支持（37个预定义图标）
- 自动生成 slug
- 关联产品统计
- 预置5个分类：镜架、镜片、隐形眼镜、护理液、配件

---

### 2. 品牌管理 🟢

**迁移文件**:
- `app/Models/Brand.php`
- `app/Filament/Resources/Brands/BrandResource.php`
- `app/Filament/Resources/Brands/Pages/ManageBrands.php`
- `database/migrations/2026_01_31_105643_create_brands_table.php`

**数据库表结构**:
```sql
brands
- id (bigint, PK)
- name (string, 品牌名称)
- slug (string, URL友好标识)
- logo (string, Logo图片)
- description (text, 描述)
- website (string, 官网)
- country (string, 国家/地区)
- sort_order (integer, 排序)
- is_active (boolean, 是否启用)
- timestamps
```

**特性**:
- Logo 上传和显示
- 预置7个品牌：雷朋、暴龙、蔡司、依视路、强生、博士伦、海昌

---

### 3. 采购订单管理 🟢

**迁移文件**:
- `app/Models/PurchaseOrder.php`
- `app/Models/PurchaseOrderItem.php`
- `app/Filament/Resources/PurchaseOrders/PurchaseOrderResource.php`
- `app/Filament/Resources/PurchaseOrders/Pages/ManagePurchaseOrders.php`
- `database/migrations/2026_01_22_063828_create_purchase_orders_table.php`
- `database/migrations/2026_01_22_083144_create_purchase_order_items_table.php`
- `database/migrations/2026_01_28_003412_add_received_quantity_to_purchase_order_items_table.php`

**数据库表结构**:
```sql
purchase_orders
- id (bigint, PK)
- supplier_id (bigint, FK)
- staff_id (bigint, FK)
- reference_no (string, 采购单号)
- status (enum: Draft/Ordered/PartialReceived/Received/Cancelled)
- total_amount (decimal, 总金额)
- note (text, 备注)
- timestamps
- soft_deletes

purchase_order_items
- id (bigint, PK)
- purchase_order_id (bigint, FK)
- product_id (bigint, FK)
- quantity (integer, 订购数量)
- received_quantity (integer, 已收货数量, 默认0)
- unit_cost (decimal, 单位成本)
- total_cost (decimal, 总成本)
- note (text, 备注)
- timestamps
```

**特性**:
- 状态流转：草稿 → 已下订 → 部分收货 → 已收货
- 自动计算总金额
- 收货时更新库存流水
- 待收货项目查询

---

### 4. 库存流水管理 🟢

**迁移文件**:
- `app/Models/InventoryTransaction.php`
- `app/Filament/Resources/InventoryTransactions/InventoryTransactionResource.php`
- `app/Filament/Resources/InventoryTransactions/Pages/ManageInventoryTransactions.php`
- `database/migrations/2026_01_22_063830_create_inventory_transactions_table.php`

**数据库表结构**:
```sql
inventory_transactions
- id (bigint, PK)
- product_id (bigint, FK)
- type (enum: in/out/adjust)
- quantity (integer, 数量)
- reference_type (string, 关联类型)
- reference_id (bigint, 关联ID)
- staff_id (bigint, FK)
- balance_after (integer, 变动后余额)
- timestamps
```

**特性**:
- 多态关联（可关联采购订单、销售订单、盘点等）
- 自动记录库存变动
- 支持入库、出库、调整三种类型

---

### 5. 员工排班管理 🟢

**迁移文件**:
- `app/Models/StaffSchedule.php`
- `app/Filament/Resources/StaffSchedules/StaffScheduleResource.php`
- `app/Filament/Resources/StaffSchedules/Pages/ManageStaffSchedules.php`
- `app/Filament/Resources/StaffSchedules/Widgets/StaffScheduleCalendarWidget.php`
- `database/migrations/2026_01_22_070636_create_staff_schedules_table.php`
- `database/migrations/2026_01_28_002939_add_shift_type_to_staff_schedules_table.php`
- `database/migrations/2026_01_28_004432_make_start_end_datetime_nullable_in_staff_schedules.php`

**数据库表结构**:
```sql
staff_schedules
- id (bigint, PK)
- user_id (bigint, FK)
- shift_type (enum: morning/afternoon/full_day/custom)
- schedule_date (date, 排班日期)
- start_time (time, 开始时间)
- end_time (time, 结束时间)
- start_datetime (datetime, 开始日期时间, 可为null)
- end_datetime (datetime, 结束日期时间, 可为null)
- note (text, 备注)
- is_swap (boolean, 是否调班)
- swapped_with_user_id (bigint, FK, 调班对象)
- timestamps
```

**特性**:
- 预定义班次：早班(9-16)、下午班(16-21)、全天(9-21)、自定义
- 日历视图 Widget
- 实时在岗查询
- 支持调班功能

---

## 🔍 差异分析

### glass 项目已有的结构

**Product 模型**（简化版）:
```php
- id
- team_id (FK)
- code (产品编码)
- name (产品名称)
- category (string, 旧字段)
- brand (string, 旧字段)
- type (enum: frame/lens/accessory)
- description (text)
- cost_price (decimal)
- retail_price (decimal)
- stock_quantity (integer)
- status (enum: active/inactive/discontinued)
- timestamps
- soft_deletes
```

### glass-v2 的增强

**Product 模型**（增强版）:
```php
// 新增字段
product_category_id (bigint, FK)  // 替代 category
brand_id (bigint, FK)            // 替代 brand
```

**需要修改**:
- 将 `category` 和 `brand` 字段改为外键关联
- 添加 BelongsToTenant trait（确保数据隔离）

---

## ⚠️ 迁移注意事项

### 1. 数据兼容性

**问题**: glass 项目已有 `products` 表，字段为 `category` (string) 和 `brand` (string)

**解决方案**:
- 创建迁移添加 `product_category_id` 和 `brand_id` 字段
- 保留旧字段用于数据迁移
- 数据迁移后可删除旧字段

### 2. 多租户隔离

**问题**: v2 的模型没有使用 `BelongsToTenant` trait

**解决方案**:
- 为所有新模型添加 `BelongsToTenant` trait
- 为所有表添加 `team_id` 字段和索引

### 3. 外键约束

**问题**: v2 的外键可能没有级联删除设置

**解决方案**:
- 供应商删除 → 采购订单设为 null
- 产品删除 → 库存流水设为 null
- 分类/品牌删除 → 产品外键设为 null

### 4. 中文本地化

**状态**: glass 项目已有 `lang/zh_CN.json`

**需要添加**:
- 采购订单相关术语
- 库存管理相关术语
- 排班管理相关术语

---

## 📋 迁移计划

### 阶段 1: 数据库结构迁移（30分钟）
1. 复制所有迁移文件到 glass 项目
2. 修改迁移添加 `team_id` 字段
3. 运行迁移

### 阶段 2: 模型迁移（45分钟）
1. 复制所有模型文件到 glass 项目
2. 为所有模型添加 `BelongsToTenant` trait
3. 更新 Product 模型关联关系
4. 测试模型关系

### 阶段 3: Filament 资源迁移（1小时）
1. 复制所有 Resource 文件到 glass 项目
2. 添加多租户中间件配置
3. 添加权限控制
4. 调整导航和分组

### 阶段 4: 数据本地化和 Seeder（30分钟）
1. 创建 ProductCategoryAndBrandSeeder
2. 添加中文翻译
3. 填充预置数据

### 阶段 5: 测试和调试（30分钟）
1. 测试 CRUD 操作
2. 测试权限隔离
3. 测试跨租户数据隔离
4. 修复发现的问题

**总预计时间**: 3小时

---

## 🚀 开始迁移

准备开始迁移工作！

---

美羊羊 🐑