Admin
2e34dd172b
文档清单： - 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张表定稿，所有决策已确认
66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
# 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，初始化数据库
|