📖 超级案例助手 - 用户使用文档

📋 目录

  1. 快速入门
  2. 用户角色说明
  3. 普通用户使用指南
  4. 组织管理员使用指南
  5. 常见问题
  6. 功能详解

🚀 快速入门

第一步：访问系统

打开浏览器，访问系统地址：https://super-case.cflpai.com

第二步：登录系统

  1. 访问系统主页时会自动跳转到登录页面
  2. 输入您的账号和密码完成登录
  3. 登录成功后自动返回系统主页

第三步：生成第一个案例

  1. 在主页填写案例信息表单
  2. 点击"生成案例"按钮
  3. 等待AI生成完成（通常需要30-60秒）
  4. 查看生成的学生案例、教师指南和练习题

👥 用户角色说明

系统支持两种用户角色，每种角色拥有不同的权限：

1. 普通用户

权限范围：

  • ✅ 生成案例
  • ✅ 查看自己的历史记录
  • ✅ 导出自己的案例
  • ❌ 查看其他用户的案例
  • ❌ 访问管理功能

适用对象：企业培训师、教师、内容创作者

2. 组织管理员

权限范围：

  • ✅ 所有普通用户权限
  • ✅ 查看本组织的所有案例
  • ✅ 查看本组织的统计数据
  • ✅ 管理本组织的用户
  • ✅ 导出本组织的数据

访问条件：

  • 必须已登录（通过Logto认证）
  • 必须属于某个组织
  • 需要被授予组织管理员权限

访问方式：访问 /orgadmin，系统自动验证权限

适用对象：部门负责人、组织管理员

📝 普通用户使用指南

一、生成案例

1.1 填写案例信息

在主页表单中填写以下信息：

必填项：

  • 核心知识与技能目标（100字以内）
    • 描述本次培训要传授的核心知识和技能
    • 例如："掌握项目管理中的风险识别与应对方法"
  • 案例背景（3000字以内）
    • 描述案例发生的业务场景和环境
    • 包括：行业背景、公司情况、项目背景等
    • 例如："某互联网公司在开发新产品时遇到的技术挑战..."
  • 案例内容与核心冲突（3000字以内）
    • 描述案例的核心事件和冲突
    • 包括：发生了什么、为什么发生、冲突点在哪里
    • 例如："技术团队与产品团队在需求优先级上产生分歧..."
  • 问题痛点（3000字以内）
    • 明确需要解决的关键问题
    • 包括：当前面临的挑战、问题的严重性
    • 例如："项目进度延误、团队协作效率低下..."

可选项：

  • 参考解决方案（3000字以内）
    • 提供可能的解决思路（仅用于教师指南，不会出现在学生案例中）
    • 例如："采用敏捷开发方法，建立跨部门沟通机制..."

1.2 生成案例

  1. 填写完必填项后，点击页面底部的"生成案例"按钮
  2. 系统会显示生成进度：
    • 正在生成学生案例...
    • 正在生成教师指南...
    • 正在生成练习题...
  3. 生成完成后，页面会自动跳转到结果展示区域

1.3 查看生成结果

生成结果分为三个标签页：

📚 学生案例

  • 结构化的教学案例
  • 包含背景介绍、核心事件、冲突描述
  • 适合直接用于课堂教学

👨‍🏫 教师指南

  • 教学要点和关键知识点
  • 讨论问题和引导思路
  • 分析框架和评估标准

📝 练习题

  • 选择题：测试基础理解
  • 简答题：评估分析能力
  • 论述题：考察综合应用

1.4 操作功能

每个标签页都提供以下功能：

  • 📋 复制内容：点击"复制"按钮，将内容复制到剪贴板
  • 📥 导出案例：点击"导出案例"按钮，下载Markdown格式文件
  • 💾 保存历史：案例自动保存到历史记录

二、查看历史记录

2.1 访问历史记录

  1. 点击导航栏的"我的历史"或访问 /user/history
  2. 系统会显示您生成的所有案例列表

2.2 历史记录列表

列表显示以下信息：

  • 案例ID：唯一标识
  • 核心知识与技能目标：案例的学习目标
  • 创建时间：案例生成时间（中国时区）
  • 操作按钮：查看详情、导出、删除

2.3 查看案例详情

  1. 点击"查看详情"按钮
  2. 进入案例详情页面，可以：
    • 查看完整的案例信息
    • 查看生成的学生案例、教师指南、练习题
    • 复制内容或导出文件

2.4 导出案例

在历史记录页面或案例详情页面：

  1. 点击"导出"按钮
  2. 选择导出格式（Markdown）
  3. 文件会自动下载到本地

2.5 删除案例

  1. 在历史记录页面，点击"删除"按钮
  2. 确认删除操作
  3. 案例将从您的历史记录中移除

注意：删除操作不可恢复，请谨慎操作。

🏢 组织管理员使用指南

一、访问组织管理平台

1.1 访问条件

要访问组织管理平台，您需要满足：

  • ✅ 已登录（通过Logto认证）
  • ✅ 属于某个组织
  • ✅ 被授予组织管理员权限

1.2 访问方式

  1. 登录系统后，访问 /orgadmin
  2. 系统会自动验证您的权限
  3. 如果权限不足，会显示相应的提示信息

二、组织仪表盘

访问 /orgadmin/dashboard 查看本组织的核心指标：

  • 总案例数：本组织累计生成的案例总数
  • 今日/本周/本月案例数：本组织的时间维度统计
  • 近7天趋势：本组织的生成趋势图表
  • 主题词热度：本组织的Top 50主题词

三、案例管理

3.1 查看本组织案例

访问 /orgadmin/history：

  • 仅显示本组织用户生成的案例
  • 支持关键词搜索（仅搜索本组织案例）
  • 支持分页浏览

3.2 案例操作

  • 查看详情：查看案例完整内容
  • 导出案例：导出单个案例为Markdown文件
  • 删除案例：删除本组织的案例（仅限本组织）

3.3 批量导出

  1. 在历史记录页面点击"导出"按钮
  2. 选择CSV或Excel格式
  3. 导出的数据仅包含本组织的案例

四、用户管理

4.1 查看本组织用户

访问 /orgadmin/users：

  • 仅显示本组织的用户列表
  • 显示用户ID、用户名、邮箱、最后登录时间等信息
  • 支持导出用户数据（仅本组织）

4.2 用户统计

  • 查看本组织的用户总数
  • 查看活跃用户（有登录记录）
  • 查看用户生成案例的统计

五、数据隔离说明

重要：组织管理员只能查看和管理本组织的数据：

  • ✅ 只能看到本组织的案例
  • ✅ 只能看到本组织的用户
  • ✅ 统计数据仅计算本组织
  • ✅ 导出数据仅包含本组织
  • ❌ 无法查看其他组织的数据
  • ❌ 无法管理其他组织的用户

❓ 常见问题

1. 登录相关

Q: 忘记密码怎么办？

A: 如果使用Logto登录，请联系系统管理员重置密码。如果是管理员账号，请联系系统管理员。

Q: 登录后一直跳转怎么办？

A: 检查Logto配置是否正确，特别是回调URI是否与系统配置一致。

Q: 提示"无权访问"怎么办？

A: 检查您的账号是否属于某个组织，以及是否被授予了组织管理员权限。如需成为组织管理员，请联系系统管理员。

2. 案例生成相关

Q: 生成案例需要多长时间？

A: 通常需要30-60秒，具体时间取决于：

  • 系统处理速度
  • 输入内容的长度
  • 网络连接状况

Q: 生成失败怎么办？

A:

  1. 检查网络连接是否正常
  2. 检查系统服务是否正常运行
  3. 尝试重新生成
  4. 如问题持续，请联系系统管理员

Q: 生成的内容不满意怎么办？

A:

  1. 优化输入内容，提供更详细的背景信息
  2. 尝试调整"参考解决方案"字段
  3. 重新生成案例
  4. 对生成的内容进行人工编辑

3. 数据管理相关

Q: 如何备份我的案例？

A:

  1. 在历史记录页面导出案例
  2. 定期导出为Markdown或Excel文件
  3. 组织管理员可以导出本组织的所有数据

Q: 删除的案例能恢复吗？

A: 不能，删除操作不可恢复。请谨慎操作，重要案例建议先导出备份。

Q: 导出的文件在哪里？

A: 导出的文件会下载到浏览器的默认下载目录。

4. 权限相关

Q: 如何成为组织管理员？

A: 需要满足以下条件：

  1. 已登录系统
  2. 属于某个组织
  3. 被系统管理员授予组织管理员权限

请联系系统管理员配置权限。

Q: 组织管理员能看到其他组织的数据吗？

A: 不能，组织管理员只能查看和管理本组织的数据，确保数据隔离。

5. 技术问题

Q: 页面显示异常怎么办？

A:

  1. 刷新页面（Ctrl+F5强制刷新）
  2. 清除浏览器缓存
  3. 检查浏览器版本是否过旧
  4. 联系系统管理员

Q: 导出文件乱码怎么办？

A:

  1. Excel文件：使用Excel打开，选择"数据"→"从文本导入"，选择UTF-8编码
  2. CSV文件：使用文本编辑器打开，选择UTF-8编码

Q: 时间显示不正确怎么办？

A: 系统统一使用中国时区（Asia/Shanghai, UTC+8）。如果时间显示不正确，请联系系统管理员检查时区配置。

🔍 功能详解

一、案例生成流程

用户填写表单
    ↓
提交生成请求
    ↓
AI生成学生案例（30-60秒）
    ↓
AI生成教师指南（30-60秒）
    ↓
AI生成练习题（30-60秒）
    ↓
保存到数据库
    ↓
返回结果给用户

二、数据存储结构

案例表（cases）：

  • 基本信息：ID、创建时间、更新时间
  • 表单数据：目标知识、背景、冲突、痛点、解决方案
  • 生成内容：学生案例、教师指南、练习题
  • 用户信息：用户ID、用户名、组织ID、组织名

用户表（users）：

  • 用户ID、用户名、邮箱
  • 最后登录时间、创建时间、更新时间

组织表（organizations）：

  • 组织ID、组织名称
  • 创建时间、更新时间

三、搜索功能

搜索范围：

  • 核心知识与技能目标
  • 案例背景
  • 案例内容与核心冲突
  • 问题痛点

搜索方式：

  • 关键词匹配
  • 支持部分匹配
  • 不区分大小写

四、导出功能

支持格式：

  • Markdown (.md)：适合文档分享和版本管理
  • CSV (.csv)：适合数据分析，可用Excel打开
  • Excel (.xlsx)：格式美观，包含完整信息

导出内容：

  • 案例基本信息
  • 所有表单字段
  • 生成的所有内容（学生案例、教师指南、练习题）
  • 用户和组织信息

五、权限控制

普通用户：

  • 只能查看和操作自己的案例
  • 无法访问管理功能

组织管理员：

  • 可以查看和管理本组织的所有案例
  • 可以查看本组织的用户
  • 无法访问其他组织的数据

📞 获取帮助

如果您在使用过程中遇到问题：

  1. 查看文档：首先查阅本文档的常见问题部分
  2. 联系管理员：联系系统管理员获取帮助
  3. 提交问题：在项目仓库提交Issue报告问题

祝您使用愉快！

最后更新：2026年1月