# 由壹点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`