# 运费模板扩展 - 源代码说明

## 目录结构

```
src/
├── Entity/                    # 实体类
│   ├── ShippingTemplateEntity.php     # 运费模板实体类
│   └── ShippingTemplateRuleEntity.php # 运费模板规则实体类
├── Enum/                      # 枚举类
│   ├── ShippingTemplateAreaTypeEnum.php    # 区域类型枚举
│   ├── ShippingTemplateCalcMethodEnum.php  # 计费方式枚举
│   └── ShippingTemplateStatusEnum.php      # 模板状态枚举
├── Model/                     # 模型类
│   ├── ShippingTemplateModel.php      # 运费模板模型类
│   └── ShippingTemplateRuleModel.php  # 运费模板规则模型类
└── Extension.php              # 扩展入口文件
```

## 类说明

### 枚举类 (Enum)

1. **ShippingTemplateStatusEnum** - 运费模板状态枚举
   - DISABLED (0): 禁用
   - ENABLED (1): 启用

2. **ShippingTemplateCalcMethodEnum** - 计费方式枚举
   - PIECE ('piece'): 按件数计算
   - WEIGHT ('weight'): 按重量计算
   - VOLUME ('volume'): 按体积计算

3. **ShippingTemplateAreaTypeEnum** - 区域类型枚举
   - DEFAULT ('default'): 默认区域
   - SPECIAL ('special'): 特殊区域

### 模型类 (Model)

1. **ShippingTemplateModel** - 运费模板模型
   - 对应数据库表: shipping_templates
   - 主要字段: id, name, calc_method, unit, status, sort 等

2. **ShippingTemplateRuleModel** - 运费模板规则模型
   - 对应数据库表: shipping_template_rules
   - 主要字段: id, template_id, first, first_price, next_price, area_type, regions 等

### 实体类 (Entity)

1. **ShippingTemplateEntity** - 运费模板实体
   - 继承 BaseEntity
   - 关联 ShippingTemplateModel

2. **ShippingTemplateRuleEntity** - 运费模板规则实体
   - 继承 BaseEntity
   - 关联 ShippingTemplateRuleModel

## 使用示例

```php
use SixShop\ShippingTemplate\Entity\ShippingTemplateEntity;

// 创建运费模板
$template = new ShippingTemplateEntity();
$template->name = '全国包邮模板';
$template->calc_method = 'piece';
$template->unit = '件';
$template->status = 1;
$template->save();

// 查询运费模板
$template = ShippingTemplateEntity::find(1);
echo $template->name;
```