xiaoquan/rent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 迭代

Browse Source
This commit is contained in:
xiaoquan
2026-05-22 18:54:30 +08:00
parent ca22542c7a
commit 4c7a1e06a8
20 changed files with 2169 additions and 1087 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+52 -32
View File
@@ -17,9 +17,9 @@
### 配置指南
- 💳 [微信支付配置](WECHAT_PAYMENT_SETUP.md) - 微信支付接入指南
### 功能模块
### 核心系统设计
- 💰 [财务系统完整设计](finance-system.md) - 账户体系、资金流转、核心服务、安全保障（v2.0 重构版）
- 🎁 [邀请码系统](features/invite-system.md) - 邀请码生成、绑定和返现机制
- 💰 [结算系统](features/settlement-system.md) - 订单支付、资金流转、周结算和商家提现
---
@@ -28,6 +28,7 @@
```
docs/
├── README.md # 本文件 - 文档索引
├── finance-system.md # 财务系统完整设计文档（v2.0）
├── DEVELOPMENT_SUMMARY.md # 开发总结（项目完成情况）
├── WECHAT_PAYMENT_SETUP.md # 微信支付配置指南
├── requirements/
@@ -35,17 +36,33 @@ docs/
├── planning/
│ └── TODO2.md # 任务清单（已完成100%）
├── database/
│ └── finance-database.md # 财务数据库设计
│ └── finance-database.md # 财务数据库设计（v2.0）
└── features/
├── invite-system.md # 邀请码系统设计文档
└── settlement-system.md # 结算系统设计文档
└── invite-system.md # 邀请码系统设计文档
```
---
## 📖 核心文档说明
### 1. [财务系统完整设计](features/finance-system.md) - v3.0 合并版
**内容**：
- 四层账户体系设计（系统总账户、平台账户、商家账户、用户账户）
- 完整的资金流转流程（订单支付、结算、退款、提现）
- 结算周期和服务费计算
- 核心服务详解（AccountService、SettlementService、RefundService、WithdrawalService、ReportService）
- 数据库表结构和SQL定义
- API接口文档
- 前端页面实现（5个页面）
- 扩展方案（未来增加其他收入）
- 安全保障机制（事务、悲观锁、乐观锁、金额精度控制）
- 数据一致性保证
- 测试验证和部署说明
- 常见问题解答
### 1. [项目需求文档](requirements/项目需求文档.md)
**适合**：后端开发人员、架构师、财务人员、测试人员
---
### 2. [项目需求文档](requirements/项目需求文档.md)
**内容**：
- 项目概述和技术栈
- 系统架构设计
@@ -58,18 +75,19 @@ docs/
---
### 2. [财务数据库设计](database/finance-database.md)
### 3. [财务数据库设计](database/finance-database.md) - v2.0 更新
**内容**：
- 完整的数据库表结构
- 账户体系设计（用户、商家、平台）
- 资金流转逻辑
- 财务交易记录
- 完整的数据库表结构（v2.0 重构版）
- 四层账户体系（system_accounts、platform_accounts、merchant_accounts、user_accounts）
- 资金流转逻辑和业务流程
- 数据一致性保证机制
- 索引说明和版本更新记录
**适合**：后端开发人员、数据库管理员
---
### 3. [任务清单 TODO2.md](planning/TODO2.md)
### 4. [任务清单 TODO2.md](planning/TODO2.md)
**内容**：
- 项目开发任务分解
- 各阶段完成情况（100%）
@@ -80,7 +98,7 @@ docs/
---
### 4. [开发总结](DEVELOPMENT_SUMMARY.md)
### 5. [开发总结](DEVELOPMENT_SUMMARY.md)
**内容**：
- 项目整体完成情况
- 已实现的功能模块
@@ -91,7 +109,7 @@ docs/
---
### 5. [微信支付配置](WECHAT_PAYMENT_SETUP.md)
### 6. [微信支付配置](WECHAT_PAYMENT_SETUP.md)
**内容**：
- 微信支付商户配置
- API密钥设置
@@ -102,7 +120,7 @@ docs/
---
### 6. [邀请码系统](features/invite-system.md)
### 7. [邀请码系统](features/invite-system.md)
**内容**：
- 邀请码生成规则（6位数字+大写字母）
- 邀请关系绑定流程
@@ -114,37 +132,38 @@ docs/
---
### 7. [结算系统](features/settlement-system.md)
**内容**：
- 完整的资金流转流程
- 周结算机制（每周一凌晨2点自动执行）
- 服务费计算规则和配置
- 订单支付、商家结算、提现流程
- 数据库设计和API接口
- 问题修复记录
**适合**：产品经理、后端开发人员、财务人员
---
## 🗄️ 数据库初始化
### 初始化脚本
位置：`database/migrations/001_init_schema.sql`
**包含内容**：
- 所有数据库表结构
- 所有数据库表结构（v2.0 重构版）
- 系统总账户表（system_accounts）
- 平台账户表（platform_accounts）
- 商家账户表（merchant_accounts）
- 用户账户表（user_accounts）
- 各类交易流水表
- 索引和外键约束
- 初始化数据
- 常住人表（guests）
- 实名认证字段
- 触发器
### 执行方式
```bash
# 方式1：命令行执行
# 方式1：命令行执行（会清空所有数据）
mysql -u root -p < database/migrations/001_init_schema.sql
# 方式2：登录后执行
mysql -u root -p
source database/migrations/001_init_schema.sql;
# 方式3：初始化系统总账户和平台账户
USE your_database_name;
INSERT INTO system_accounts (account_name, balance, total_income, total_refund, total_withdrawn)
VALUES ('系统总账户', 0.00, 0.00, 0.00, 0.00);
INSERT INTO platform_accounts (account_name, balance, total_income, total_expense)
VALUES ('主账户', 0.00, 0.00, 0.00);
```
---
@@ -196,6 +215,7 @@ source database/migrations/001_init_schema.sql;
| 日期 | 版本 | 说明 |
|------|------|------|
| 2024-01-XX | v5.0 | 财务系统账户体系重构（v2.0），新增系统总账户，重构平台账户 |
| 2026-05-13 | v4.2 | 新增结算系统设计文档，修复结算逻辑问题 |
| 2026-05-13 | v4.1 | 新增邀请码系统设计文档 |
| 2026-05-13 | v4.0 | 整合文档，删除重复内容，项目完成100% |