管理员运营手册

路径：登录后 → 顶部导航 → 「后台管理」（仅 admin 角色可见） 或直接访问：平台域名/admin 权限说明： • admin 角色：可访问所有管理功能 • user 角色：无法访问后台，访问 /admin 会显示"无权限"提示 如何授予 admin 权限： 1. 进入后台 → 「用户管理」Tab 2. 找到目标用户 → 修改角色为 admin （注意：轻易不要给用户 admin 权限，admin 可查看所有用户数据）

管理后台共 6 个 Tab： Tab 功能说明 ──────────────────────────────────── 数据总览 平台核心指标一览 任务调度 自动化任务的开关与定时配置 洞察管理 博客文章的发布/下架/AI生成管理 邀请码管理 创建、编辑、禁用邀请码 用户管理 查看用户点数和注册信息 套餐管理 配置充值套餐及 Stripe 定价

系统预置以下自动化任务，在「任务调度」Tab 中统一管理： 任务名称 默认执行时间 说明 ───────────────────────────────────────────── 爬取红果榜单 每日 09:00 抓取红果短剧 Top 排行榜数据 爬取漫剧榜单 每日 09:30 抓取漫剧平台排行数据 爬取火龙榜单 每日 10:00 抓取火龙平台数据 每日洞察分析 每日 10:30 AI 生成每日深度市场分析报告 生成热门题材 每日 11:00 更新首页热门题材热度数据 每日博客生成 每日 11:30 AI 自动生成一篇行业洞察文章

1. 进入后台 → 「任务调度」Tab 2. 找到对应任务，修改「执行小时」和「执行分钟」 3. 点击「保存」按钮 4. 系统将在下次到达该时间点时执行 手动触发： • 每个任务右侧均有「立即执行」按钮，可跳过定时立即运行 • 适用于需要紧急刷新数据的场景 启用/禁用： • 切换任务右侧的开关，可随时暂停或恢复某个任务 • 禁用后该任务的定时执行会暂停，但手动仍可触发 ⚠️ 注意：AI 生成类任务会消耗平台的 AI 积分，建议每类任务每日执行不超过 1–2 次。

系统每日自动通过「每日博客生成」任务生成一篇行业洞察文章，默认状态为「已发布」。 手动管理文章： 路径：后台 → 「洞察管理」Tab 核心操作： 1. 上架/下架：点击文章列表中的眼睛图标（🟢 绿色=已上架，灰色=草稿） - 已上架文章对所有用户可见 - 草稿状态文章仅管理员可见（前台不展示） 2. 删除文章：点击红色垃圾桶图标，二次确认后永久删除 3. 按分类筛选：使用顶部分类按钮快速过滤 4. 搜索文章：输入关键词可搜索标题和摘要 5. 手动生成：点击右上角「AI 立即生成一篇」，触发即时生成

内容质量控制建议： • 每篇 AI 生成文章发布前，建议快速浏览标题和摘要，确认内容质量 • 对于质量不佳的文章，可直接下架（改为草稿）而不删除，保留备份 • 建议保持每周至少 3–5 篇已发布文章，保证内容丰富度 分类管理： • 博客前台的分类 Tab 是动态的，只显示有已发布文章的分类 • 6 个分类：题材趋势、爆款分析、投流策略、海外出海、创作技巧、行业动态 • 若某个分类长期无文章，该 Tab 会自动从前台隐藏 特殊运营场景： • 重要节点（春节、暑期档等）前，可手动生成多篇针对性文章并提前安排发布 • 热点事件发生时，可临时提高生成频率（手动触发 2–3 次）以抢占流量

路径：后台 → 「邀请码管理」Tab → 「创建邀请码」 字段说明： • 邀请码：自定义字符串，如 VIP2025、FRIEND50，建议大写字母+数字 • 折扣百分比：如填 20，表示购买任意套餐享 8 折 • 注册赠送点数：用户使用该码注册后自动获得的点数 • 最大使用次数：0 表示无限制 • 价格组：绑定该用户的定价权限（standard/vip/enterprise） • 备注：内部标注，用于区分不同渠道的邀请码 典型场景： • KOL 合作：discount_percent=30, bonus_credits=20, max_uses=100 • 内部员工：discount_percent=100（免费）, bonus_credits=50 • 限时活动：discount_percent=20, max_uses=500, note="五一活动"

禁用/启用：点击邀请码右侧的「禁用」/「启用」按钮，可随时停止某码的使用 编辑：点击铅笔图标，可修改折扣、赠送点数和备注（不能修改邀请码本身） 删除：永久删除该邀请码（已使用该码注册的用户不受影响） 查看使用情况： • 「已用 X/Y」显示当前使用次数和最大限制 • 0/∞ 表示未使用且无限制

路径：后台 → 「用户管理」Tab 表格字段说明： • 用户邮箱：注册邮箱，唯一标识 • 余额：当前可用点数 • 累计购买：历史充值获得的总点数 • 累计消耗：已使用的总点数 • 价格组：standard/vip/enterprise，影响购买时的定价 • 邀请码：注册时使用的邀请码（无则显示 -） • 注册时间：账号创建日期

目前点数管理通过数据库实体直接操作： 手动赠送点数（紧急情况）： 1. 联系技术团队通过后台数据库操作 2. 或直接在 UserCredits 实体中更新 balance 字段 3. 同步在 CreditTransaction 中添加一条 type=bonus 的记录，保持审计可追溯 补偿流程（用于处理充值未到账等客诉）： 1. 核实用户支付凭证 2. 查询 CreditTransaction 确认是否存在对应 purchase 记录 3. 若确认支付成功但未到账，手动更新 balance 并创建补偿记录 ⚠️ 所有点数变更必须同步记录到 CreditTransaction 实体，否则账目无法核对。

路径：后台 → 「套餐管理」Tab 套餐字段说明： • 套餐名称：显示在充值页面的名称 • 价格组：standard/vip/enterprise，决定哪些用户可见该套餐 • 获得点数：购买后到账的点数 • 价格（元）：人民币计价 • Stripe Price ID：对应 Stripe 后台的价格 ID（必填，用于实际收款） • 标签：如「最受欢迎」，在 UI 上高亮显示 • 排序：数字越小越靠前显示 • 是否激活：关闭后用户无法购买该套餐 重要：修改套餐价格时，必须同步在 Stripe 后台创建新的 Price，并更新 Stripe Price ID，否则实际收款金额不会改变。

Stripe 相关配置位于：系统设置 → 环境变量 必填密钥： • STRIPE_SECRET_KEY：Stripe 后台 → Developers → API Keys → Secret key • STRIPE_WEBHOOK_SECRET：Stripe 后台 → Webhooks → 对应 webhook 的 Signing secret • APP_URL：平台的完整域名，如 https://yourdomain.com Webhook 地址：平台域名/api/functions/stripeWebhook 需要在 Stripe 后台配置监听事件：checkout.session.completed 测试充值：使用 Stripe 测试卡号 4242 4242 4242 4242，有效期任意未来日期，CVV 任意 3 位。

系统数据存储在 Base44 平台的云数据库中，自动备份，无需手动维护。 定期清理建议（每月一次）： • 榜单数据（DramaRanking）：保留最近 90 天数据，定期清理过期榜单，避免数据库过大 • 合规检测记录（ComplianceCheck）：用户自行管理，运营无需干预 • 趋势报告（TrendReport）：保留最近 60 天，老报告可归档 数据实体说明： 实体名称 说明 ────────────────────────────── BlogPost 博客文章 TrendReport 每日趋势报告 DramaRanking 平台榜单数据 ScriptAnalysis 用户剧本分析记录 ComplianceCheck 合规检测记录 CopyrightRecord 版权存证档案 UserCredits 用户点数账户 CreditTransaction 点数流水记录 InviteCode 邀请码 PricingPlan 充值套餐 SystemConfig 系统配置（任务调度）

Q：自动任务执行了但数据没更新？ A：检查步骤： 1. 后台 → 任务调度 → 查看该任务的「最近执行时间」和「状态」 2. 若状态为 failed，点击「立即执行」手动触发，观察是否报错 3. 若报错，通常是 AI API 额度不足或网络超时，等待 10 分钟后重试 Q：榜单数据一直是旧的？ A：确认「爬取榜单」任务是否启用（开关是否打开）。手动触发一次，查看是否成功。注意：榜单爬取依赖目标平台的数据接口，若目标平台更新接口可能导致临时失效。 Q：AI 生成的博客文章质量不稳定？ A：AI 生成受到模型版本和 prompt 影响，偶尔会生成质量较差的文章。建议： • 开启生成后先预览，质量差的直接下架 • 重要时间节点前，提前几天积累内容备用

Q：用户反映充值后点数未到账？ A：处理流程： 1. 让用户提供支付截图和支付时间 2. 后台 → 用户管理 → 找到该用户 → 查看点数余额变化时间 3. Stripe 后台确认该笔支付是否成功 4. 若 Stripe 显示支付成功但点数未到账，可能是 Webhook 未触发，手动在数据库补充点数并记录流水 Q：用户无法完成支付，页面报错？ A：常见原因： • Stripe 密钥配置错误 → 检查 STRIPE_SECRET_KEY 是否正确 • 套餐的 Stripe Price ID 不存在或已归档 → 在 Stripe 后台核实 • APP_URL 配置不正确导致回调失败 → 确认环境变量值 Q：需要封禁某个用户账号怎么操作？ A：目前系统没有一键封禁功能。临时处理方案： • 将该用户的 balance 清零（CreditTransaction 记录一条 refund 或 consume） • 如需彻底禁止，联系技术团队在数据库层面处理 Q：如何批量邀请用户注册？ A：创建一个通用邀请码（max_uses 设为预期人数），将邀请码附在注册链接后发给目标用户群。用户使用该码注册即自动绑定优惠政策。

Q：AI 生成了不当内容的博客文章怎么办？ A：立即下架（改为草稿状态）→ 删除 → 手动触发重新生成一篇。 同时检查 generateDailyBlogPost 函数中的 prompt，看是否需要加强内容限制。 Q：用户反映合规检测误报，认为内容没有问题？ A：说明 AI 检测具有一定误判率。建议告知用户：检测结果仅供参考，最终标准以各平台官方审核为准。特别是「伊斯兰禁忌」检测，对于不出海的内容可以忽略。 Q：平台本身的内容安全合规怎么保障？ A：平台处理用户上传内容的原则： • 合规检测、版权存证：文件上传后提取文本，不长期存储原文 • 剧本分析：文本用于 AI 分析，处理完成后不作二次使用 • 所有数据存储在 Base44 云平台，遵守其服务条款和数据保护政策