flnxi-Wu/docs/archive/新手用户使用指引.md
WuYongJie 63ec6b7dfb fix: 修复排行榜按钮消失、tag排序和输入框浅色模式问题
1. 排行榜悬浮窗关闭后小按钮消失问题
   - 修复面板居中模式关闭时按钮位置错误
   - 保存并恢复按钮的居中状态

2. 首页tag按钮按素材数量排序
   - 添加按素材数量降序排序逻辑

3. 上传弹窗输入框浅色模式文字不可见
   - 添加 text-slate-900 确保浅色模式下文字可见
   - 添加 placeholder 样式确保占位符正确显示
2025-12-14 21:41:29 +08:00

3.6 KiB
Raw Blame History

新手用户上手指引

这份指引面向首次接触 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. 在个人中心下载自己的素材压缩包,验证解压内容正确。

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