# Kylin Pet Package

智慧宠物服务系统 — 宠物业务核心扩展包，提供预约、寄养、健康提醒、库存管理功能，符合宠物行业国家标准。

## 功能特性

### 预约服务（AppointmentService）
- 预约创建、状态流转、冲突检测
- `AppointmentStatus` 状态机（待确认/已确认/已取消/已完成/已过期）
- `ServiceType` 服务类型（诊疗/美容/寄养/疫苗）
- 时间冲突自动检测

### 寄养管理（BoardingService）
- 寄养登记、入住退房、照护日志
- `PetBoarding` 寄养记录，`BoardingStatus` 状态机
- `PetDisinfectionLog` 消毒记录（依据 GB/T 45204-2025）
- 入住前强制消毒，三级分区管理

### 健康提醒（HealthReminderService）
- 疫苗到期提醒（依据 GB/T 43825-2024）
- 驱虫到期提醒
- 库存预警
- `PetVaccine` 疫苗批号追溯

### 库存管理（InventoryService）
- 采购入库、库存扣减、预警
- 商品/药品/疫苗库存管理

### 宠物档案
- `Pet` 宠物档案，`PetSpecies` 物种分类（犬/猫/异宠）
- `PetMedicalRecord` 诊疗记录（依据 GB/T 45295-2025，16 环节完整覆盖）
- `PetVaccine` 疫苗记录（依据 GB/T 43825-2024，批号追溯）

## 安装

```bash
composer require kylin/pet
php artisan vendor:publish --tag=kylin-pet-config
php artisan vendor:publish --tag=kylin-pet-migrations
php artisan migrate
```

## 使用示例

### 预约服务

```php
use Kylin\Pet\Services\AppointmentService;
use Kylin\Pet\Enums\ServiceType;

// 创建预约
$appointment = $appointmentService->create([
    'pet_id' => $petId,
    'service_type' => ServiceType::Medical,
    'scheduled_at' => '2026-06-20 14:00:00',
    'duration' => 60,
    'notes' => '年度体检',
]);
```

### 寄养管理

```php
use Kylin\Pet\Services\BoardingService;

// 入住寄养（自动创建消毒记录）
$boarding = $boardingService->checkIn([
    'pet_id' => $petId,
    'owner_id' => $ownerId,
    'start_at' => now(),
    'end_at' => now()->addDays(7),
    'area' => 'A',  // 三级分区
]);

// 记录消毒
$boardingService->logDisinfection($boarding->id, [
    'method' => '紫外线',
    'operator' => '张三',
    'disinfected_at' => now(),
]);
```

### 健康提醒

```php
use Kylin\Pet\Services\HealthReminderService;

// 获取到期疫苗提醒
$reminders = $healthReminderService->getVaccineReminders();

// 获取驱虫到期提醒
$dewormingReminders = $healthReminderService->getDewormingReminders();
```

## 数据库表

| 表名 | 说明 |
|------|------|
| `kylin_pets` | 宠物档案表 |
| `kylin_pet_appointments` | 预约记录表 |
| `kylin_pet_boardings` | 寄养记录表 |
| `kylin_pet_disinfection_logs` | 消毒记录表（GB/T 45204-2025） |
| `kylin_pet_medical_records` | 诊疗记录表（GB/T 45295-2025） |
| `kylin_pet_vaccines` | 疫苗记录表（GB/T 43825-2024） |
| `kylin_pet_inventory` | 库存表 |

## 合规标准

| 标准 | 模块 | 要求 |
|------|------|------|
| **GB/T 45204-2025** | 寄养管理 | 入住前消毒记录、三级分区管理 |
| **GB/T 43825-2024** | 疫苗管理 | 疫苗批号追溯、到期提醒 |
| **GB/T 45295-2025** | 诊疗记录 | 16 环节完整覆盖 |
| **GB/T 47217-2026** | 体况评分 | BCS 1-9 分制 |
| **NY/T 4659-2025** | 日常照护 | 四级护理等级 |

## 法律合规

详见 [LEGAL.md](./LEGAL.md)，涵盖：
- 《中华人民共和国动物防疫法》
- 《中华人民共和国畜牧法》
- 《中华人民共和国野生动物保护法》
- 《中华人民共和国个人信息保护法》— 宠物主人信息保护
- GB/T 45204-2025、GB/T 43825-2024、GB/T 45295-2025、GB/T 47217-2026、NY/T 4659-2025

## 依赖

- PHP ^8.5
- Laravel ^13.0
- kylin/core
- kylin/audit-log（审计日志）

## 许可证

私有软件，未经授权禁止使用。
