## 新手用户上手指引

这份指引面向**首次接触 FLNXI 素材库**的普通成员，帮助他们在 10 分钟内完成账号激活、素材上传、权限确认与移交。管理员可在培训/迎新时直接引用。

### 1. 获取账号并首次登录
1. 打开管理员发送的登录地址（示例：`https://materials.example.com/login`）。
2. 输入分配的账号密码或使用钉钉扫码（若已开启）。
3. 首次登录后，系统会提示**修改默认密码**，请设置一个长度 ≥ 8 位、包含数字和字母的新密码。
4. 进入“个人资料”页补齐真实姓名、部门、联系方式，确保后续素材归属准确展示。

### 2. 了解素材归属 / 所有权
- 每份素材都包含两个身份信息：
  - `createdByUserId`：最初上传者（用来追溯责任人）。
  - `ownerType + ownerId`：当前归属（个人/团队）。离职移交后只会更新归属，不会丢失上传者信息。
- 在“我的素材”列表中可看到自己上传并归属到个人的作品；若素材被移交给团队，该列表会同步更新。

### 3. 上传与预览流程（以视频为例）
1. 点击右上角“上传素材”，选择匹配的模板。
2. 填写基础信息：品牌、系列、SKU、材质、场景等。
3. 上传源文件（压缩包/视频）。上传结束后系统会：
   - 调用 FFmpeg 生成 540P 预览和 10 秒短片；
   - 自动截图生成封面，保持与预览视频一致的比例；
   - 删除本地临时源文件，避免占用 NAS 空间。
4. 在首页卡片或详情弹窗中即可查看转码进度：
   - `pending`：等待转码（展示“预览生成中…”占位图）；
   - `processing`：FFmpeg 运行中；
   - `done`：可播放/下载；
   - `failed`：可点击“重新转码”或联系管理员。

### 4. 分享与互动
- **收藏/点赞**：在卡片上直接操作，数据会实时同步到个人中心的“我的收藏”。
- **下载**：根据权限决定是否显示按钮；下载记录会写入 `material_download_logs`，便于审计。
- **分享链接**：点击卡片右上角“分享”生成短链，可面向外部预览但不允许下载原文件。

### 5. 所有权移交 / 离职交接
- 若素材需要交给其他成员或团队空间，请联系管理员在后台执行“素材移交”：
  1. 管理员选择目标素材 → 点击“移交所有权”；
  2. 选择目标类型：`USER`（个人）或 `TEAM`（部门/项目组）；
  3. 保存后系统会记录 `lastTransferredAt`，并在详情页展示最新归属。
- 被移交的素材依旧保留原作者信息，可在日志中查看完整操作历史。

### 6. 常见问题
| 场景 | 解决方案 |
| --- | --- |
| 登录后提示“账号未激活” | 联系管理员在用户管理中启用 `isActive` |
| 上传后长时间显示“等待转码” | 处理队列可能被占满，刷新或通知管理员检查 FFmpeg/队列服务 |
| 详情弹窗显示黑边或白屏 | 按 F5 强刷；若仍异常，请记下素材 ID 反馈给研发 |
| 我的素材为空 | 确认是否刚执行过所有权移交或系统刚恢复出厂，可重新上传或联系管理员核对归属 |

### 7. 建议的“新人成长任务”
1. 上传一份个人作品并补齐所有元数据。
2. 将素材分享到公共链接，邀请同事点赞/收藏。
3. 体验一次素材移交（可与同组同事互换），理解离职交接流程。
4. 在个人中心下载自己的素材压缩包，验证解压内容正确。

完成以上步骤后，即可熟练掌握素材库的核心操作。若需要更深入的后台/模板管理权限，请参考管理员文档或联系系统负责人开通角色。