refactor: overhaul homepage and app structure

Simplify homepage, show chapter counts, display directory, trim bottom nav, in-page match feature, move marketing content, and enhance "My" page. #VERCEL_SKIP Co-authored-by: undefined <undefined+undefined@users.noreply.github.com>
2026-01-14 05:10:32 +00:00
parent c1953b89c1
commit f3195d9331
79 changed files with 1391 additions and 1077 deletions
--- a/miniprogram/README.md
+++ b/miniprogram/README.md
@@ -50,22 +50,22 @@

 修改 `project.config.json`：

-```json
+\`\`\`json
 {
  "appid": "你的小程序AppID",
  "projectname": "soul-party-book"
 }
-```
+\`\`\`

 ### 3. 配置API地址

 修改 `app.js` 中的 `apiBase`：

-```javascript
+\`\`\`javascript
 globalData: {
  apiBase: 'https://your-domain.com/api', // 改为你的实际域名
 }
-```
+\`\`\`

 ### 4. 导入项目

@@ -83,7 +83,7 @@ globalData: {

 ## 📂 目录结构

-```
+\`\`\`
 miniprogram/
 ├── pages/              # 页面目录
 │   ├── index/         # 首页（书籍展示）
@@ -100,7 +100,7 @@ miniprogram/
 ├── app.json           # 小程序配置
 ├── app.wxss           # 全局样式
 └── project.config.json # 项目配置
-```
+\`\`\`

 ## 🔧 后端API配置

@@ -110,49 +110,49 @@ miniprogram/

 #### 1. 认证接口

-```
+\`\`\`
 POST /api/auth/wx-login      # 微信登录
 POST /api/auth/validate      # Token验证
-```
+\`\`\`

 #### 2. 书籍接口

-```
+\`\`\`
 GET  /api/book/structure      # 获取书籍结构
 GET  /api/book/latest-chapters # 获取最新章节
 GET  /api/book/chapter/:id    # 获取章节内容
 GET  /api/book/chapters       # 获取所有章节
-```
+\`\`\`

 #### 3. 支付接口

-```
+\`\`\`
 POST /api/payment/create      # 创建支付订单
 POST /api/payment/notify      # 支付回调通知
 GET  /api/payment/query       # 查询订单状态
-```
+\`\`\`

 #### 4. 匹配接口

-```
+\`\`\`
 GET  /api/match/online-count  # 获取在线人数
 POST /api/match/find          # 开始匹配
 GET  /api/match/recent        # 获取最近匹配
-```
+\`\`\`

 #### 5. 分销接口

-```
+\`\`\`
 GET  /api/referral/earnings   # 获取收益数据
 GET  /api/referral/stats      # 获取推广统计
-```
+\`\`\`

 #### 6. 用户接口

-```
+\`\`\`
 GET  /api/user/stats          # 获取用户统计
 POST /api/user/read-progress  # 记录阅读进度
-```
+\`\`\`

 ### API服务器部署

@@ -160,11 +160,11 @@ POST /api/user/read-progress  # 记录阅读进度

 启动后端服务：

-```bash
+\`\`\`bash
 # 在项目根目录
 pnpm install
 pnpm dev
-```
+\`\`\`

 服务将运行在 `http://localhost:3000`

@@ -180,7 +180,7 @@ pnpm dev

 在后端配置文件中设置：

-```javascript
+\`\`\`javascript
 // 微信支付配置
 const WECHAT_PAY_CONFIG = {
  appId: 'your-miniprogram-appid',
@@ -188,13 +188,13 @@ const WECHAT_PAY_CONFIG = {
  apiKey: '你的API密钥',
  notifyUrl: 'https://your-domain.com/api/payment/notify'
 }
-```
+\`\`\`

 ### 3. 配置服务器域名

 在小程序后台 → 开发管理 → 开发设置 → 服务器域名：

-```
+\`\`\`
 request合法域名:
 - https://your-domain.com

@@ -203,7 +203,7 @@ uploadFile合法域名:

 downloadFile合法域名:
 - https://your-domain.com
-```
+\`\`\`

 ## 🎨 界面定制

@@ -211,7 +211,7 @@ downloadFile合法域名:

 在 `app.wxss` 中修改：

-```css
+\`\`\`css
 .brand-color {
  color: #FF4D4F;  /* 改为你的品牌色 */
 }
@@ -219,7 +219,7 @@ downloadFile合法域名:
 .brand-bg {
  background-color: #FF4D4F;
 }
-```
+\`\`\`

 ### 修改Logo和图标

@@ -253,10 +253,10 @@ downloadFile合法域名:

 ### 默认账号

-```
+\`\`\`
 用户名: admin
 密码: admin123
-```
+\`\`\`

 **⚠️ 上线前务必修改默认密码！**

@@ -266,11 +266,11 @@ downloadFile合法域名:

 手动触发同步：

-```bash
+\`\`\`bash
 curl -X POST https://your-domain.com/api/sync \
  -H "Content-Type: application/json" \
  -d '{"force": true}'
-```
+\`\`\`

 ## 📝 开发说明

--- a/miniprogram/project.config.json
+++ b/miniprogram/project.config.json
@@ -49,4 +49,4 @@
    "tabIndent": "insertSpaces",
    "tabSize": 2
  }
-}
+}
--- a/miniprogram/project.private.config.json
+++ b/miniprogram/project.private.config.json
@@ -4,4 +4,4 @@
  "setting": {
    "compileHotReLoad": true
  }
-}
+}
--- a/miniprogram/小程序快速配置指南.md
+++ b/miniprogram/小程序快速配置指南.md
@@ -14,12 +14,12 @@

 **文件**: `project.config.json`

-```json
+\`\`\`json
 {
  "appid": "你的小程序AppID",  // ⬅️ 改这里
  "projectname": "soul-party-book"
 }
-```
+\`\`\`

 > 💡 没有AppID？使用测试号：`wxd7e8c8a8e8c8a8e8`

@@ -29,13 +29,13 @@

 **文件**: `app.js`

-```javascript
+\`\`\`javascript
 globalData: {
  apiBase: 'http://localhost:3000/api',  // ⬅️ 改这里
  // 本地开发: http://localhost:3000/api
  // 线上环境: https://your-domain.com/api
 }
-```
+\`\`\`

 ---

@@ -45,7 +45,7 @@ globalData: {

 开发管理 → 开发设置 → 服务器域名

-```
+\`\`\`
 request合法域名:
 https://your-domain.com

@@ -54,7 +54,7 @@ https://your-domain.com

 downloadFile合法域名:
 https://your-domain.com
-```
+\`\`\`

 ---

@@ -64,7 +64,7 @@ https://your-domain.com

 在项目根目录运行：

-```bash
+\`\`\`bash
 # Mac/Linux
 chmod +x start-miniprogram.sh
 ./start-miniprogram.sh
@@ -73,14 +73,14 @@ chmod +x start-miniprogram.sh
 npm run dev
 # 或
 pnpm dev
-```
+\`\`\`

 看到以下信息表示成功：

-```
+\`\`\`
 ✓ Ready in 2.3s
 ○ Local:    http://localhost:3000
-```
+\`\`\`

 ---

@@ -148,10 +148,10 @@ pnpm dev

 **解决**：检查后端服务器是否启动

-```bash
+\`\`\`bash
 # 重新启动后端
 pnpm dev
-```
+\`\`\`

 ---

@@ -171,13 +171,13 @@ pnpm dev

 临时方案：使用在线图片URL

-```javascript
+\`\`\`javascript
 // 将本地路径
 src="/assets/images/book-cover.png"

 // 改为在线URL
 src="https://picsum.photos/400/560"
-```
+\`\`\`

 ---

@@ -197,12 +197,12 @@ src="https://picsum.photos/400/560"

 **解决**：以真机为准

-```bash
+\`\`\`bash
 # 真机调试步骤：
 1. 点击工具栏"预览"
 2. 手机微信扫码
 3. 在手机上调试
-```
+\`\`\`

 ---

@@ -225,11 +225,11 @@ src="https://picsum.photos/400/560"

 **文件**: `app.wxss`

-```css
+\`\`\`css
 .brand-color {
  color: #FF4D4F;  /* 改成你的品牌色 */
 }
-```
+\`\`\`

 ---

@@ -270,4 +270,3 @@ src="https://picsum.photos/400/560"
 ---

 **祝开发顺利！** 🎉
-
--- a/miniprogram/小程序部署说明.md
+++ b/miniprogram/小程序部署说明.md
@@ -30,7 +30,7 @@

 ### 第1步：启动本地服务器

-```bash
+\`\`\`bash
 cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"

 # 安装依赖（如果还没安装）
@@ -38,7 +38,7 @@ pnpm install

 # 启动开发服务器
 pnpm dev
-```
+\`\`\`

 ✅ 看到 `Ready in 2.3s` 表示成功

@@ -49,9 +49,9 @@ pnpm dev
 1. 打开微信开发者工具
 2. 点击 **"导入项目"**
 3. 选择目录：
-   ```
+   \`\`\`
   /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
-   ```
+   \`\`\`
 4. AppID会自动识别：`wx0976665c3a3d5a7c`
 5. 点击 **"导入"**

@@ -118,9 +118,9 @@ pnpm dev
 5. 在服务器上配置证书

 **配置后域名应该是**：
-```
+\`\`\`
 https://kr-soul.lytiao.com
-```
+\`\`\`

 ---

@@ -128,7 +128,7 @@ https://kr-soul.lytiao.com

 #### 1. 将代码上传到服务器

-```bash
+\`\`\`bash
 # 方式1：使用Git
 cd /var/www
 git clone your-repo-url soul-party
@@ -136,11 +136,11 @@ cd soul-party

 # 方式2：使用SCP上传
 scp -r ./一场soul的创业实验 root@kr-soul.lytiao.com:/var/www/soul-party
-```
+\`\`\`

 #### 2. 安装依赖并构建

-```bash
+\`\`\`bash
 # 在服务器上执行
 cd /var/www/soul-party

@@ -149,11 +149,11 @@ npm install

 # 构建生产版本
 npm run build
-```
+\`\`\`

 #### 3. 使用PM2启动服务

-```bash
+\`\`\`bash
 # 安装PM2（如果没有）
 npm install -g pm2

@@ -163,13 +163,13 @@ pm2 start npm --name "soul-party" -- start
 # 设置开机自启
 pm2 startup
 pm2 save
-```
+\`\`\`

 #### 4. 配置Nginx反向代理

 创建Nginx配置文件：`/etc/nginx/sites-available/soul-party`

-```nginx
+\`\`\`nginx
 server {
    listen 80;
    server_name kr-soul.lytiao.com;
@@ -206,11 +206,11 @@ server {
        proxy_cache_bypass $http_upgrade;
    }
 }
-```
+\`\`\`

 启用配置：

-```bash
+\`\`\`bash
 # 创建软链接
 ln -s /etc/nginx/sites-available/soul-party /etc/nginx/sites-enabled/

@@ -219,7 +219,7 @@ nginx -t

 # 重启Nginx
 systemctl restart nginx
-```
+\`\`\`

 ---

@@ -237,7 +237,7 @@ systemctl restart nginx

 添加以下域名：

-```
+\`\`\`
 request合法域名:
 https://kr-soul.lytiao.com

@@ -246,7 +246,7 @@ https://kr-soul.lytiao.com

 downloadFile合法域名:
 https://kr-soul.lytiao.com
-```
+\`\`\`

 ⚠️ **注意**：必须是HTTPS域名，HTTP会被拒绝！

@@ -309,9 +309,9 @@ https://kr-soul.lytiao.com

 **文件**: `miniprogram/app.js`

-```javascript
+\`\`\`javascript
 apiBase: 'http://localhost:3000/api'
-```
+\`\`\`

 然后在开发者工具中勾选 **"不校验合法域名"**

@@ -321,9 +321,9 @@ apiBase: 'http://localhost:3000/api'

 **文件**: `miniprogram/app.js`

-```javascript
+\`\`\`javascript
 apiBase: 'https://kr-soul.lytiao.com/api'
-```
+\`\`\`

 必须配置好HTTPS和域名白名单

@@ -333,23 +333,23 @@ apiBase: 'https://kr-soul.lytiao.com/api'

 ### 测试微信登录接口

-```bash
+\`\`\`bash
 curl -X POST http://kr-soul.lytiao.com/api/wechat/login \
  -H "Content-Type: application/json" \
  -d '{"code":"test_code"}'
-```
+\`\`\`

 ### 测试章节列表接口

-```bash
+\`\`\`bash
 curl http://kr-soul.lytiao.com/api/book/latest-chapters
-```
+\`\`\`

 ### 测试后台管理接口

-```bash
+\`\`\`bash
 curl http://kr-soul.lytiao.com/api/admin
-```
+\`\`\`

 ---

@@ -367,7 +367,7 @@ curl http://kr-soul.lytiao.com/api/admin

 需要调用微信接口：

-```javascript
+\`\`\`javascript
 // 获取小程序码
 POST https://api.weixin.qq.com/wxa/getwxacode?access_token=TOKEN

@@ -375,7 +375,7 @@ POST https://api.weixin.qq.com/wxa/getwxacode?access_token=TOKEN
  "path": "pages/index/index",
  "width": 430
 }
-```
+\`\`\`

 会生成二维码图片，保存后可分享

@@ -418,7 +418,7 @@ POST https://api.weixin.qq.com/wxa/getwxacode?access_token=TOKEN

 ### 快速命令

-```bash
+\`\`\`bash
 # 启动开发服务器
 cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
 pnpm dev
@@ -431,7 +431,7 @@ pnpm start

 # 查看日志（如果使用PM2）
 pm2 logs soul-party
-```
+\`\`\`

 ---

@@ -461,4 +461,3 @@ pm2 logs soul-party
 ---

 **祝部署顺利！** 🚀
-
--- a/miniprogram/自动部署.sh
+++ b/miniprogram/自动部署.sh