# 数据库模型（Yoone Subscriptions）

本插件新增一个独立的数据库模型目录 `includes/models/`，用于管理用户订阅实例的持久化数据。当前实现增加了基础表结构与 CRUD 接口，方便未来接入续订、暂停、取消等业务。

## 表结构

表名：`{wp_prefix}yoone_subscriptions`

字段：
- `id` bigint(20) unsigned 主键，自增
- `user_id` bigint(20) unsigned 用户ID（WP用户）
- `product_id` bigint(20) unsigned 产品ID（WooCommerce 产品）
- `period` varchar(10) 订阅周期：`month` 或 `year`
- `qty` int(11) unsigned 订阅数量（每周期数量）
- `price_per_cycle` decimal(18,8) 每周期价格（不含周期系数；年周期计算会乘以 12）
- `status` varchar(20) 订阅状态（如 `active`、`paused`、`canceled`，当前未做枚举限制）
- `start_date` datetime 订阅开始时间
- `next_renewal_date` datetime 下次续订时间（可空）
- `created_at` datetime 创建时间
- `updated_at` datetime 更新时间

索引：
- `user_id`
- `product_id`
- `status`

安装：在插件激活时调用安装逻辑创建/升级表结构（使用 `dbDelta`）。

## 目录与类

- 目录：`wp-content/plugins/yoone-subscriptions/includes/models/`
- 类：`Yoone_Subscriptions_DB`（文件：`class-yoone-subscriptions-db.php`）

主要方法：
- `Yoone_Subscriptions_DB::install()` 创建/升级表结构
- `Yoone_Subscriptions_DB::create(array $data)` 插入订阅实例，返回插入ID
- `Yoone_Subscriptions_DB::update(int $id, array $data)` 更新订阅实例
- `Yoone_Subscriptions_DB::get(int $id)` 获取单条订阅实例
- `Yoone_Subscriptions_DB::get_by_user(int $user_id, array $args = [])` 获取某用户的订阅实例列表

## 与现有逻辑的关系

目前产品的订阅计划配置（是否启用、周期、默认数量、每周期价格、是否允许一次性购买）仍存储在产品 `postmeta` 中，见 `Yoone_Subscriptions::get_config()`。

新增数据库模型仅作为“用户订阅实例”的数据持久层，暂未在前端流程中自动写入。待未来接入续订与周期性扣费时，可在下单或激活订阅时创建实例，并结合定时任务（`wp_cron`）或队列进行续订处理。

## 下一步建议

- 在结账成功（`woocommerce_checkout_order_processed` 或 `woocommerce_order_status_changed`）时，根据订单行项目写入订阅实例。
- 增加状态枚举与状态迁移方法（active→paused→canceled），以及日志记录。
- 增加管理后台页面展示用户订阅列表（可筛选用户、产品、状态），支持手动操作。
- 结合支付网关对接续订扣费逻辑，写入 `next_renewal_date` 并在到期前触发续订流程。