purovps/work_flow_ishare
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

init: iShare Phase D 设计文档完整归档

Browse Source 
文档清单：
- README.md                     仓库导航
- iShare-dev-plan.md            开发规划
- SYSTEM_DESIGN.md              系统设计（角色/流程/接口）
- DATABASE_DESIGN_V2.md         数据库完整字段设计
- DATABASE_DESIGN_OVERVIEW.md   设计概要 v4（28张表）
- DECISIONS.md                  6个关键决策记录
- db/ishare_schema_v2.sql       基础建表 SQL
- db/ishare_schema_v3_delta.sql v2→v3 增量（评审修复）
- db/ishare_schema_v4_delta.sql v3→v4 增量（决策确认）
- memory_2026-02-17.md          工作日志

Phase D 完成：28张表定稿，所有决策已确认
This commit is contained in:
Admin
2026-02-17 13:27:34 +01:00
parent 01df3d8710
commit 2e34dd172b
10 changed files with 2238 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

232
DATABASE_DESIGN_OVERVIEW.md Normal file
View File

@@ -0,0 +1,232 @@
# iShare 数据库设计概要
> 版本：v4（决策确认后最终版）
> 修订时间：2026-02-17
> 完整建表 SQL（v2 基础版）：`db/ishare_schema_v2.sql`
> 增量 SQL：`db/ishare_schema_v3_delta.sql` → `db/ishare_schema_v4_delta.sql`
> 完整字段说明：`DATABASE_DESIGN_V2.md`
> 设计决策记录：`DECISIONS.md`
---
## 一、表总览（28 张表）
### 1.1 App 基础表（复用 PigX，共 9 张）
| # | 表名 | 说明 | 变更 |
|---|------|------|------|
| 1 | `app_user` | 用户 | 追加 `invite_code`、`inviter_id` |
| 2-9 | `app_role` / `app_user_role` / `app_social_details` / `app_article*` / `app_page` / `app_tabbar` | 框架基础 | 沿用 |
### 1.2 业务表（iShare 专属，共 19 张）
#### 平台与产品
| # | 表名 | 说明 | Phase |
|---|------|------|-------|
| 10 | `as_platform_type` | 平台分类 | P1 |
| 11 | `as_platform` | 流媒体平台 | P1 |
| 12 | `as_sub_plan` | 订阅计划 | P1 |
| 13 | `as_sub_payroll` | 付费方案（月/季/年） | P1 |
| 14 | `as_sub_product` | 合租商品（P1仅 type=1 自营） | P1 |
| 15 | `as_product_plan_rel` | 产品-计划 M:N 关联 | P1 |
| 16 | `as_sub_account` | 平台账号凭据（AES 加密） | P1 |
| 17 | `as_sub_product_comment` | 商品评价 | P1 |
| 18 | `as_banner` | 首页 Banner 广告位 | P1 |
#### 订阅与订单
| # | 表名 | 说明 | Phase |
|---|------|------|-------|
| 19 | `as_user_sub` | 合租槽/共享池 | P1 |
| 20 | `as_user_sub_member` | 个人订阅记录（status=4 P2用） | P1 |
| 21 | `as_order` | 订单（三种支付方式，复用 pigx-pay） | P1 |
#### 钱包与推广
| # | 表名 | 说明 | Phase |
|---|------|------|-------|
| 22 | `as_recharge` | 充值单（人工/支付宝/微信） | P1 |
| 23 | `as_wallet` | 用户钱包（乐观锁防并发） | P1 |
| 24 | `as_wallet_log` | 钱包流水（type=5 提现 P2用） | P1 |
| 25 | `as_invite` | 邀请关系与返现记录 | P1 |
| 26 | `as_invite_config` | 邀请返现规则配置（可配置） | P1 |
| 27 | `as_notification` | 系统通知 | P1 |
---
## 二、核心 ER 关系概览
```
as_platform_type (1) ──< (N) as_platform
as_platform (1) ──< (N) as_sub_plan
as_sub_plan (1) ──< (N) as_sub_payroll
as_sub_plan (N) >──< (N) as_sub_product [via as_product_plan_rel]
as_platform (1) ──< (N) as_sub_product [platform_id 冗余]
as_sub_product (1) ──< (N) as_sub_account
as_sub_product (1) ──< (N) as_user_sub
as_user_sub (1) ──< (N) as_user_sub_member
as_sub_product (1) ──< (N) as_order
as_order (1) ──< (1) as_user_sub_member [order_id]
app_user (1) ──< (1) as_wallet
as_wallet (1) ──< (N) as_wallet_log
as_wallet (1) ──< (N) as_recharge [user_id]
app_user (1) ──< (N) as_order
app_user (1) ──< (N) as_recharge
app_user (1) ──< (N) as_user_sub_member
app_user (1) ──< (N) as_invite [as inviter]
app_user (1) ──< (1) as_invite [as invitee]
app_user (1) ──< (N) as_notification
as_invite_config (1:active) ──→ as_invite [规则快照到 reward_amount]
```
---
## 三、关键状态机
### 3.1 订单（as_order）
```
[待支付(0)] ─→ 15min 超时 ─→ [已取消(4)]
[待支付(0)] ─→ 支付成功 ─→ [已支付(1)] ─→ 激活订阅 ─→ [已完成(2)]
[已支付/完成] ─→ 退款 ─→ [已退款(3)]
```
**支付方式：** 1=余额 / 2=支付宝 / 3=微信（均通过 pigx-pay 模块处理）
### 3.2 充值单（as_recharge）
```
人工充值（管理员）: 直接创建 status=1 记录
外部支付：
[待支付(0)] ─→ 支付成功 ─→ [已到账(1)] ─→ as_wallet.balance +amount
─→ 15min 超时 ─→ [已取消(3)]
─→ 支付失败 ─→ [失败(2)]
```
### 3.3 个人订阅（as_user_sub_member）
```
[待激活(0)] ─→ 订单完成 ─→ [使用中(1)]
[使用中(1)] ─→ 到期 ─→ [已到期(2)] ─→ 续费 → 新建记录回到[待激活(0)]
─→ 主动退订 ─→ [已退订(3)]
[Phase2] 拼车广场付款后 → [等待车主录入凭据(4)] → 车主录入 → [使用中(1)]
```
> 续费策略：新建 member 记录，旧记录置为2=已到期（保留历史，便于对账）
### 3.4 合租槽（as_user_sub）
```
[可加入(0)] ─→ 席位满 ─→ [已满(1)]
[可加入/已满] ─→ 到期 ─→ [已到期(2)]
─→ 车主关闭 ─→ [已关闭(3)]
```
---
## 四、关键设计机制
### 4.1 席位超卖防护（乐观锁）
```sql
UPDATE as_user_sub
SET capacity_loaded = capacity_loaded + 1
WHERE id = ? AND capacity_loaded < capacity;
-- affected rows = 0 → 席位已满，拒绝购买
```
### 4.2 账号凭据安全
- 存储：AES-256-GCM 加密，密钥存环境变量不入库
- 查看：**需二次验证（SMS OTP 或密码重输），OTP 存 Redis TTL 5min**
- 返回：服务端解密后返回明文，不记录日志，前端倒计时隐藏
### 4.3 支付集成
- **复用 pigx-pay 模块**（已集成支付宝 + 微信）
- 购买商品 → `as_order`（pay_type 2/3）→ pigx-pay 回调 → 更新订单状态 → 创建 member 记录
- 余额充值 → `as_recharge`（pay_type 2/3）→ pigx-pay 回调 → 更新充值单 → 增加钱包余额
### 4.4 邀请返现（可配置规则）
```
1. 管理后台配置 as_invite_config（选择激活规则）
2. 被邀请人注册 → 写入 as_invite 记录
3. 触发条件满足（首次购买 or 每次购买）
→ 读取当前 is_active=1 的 as_invite_config
→ 计算返现金额（快照到 as_invite.reward_amount）
→ 延迟发放（reward_delay_days 天后）
→ as_wallet_log（type=4）+ as_wallet.balance +reward_amount
```
### 4.5 钱包余额并发控制（乐观锁）
```sql
UPDATE as_wallet
SET balance = balance - ?, version = version + 1
WHERE user_id = ? AND version = ? AND balance >= ?;
-- affected rows = 0 → 并发冲突或余额不足
```
### 4.6 订阅到期定时任务（每日 02:00）
```
1. expire_time < now()+7天 且 status=1 → 推送续费提醒
2. expire_time < now() 且 status=1 → 置 status=2，capacity_loaded -1
3. as_order.expire_time < now() 且 status=0 → 置 status=4（取消）
4. as_recharge.expire_time < now() 且 status=0 → 置 status=3（取消）
```
---
## 五、关键索引清单
| 表 | 索引字段 | 用途 |
|----|---------|------|
| `as_user_sub_member` | `(user_id, status)` | 我的订阅列表 |
| `as_user_sub_member` | `(expire_time, status)` | 定时任务扫描到期 |
| `as_order` | `(user_id, status)` | 用户订单列表 |
| `as_notification` | `(user_id, is_read)` | 未读通知数 |
| `as_user_sub` | `(product_id, status)` | 商品可用合租槽 |
| `as_sub_account` | `(product_id, status)` | 产品账号列表 |
| `as_sub_product` | `(product_type, status)` | 商品分类查询 |
| `as_banner` | `(status, sort_order)` | 首页 Banner |
| `as_recharge` | `(user_id, status)` | 充值记录查询 |
| `as_product_plan_rel` | `(product_id)` / `(plan_id)` | M:N 双向查询 |
| `as_invite_config` | `(is_active)` | 读取当前规则 |
---
## 六、版本变更记录
| 版本 | 变更内容 |
|------|----------|
| v1 | 原版骨架（2023-08，有多项严重缺陷） |
| v2 | 全面修订：修复15项缺陷，新增6张表（23张） |
| v3 | 评审修订：修复7个问题，新增3张表（27张） |
| **v4** | **决策确认：新增 `as_invite_config`（28张），Phase 1/2 范围明确** |
---
## 七、所有待决策项（已全部确认 ✅）
| # | 问题 | 决策 |
|---|------|------|
| 1 | 付费方式一期 | ✅ C - 余额+支付宝+微信（复用 pigx-pay） |
| 2 | 拼车广场 | ✅ C - Phase 1 不做，Phase 2 追加 |
| 3 | 凭据展示 | ✅ B - 二次验证（SMS OTP 或密码重输） |
| 4 | 邀请返现 | ✅ 完全可配置（类型/金额/触发条件），无上限 |
| 5 | M:N 关联 | ✅ v3 已改为 `as_product_plan_rel` |
| 6 | 提现功能 | ✅ B - Phase 2，一期只充值+消费 |
**Phase D（系统设计）✅ 全部完成**
---
*最后更新：2026-02-17 · v4 定稿*

427
DATABASE_DESIGN_V2.md Normal file
View File

@@ -0,0 +1,427 @@
# iShare 数据库设计 v2.0（修订版）
> 基于原版 v1.0（2023-08 骨架）审查后全面修订
> 修订时间: 2026-02-17
> 建表脚本: `db/ishare_schema_v2.sql`
---
## 一、修订说明
### 1.1 原版问题总结
| 类型 | 数量 | 说明 |
|------|------|------|
| 🔴 严重缺陷 | 4 项 | 直接导致核心功能不可用 |
| 🟠 重要问题 | 6 项 | 数据类型错误/查询困难 |
| 🟡 设计缺失 | 5 项 | 运营/安全功能不完整 |
### 1.2 修订内容
| 表名 | 修订类型 | 主要变更 |
|------|----------|----------|
| `as_platform_type` | 补充 | 加 `status`、`del_flag`、时间戳；`sort_order` varchar→int |
| `as_platform` | 补充 | 加 `description`、`status`、`del_flag`、时间戳；`sort_order` varchar→int |
| `as_sub_plan` | 修复+补充 | `platform_id` varchar→**bigint**；`capacity` varchar→**int**；加状态/软删除/时间戳 |
| `as_sub_payroll` | 重构 | `sub_plans`→**`sub_plan_id`**（语义明确）；加 `duration_months`、`original_price`、`is_active`；软删除/时间戳 |
| `as_sub_product` | 修复+补充 | **`Tags`→`tags`**（命名修复）；加 `platform_id`、`cover_image`、`status`、`total_capacity`；`product_type`/`sub_type` Long→**tinyint** |
| `as_sub_account` | 修复+补充 | 4个字段 int→**bigint**；`passwd_salt` int→**varchar(64)**；加 `encrypt_type`、`status`、软删除/时间戳 |
| `as_user_sub` | 语义修订+修复 | 重定义为"合租槽（共享池）"；`remark` int→**varchar**；字段 int→bigint；加 `product_id`、`status`、`expire_time`、软删除/时间戳；`user_id`→`host_user_id`（语义明确）；`main_account`→`account_id` |
| `as_sub_product_comment` | 补充 | 加 `order_id`（购买验证）、`is_anonymous`、`reply_id`（追评）、`del_flag` |
| `as_user_sub_member` | **新增** | 个人订阅记录（原版最大缺失），含 `status`、`start_time`、`expire_time` |
| `as_order` | **新增** | 完整订单表（含状态机、价格快照、支付信息） |
| `as_wallet` | **新增** | 用户钱包（含乐观锁 `version` 防并发） |
| `as_wallet_log` | **新增** | 钱包流水（含 `balance_after` 快照便于对账） |
| `as_invite` | **新增** | 邀请关系与返现 |
| `as_notification` | **新增** | 系统通知（续费提醒/订单/公告/奖励） |
| `app_user` | 追加字段 | 加 `invite_code`（专属邀请码）、`inviter_id` |
---
## 二、表结构（v2.0）
### 2.1 `as_platform_type` — 平台类型
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `name` | varchar(64) NOT NULL | 类型名称（视频/音乐/AI等） |
| `platform_type` | int DEFAULT 0 | 类型编号（0=全部，用于筛选） |
| `sort_order` | int DEFAULT 0 | 排序权重（升序，**原为 varchar**） |
| `status` | tinyint DEFAULT 1 | **新增** 0=禁用, 1=启用 |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` | datetime | **新增** |
| `update_time` | datetime | **新增** |
### 2.2 `as_platform` — 流媒体平台
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `platform_name` | varchar(128) NOT NULL | 平台名称 |
| `platform_type` | int DEFAULT 0 | 关联类型编号 |
| `icon` | varchar(512) | 图标 URL |
| `description` | varchar(512) | **新增** 平台简介 |
| `company` | varchar(128) | 所属公司 |
| `website` | varchar(256) | 官网 |
| `sort_order` | int DEFAULT 0 | 排序（**原为 varchar**） |
| `status` | tinyint DEFAULT 1 | **新增** 0=禁用, 1=启用 |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` | datetime | **新增** |
| `update_time` | datetime | **新增** |
### 2.3 `as_sub_plan` — 订阅计划
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `name` | varchar(128) NOT NULL | 计划名称 |
| `platform_id` | bigint NOT NULL | 所属平台（**原为 varchar，已修复**） |
| `capacity` | int NOT NULL DEFAULT 1 | 席位容量（**原为 varchar，已修复**） |
| `remark` | varchar(256) | 备注 |
| `sort_order` | int DEFAULT 0 | 排序 |
| `status` | tinyint DEFAULT 1 | **新增** 0=禁用, 1=启用 |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` | datetime | **新增** |
| `update_time` | datetime | **新增** |
### 2.4 `as_sub_payroll` — 付费方案
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `sub_plan_id` | bigint NOT NULL | 所属订阅计划（**原 `sub_plans` 注释混乱，已重命名+澄清**） |
| `platform_id` | bigint NOT NULL | 平台ID（冗余） |
| `payroll` | tinyint NOT NULL | 周期: 1=月付, 2=季付, 3=年付 |
| `duration_months` | int NOT NULL | **新增** 实际月数: 1/3/12 |
| `price` | decimal(10,2) | 售价 |
| `original_price` | decimal(10,2) | **新增** 划线价（显示折扣用） |
| `currency` | varchar(8) DEFAULT 'CNY' | 货币单位 |
| `region` | varchar(64) | 适用地区 |
| `is_active` | tinyint DEFAULT 1 | **新增** 0=下架, 1=上架 |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` | datetime | **新增** |
| `update_time` | datetime | **新增** |
### 2.5 `as_sub_product` — 订阅产品（合租商品）
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `title` | varchar(256) NOT NULL | 产品标题 |
| `description` | varchar(1024) | 描述 |
| `cover_image` | varchar(512) | **新增** 封面图 URL |
| `tags` | varchar(256) | 标签（逗号分隔，**原字段名 `Tags` 大写 Bug 已修复**） |
| `platform_id` | bigint NOT NULL | **新增** 所属平台（加速查询） |
| `sub_plan_ids` | varchar(256) | 关联计划ID列表（逗号分隔，保留现状） |
| `product_type` | tinyint NOT NULL DEFAULT 1 | 1=自营, 2=个人（**原为 Long，已修复**） |
| `sub_type` | tinyint NOT NULL DEFAULT 1 | 1=单品, 2=多品组合（**原为 Long，已修复**） |
| `total_capacity` | int NOT NULL DEFAULT 1 | **新增** 总席位数 |
| `amount` | decimal(10,2) | 基准月价 |
| `star` | decimal(3,1) DEFAULT 0.0 | 综合评分（由评价聚合更新） |
| `status` | tinyint NOT NULL DEFAULT 0 | **新增** 0=草稿, 1=上架, 2=下架, 3=售完 |
| `user_id` | bigint | 发布者用户ID |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_by` / `update_by` | varchar(64) | **新增** |
| `create_time` / `update_time` | datetime | |
### 2.6 `as_sub_account` — 平台账号凭据
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `product_id` | bigint | 关联产品ID |
| `sub_plan_id` | bigint | 订阅计划ID（**原 int，已修复**） |
| `sub_payroll_id` | bigint | 付费方案ID（**原 int，已修复**） |
| `platform_id` | bigint NOT NULL | 平台ID（**原 int，已修复**） |
| `user_id` | bigint NOT NULL | 账号持有者（**原 int，已修复**） |
| `account_name` | varchar(256) NOT NULL | 平台登录用户名/邮箱 |
| `account_passwd` | varchar(512) NOT NULL | 加密后的密码 |
| `passwd_salt` | varchar(64) NOT NULL | 加密盐值（**原 int 已修复为 varchar(64)**） |
| `encrypt_type` | tinyint NOT NULL DEFAULT 1 | **新增** 加密算法: 1=AES-256-GCM |
| `region` | varchar(64) | 账号地区 |
| `share_type` | tinyint | 分享类型 |
| `account_type` | tinyint | 账号类型 |
| `renew_date` | datetime | 账号下次续费日 |
| `status` | tinyint NOT NULL DEFAULT 0 | **新增** 0=正常, 1=已失效, 2=异常/被封 |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` / `update_time` | datetime | **新增** |
### 2.7 `as_user_sub` — 合租槽（共享池）
> 语义修订：代表"一个共享席位池"，不代表个人订阅。个人订阅记录见 `as_user_sub_member`。
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `product_id` | bigint NOT NULL | **新增** 关联产品 |
| `plan_id` | bigint NOT NULL | 订阅计划（**原 int，已修复**） |
| `platform_id` | bigint NOT NULL | 平台（冗余） |
| `host_user_id` | bigint NOT NULL | **重命名自 `user_id`**，车主用户ID（语义明确） |
| `account_id` | bigint | **重命名自 `main_account`**，关联凭据（语义明确） |
| `capacity` | int NOT NULL | 总席位数 |
| `capacity_loaded` | int NOT NULL DEFAULT 0 | 已占用席位数 |
| `region` | varchar(64) | 地区 |
| `status` | tinyint NOT NULL DEFAULT 0 | **新增** 0=可加入, 1=已满, 2=已到期, 3=已关闭 |
| `expire_time` | datetime | **新增** 合租槽到期时间 |
| `remark` | varchar(512) | 车主说明（**原 int，已修复为 varchar**） |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` / `update_time` | datetime | **新增** |
### 2.8 `as_sub_product_comment` — 产品评价
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `product_id` | bigint NOT NULL | 关联产品 |
| `user_id` | bigint NOT NULL | 评价用户 |
| `order_id` | bigint | **新增** 关联订单（验证是否购买过） |
| `star` | tinyint NOT NULL | 评分 1-5 |
| `comment` | varchar(1024) | 评价内容 |
| `is_anonymous` | tinyint DEFAULT 0 | **新增** 0=公开, 1=匿名 |
| `reply_id` | bigint | **新增** 回复的评价ID（追评/商家回复） |
| `del_flag` | char(1) DEFAULT '0' | **新增** 软删除 |
| `create_time` / `update_time` | datetime | |
### 2.9 `as_user_sub_member` — 个人订阅记录 【新增，原版最大缺失】
> 原版无此表，导致"哪些用户加入了哪个合租位"完全无法追踪。
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `sub_id` | bigint NOT NULL | 所在合租槽（→ `as_user_sub.id`） |
| `user_id` | bigint NOT NULL | 订阅用户 |
| `order_id` | bigint NOT NULL | 来源订单（→ `as_order.id`） |
| `payroll_id` | bigint NOT NULL | 购买的付费方案 |
| `status` | tinyint NOT NULL DEFAULT 0 | 0=待激活, 1=使用中, 2=已到期, 3=已退订 |
| `start_time` | datetime NOT NULL | 订阅开始时间 |
| `expire_time` | datetime NOT NULL | 订阅到期时间 |
| `del_flag` | char(1) DEFAULT '0' | 软删除 |
| `create_time` / `update_time` | datetime | |
| UK: `(sub_id, user_id)` | — | 同一合租槽同一用户只能有一条有效记录 |
### 2.10 `as_order` — 订单表 【新增】
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `order_no` | varchar(32) UNIQUE | 业务订单号（AS+时间戳+随机） |
| `user_id` | bigint NOT NULL | 购买用户 |
| `product_id` | bigint NOT NULL | 商品 |
| `payroll_id` | bigint NOT NULL | 付费方案 |
| `original_amount` | decimal(10,2) | 原价快照（防价格变动） |
| `discount_amount` | decimal(10,2) DEFAULT 0 | 优惠金额 |
| `amount` | decimal(10,2) | 实付金额 |
| `pay_type` | tinyint | 1=余额, 2=支付宝, 3=微信 |
| `pay_no` | varchar(64) | 第三方支付单号 |
| `status` | tinyint NOT NULL DEFAULT 0 | 0=待支付, 1=已支付, 2=已完成, 3=已退款, 4=已取消 |
| `member_id` | bigint | 关联个人订阅记录（支付后填充） |
| `expire_time` | datetime NOT NULL | 订单过期时间（默认 +15min）|
| `pay_time` | datetime | 实际支付时间 |
| `del_flag` | char(1) DEFAULT '0' | 软删除 |
| `create_time` / `update_time` | datetime | |
**订单状态机：**
```
[待支付] → 15分钟超时 → [已取消]
[待支付] → 支付成功 → [已支付] → 激活订阅 → [已完成]
[已支付/已完成] → 退款 → [已退款]
```
### 2.11 `as_wallet` — 用户钱包 【新增】
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `user_id` | bigint UNIQUE | 用户（一人一钱包） |
| `balance` | decimal(10,2) | 可用余额 |
| `frozen_amount` | decimal(10,2) | 冻结金额 |
| `total_income` | decimal(10,2) | 累计收入 |
| `total_expense` | decimal(10,2) | 累计支出 |
| `version` | int DEFAULT 0 | 乐观锁版本号（防并发余额错误） |
| `create_time` / `update_time` | datetime | |
### 2.12 `as_wallet_log` — 钱包流水 【新增】
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `user_id` | bigint NOT NULL | 用户 |
| `amount` | decimal(10,2) | 金额（正=收入, 负=支出） |
| `type` | tinyint | 1=充值, 2=消费, 3=退款, 4=邀请返现, 5=提现 |
| `order_id` | bigint | 关联订单（可空） |
| `balance_after` | decimal(10,2) | 操作后余额快照（对账用） |
| `remark` | varchar(256) | 说明 |
| `create_time` | datetime | |
### 2.13 `as_invite` — 邀请关系 【新增】
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `inviter_id` | bigint NOT NULL | 邀请人 |
| `invitee_id` | bigint NOT NULL UNIQUE | 被邀请人（一个人只有一条邀请记录） |
| `invite_code` | varchar(16) | 使用的邀请码 |
| `reward_amount` | decimal(10,2) | 返现金额 |
| `reward_status` | tinyint DEFAULT 0 | 0=待发放, 1=已发放, 2=已失效 |
| `reward_time` | datetime | 返现时间 |
| `create_time` | datetime | 注册时间 |
### 2.14 `as_notification` — 系统通知 【新增】
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 主键 |
| `user_id` | bigint NOT NULL | 目标用户（0=全体广播） |
| `title` | varchar(128) | 通知标题 |
| `content` | varchar(1024) | 通知内容 |
| `type` | tinyint | 1=续费提醒, 2=订单通知, 3=系统公告, 4=邀请奖励 |
| `ref_id` | bigint | 关联业务ID（按 type 解析） |
| `is_read` | tinyint DEFAULT 0 | 0=未读, 1=已读 |
| `create_time` | datetime | |
---
## 三、完整 ER 关系图（v2.0）
```
as_platform_type (1) ──< (N) as_platform [platform_type]
as_platform (1) ──< (N) as_sub_plan [platform_id]
as_sub_plan (1) ──< (N) as_sub_payroll [sub_plan_id]
as_sub_plan (N) >──< (N) as_sub_product [sub_plan_ids 逗号分隔]
as_platform (1) ──< (N) as_sub_product [platform_id 冗余]
as_sub_product (1) ──< (N) as_sub_product_comment [product_id]
as_sub_product (1) ──< (N) as_sub_account [product_id]
as_sub_product (1) ──< (N) as_user_sub [product_id]
as_sub_plan (1) ──< (N) as_sub_account [sub_plan_id]
as_sub_payroll (1) ──< (N) as_sub_account [sub_payroll_id]
as_user_sub (1) ──< (N) as_user_sub_member [sub_id] ← 新增关键表
as_order (1) ──< (1) as_user_sub_member [order_id]
as_sub_payroll (1) ──< (N) as_user_sub_member [payroll_id]
as_sub_product (1) ──< (N) as_order [product_id]
as_sub_payroll (1) ──< (N) as_order [payroll_id]
as_order (1) ──< (N) as_wallet_log [order_id]
app_user (1) ──< (1) as_wallet [user_id]
as_wallet (1) ──< (N) as_wallet_log [user_id]
app_user (1) ──< (N) as_order [user_id]
app_user (1) ──< (N) as_user_sub [as host] [host_user_id]
app_user (1) ──< (N) as_user_sub_member [user_id]
app_user (1) ──< (N) as_sub_product [user_id 发布者]
app_user (1) ──< (N) as_sub_account [user_id 持有者]
app_user (1) ──< (N) as_sub_product_comment [user_id]
app_user (1) ──< (N) as_notification [user_id]
app_user (1) ──< (N) as_invite [as inviter] [inviter_id]
app_user (1) ──< (1) as_invite [as invitee] [invitee_id]
```
---
## 四、`as_user_sub_member` 状态机
```
购买成功(order paid)
[待激活] ──────────────→ [使用中]
│
┌───────────┤
│ │
主动退订 到期
│ │
↓ ↓
[已退订] [已到期]
│
续费
│
↓
[使用中]
```
---
## 五、重要设计说明
### 5.1 容量管理与并发控制
**席位超卖防护：**
- `as_sub_product.total_capacity` — 总席位（固定值）
- `as_user_sub.capacity_loaded` — 已占用（购买时 +1，退订/到期时 -1）
- 购买时通过 **乐观锁** 控制：
```sql
UPDATE as_user_sub
SET capacity_loaded = capacity_loaded + 1
WHERE id = ? AND capacity_loaded < capacity
```
更新行数 = 0 则说明已满，拒绝购买
### 5.2 账号凭据加密
- 算法：AES-256-GCM（`encrypt_type = 1`）
- `account_passwd`：密文（Base64 编码）
- `passwd_salt`：随机 IV（16字节，Base64 编码，**原 int 类型错误已修复**）
- 密钥：存于服务端配置/环境变量，不入库
### 5.3 钱包余额并发控制
- `as_wallet.version` 字段实现乐观锁：
```sql
UPDATE as_wallet
SET balance = balance - ?, version = version + 1
WHERE user_id = ? AND version = ? AND balance >= ?
```
更新行数 = 0 则说明并发冲突或余额不足
### 5.4 订阅到期任务
定时任务（建议每日 02:00）：
```
1. 查询 expire_time < now() + 7d 且 status = 1 的 as_user_sub_member
→ 生成 as_notification（type=1，续费提醒）
2. 查询 expire_time < now() 且 status = 1 的 as_user_sub_member
→ UPDATE status = 2（已到期）
→ UPDATE as_user_sub SET capacity_loaded = capacity_loaded - 1
```
### 5.5 评价限制
- 写评价前校验：`as_order` 存在且 `status IN (2,3)` 且 `user_id` 匹配
- `star` 范围 1-5，服务端强制校验
- `as_sub_product.star` 由定时任务或触发器聚合更新（AVG）
---
## 六、数据库表总览（v2.0）
| # | 表名 | 类型 | 状态 |
|---|------|------|------|
| 1 | `app_user` | App基础 | 追加2字段 |
| 2 | `app_role` | App基础 | 沿用 |
| 3 | `app_user_role` | App基础 | 沿用 |
| 4 | `app_social_details` | App基础 | 沿用 |
| 5 | `app_article_category` | App基础 | 沿用 |
| 6 | `app_article` | App基础 | 沿用 |
| 7 | `app_article_collect` | App基础 | 沿用 |
| 8 | `app_page` | App基础 | 沿用 |
| 9 | `app_tabbar` | App基础 | 沿用 |
| 10 | `as_platform_type` | 业务 | 修订 |
| 11 | `as_platform` | 业务 | 修订 |
| 12 | `as_sub_plan` | 业务 | 修订 |
| 13 | `as_sub_payroll` | 业务 | 修订 |
| 14 | `as_sub_product` | 业务 | 修订 |
| 15 | `as_sub_account` | 业务 | 修订 |
| 16 | `as_user_sub` | 业务 | 修订（语义重定义） |
| 17 | `as_sub_product_comment` | 业务 | 修订 |
| 18 | `as_user_sub_member` | 业务 | **新增** |
| 19 | `as_order` | 业务 | **新增** |
| 20 | `as_wallet` | 业务 | **新增** |
| 21 | `as_wallet_log` | 业务 | **新增** |
| 22 | `as_invite` | 业务 | **新增** |
| 23 | `as_notification` | 业务 | **新增** |
合计：9 张 App 基础表 + 14 张业务表 = **23 张表**

108
DECISIONS.md Normal file
View File

@@ -0,0 +1,108 @@
# iShare 设计决策记录
> 决策时间：2026-02-17
> 阶段：Phase D（系统设计）
---
## 决策1：付费方式（一期）
**结论：C — 余额 + 支付宝 + 微信全支持**
**原因：** PigX 框架已集成支付功能，无需自行实现，接入成本低。
**影响：**
- `as_order.pay_type`：1=余额, 2=支付宝, 3=微信 ✅（已支持）
- `as_recharge.pay_type`：同上 ✅
- 支付接入：复用 `pigx-pay` 模块，配置支付宝/微信商户信息即可
---
## 决策2：拼车广场
**结论：C — 一期不做广场，仅平台自营商品**
**原因：** 简化一期功能，降低开发复杂度；拼车广场作为 Phase 2 功能后续追加。
**影响：**
- `as_sub_product.product_type=2`（个人发布）一期不启用
- `as_user_sub_member.status=4`（等待车主录入凭据）一期不启用
- `as_user_sub.host_user_id` 一期始终为平台管理员账号
- 管理后台的"广场审核"模块 Phase 2 再开发
---
## 决策3：账号凭据展示方式
**结论：B — 需二次验证（短信/密码）才能查看**
**原因：** 安全优先，防止他人借用设备盗取账号密码。
**影响：**
- 查看凭据接口前置二次验证步骤
- 验证方式：短信验证码（发到注册手机号）or 账号密码重新输入
- 实现：OTP 存 Redis（TTL 5min），无需额外数据库表
- 凭据展示后建议前端自动隐藏倒计时（UX 优化，非强制）
---
## 决策4：邀请返现规则
**结论：完全可配置，无上限**
| 配置项 | 说明 |
|--------|------|
| 返现类型 | 可配置：固定金额 or 按比例（%） |
| 返现值 | 数字，根据类型解释为金额或百分比 |
| 触发条件 | 可配置：仅首次购买 or 每次购买 |
| 最低订单金额 | 可配置（NULL=不限） |
| 延迟发放天数 | 可配置（0=立即，N天后发放，防退款刷单） |
| 返现上限 | 无上限 |
**影响：**
- 新增 `as_invite_config` 表（管理后台可配置规则，同时启用一套）
- `as_invite.reward_amount` 记录实际发放金额（创建时从当前有效规则快照）
---
## 决策5：`sub_plan_ids` 关联方式
**结论：改为关联表** ✅（已在 v3 执行）
---
## 决策6：提现功能
**结论：B — 二期再做，一期只充值+消费**
**原因：** 提现涉及实名认证、合规审核等复杂流程，MVP 阶段不上线。
**影响：**
- `as_wallet_log.type=5`（提现）一期不启用
- `as_wallet.frozen_amount` 字段保留，一期无写入场景
- 管理后台"提现审核"模块 Phase 2 开发
---
## Phase 1 功能范围（最终确认）
### ✅ Phase 1 包含
- 用户注册/登录（手机/邮箱）
- 首页（Banner + 商品列表）
- 平台自营商品（product_type=1）购买
- 余额 + 支付宝 + 微信支付（复用 pigx-pay）
- 我的订阅 + 账号凭据查看（二次验证）
- 余额充值（支付宝/微信/人工充值）
- 邀请推广 + 可配置返现
- 系统通知（续费提醒/订单通知）
- 管理后台：平台/商品/账号/订单/用户管理
### ❌ Phase 2 延期
- 拼车广场（个人发布 + 审核流程）
- 提现功能
- 微信/社交登录
- 小程序端
---
*决策人：Ami · 2026-02-17*

66
README.md
View File

@@ -1,3 +1,65 @@
# work_flow_ishare
# iShare 项目设计文档归档
iShare 项目工作流程与设计文档归档
> 归档时间：2026-02-17
> 项目：流媒体订阅合租分享平台（Netflix/Spotify 等）
> 技术栈：PigX 5.11.0（Java 17 + Spring Boot 3）二次开发
> 源码仓库：https://git.puro.im/purovps/pigx_ishare
---
## 文档目录
### 系统设计
| 文件 | 说明 |
|------|------|
| `iShare-dev-plan.md` | 项目开发规划（技术路线、仓库规划、开发周期） |
| `SYSTEM_DESIGN.md` | 系统设计文档（角色、功能模块、业务流程、接口要点） |
| `DECISIONS.md` | 设计决策记录（6个关键决策 + Phase 1/2 范围确认） |
### 数据库设计
| 文件 | 说明 |
|------|------|
| `DATABASE_DESIGN_V2.md` | 完整数据库字段设计（28张表详细说明） |
| `DATABASE_DESIGN_OVERVIEW.md` | 数据库设计概要（表总览、ER关系、状态机、设计机制） |
| `db/ishare_schema_v2.sql` | 基础建表 SQL（修订版，23张表） |
| `db/ishare_schema_v3_delta.sql` | v2→v3 增量 SQL（评审修复：新增3张表，补索引） |
| `db/ishare_schema_v4_delta.sql` | v3→v4 增量 SQL（决策确认：新增 as_invite_config） |
### 工作记录
| 文件 | 说明 |
|------|------|
| `memory_2026-02-17.md` | 2026-02-17 工作日志（Phase D 完整过程） |
---
## 版本历史
| Tag | 说明 |
|-----|------|
| `v1-initial-design` | 初步设计（功能清单 + 流程 + 数据库 v2.0） |
| `v2-db-reviewed` | 数据库评审完成（7个问题全部修复，27张表） |
| `v3-phase-d-complete` | Phase D 完成（决策确认，28张表定稿） |
---
## 数据库概览
- **总表数**：28 张（9张 PigX 基础表 + 19张 iShare 业务表）
- **核心新增**：`as_recharge`（充值单）/ `as_banner`（广告位）/ `as_product_plan_rel`（M:N关联）/ `as_invite_config`（返现配置）
## Phase 1 范围（已确认）
✅ 平台自营商品购买 | 三种支付（复用 pigx-pay）| 凭据二次验证 | 可配置邀请返现
❌ 拼车广场（Phase 2）| 提现（Phase 2）
---
## 下一步
**Phase 0：环境搭建**
- 创建 3 个开发仓库（ishare-backend / ishare-admin / ishare-web）
- Fork PigX 5.11.0 + 配置 Drone CI/CD
- 执行建表 SQL，初始化数据库

371
SYSTEM_DESIGN.md Normal file
View File

@@ -0,0 +1,371 @@
# iShare 系统设计文档
> 优先级：最高（先于所有开发任务）
> 版本：v1.0
> 日期：2026-02-17
---
## 一、系统角色
| 角色 | 说明 |
|------|------|
| **普通用户** | 注册登录，购买合租商品，获取账号凭据 |
| **车主（发布者）** | 发布自己的合租位（个人拼车广场） |
| **平台运营（管理员）** | 管理平台数据、自营商品、用户、订单 |
| **超级管理员** | 全局配置，含财务、权限管理 |
---
## 二、功能模块清单
### 2.1 用户端 H5 功能
| 模块 | 功能点 |
|------|--------|
| **账号** | 手机号注册/登录、邮箱注册/登录、找回密码（验证码）、微信/社交登录（二期） |
| **首页** | 平台分类Tab、推荐商品卡片、Banner 广告位、热门合租榜 |
| **商品列表** | 按平台类型筛选、按价格/评分排序、关键词搜索 |
| **商品详情** | 平台介绍、套餐选择（月/季/年）、评价列表、剩余席位数、立即购买 |
| **购买流程** | 选套餐 → 确认订单 → 支付（余额/在线支付）→ 获取账号凭据 |
| **我的订阅** | 当前有效订阅列表、账号凭据查看、续费、退订 |
| **广场/拼车** | 浏览他人发起的合租位、申请加入、发起自己的合租 |
| **推广中心** | 邀请码、邀请记录、返现奖励记录 |
| **钱包** | 余额查看、充值、提现（二期）、流水记录 |
| **通知** | 续费提醒、订单状态变更、系统公告 |
| **个人中心** | 基本信息编辑、头像、安全设置（改密）、退出登录 |
### 2.2 管理后台功能
| 模块 | 功能点 |
|------|--------|
| **平台管理** | 平台CRUD、平台分类CRUD、图标上传 |
| **订阅计划管理** | 计划CRUD、付费方案CRUD（多地区/多货币） |
| **自营商品管理** | 商品CRUD、上下架、库存（账号）管理、绑定账号凭据 |
| **订单管理** | 订单列表、状态查看、人工审核、退款处理 |
| **用户管理** | 用户列表、封禁/解封、余额调整、查看订阅记录 |
| **评价管理** | 评价列表、违规删除 |
| **财务管理** | 收入统计、提现申请审核（二期）、优惠券管理（二期） |
| **通知配置** | 系统通知模板、续费提醒开关 |
| **系统配置** | 站点信息、支付配置、短信/邮件配置 |
---
## 三、核心业务流程
### 3.1 用户注册/登录
```
[用户] → 输入手机/邮箱
→ 获取验证码（短信/邮件）
→ 验证 → 首次登录自动注册 app_user
→ 生成 JWT Token（复用 pigx-auth）
→ 进入首页
```
### 3.2 购买合租商品（核心流程）
```
[用户] → 浏览商品列表（as_sub_product, status=上架）
→ 商品详情页
├── 查看剩余席位 = capacity - capacity_loaded（来自 as_user_sub 聚合）
└── 选择付费方案（as_sub_payroll）
→ 点击"立即购买"
→ 创建订单（as_order, status=待支付）
→ 支付
├── 余额支付 → 扣减 as_wallet.balance
└── 在线支付 → 支付宝/微信回调 → 更新订单状态
→ 支付成功
├── 订单状态 → 已支付 → 使用中
├── 创建 as_user_sub 记录（capacity_loaded +1）
├── 返回账号凭据（as_sub_account 解密后展示）
└── 推送通知（订阅成功）
```
### 3.3 账号凭据查看
```
[用户] → "我的订阅" → 选择订阅
→ 验证身份（二次密码/生物识别，可选）
→ 从 as_sub_account 查询 account_name + account_passwd
→ AES 解密 account_passwd（服务端解密，不返回明文密钥）
→ 展示账号密码（可设置自动隐藏倒计时）
```
### 3.4 订阅到期/续费
```
[定时任务（每日凌晨）]
→ 扫描 as_user_sub.expire_time < now() + 7天
→ 发送续费提醒通知（as_notification）
→ 到期当日：as_user_sub.status = expired
→ capacity_loaded -1（释放席位）
[用户续费]
→ 进入"我的订阅" → 点击续费
→ 选择续费套餐 → 走购买流程（复用）
→ 续费成功：as_user_sub.expire_time 延长
```
### 3.5 广场拼车（个人发布）
```
[车主]
→ 填写合租信息（平台、计划、价格、总席位数、说明）
→ 创建 as_sub_product（product_type=2 个人）
→ 提交审核 → 管理员审核通过 → 上架（status=active）
[拼车者]
→ 广场浏览 → 找到心仪的拼车
→ 申请加入 → 走购买流程
→ 成功后 → 车主将账号凭据录入 as_sub_account
→ 拼车者可查看凭据
```
### 3.6 推广/邀请
```
[用户A] → 分享邀请码/链接
[用户B] → 点击链接注册
→ as_invite 记录（inviter=A, invitee=B）
[用户B首次购买成功]
→ 触发返现奖励
→ as_wallet_log 记录（用户A 获得返现）
→ as_wallet.balance 增加
```
---
## 四、数据库设计（完整版）
### 4.1 现有表评审与修订
#### ⚠️ 现有设计问题
| 表 | 问题 | 修订方案 |
|----|------|----------|
| `as_sub_account` | `passwd_salt` 是 int，不够安全；缺加密字段标记 | 改为 varchar salt，加 `encrypt_type` 字段 |
| `as_sub_account` | 缺 `status` 字段（账号可能失效/被封） | 加 `status`: 0=正常,1=失效,2=异常 |
| `as_user_sub` | 缺 `status`、`start_time`、`expire_time` | 补充状态和时间字段 |
| `as_user_sub` | `remark` 字段类型是 int（应为 varchar） | 改为 varchar |
| `as_sub_product` | 缺 `status`（上架/下架/售完）、`available_seats` | 补充状态和实时剩余席位 |
| `as_sub_product` | `sub_plan_ids` 用逗号分隔（反范式） | 评估是否改为关联表（影响查询） |
| `as_sub_payroll` | 缺促销价/折扣字段 | 加 `original_price`、`discount_rate` |
| `as_platform_type` | `platform_type` 是 int，0=全部 含义混乱 | 改用独立 sort_order + is_all 标志位 |
### 4.2 核心业务表（完整版）
#### 保留现有（修订后）
- `as_platform`
- `as_platform_type`
- `as_sub_plan`
- `as_sub_payroll`（加 original_price, discount_rate）
- `as_sub_account`（加 status, encrypt_type, 改 passwd_salt 为 varchar）
- `as_sub_product`（加 status, available_seats）
- `as_sub_product_comment`
- `as_user_sub`（加 status, start_time, expire_time, 改 remark 为 varchar）
#### 新增表
---
### `as_order` — 订单表
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | 订单ID |
| `order_no` | varchar(32) | 订单号（唯一，业务用） |
| `user_id` | bigint | 购买用户 |
| `product_id` | bigint | 商品ID (as_sub_product) |
| `payroll_id` | bigint | 付费方案ID (as_sub_payroll) |
| `amount` | decimal(10,2) | 实付金额 |
| `original_amount` | decimal(10,2) | 原价 |
| `discount_amount` | decimal(10,2) | 优惠金额 |
| `pay_type` | tinyint | 支付方式: 1=余额, 2=支付宝, 3=微信 |
| `pay_no` | varchar(64) | 第三方支付单号 |
| `status` | tinyint | 0=待支付, 1=已支付, 2=已完成, 3=已退款, 4=已取消 |
| `user_sub_id` | bigint | 关联的用户订阅ID (创建后填充) |
| `remark` | varchar | 备注 |
| `expire_time` | datetime | 订单过期时间（未支付自动取消） |
| `pay_time` | datetime | 支付时间 |
| `create_time` | datetime | |
| `update_time` | datetime | |
---
### `as_wallet` — 用户钱包
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | |
| `user_id` | bigint UNIQUE | 用户ID（一人一钱包） |
| `balance` | decimal(10,2) | 可用余额 |
| `frozen_amount` | decimal(10,2) | 冻结金额（待退款/提现） |
| `total_income` | decimal(10,2) | 累计收入 |
| `total_expense` | decimal(10,2) | 累计支出 |
| `create_time` | datetime | |
| `update_time` | datetime | |
---
### `as_wallet_log` — 钱包流水
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | |
| `user_id` | bigint | 用户ID |
| `amount` | decimal(10,2) | 金额（正=收入，负=支出） |
| `type` | tinyint | 1=充值, 2=消费, 3=退款, 4=邀请返现, 5=提现 |
| `order_id` | bigint | 关联订单ID（可空） |
| `balance_after` | decimal(10,2) | 操作后余额（快照） |
| `remark` | varchar | 说明（如"订阅 Netflix 高级版"） |
| `create_time` | datetime | |
---
### `as_invite` — 邀请关系
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | |
| `inviter_id` | bigint | 邀请人用户ID |
| `invitee_id` | bigint | 被邀请人用户ID |
| `invite_code` | varchar(16) | 使用的邀请码 |
| `reward_amount` | decimal(10,2) | 返现金额 |
| `reward_status` | tinyint | 0=待发放, 1=已发放（首次购买后触发） |
| `create_time` | datetime | |
| `reward_time` | datetime | 返现时间 |
---
### `as_notification` — 通知消息
| 字段 | 类型 | 说明 |
|------|------|------|
| `id` | bigint PK | |
| `user_id` | bigint | 目标用户ID（0=全部用户） |
| `title` | varchar | 通知标题 |
| `content` | varchar | 通知内容 |
| `type` | tinyint | 1=续费提醒, 2=订单通知, 3=系统公告, 4=邀请奖励 |
| `ref_id` | bigint | 关联业务ID（如订单ID、订阅ID） |
| `is_read` | tinyint | 0=未读, 1=已读 |
| `create_time` | datetime | |
---
### `app_user` 字段补充
在现有 PigX 的 `app_user` 表上，补充以下字段（via ALTER）：
| 字段 | 类型 | 说明 |
|------|------|------|
| `invite_code` | varchar(16) UNIQUE | 用户的专属邀请码（注册时生成） |
| `inviter_id` | bigint | 邀请人用户ID（注册时记录） |
---
### 4.3 完整 ER 关系图
```
as_platform_type (1) ──< (N) as_platform [platform_type]
as_platform (1) ──< (N) as_sub_plan [platform_id]
as_sub_plan (1) ──< (N) as_sub_payroll [sub_plans]
as_sub_plan (N) >──< (N) as_sub_product [sub_plan_ids]
as_sub_product (1) ──< (N) as_sub_product_comment [product_id]
as_sub_product (1) ──< (N) as_sub_account [product_id]
as_sub_plan (1) ──< (N) as_sub_account [sub_plan_id]
as_sub_payroll (1) ──< (N) as_sub_account [sub_payroll_id]
as_sub_product (1) ──< (N) as_order [product_id]
as_sub_payroll (1) ──< (N) as_order [payroll_id]
as_order (1) ──< (1) as_user_sub [user_sub_id]
as_sub_plan (1) ──< (N) as_user_sub [plan_id]
as_sub_account (1) ──< (N) as_user_sub [main_account]
app_user (1) ──< (1) as_wallet [user_id]
as_wallet (1) ──< (N) as_wallet_log [user_id]
as_order (1) ──< (N) as_wallet_log [order_id]
app_user (1) ──< (N) as_order [user_id]
app_user (1) ──< (N) as_user_sub [user_id]
app_user (1) ──< (N) as_sub_product [user_id — 发布者]
app_user (1) ──< (N) as_sub_account [user_id — 账号持有者]
app_user (1) ──< (N) as_sub_product_comment [user_id]
app_user (1) ──< (N) as_notification [user_id]
app_user (1) ──< (N) as_invite [as inviter] [inviter_id]
app_user (1) ──< (1) as_invite [as invitee] [invitee_id]
```
### 4.4 `as_user_sub` 状态机
```
购买成功
[pending] ──────→ [active] ──→ 到期 ──→ [expired]
│ │
│ 退款/申请退订 │ 续费
↓ ↓
[cancelled] [active]
```
状态值：0=待激活, 1=使用中, 2=已到期, 3=已退订
### 4.5 `as_order` 状态机
```
[pending] → 15分钟未支付 → [cancelled]
[pending] → 支付成功 → [paid] → 激活订阅成功 → [completed]
[paid/completed] → 退款申请 → 审核通过 → [refunded]
```
---
## 五、接口设计要点
### 5.1 账号凭据安全
- `account_passwd` 使用 **AES-256-GCM** 加密存储
- 密钥由服务端持有（存配置中心/环境变量），不入库
- `passwd_salt` 用于 AES 的 IV（改为 varchar(32)，16字节随机）
- 凭据查看接口：仅限订阅状态为 `active` 的用户，且需校验 `as_user_sub.user_id == currentUser`
- 返回解密后的明文，但 **不记录日志**（防止泄露）
### 5.2 席位并发控制
- 购买时使用 **数据库乐观锁** 或 **Redis 分布式锁** 防止超卖
- `as_sub_product.available_seats` 在下单时 -1（乐观锁 version 字段）
- 订单取消/超时后 +1 回补
### 5.3 价格一致性
- 订单金额在创建时 **快照** 到 `as_order.amount`
- 不依赖付费方案的实时价格（防止价格变动导致差异）
---
## 六、设计待决策项（需 Ami 确认）
| # | 问题 | 选项 |
|---|------|------|
| 1 | 付费方式一期支持哪些？ | A) 仅余额（人工充值）B) 余额+支付宝 C) 三种都支持 |
| 2 | 拼车广场是否需要审核流程？ | A) 管理员审核 B) 自动上架 C) 仅自营，无拼车广场 |
| 3 | 账号凭据展示方式？ | A) 直接明文 B) 需二次验证（短信/密码）C) 限时展示（30s后隐藏）|
| 4 | 邀请返现比例和条件？ | 需定义：返现金额/比例，是否有上限 |
| 5 | `as_sub_product` 的多计划关联是否改为关联表？ | A) 保持逗号分隔（简单）B) 改关联表（规范，便于查询）|
| 6 | 提现功能是否一期上线？ | A) 一期上 B) 二期（一期只充值不提现）|
---
## 七、调整后的项目阶段
| 阶段 | 内容 | 时间 |
|------|------|------|
| **Phase D（当前·最高优先）** | 系统设计：功能清单 + 业务流程 + 数据库设计 | 进行中 |
| **Phase 0** | 环境搭建：仓库 + Fork PigX + CI/CD + 建库 SQL | D 完成后 |
| **Phase 1** | 后端核心 CRUD API | 1-2周 |
| **Phase 2** | 管理后台前端 | 1周 |
| **Phase 3** | 用户端 H5 | 2-3周 |
| **Phase 4** | 支付集成 | 按需 |
| **Phase 5** | 测试 + 上线 | — |

370
db/ishare_schema_v2.sql Normal file
View File

@@ -0,0 +1,370 @@
-- ============================================================
-- iShare 数据库设计 v2.0（修订版）
-- 修订时间: 2026-02-17
-- 修订说明: 修复原版缺陷，补充完整业务字段和新增表
-- 数据库: pigxx_app
-- ============================================================
USE pigxx_app;
SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;
-- ============================================================
-- 一、App 基础表（沿用原版，仅 app_user 追加字段）
-- ============================================================
-- app_user 追加字段（ALTER，不重建表）
ALTER TABLE `app_user`
ADD COLUMN IF NOT EXISTS `invite_code` varchar(16) UNIQUE COMMENT '用户专属邀请码（注册时生成）' AFTER `email`,
ADD COLUMN IF NOT EXISTS `inviter_id` bigint DEFAULT NULL COMMENT '邀请人用户ID' AFTER `invite_code`;
-- ============================================================
-- 二、iShare 核心业务表（修订版，8 张原表 + 新增 6 张）
-- ============================================================
-- ------------------------------------------------------------
-- 2.1 as_platform_type — 平台类型
-- 修订: 加 status、del_flag、create_time/update_time
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_platform_type`;
CREATE TABLE `as_platform_type` (
`id` bigint NOT NULL COMMENT '主键',
`name` varchar(64) NOT NULL COMMENT '类型名称（视频/音乐/AI等）',
`platform_type` int NOT NULL DEFAULT 0 COMMENT '类型编号（用于分类筛选），0=全部',
`sort_order` int NOT NULL DEFAULT 0 COMMENT '排序权重（升序）',
`status` tinyint NOT NULL DEFAULT 1 COMMENT '状态: 0=禁用, 1=启用',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_platform_type` (`platform_type`),
KEY `idx_sort` (`sort_order`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='平台类型表';
-- ------------------------------------------------------------
-- 2.2 as_platform — 流媒体平台
-- 修订: 加 description、status、del_flag、create_time/update_time
-- sort_order 从 varchar 改为 int
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_platform`;
CREATE TABLE `as_platform` (
`id` bigint NOT NULL COMMENT '主键',
`platform_name` varchar(128) NOT NULL COMMENT '平台名称',
`platform_type` int NOT NULL DEFAULT 0 COMMENT '平台类型（关联 as_platform_type.platform_type）',
`icon` varchar(512) DEFAULT NULL COMMENT '应用图标 URL',
`description` varchar(512) DEFAULT NULL COMMENT '平台简介',
`company` varchar(128) DEFAULT NULL COMMENT '所属公司',
`website` varchar(256) DEFAULT NULL COMMENT '平台官网',
`sort_order` int NOT NULL DEFAULT 0 COMMENT '排序权重（升序）',
`status` tinyint NOT NULL DEFAULT 1 COMMENT '状态: 0=禁用, 1=启用',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_platform_type` (`platform_type`),
KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流媒体平台表';
-- ------------------------------------------------------------
-- 2.3 as_sub_plan — 订阅计划
-- 修订: platform_id varchar→bigint, capacity varchar→int
-- 加 status、del_flag、create_time/update_time
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_sub_plan`;
CREATE TABLE `as_sub_plan` (
`id` bigint NOT NULL COMMENT '计划ID',
`name` varchar(128) NOT NULL COMMENT '计划名称（标准版/高级版等）',
`platform_id` bigint NOT NULL COMMENT '所属平台ID（→ as_platform.id）',
`capacity` int NOT NULL DEFAULT 1 COMMENT '席位容量（该计划最多可共享人数）',
`remark` varchar(256) DEFAULT NULL COMMENT '备注',
`sort_order` int NOT NULL DEFAULT 0 COMMENT '排序权重（升序）',
`status` tinyint NOT NULL DEFAULT 1 COMMENT '状态: 0=禁用, 1=启用',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_platform_id` (`platform_id`),
KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='订阅计划表';
-- ------------------------------------------------------------
-- 2.4 as_sub_payroll — 付费方案
-- 修订: sub_plans(Long,注释混乱) → sub_plan_id(bigint,明确1:1)
-- 加 duration_months、original_price、is_active
-- del_flag、create_time/update_time
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_sub_payroll`;
CREATE TABLE `as_sub_payroll` (
`id` bigint NOT NULL COMMENT '主键',
`sub_plan_id` bigint NOT NULL COMMENT '所属订阅计划ID（→ as_sub_plan.id）',
`platform_id` bigint NOT NULL COMMENT '平台ID（冗余，便于查询）',
`payroll` tinyint NOT NULL COMMENT '付费周期: 1=月付, 2=季付, 3=年付',
`duration_months` int NOT NULL COMMENT '实际月数: 1/3/12（与 payroll 对应）',
`price` decimal(10,2) NOT NULL COMMENT '售价',
`original_price` decimal(10,2) DEFAULT NULL COMMENT '划线价（原价，用于展示折扣）',
`currency` varchar(8) NOT NULL DEFAULT 'CNY' COMMENT '货币单位（CNY/USD等）',
`region` varchar(64) DEFAULT NULL COMMENT '适用地区',
`is_active` tinyint NOT NULL DEFAULT 1 COMMENT '是否上架: 0=下架, 1=上架',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_sub_plan_id` (`sub_plan_id`),
KEY `idx_platform_id` (`platform_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='付费方案表';
-- ------------------------------------------------------------
-- 2.5 as_sub_product — 订阅产品（合租商品）
-- 修订: Tags→tags(命名修复), 加 platform_id、status、cover_image
-- product_type/sub_type 从 Long 改为 tinyint
-- 加 total_capacity、del_flag、create_by/update_by
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_sub_product`;
CREATE TABLE `as_sub_product` (
`id` bigint NOT NULL COMMENT '主键',
`title` varchar(256) NOT NULL COMMENT '产品标题',
`description` varchar(1024) DEFAULT NULL COMMENT '产品描述',
`cover_image` varchar(512) DEFAULT NULL COMMENT '封面图 URL',
`tags` varchar(256) DEFAULT NULL COMMENT '标签（逗号分隔）',
`platform_id` bigint NOT NULL COMMENT '所属平台ID（→ as_platform.id，冗余加速查询）',
`sub_plan_ids` varchar(256) DEFAULT NULL COMMENT '关联订阅计划ID列表（逗号分隔）',
`product_type` tinyint NOT NULL DEFAULT 1 COMMENT '产品类型: 1=自营, 2=个人',
`sub_type` tinyint NOT NULL DEFAULT 1 COMMENT '订阅类型: 1=单品, 2=多品组合',
`total_capacity` int NOT NULL DEFAULT 1 COMMENT '总席位数（该商品可供多少人购买）',
`amount` decimal(10,2) DEFAULT NULL COMMENT '基准价格（月）',
`star` decimal(3,1) DEFAULT 0.0 COMMENT '综合评分（0.0-5.0，由评价聚合更新）',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=草稿, 1=上架, 2=下架, 3=售完',
`user_id` bigint DEFAULT NULL COMMENT '发布者用户ID（→ app_user.user_id）',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
`update_by` varchar(64) DEFAULT NULL COMMENT '修改人',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_platform_id` (`platform_id`),
KEY `idx_status` (`status`),
KEY `idx_product_type` (`product_type`),
KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='订阅产品表（合租商品）';
-- ------------------------------------------------------------
-- 2.6 as_sub_account — 流媒体平台账号凭据
-- 修订: user_id/sub_plan_id/sub_payroll_id/platform_id int→bigint
-- passwd_salt int→varchar(64,存hex/base64)
-- 加 encrypt_type、status、del_flag、create_time/update_time
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_sub_account`;
CREATE TABLE `as_sub_account` (
`id` bigint NOT NULL COMMENT '主键',
`product_id` bigint DEFAULT NULL COMMENT '关联产品ID（→ as_sub_product.id）',
`sub_plan_id` bigint DEFAULT NULL COMMENT '订阅计划ID（→ as_sub_plan.id）',
`sub_payroll_id` bigint DEFAULT NULL COMMENT '付费方案ID（→ as_sub_payroll.id）',
`platform_id` bigint NOT NULL COMMENT '平台ID（→ as_platform.id）',
`user_id` bigint NOT NULL COMMENT '账号持有者用户ID（主用户，→ app_user.user_id）',
`account_name` varchar(256) NOT NULL COMMENT '平台登录用户名/邮箱',
`account_passwd` varchar(512) NOT NULL COMMENT '平台登录密码（加密存储）',
`passwd_salt` varchar(64) NOT NULL COMMENT '加密盐值（Base64/Hex，16字节随机）',
`encrypt_type` tinyint NOT NULL DEFAULT 1 COMMENT '加密算法: 1=AES-256-GCM',
`region` varchar(64) DEFAULT NULL COMMENT '账号所在地区',
`share_type` tinyint DEFAULT NULL COMMENT '分享类型',
`account_type` tinyint DEFAULT NULL COMMENT '账号类型（主账号/子账号等）',
`renew_date` datetime DEFAULT NULL COMMENT '账号在平台的下次续费日',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '账号状态: 0=正常, 1=已失效, 2=异常/被封',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_product_id` (`product_id`),
KEY `idx_platform_id` (`platform_id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='流媒体平台账号凭据表';
-- ------------------------------------------------------------
-- 2.7 as_user_sub — 合租槽（共享池）
-- 语义修订: 代表"一个合租位池"，不代表个人订阅
-- 修订: remark int→varchar, plan_id/user_id/main_account int→bigint
-- 加 product_id、status、expire_time、del_flag、create_time/update_time
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_user_sub`;
CREATE TABLE `as_user_sub` (
`id` bigint NOT NULL COMMENT '主键',
`product_id` bigint NOT NULL COMMENT '关联产品ID（→ as_sub_product.id）',
`plan_id` bigint NOT NULL COMMENT '订阅计划ID（→ as_sub_plan.id）',
`platform_id` bigint NOT NULL COMMENT '平台ID（冗余，加速查询）',
`host_user_id` bigint NOT NULL COMMENT '车主用户ID（提供账号的一方，→ app_user.user_id）',
`account_id` bigint DEFAULT NULL COMMENT '关联平台账号ID（→ as_sub_account.id）',
`capacity` int NOT NULL COMMENT '总席位数（来自 as_sub_plan.capacity）',
`capacity_loaded` int NOT NULL DEFAULT 0 COMMENT '已占用席位数',
`region` varchar(64) DEFAULT NULL COMMENT '地区',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=可加入, 1=已满, 2=已到期, 3=已关闭',
`expire_time` datetime DEFAULT NULL COMMENT '该合租槽到期时间（来自最晚成员到期时间）',
`remark` varchar(512) DEFAULT NULL COMMENT '备注（车主说明）',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_product_id` (`product_id`),
KEY `idx_plan_id` (`plan_id`),
KEY `idx_host_user_id` (`host_user_id`),
KEY `idx_status` (`status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='合租槽表（共享席位池）';
-- ------------------------------------------------------------
-- 2.8 as_sub_product_comment — 产品评价
-- 修订: 加 del_flag、is_anonymous、reply_id（支持追评）
-- star 字段加注释明确 1-5 范围
-- ------------------------------------------------------------
DROP TABLE IF EXISTS `as_sub_product_comment`;
CREATE TABLE `as_sub_product_comment` (
`id` bigint NOT NULL COMMENT '主键',
`product_id` bigint NOT NULL COMMENT '关联产品ID（→ as_sub_product.id）',
`user_id` bigint NOT NULL COMMENT '评价用户ID（→ app_user.user_id）',
`order_id` bigint DEFAULT NULL COMMENT '关联订单ID（校验是否已购买）',
`star` tinyint NOT NULL COMMENT '评分 1-5（服务端校验范围）',
`comment` varchar(1024) DEFAULT NULL COMMENT '评价内容',
`is_anonymous` tinyint NOT NULL DEFAULT 0 COMMENT '是否匿名: 0=公开, 1=匿名',
`reply_id` bigint DEFAULT NULL COMMENT '回复的评价ID（追评/商家回复，NULL=原始评价）',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_product_id` (`product_id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_reply_id` (`reply_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='产品评价表';
-- ============================================================
-- 三、新增表（原版缺失的核心业务表）
-- ============================================================
-- ------------------------------------------------------------
-- 3.1 as_user_sub_member — 个人订阅记录（原版最大缺失）
-- 语义: 某用户购买加入了某合租槽，追踪个人维度
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_user_sub_member` (
`id` bigint NOT NULL COMMENT '主键',
`sub_id` bigint NOT NULL COMMENT '关联合租槽ID（→ as_user_sub.id）',
`user_id` bigint NOT NULL COMMENT '订阅用户ID（→ app_user.user_id）',
`order_id` bigint NOT NULL COMMENT '关联订单ID（→ as_order.id）',
`payroll_id` bigint NOT NULL COMMENT '购买的付费方案ID（→ as_sub_payroll.id）',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=待激活, 1=使用中, 2=已到期, 3=已退订',
`start_time` datetime NOT NULL COMMENT '订阅开始时间',
`expire_time` datetime NOT NULL COMMENT '订阅到期时间',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_sub_user` (`sub_id`, `user_id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_order_id` (`order_id`),
KEY `idx_status` (`status`),
KEY `idx_expire` (`expire_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='个人订阅记录表';
-- ------------------------------------------------------------
-- 3.2 as_order — 订单表
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_order` (
`id` bigint NOT NULL COMMENT '主键',
`order_no` varchar(32) NOT NULL COMMENT '订单号（业务唯一，格式: AS+时间戳+随机）',
`user_id` bigint NOT NULL COMMENT '购买用户ID（→ app_user.user_id）',
`product_id` bigint NOT NULL COMMENT '商品ID（→ as_sub_product.id）',
`payroll_id` bigint NOT NULL COMMENT '付费方案ID（→ as_sub_payroll.id）',
`original_amount` decimal(10,2) NOT NULL COMMENT '原价（快照，防止价格变动）',
`discount_amount` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '优惠金额',
`amount` decimal(10,2) NOT NULL COMMENT '实付金额',
`pay_type` tinyint DEFAULT NULL COMMENT '支付方式: 1=余额, 2=支付宝, 3=微信支付',
`pay_no` varchar(64) DEFAULT NULL COMMENT '第三方支付单号',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=待支付, 1=已支付, 2=已完成, 3=已退款, 4=已取消',
`member_id` bigint DEFAULT NULL COMMENT '关联个人订阅记录ID（→ as_user_sub_member.id，支付成功后填充）',
`remark` varchar(256) DEFAULT NULL COMMENT '备注',
`expire_time` datetime NOT NULL COMMENT '订单过期时间（未支付自动取消，默认 +15min）',
`pay_time` datetime DEFAULT NULL COMMENT '实际支付时间',
`del_flag` char(1) NOT NULL DEFAULT '0' COMMENT '删除标志: 0=正常, 1=已删除',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_order_no` (`order_no`),
KEY `idx_user_id` (`user_id`),
KEY `idx_product_id` (`product_id`),
KEY `idx_status` (`status`),
KEY `idx_expire` (`expire_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='订单表';
-- ------------------------------------------------------------
-- 3.3 as_wallet — 用户钱包
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_wallet` (
`id` bigint NOT NULL COMMENT '主键',
`user_id` bigint NOT NULL COMMENT '用户ID（→ app_user.user_id，一人一钱包）',
`balance` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '可用余额',
`frozen_amount` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '冻结金额（退款/提现处理中）',
`total_income` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '累计收入',
`total_expense` decimal(10,2) NOT NULL DEFAULT 0.00 COMMENT '累计支出',
`version` int NOT NULL DEFAULT 0 COMMENT '乐观锁版本号（防并发余额错误）',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='用户钱包表';
-- ------------------------------------------------------------
-- 3.4 as_wallet_log — 钱包流水
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_wallet_log` (
`id` bigint NOT NULL COMMENT '主键',
`user_id` bigint NOT NULL COMMENT '用户ID（→ app_user.user_id）',
`amount` decimal(10,2) NOT NULL COMMENT '变动金额（正=收入, 负=支出）',
`type` tinyint NOT NULL COMMENT '类型: 1=充值, 2=消费, 3=退款, 4=邀请返现, 5=提现',
`order_id` bigint DEFAULT NULL COMMENT '关联订单ID（→ as_order.id，可空）',
`balance_after` decimal(10,2) NOT NULL COMMENT '操作后余额（快照，便于对账）',
`remark` varchar(256) DEFAULT NULL COMMENT '说明（如：订阅 Netflix 高级版 3 个月）',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_order_id` (`order_id`),
KEY `idx_type` (`type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='钱包流水表';
-- ------------------------------------------------------------
-- 3.5 as_invite — 邀请关系
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_invite` (
`id` bigint NOT NULL COMMENT '主键',
`inviter_id` bigint NOT NULL COMMENT '邀请人用户ID（→ app_user.user_id）',
`invitee_id` bigint NOT NULL COMMENT '被邀请人用户ID（→ app_user.user_id）',
`invite_code` varchar(16) NOT NULL COMMENT '使用的邀请码',
`reward_amount` decimal(10,2) DEFAULT NULL COMMENT '返现金额（首次购买后确定）',
`reward_status` tinyint NOT NULL DEFAULT 0 COMMENT '返现状态: 0=待发放, 1=已发放, 2=已失效',
`reward_time` datetime DEFAULT NULL COMMENT '返现发放时间',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间（注册时间）',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_invitee` (`invitee_id`),
KEY `idx_inviter_id` (`inviter_id`),
KEY `idx_invite_code` (`invite_code`),
KEY `idx_reward_status` (`reward_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='邀请关系表';
-- ------------------------------------------------------------
-- 3.6 as_notification — 系统通知
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `as_notification` (
`id` bigint NOT NULL COMMENT '主键',
`user_id` bigint NOT NULL COMMENT '目标用户ID（→ app_user.user_id，0=全体广播）',
`title` varchar(128) NOT NULL COMMENT '通知标题',
`content` varchar(1024) NOT NULL COMMENT '通知内容',
`type` tinyint NOT NULL COMMENT '类型: 1=续费提醒, 2=订单通知, 3=系统公告, 4=邀请奖励',
`ref_id` bigint DEFAULT NULL COMMENT '关联业务ID（订单ID/订阅ID等，按 type 解析）',
`is_read` tinyint NOT NULL DEFAULT 0 COMMENT '是否已读: 0=未读, 1=已读',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
KEY `idx_user_id` (`user_id`),
KEY `idx_is_read` (`is_read`),
KEY `idx_type` (`type`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='系统通知表';
SET FOREIGN_KEY_CHECKS = 1;

129
db/ishare_schema_v3_delta.sql Normal file
View File

@@ -0,0 +1,129 @@
-- ============================================================
-- iShare 数据库设计 v2 → v3 增量脚本
-- 修订时间: 2026-02-17
-- 处理评审问题: R1, R2, I1, I2, I3(文档), L1, L2
-- ============================================================
USE pigxx_app;
SET NAMES utf8mb4;
-- ============================================================
-- R2: 修复 as_user_sub_member 唯一键问题
-- 原 UNIQUE(sub_id, user_id) 导致续费覆盖历史记录
-- 改为：允许多条记录，逻辑约束同 sub_id+user_id 只有一条 status=1
-- ============================================================
ALTER TABLE `as_user_sub_member`
DROP INDEX IF EXISTS `uk_sub_user`;
-- 补充索引（定时任务/我的订阅高频查询）
ALTER TABLE `as_user_sub_member`
ADD INDEX IF NOT EXISTS `idx_user_status` (`user_id`, `status`),
ADD INDEX IF NOT EXISTS `idx_expire_status` (`expire_time`, `status`);
-- L1: status 增加 4=等待车主录入凭据（广场拼车场景）
-- 注：仅修改注释，逻辑不变；应用层处理状态值
ALTER TABLE `as_user_sub_member`
MODIFY COLUMN `status` tinyint NOT NULL DEFAULT 0
COMMENT '状态: 0=待激活, 1=使用中, 2=已到期, 3=已退订, 4=等待车主录入凭据';
-- ============================================================
-- I2: as_sub_product.sub_plan_ids 逗号分隔改为关联表
-- ============================================================
-- 新增 M:N 关联表
CREATE TABLE IF NOT EXISTS `as_product_plan_rel` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
`product_id` bigint NOT NULL COMMENT '产品ID（→ as_sub_product.id）',
`plan_id` bigint NOT NULL COMMENT '订阅计划ID（→ as_sub_plan.id）',
`sort_order` int NOT NULL DEFAULT 0 COMMENT '排序权重（同产品内多计划的展示顺序）',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_product_plan` (`product_id`, `plan_id`),
KEY `idx_product_id` (`product_id`),
KEY `idx_plan_id` (`plan_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='产品-订阅计划关联表（M:N）';
-- 移除旧的逗号分隔字段
ALTER TABLE `as_sub_product`
DROP COLUMN IF EXISTS `sub_plan_ids`;
-- 补充 as_sub_product 高频查询索引
ALTER TABLE `as_sub_product`
ADD INDEX IF NOT EXISTS `idx_product_type_status` (`product_type`, `status`);
-- ============================================================
-- R1: 新增 as_recharge — 钱包充值单
-- 支持外部支付充值时追踪（待支付→成功→到账）
-- ============================================================
CREATE TABLE IF NOT EXISTS `as_recharge` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
`recharge_no` varchar(32) NOT NULL COMMENT '充值单号（RC+时间戳+随机，业务唯一）',
`user_id` bigint NOT NULL COMMENT '用户ID（→ app_user.user_id）',
`amount` decimal(10,2) NOT NULL COMMENT '充值金额',
`pay_type` tinyint NOT NULL COMMENT '支付方式: 1=人工充值(管理员), 2=支付宝, 3=微信支付',
`pay_no` varchar(64) DEFAULT NULL COMMENT '第三方支付单号（外部支付时回填）',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=待支付, 1=已支付/已到账, 2=支付失败, 3=已取消',
`remark` varchar(256) DEFAULT NULL COMMENT '备注（人工充值时填写原因）',
`operator_id` bigint DEFAULT NULL COMMENT '操作人ID（人工充值时为管理员ID）',
`expire_time` datetime DEFAULT NULL COMMENT '订单过期时间（外部支付时 +15min）',
`pay_time` datetime DEFAULT NULL COMMENT '实际支付/到账时间',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_recharge_no` (`recharge_no`),
KEY `idx_user_id` (`user_id`),
KEY `idx_status` (`status`),
KEY `idx_pay_no` (`pay_no`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='钱包充值单表（含外部支付追踪）';
-- ============================================================
-- I1: 新增 as_banner — 首页广告位/Banner
-- ============================================================
CREATE TABLE IF NOT EXISTS `as_banner` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
`title` varchar(128) NOT NULL COMMENT 'Banner 标题（后台管理用）',
`image_url` varchar(512) NOT NULL COMMENT 'Banner 图片 URL',
`link_type` tinyint NOT NULL DEFAULT 0 COMMENT '跳转类型: 0=无跳转, 1=商品详情, 2=外部链接, 3=平台分类',
`link_target` varchar(512) DEFAULT NULL COMMENT '跳转目标（商品ID/URL/分类ID，按 link_type 解析）',
`sort_order` int NOT NULL DEFAULT 0 COMMENT '排序权重（升序，值小靠前）',
`status` tinyint NOT NULL DEFAULT 0 COMMENT '状态: 0=草稿, 1=展示中, 2=已下线',
`start_time` datetime DEFAULT NULL COMMENT '展示开始时间（NULL=立即生效）',
`end_time` datetime DEFAULT NULL COMMENT '展示结束时间（NULL=长期有效）',
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_status_sort` (`status`, `sort_order`),
KEY `idx_time_range` (`start_time`, `end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='首页 Banner 广告位表';
-- ============================================================
-- L2: 补充关键查询索引
-- ============================================================
-- as_order: 用户订单列表 / 状态过滤
ALTER TABLE `as_order`
ADD INDEX IF NOT EXISTS `idx_user_status` (`user_id`, `status`);
-- as_notification: 未读消息数
ALTER TABLE `as_notification`
ADD INDEX IF NOT EXISTS `idx_user_read` (`user_id`, `is_read`);
-- as_user_sub: 商品下的可用合租槽
ALTER TABLE `as_user_sub`
ADD INDEX IF NOT EXISTS `idx_product_status` (`product_id`, `status`);
-- as_sub_account: 产品下的账号列表
ALTER TABLE `as_sub_account`
ADD INDEX IF NOT EXISTS `idx_product_status` (`product_id`, `status`);
-- ============================================================
-- END
-- ============================================================

59
db/ishare_schema_v4_delta.sql Normal file
View File

@@ -0,0 +1,59 @@
-- ============================================================
-- iShare 数据库设计 v3 → v4 增量脚本
-- 修订时间: 2026-02-17
-- 依据: 决策确认（决策1-4,6）
-- ============================================================
USE pigxx_app;
SET NAMES utf8mb4;
-- ============================================================
-- 决策4: 新增 as_invite_config — 邀请返现规则配置表
-- 返现类型/金额/触发条件均可配置，支持多套规则（启用一套）
-- ============================================================
CREATE TABLE IF NOT EXISTS `as_invite_config` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
`name` varchar(64) NOT NULL COMMENT '规则名称（管理后台展示用）',
`reward_type` tinyint NOT NULL DEFAULT 1 COMMENT '返现类型: 1=固定金额, 2=按比例（%）',
`reward_value` decimal(10,4) NOT NULL DEFAULT 0 COMMENT '返现值（type=1时为金额CNY; type=2时为百分比，如5.00=5%）',
`trigger_type` tinyint NOT NULL DEFAULT 1 COMMENT '触发条件: 1=被邀请人首次购买, 2=被邀请人每次购买',
`min_order_amount` decimal(10,2) DEFAULT NULL COMMENT '触发最低订单金额（NULL=不限）',
`reward_delay_days` int NOT NULL DEFAULT 0 COMMENT '返现延迟天数（0=立即，N=N天后发放，防退款刷单）',
`is_active` tinyint NOT NULL DEFAULT 0 COMMENT '是否启用: 0=禁用, 1=启用（同一时刻只有一条有效）',
`remark` varchar(256) DEFAULT NULL COMMENT '规则备注',
`create_by` varchar(64) DEFAULT NULL COMMENT '创建人',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
`update_time` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
PRIMARY KEY (`id`),
KEY `idx_is_active` (`is_active`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='邀请返现规则配置表（可配置，启用一套）';
-- ============================================================
-- 决策2: Phase 1 无拼车广场
-- as_user_sub_member.status=4（等待车主录入凭据）一期不启用
-- 修改注释说明，字段值保留供 Phase 2 使用
-- ============================================================
ALTER TABLE `as_user_sub_member`
MODIFY COLUMN `status` tinyint NOT NULL DEFAULT 0
COMMENT '状态: 0=待激活, 1=使用中, 2=已到期, 3=已退订 | Phase2: 4=等待车主录入凭据（拼车广场）';
-- as_sub_product.product_type=2（个人发布）Phase 1 不启用
-- 修改注释说明
ALTER TABLE `as_sub_product`
MODIFY COLUMN `product_type` tinyint NOT NULL DEFAULT 1
COMMENT '产品类型: 1=自营（Phase1启用）, 2=个人发布（Phase2拼车广场）';
-- ============================================================
-- 决策6: 提现功能 Phase 2
-- as_wallet_log.type=5（提现）一期不启用，字段保留
-- ============================================================
ALTER TABLE `as_wallet_log`
MODIFY COLUMN `type` tinyint NOT NULL
COMMENT '流水类型: 1=充值, 2=消费, 3=退款, 4=邀请返现 | Phase2: 5=提现';
-- ============================================================
-- END
-- ============================================================

277
iShare-dev-plan.md Normal file
View File

@@ -0,0 +1,277 @@
# iShare 开发规划
> 流媒体账号合租分享平台
> 基于 PigX 5.11.0 二次开发
> 制定日期: 2026-02-17
---
## 一、项目背景
| 项目 | 说明 |
|------|------|
| 产品定位 | 流媒体订阅合租平台（Netflix/Spotify/Apple TV 等合租分享） |
| 核心价值 | 用户以正价 10%-30% 享受正版流媒体服务 |
| 已有资产 | iShare 旧版代码（基于 PigX 5.2）、数据库设计、Figma 设计稿 |
| 目标框架 | PigX 5.11.0（最新版，Java 17 + Spring Boot 3） |
| 代码仓库 | https://git.puro.im/purovps/pigx（PigX 框架备份）|
---
## 二、技术路线
### 2.1 为什么迁移到 PigX 5.11.0
| 维度 | 旧版 (5.2) | 新版 (5.11.0) |
|------|-----------|--------------|
| Java | JDK 8 | JDK 17 (LTS) |
| Spring Boot | 2.x | 3.5.9 |
| Spring Cloud Alibaba | 旧版 | 2023.0.3.3 |
| 包名 | javax.* | jakarta.* |
| 部署模式 | 仅微服务 | 支持单体(pigx-boot) + 微服务双模式 |
| AI 能力 | 无 | LangChain4j + Spring AI + pgvector |
| 前端 | Vue2 | Vue3 + TypeScript + Vite + Tailwind |
**结论**: 5.11.0 支持单体模式部署，开发初期用 `pigx-boot` 单体模式，极大降低运维复杂度；后期需要时再拆微服务。
### 2.2 整体技术栈
**后端**
- Java 17 + Spring Boot 3.5.9
- Spring Cloud Alibaba 2023（微服务模式时）
- MyBatis-Plus + MySQL（业务数据）
- Redis（缓存、Session）
- Nacos（配置中心、服务发现）
- Maven 多模块项目
**前端（管理后台）**
- Vue 3 + TypeScript + Vite
- Tailwind CSS
- 基于 pigx-ui 二次开发
**前端（用户 H5/Web）**
- Vue 3 + TypeScript + Vite（独立项目）
- 移动端优先，响应式设计
- 基于 Figma 设计稿实现
**部署**
- 开发阶段: Docker Compose 单体部署（pigx-boot）
- 生产阶段: Docker + Drone CI/CD 自动化
- 数据库: MySQL（复用 VPS 上的 MariaDB）
### 2.3 仓库规划
| 仓库 | 说明 | Git 地址（待创建）|
|------|------|-----------------|
| `ishare-backend` | PigX 后端主仓库（含 pigx-ishare 业务模块） | git.puro.im/purovps/ishare-backend |
| `ishare-admin` | 管理后台前端（基于 pigx-ui） | git.puro.im/purovps/ishare-admin |
| `ishare-web` | 用户端 H5/Web 前端 | git.puro.im/purovps/ishare-web |
---
## 三、架构设计
### 3.1 模块结构（后端）
```
ishare-backend/
├── pigx-boot/ # 单体部署启动器（开发阶段使用）
├── pigx-ishare/ # ★ iShare 业务模块（核心新增）
│ └── src/main/java/
│ ├── controller/ # REST API
│ ├── service/ # 业务逻辑
│ ├── mapper/ # MyBatis Mapper
│ ├── entity/ # 实体类
│ └── dto/ # 数据传输对象
├── pigx-auth/ # 认证（PigX 原版，无侵入）
├── pigx-upms-biz/ # 用户权限管理（PigX 原版）
├── pigx-gateway/ # 网关（微服务模式时使用）
├── pigx-common/ # 公共模块（PigX 原版）
├── db/
│ ├── 0pigxx_boot.sql # PigX 基础表
│ └── 1ishare_schema.sql # iShare 业务表（迁移自现有设计）
└── docker-compose.yml # 本地开发环境
```
### 3.2 数据库设计（沿用现有，小幅调整）
**核心业务表（as_*）**（已有设计，直接复用）
- `as_platform` — 流媒体平台
- `as_platform_type` — 平台分类
- `as_sub_plan` — 订阅计划
- `as_sub_payroll` — 付费方案
- `as_sub_account` — 订阅账号（含加密凭据）
- `as_sub_product` — 合租商品
- `as_sub_product_comment` — 商品评价
- `as_user_sub` — 用户订阅关系
**新增考虑**（二期）
- `as_order` — 订单表（支付流程）
- `as_withdraw` — 提现记录
- `as_invite` — 邀请关系（推广中心）
**App 基础表（app_*）**（PigX 原版提供）
- `app_user`、`app_social_details`（社交登录）
- `app_page`、`app_tabbar`（页面装修）
### 3.3 核心业务流程
```
用户端:
注册/登录（手机/邮箱/社交）
→ 浏览平台列表 + 筛选
→ 查看合租商品详情
→ 下单付款（一期：手动确认）
→ 获取账号信息
→ 评价
车主端（合租发起方）:
发布合租商品 → 等待拼客 → 管理席位 → 续费/关闭
管理后台:
平台管理 → 订阅计划管理 → 商品审核 → 订单管理 → 用户管理
```
---
## 四、开发阶段规划
### Phase 0: 环境搭建（1-2天）
- [ ] 在 Gitea 创建三个仓库（ishare-backend / ishare-admin / ishare-web）
- [ ] fork/copy 新版 PigX 5.11.0 到 ishare-backend，清理无关模块（pigx-knowledge AI相关）
- [ ] 本地搭建开发环境（MySQL + Redis + IDEA）
- [ ] 配置 VPS Drone CI/CD pipeline（`.drone.yml`）
- [ ] 创建 iShare 数据库，导入建表 SQL
### Phase 1: 后端基础功能（1-2周）
**目标**: 完成核心 CRUD API，管理后台可用
- [ ] 新增 `pigx-ishare` Maven 模块，接入 pigx-boot
- [ ] 迁移 as-app-server 代码到 Java 17（javax → jakarta，注解调整）
- [ ] 实现平台管理接口（CRUD: `as_platform` / `as_platform_type`）
- [ ] 实现订阅计划管理接口（`as_sub_plan` / `as_sub_payroll`）
- [ ] 实现商品管理接口（`as_sub_product` + 评价）
- [ ] 实现账号管理接口（`as_sub_account`，账号密码加密存储）
- [ ] 实现用户订阅管理（`as_user_sub`）
- [ ] App 用户注册/登录 API（手机+邮箱+验证码，复用 pigx-auth）
- [ ] Swagger/Knife4j 接口文档
### Phase 2: 管理后台前端（1周）
**目标**: 管理员可通过后台管理数据
- [ ] fork pigx-ui 到 ishare-admin，调整品牌样式
- [ ] 平台管理页面
- [ ] 订阅计划 + 付费方案页面
- [ ] 合租商品管理页面（含审核）
- [ ] 用户管理页面
- [ ] 订单/订阅查看页面
### Phase 3: 用户端 H5（2-3周）
**目标**: 用户可完成合租全流程
按 Figma 设计稿实现：
- [ ] 首页/欢迎页（品牌展示）
- [ ] 登录/注册页（手机+邮箱+社交登录入口）
- [ ] 忘记密码（验证码找回）
- [ ] 主页/服务列表（平台卡片 + 分类筛选）
- [ ] 服务详情页（介绍 + 价格套餐 + 评价）
- [ ] 购买流程（选套餐 → 确认订单 → 支付 → 获取账号）
- [ ] 广场/拼车（浏览他人发起的合租）
- [ ] 推广中心（邀请码 + 返现记录）
- [ ] 个人中心（我的订阅 + 账单 + 设置）
- [ ] 底部 Tab 导航（首页 / 广场 / 推广 / 我的）
### Phase 4: 支付集成（按需）
- [ ] 对接支付宝/微信支付（或先用余额/人工确认模式）
- [ ] 订单状态流转（待付款→已付款→使用中→已到期）
- [ ] 自动续费提醒
### Phase 5: 测试 & 上线
- [ ] 接口联调测试
- [ ] 账号信息安全审计（加密方案验证）
- [ ] VPS 生产环境部署
- [ ] 性能基准测试（并发下单）
---
## 五、CI/CD 流程
```yaml
# .drone.yml 结构（参考 jshERP 配置）
steps:
- name: backend-build
image: maven:3.9-eclipse-temurin-17
commands:
- mvn clean package -DskipTests -P boot
- name: frontend-admin-build
image: node:18-alpine
commands:
- cd ../ishare-admin && npm ci && npm run build
- name: frontend-web-build
image: node:18-alpine
commands:
- cd ../ishare-web && npm ci && npm run build
- name: deploy
image: docker:dind
commands:
- docker-compose up -d --build
```
触发条件:
- push 到 `main` 分支 → 自动构建 + 部署到 VPS
- PR → 只跑构建，不部署
---
## 六、里程碑
| 里程碑 | 内容 | 预计时间 |
|--------|------|---------|
| M0 | 环境搭建完成，空项目跑通 CI | 第 1 周 |
| M1 | 后端 API 完成，Swagger 文档可访问 | 第 2-3 周 |
| M2 | 管理后台可用，数据录入正常 | 第 3-4 周 |
| M3 | 用户端 H5 完成，全流程可跑通 | 第 5-7 周 |
| M4 | 支付接入，正式上线 | 第 8+ 周 |
---
## 七、关键技术决策
### Q1: 为什么不直接改旧代码，而是基于新 PigX 重新集成？
旧代码基于 PigX 5.2（Java 8 + Spring Boot 2），Spring Boot 2 已于 2023 年 EOL，Java 8 缺少现代特性。新版 5.11.0 支持单体模式，开发阶段不需要 Nacos/Gateway，本地启动一个 JAR 即可，和旧版微服务架构相比开发效率高得多。
### Q2: 单体模式 vs 微服务？
**开发阶段**: 用 `pigx-boot` 单体模式 — 一个进程，本地开发零运维负担。
**生产上线后**: 如并发压力大，再按模块拆分微服务（业务模块无需改代码，只需改部署配置）。
### Q3: 用户端用 H5 还是小程序？
一期先做响应式 H5（Vue3），可在微信内置浏览器打开，无需发布审核。小程序适配二期按需追加。
### Q4: 账号密码安全？
`as_sub_account` 存储平台登录密码，需要对称加密（AES）存储，密钥由服务端持有，不直接暴露明文。PigX 本身已有 Jasypt 配置加密，沿用即可。
---
## 八、参考资源
| 资源 | 地址 |
|------|------|
| PigX 框架（最新版） | https://git.puro.im/purovps/pigx |
| iShare 旧版代码 | https://git.puro.im/purovps/pigx_ishare/src/branch/pigx_ishare |
| 数据库设计文档 | https://git.puro.im/purovps/pigx_ishare/src/branch/pigx_ishare/DATABASE_DESIGN.md |
| Figma 设计稿 | iShare_Design/iShare_设计文档.html |
| VPS 环境 | https://git.puro.im/purovps/vps_env/src/branch/main/vps-environment.md |

201
memory_2026-02-17.md Normal file
View File

@@ -0,0 +1,201 @@
# 2026-02-17 日记
## 上午/下午
### 1. 补充 VPS 环境文档
- 对比记忆 vs Gitea 文档，发现几处缺漏
- 已补充推送到 Gitea：https://git.puro.im/purovps/vps_env/src/branch/main/vps-environment.md
- 补充内容：
- Redis (localhost:6379 无密码) / Prometheus (9090) / Loki (3100)
- jshERP 架构：后端容器 `jsherp`（host network, 9999）、前端静态 `/opt/jshERP-web/`
- Drone Trusted 模式、Dockerfile 需要 fontconfig + ttf-dejavu
- 踩坑记录：Redis slave 问题、Portainer 改 9000 (HTTP)、前端 403 改到 /opt/jshERP-web/ 等
- Caddy conf.d 路径：devops.conf / erp.conf / im.conf / claw.conf
- Mattermost Bot：@erp_devbot token，助手启停方法
- Fail2ban + Swap 4GB
### 2. iShare 开发规划
- 项目仓库：https://git.puro.im/purovps/pigx_ishare
- 规划文档已推送：https://git.puro.im/purovps/pigx_ishare/src/branch/master/iShare-dev-plan.md
- 技术路线决策：
- 基于 PigX 5.11.0 二次开发，新增 `pigx-ishare` 业务模块（不动框架原代码）
- Java 17 + Spring Boot 3（javax → jakarta 迁移）
- 开发阶段用 `pigx-boot` 单体模式，一个 JAR 跑全部；上线后按需拆微服务
- 管理后台：pigx-ui（Vue3 + TypeScript + Tailwind）
- 用户端：独立 H5 项目，响应式移动端优先
- 仓库规划：3个独立仓库（ishare-backend / ishare-admin / ishare-web）
- 开发周期：约 7-8 周到 MVP（不含支付）
- **下一步待定：开始执行哪个 Phase**
## 晚上
- /compact 压缩后 /new 新开 session
- Ami 粘贴了上次对话记录，同步上下文
---
## ✅ 待办：iShare 开发执行
### 项目概况
- **产品**：流媒体订阅合租分享平台（Netflix/Spotify 等）
- **技术栈**：PigX 5.11.0（Java 17 + Spring Boot 3）二次开发
- **规划文档**：https://git.puro.im/purovps/pigx_ishare/src/branch/master/iShare-dev-plan.md
- **PigX 框架**：https://git.puro.im/purovps/pigx
- **旧版代码**：https://git.puro.im/purovps/pigx_ishare/src/branch/pigx_ishare
### 仓库规划（待创建）
- `ishare-backend` — 后端主仓库（Fork PigX 5.11.0 + pigx-ishare 模块）
- `ishare-admin` — 管理后台（Fork pigx-ui）
- `ishare-web` — 用户端 H5（独立 Vue3 项目）
### 开发阶段（已调整优先级）
- [ ] **Phase D（最高优先）**：系统设计 — 功能清单 + 业务流程 + 数据库设计 ← 进行中
- [ ] **Phase 0**（1-2天）：创建仓库 + Fork PigX + 本地环境 + Drone CI/CD + 建库 SQL
- [ ] **Phase 1**（1-2周）：后端核心 CRUD API（平台/计划/商品/账号/用户订阅）
- [ ] **Phase 2**（1周）：管理后台前端（ishare-admin）
- [ ] **Phase 3**（2-3周）：用户端 H5（ishare-web，按 Figma 设计稿）
- [ ] **Phase 4**（按需）：支付集成（支付宝/微信）
- [ ] **Phase 5**：测试 + 上线
### Phase D 完成状态
- [x] 系统角色定义（4个角色）
- [x] 功能模块清单（用户端11模块 + 管理后台9模块）
- [x] 核心业务流程（注册/购买/凭据查看/续费/拼车/邀请 共6条）
- [x] 数据库完整设计（现有8表修订 + 新增5表：as_order/as_wallet/as_wallet_log/as_invite/as_notification）
- [x] 接口设计要点（AES加密/席位并发控制/价格快照）
- [ ] 待决策项确认（6个决策点，需 Ami 确认）
- 设计文档：https://git.puro.im/purovps/pigx_ishare/src/branch/master/SYSTEM_DESIGN.md
### 关键设计决策
- 开发阶段用 `pigx-boot` 单体模式（一个 JAR），上线后按需拆微服务
- 用户端做响应式 H5，二期再考虑小程序
- 账号密码 AES 加密存储（复用 PigX Jasypt）
- 数据库复用 VPS MariaDB，CI/CD 复用 Drone
### 下一步
→ 确认从 **Phase 0** 开始执行
---
## 🛠️ OpenClaw 配置修复（2026-02-17 晚）
### QMD 记忆后端修复
- **问题**：`qmd-wrapper.sh` 强制用 nvm v24 Node，但 `better-sqlite3` 编译于 v22（MODULE_VERSION 127），版本冲突导致 `qmd update` 每次都失败
- **修复**：改 wrapper 用 `/usr/bin/node`（系统 v22），兼容 better-sqlite3
- **文件**：`/home/macsvr/clawd/scripts/qmd-wrapper.sh`
- **结果**：QMD 正常索引 78 个文档，BM25 记忆检索恢复正常
### Local Embedding（memorySearch）
- 重新启用（之前临时关闭）
- 模型：`hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf`
- 文件存在：`~/.node-llama-cpp/models/hf_ggml-org_embeddinggemma-300M-Q8_0.gguf`
---
## 📐 iShare Phase D：数据库设计 v2.0 完成
### 已推送到 Gitea
- 设计文档：https://git.puro.im/purovps/pigx_ishare/src/branch/master/DATABASE_DESIGN_V2.md
- 建表 SQL：https://git.puro.im/purovps/pigx_ishare/src/branch/master/db/ishare_schema_v2.sql
### 修复的原版缺陷（15项）
**严重（4项）：**
1. `as_user_sub.remark` int→varchar（字段类型 Bug）
2. `as_user_sub` 缺 `status`、`expire_time`（订阅生命周期无法管理）
3. `as_sub_account.passwd_salt` int→varchar(64)（加密 Salt 不能用 int）
4. 缺少个人订阅记录表（无法追踪谁加入了哪个合租位）
**重要（6项）：**
5. `as_sub_product.Tags`→`tags`（Java 命名 Bug）
6. `as_sub_plan.platform_id` varchar→bigint，`capacity` varchar→int
7. `as_sub_payroll.sub_plans`→`sub_plan_id`（语义混乱）
8. 7 处 int/Long→bigint 类型对齐
9. `as_sub_product` 缺 `platform_id`、`status`、`cover_image`
10. `as_sub_payroll` 缺 `duration_months`、`original_price`
### 新增 6 张表
| 表 | 作用 |
|----|------|
| `as_user_sub_member` | 个人订阅记录（最关键缺失表） |
| `as_order` | 完整订单（含状态机） |
| `as_wallet` | 用户钱包（含乐观锁） |
| `as_wallet_log` | 钱包流水 |
| `as_invite` | 邀请关系/返现 |
| `as_notification` | 系统通知 |
**总计：9 App 基础表 + 14 业务表 = 23 张表**
### Phase D 状态
- [x] 系统角色/功能模块清单
- [x] 核心业务流程（6条）
- [x] 数据库设计 v2.0（修复+新增）
- [ ] 待决策项确认（6个，见 SYSTEM_DESIGN.md）
- [ ] Phase 0 环境搭建（等 Phase D 决策确认后）
---
## 🌙 晚上（Session 2）
### iShare Phase D 完成
#### 数据库评审（7 个问题全部修复）
| 问题 | 处理 |
|------|------|
| R1 充值流水缺失 | 新增 `as_recharge` 表 |
| R2 续费唯一键问题 | 移除 UNIQUE KEY，续费改为新建记录 |
| I1 Banner 表缺失 | 新增 `as_banner` 表 |
| I2 M:N 逗号分隔 | 新增 `as_product_plan_rel`，移除 `sub_plan_ids` |
| I3 文档字段不一致 | 概要统一至 v2 修订字段名 |
| L1 拼车状态未建模 | `status=4` 等待车主录入凭据 |
| L2 索引缺失 | 补充 12 项关键索引 |
**表数量：v2(23张) → v3(27张)**
#### 5 个决策项确认
| # | 决策 |
|---|------|
| 1 | 三种支付全支持（复用 pigx-pay） |
| 2 | 拼车广场 Phase 2，一期仅自营 |
| 3 | 凭据查看需二次验证（SMS OTP） |
| 4 | 邀请返现完全可配置，新增 `as_invite_config` 表 |
| 6 | 提现 Phase 2 |
**最终：28 张表，Phase D 完成**
#### Gitea 提交记录
- `v1-initial-design` — 初版设计快照
- `v2-db-reviewed` — 评审修复完成
- `v3-phase-d-complete` — Phase D 全部完成（决策确认）
**新增文件：**
- `db/ishare_schema_v3_delta.sql` / `db/ishare_schema_v4_delta.sql`
- `DECISIONS.md` — 完整决策记录
- `DATABASE_DESIGN_OVERVIEW.md` — v4 最终版概要
---
## 📋 前置信息整理（开发背景）
### VPS 环境文档同步（2026-02-17 下午）
文档与记忆对比，发现缺漏并已补充推送：
**文档里有但记忆缺的（新信息）：**
- LCMP (teddysun/lcmp) 一键安装 + lcmp-guide.md
- PHP 8.4.18 (php8.4-fpm)
- MariaDB 11.4.10 版本
**记忆里有但文档缺的（已补充）：**
- Redis (localhost:6379, 无密码) / Prometheus (9090) / Loki (3100)
- jshERP 架构：容器 `jsherp`（host network, 9999）、前端 `/opt/jshERP-web/`、Drone Trusted 模式、Dockerfile 需 fontconfig + ttf-dejavu
- 踩坑记录：Redis slave 问题、Portainer 改 9000 (HTTP)、前端 403 改路径等
- Caddy conf.d 路径：devops.conf / erp.conf / im.conf / claw.conf
- Mattermost Bot：@erp_devbot token，MS 助手启停方法
- 安全基础：Swap 4GB、Fail2ban
文档地址：https://git.puro.im/purovps/vps_env/src/branch/main/vps-environment.md
### iShare 规划来源
- 旧版代码（基于 PigX 5.2）：https://git.puro.im/purovps/pigx_ishare/src/branch/pigx_ishare
- 新版 PigX 框架：https://git.puro.im/purovps/pigx
- 已有资产：旧版代码 + 数据库设计 + Figma 设计稿（iShare_Design/iShare_设计文档.html）