gongxiangp2/.kiro/steering/项目配置与开发规范.md

由壹点3D素材平台 - 项目配置与开发规范

项目概述

由壹点3D素材平台是一个内部素材管理系统，支持多种素材类型的上传、管理和分享。

---

用户偏好

1. 语言: 能用中文的地方就用中文（文档、脚本命名、注释）
2. 文档: 不写不重要的文档，除非明确要求
3. 代码注释: 必须写中文注释
4. 整洁: 不喜欢垃圾文件、残留文件、过期文件、重复功能的文件

---

生产环境配置

数据库

环境	数据库名	地址
生产	lobechat	192.168.58.20:5432
影子	lobechat_stage	192.168.58.20:5432
用户	gongxiangpan / gongxiangpan123

S3 存储（生产）

• Endpoint: https://s3.yydd.ai
• Bucket: gongxiangpan
• 公网域名: https://s3.yydd.ai/gongxiangpan
• 文件前缀: 由壹点AI/

部署端口

系统	端口	容器名
正式	4320	youyidian-3d-material
影子	5320	youyidian-3d-material-shadow
Redis正式	6379	Redis影子 6380

访问地址

• 内网: http://192.168.58.20:4320
• 公网: http://180.97.221.140:2320

文件存储

• 预览图/视频 → MinIO S3
• 源文件（压缩包）→ 本地 ./uploads（Docker挂载）

---

核心数据表

• users - 用户（含钉钉登录）
• materials - 素材（含软删除deletedAt、视频转码字段）
• material_favorites - 收藏
• material_download_logs - 下载日志
• material_logs - 操作日志
• categories/scenes/platforms - 分类

---

素材类型（15种）

• 3DMAX、3D场景、其他、音乐、PSD
• 种草视频、买家秀图片、主图视频、安装视频
• 实拍图片、详情页、材质、模特、标准模型、小红书种草

---

操作规范

1. 任何数据库修改前必须备份
2. 部署默认到正式系统(4320)，只有用户明确要求时才部署到影子系统(5320)
3. uploads目录是用户文件，不可删除

---

部署脚本

• 部署到正式系统：.\deploy-local-build.ps1
• 部署到影子系统：.\deploy-local-build.ps1 -Target shadow
• 影子覆盖正式：.\deploy-shadow-to-prod.ps1

---

忽略目录

• flnxi_sucai/ - 另一个项目的源文件，不属于本项目
• gongxiangp2/ - 如有同名目录也忽略

---

构建缓存

• prisma/engine-cache/ - Prisma 引擎本地缓存
• .docker-cache/ - npm 包缓存

---

Git 仓库

• 远程仓库: https://git.1080p.hk/chenpei/gongxiangp2.git