gongxiangp2/.kiro/steering/项目记忆库.md

inclusion

inclusion
always

由壹点3D素材平台 - 项目记忆库

企业内部素材分享系统，支持15种素材类型的上传、管理和下载。

---

用户偏好

• 能用中文就用中文（文档、注释）
• 不写不重要的文档
• 不喜欢垃圾文件、残留文件
• 修复原则: 优先找到问题根源彻底解决，不要打补丁（除非不得已）

---

技术栈

Next.js 14 + React 18 + TypeScript + TailwindCSS + Prisma + PostgreSQL + MinIO S3 + NextAuth + 钉钉登录

处理库：FFmpeg（视频）、Sharp（图片）、music-metadata（音频）、ag-psd（PSD）

---

生产环境

• 数据库: lobechat @ 192.168.58.20:5432（影子: lobechat_stage）
• S3: https://s3.yydd.ai，Bucket: gongxiangpan，前缀: 由壹点AI/
• 正式: 端口4320 | 影子: 端口5320
• 本地存储: /mnt/PoolOne/apps/youyidian-3d/uploads

---

⚠️ 新老素材存储（核心）

分界点：2025-10-27

项目	老素材	新素材
S3	s3.1080p.hk/jsxiangche	s3.yydd.ai/gongxiangpan/由壹点AI/
识别	previewUrl不含由壹点AI/	previewUrl含由壹点AI/

原则: 不改老素材 | 视频/音频存本地（MinIO机械盘慢）| 下载兼容新老路径

---

关键文件

• 上传: components/UploadModal.tsx、components/upload/
• API: app/api/materials/upload/（含init/chunk/complete）、download/、transcode/
• Lib: lib/s3.ts、lib/video-processor.ts、lib/url-rewrite.ts

---

文件命名

• 视频: video-{ts}-{hash}.mp4（不是video-source）
• 音频: audio-source-{id}-{ts}.mp3
• 其他: material-{ts}-{hash}.zip

---

要点

• 分片上传: >5MB自动启用，IndexedDB断点续传
• 视频转码: 自动触发，720P预览+10秒片段+封面，状态pending→processing→done/failed
• 图片: 预览图压缩800×2000，展示图>1500px自动切片
• 数据库: 所有查询必须 deletedAt: null

---

操作规范

1. 数据库修改前必须备份
2. 部署默认正式系统，明确要求才部署影子
3. uploads目录不可删除

部署: .\deploy-local-build.ps1（影子加 -Target shadow）

---

忽略目录

flnxi_sucai/、gongxiangp2/（子目录）- 仅参考，不要使用

---

终端提示

推荐 Git Bash 作为默认终端（PowerShell批量操作语法差）

VSCode: terminal.integrated.defaultProfile.windows: "Git Bash"

---

更新: 2025-12-27