flnxi-Wu/docs/USER_ONBOARDING_GUIDE.md
WuYongJie d1c6efc79d
Some checks failed
CI Check / check (push) Has been cancelled
feat: NAS 部署与 Harbor 推送流程
2025-12-03 14:39:06 +08:00

58 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 新手用户上手指引
这份指引面向**首次接触 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. 在个人中心下载自己的素材压缩包,验证解压内容正确。
完成以上步骤后,即可熟练掌握素材库的核心操作。若需要更深入的后台/模板管理权限,请参考管理员文档或联系系统负责人开通角色。