# 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，初始化数据库