107 lines
2.5 KiB
Markdown
107 lines
2.5 KiB
Markdown
# 由壹点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`
|