221 lines
4.4 KiB
Markdown
221 lines
4.4 KiB
Markdown
# 系统更新 v2.2 - 素材卡片增强
|
||
|
||
## 📅 更新日期：2025-10-17
|
||
|
||
---
|
||
|
||
## ✨ 更新概要
|
||
|
||
本次更新主要增强了首页素材卡片的信息展示和互动功能，新增了下载统计和点赞功能。
|
||
|
||
---
|
||
|
||
## 🎯 核心功能
|
||
|
||
### 1. ❤️ 点赞功能
|
||
- 用户可以为喜欢的素材点赞
|
||
- 点击红心按钮切换点赞状态
|
||
- 实时显示点赞次数
|
||
- 每个用户对每个素材只能点赞一次
|
||
- 已点赞显示红色实心❤️，未点赞显示灰色空心
|
||
|
||
### 2. 📊 下载统计
|
||
- 自动统计每个素材的下载次数
|
||
- 每次下载自动 +1
|
||
- 实时显示在卡片上
|
||
- 帮助了解素材热度
|
||
|
||
### 3. 🎨 卡片信息优化
|
||
- **SPU标签**：图片左上角显示SPU
|
||
- **彩色标签**：
|
||
- 🔵 蓝色：使用店铺
|
||
- 🟢 绿色：场景类别
|
||
- **完整信息**：
|
||
- 作者名称
|
||
- 文件名
|
||
- 上传时间
|
||
- 下载次数（带图标📥）
|
||
- 点赞次数（带图标❤️）
|
||
- **优化布局**：更现代、更易读
|
||
|
||
---
|
||
|
||
## 🔄 数据库变更
|
||
|
||
### 新增字段
|
||
- `Material.downloadCount` - 下载次数
|
||
- `Material.likeCount` - 点赞次数
|
||
|
||
### 新增表
|
||
- `MaterialLike` - 点赞关系表
|
||
- 记录用户点赞行为
|
||
- 防止重复点赞
|
||
|
||
---
|
||
|
||
## 📱 用户界面变化
|
||
|
||
### 卡片布局（Before → After）
|
||
|
||
**之前**：
|
||
```
|
||
[预览图]
|
||
商品型号
|
||
店铺、场景、作者
|
||
时间
|
||
[下载按钮]
|
||
```
|
||
|
||
**现在**：
|
||
```
|
||
[预览图 + SPU标签]
|
||
[店铺标签] [场景标签]
|
||
作者、文件名、时间
|
||
───────────────
|
||
📥 25 ❤️ 10
|
||
───────────────
|
||
[❤️] [📥 下载]
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 快速部署
|
||
|
||
### 一键部署
|
||
```bash
|
||
cd /Users/lanmu/Desktop/gongxiangp2
|
||
./update-deploy.sh
|
||
```
|
||
|
||
### 手动部署步骤
|
||
|
||
#### 1. 打包代码
|
||
```bash
|
||
cd /Users/lanmu/Desktop/gongxiangp2
|
||
tar -czf update-v2.2.tar.gz \
|
||
--exclude='node_modules' \
|
||
--exclude='.next' \
|
||
--exclude='uploads/*' \
|
||
--exclude='.git' \
|
||
.
|
||
```
|
||
|
||
#### 2. 上传到NAS
|
||
```bash
|
||
scp update-v2.2.tar.gz root@192.168.58.20:/mnt/tank/apps/youyidian-3d/
|
||
# 密码：jsjj8888
|
||
```
|
||
|
||
#### 3. SSH到NAS并部署
|
||
```bash
|
||
ssh root@192.168.58.20
|
||
cd /mnt/tank/apps/youyidian-3d
|
||
|
||
# 解压
|
||
tar -xzf update-v2.2.tar.gz
|
||
rm update-v2.2.tar.gz
|
||
|
||
# 重新构建
|
||
docker compose down
|
||
docker compose up -d --build
|
||
|
||
# 等待启动
|
||
sleep 15
|
||
|
||
# 运行数据库迁移
|
||
docker compose exec app npx prisma db push
|
||
|
||
# 检查状态
|
||
docker compose ps
|
||
docker compose logs --tail=30 app
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 验证步骤
|
||
|
||
### 1. 检查卡片显示
|
||
- [ ] SPU标签显示在图片左上角
|
||
- [ ] 店铺和场景显示为彩色标签
|
||
- [ ] 文件名正确显示
|
||
- [ ] 下载次数和点赞次数显示
|
||
|
||
### 2. 测试点赞功能
|
||
- [ ] 点击点赞按钮，按钮变红
|
||
- [ ] 点赞次数 +1
|
||
- [ ] 再次点击，取消点赞
|
||
- [ ] 刷新页面，点赞状态保持
|
||
|
||
### 3. 测试下载功能
|
||
- [ ] 点击下载按钮
|
||
- [ ] 文件正常下载
|
||
- [ ] 下载次数 +1
|
||
|
||
---
|
||
|
||
## 📊 数据初始化
|
||
|
||
现有素材的下载次数和点赞次数默认为0，无需额外操作。
|
||
|
||
如需查看统计数据：
|
||
```bash
|
||
ssh root@192.168.58.20
|
||
cd /mnt/tank/apps/youyidian-3d
|
||
|
||
# 查看热门素材
|
||
docker compose exec -T app npx prisma db execute --schema=/app/prisma/schema.prisma --stdin <<< "
|
||
SELECT \"productModel\", \"categoryName\", \"downloadCount\", \"likeCount\"
|
||
FROM materials
|
||
ORDER BY \"likeCount\" DESC
|
||
LIMIT 10;
|
||
"
|
||
```
|
||
|
||
---
|
||
|
||
## 🎨 视觉优化
|
||
|
||
### 配色方案
|
||
- **店铺标签**：蓝色系 (#DBEAFE / #1D4ED8)
|
||
- **场景标签**：绿色系 (#D1FAE5 / #047857)
|
||
- **点赞按钮（已点赞）**：红色 (#EF4444)
|
||
- **点赞按钮（未点赞）**：灰色 (#F3F4F6)
|
||
|
||
### 响应式设计
|
||
- 移动端：1列
|
||
- 平板：3列
|
||
- 桌面：4列
|
||
|
||
---
|
||
|
||
## 🔗 访问地址
|
||
|
||
- 🏠 **内网**：http://192.168.58.20:4320
|
||
- 🌍 **公网**：http://180.97.221.140:2320
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- 详细功能说明：`CARD_ENHANCEMENT.md`
|
||
- 标签优化说明：`LABEL_OPTIMIZATION.md`
|
||
- 功能更新列表：`FEATURE_UPDATES.md`
|
||
- 快速部署指南：`QUICK_DEPLOY.md`
|
||
|
||
---
|
||
|
||
## 🎉 更新亮点
|
||
|
||
1. ✅ **视觉升级**：更现代、更专业的卡片设计
|
||
2. ✅ **信息完整**：所有关键信息一目了然
|
||
3. ✅ **用户互动**：点赞功能增加用户参与度
|
||
4. ✅ **数据洞察**：下载和点赞统计支持运营决策
|
||
5. ✅ **响应式**：完美适配各种设备
|
||
|
||
---
|
||
|
||
**部署愉快！** 🚀
|
||
|
||
如有问题请查看详细文档或联系技术支持。
|
||
|