系统使用 · 测试文档 · 持续更新

🎓 小陆辅导 · 文章写作辅导平台

面向管理员（小陆）、写手、客户三端的一站式论文辅导协作平台：闲鱼订单同步、套餐与写手管理、订单分配、三方实时沟通（文字 / 图片 / 语音）、写手通讯录私聊、内部论坛、客户免登录下单、数据自动清理。

文档版本v1.4
系统地址https://xiaolu-tutoring.pages.dev
写手工作台https://xiaolu-tutoring.pages.dev/writer.html
客户门户https://xiaolu-tutoring.pages.dev/client.html
更新日期2026-08-11

1平台概览

小陆辅导是一个连接论文辅导客户与写手的协作平台。客户通过客户门户选择套餐下单；管理员在后台接收订单、分配写手并管理套餐；写手拥有独立工作台，只查看自己负责的订单。订单分配后，管理员（小陆）、写手、客户三方可在同一订单下沟通；此外写手之间、写手与管理员之间还可通过通讯录私聊，并在内部论坛发帖交流。平台部署于 Cloudflare Pages，数据存储于 Cloudflare D1（免费版单库 500 MB 上限）。

👑

管理员 · 小陆

订单 / 套餐 / 写手全局管理，沟通中心、通讯录私聊、内部论坛、数据清理、使用文档

https://xiaolu-tutoring.pages.dev/（管理后台）
✍️

写手（独立工作台）

我的订单、订单沟通、通讯录私聊（写手间 / 与管理）、内部论坛

https://xiaolu-tutoring.pages.dev/writer.html
🙋

客户

免注册浏览套餐、下单，凭专属链接查看订单并沟通

https://xiaolu-tutoring.pages.dev/client.html（免登录下单）
💡 角色与可见性规则：订单分配后，管理员、写手、客户均可查看该订单的完整对话；写手只能看到分配给自己的订单；写手登录后自动进入独立工作台，不进入管理后台；管理员与写手共享通讯录与内部论坛。
flowchart LR
  C[客户门户 /client.html] -->|浏览套餐/下单| A[API 网关]
  A -->|订单+token| DB[(D1 数据库)]
  M[管理后台 /] -->|订单/套餐/写手管理| A
  W[写手工作台 /writer.html] -->|我的订单| A
  W2[写手/管理员] -->|通讯录私聊| A
  W3[写手/管理员] -->|内部论坛 发帖/回复| A
  C2[客户专属链接] -->|token 自动登录| A
  subgraph 沟通体系
    A -->|订单对话: 文字/图片/语音| DB
    A -->|私聊: 文字/图片/语音| DB
  end
  A -->|图片/语音文件| R2[(R2 对象存储)]
图 1-1：平台架构与数据流向（v1.2）

2账号清单与入口

2.1 管理员账号

角色用户名密码说明
管理员adminadmin123系统显示名为「小陆」，拥有全部管理权限
⚠️ 生产环境请立即修改默认密码：更新 ADMIN_PASSWORD 环境变量（wrangler.toml）。

2.2 写手示例账号（密码均为 writer123）

用户名手机号专业方向说明
张老师13800001111数学与应用数学可测试写手间私聊
李老师13800002222英语语言文学—
王老师13800003333计算机科学与技术已有 3 单，可测试写手视角与私聊
赵老师13800004444经济学—
陈老师13800005555临床医学—
刘老师13800006666法学—

2.3 客户账号（免注册）

客户无需注册。下单后系统自动生成 16 位访问口令（Token）与专属链接，客户凭链接自动登录。测试方法：在客户门户下单，或构造链接 https://xiaolu-tutoring.pages.dev/client.html?token=口令。

3管理员使用手册（小陆）

3.1 登录与工作台

登录访问系统首页，选择「管理员」身份，输入 admin / admin123。
身份显示登录后侧边栏显示「小陆」，进入工作台（4 项统计 + 最新订单）。

3.2 订单管理（含客户免登录链接）

新建订单点击「+ 新建订单」，填写客户信息并选择套餐提交；成功后将自动复制客户免登录链接到剪贴板并弹窗提示，直接发给客户即可。
订单列表链接每个订单右侧有 🔗链接 按钮，一键复制该订单的客户免登录链接（https://xiaolu-tutoring.pages.dev/client.html?token=xxx），随时可再次发送给客户。
分配写手待处理订单点击「分配」，选择写手后订单转为「进行中」，系统自动发送通知。
状态流转支持 待处理 / 进行中 / 已完成 / 已取消，可按状态筛选。

3.3 套餐管理

新建套餐配置名称、价格、辅导天数、修改次数、字数、特色功能、排序、上架状态。
编辑 / 下架 / 重新上架套餐卡片操作按钮；下架后客户不可见但历史订单不受影响。

3.4 写手管理

添加写手填写姓名、昵称、手机、微信、专业、擅长领域、登录密码（≥6 位）、评分。
编辑 / 重置密码 / 删除写手卡片操作；有进行中订单的写手删除时自动转为「停用」。

3.5 沟通中心与通讯录

沟通中心：管理员可查看并参与全部订单对话，发送文字 / 图片（自动压缩）/ 语音，身份显示「小陆」（紫色气泡）。

通讯录：管理员可见全部写手，可发起一对一私聊（文字 / 图片 / 语音），未读消息带角标提醒。

3.6 内部论坛与使用文档

内部论坛侧边栏「内部论坛」，管理员与写手均可发帖、回复；管理员可删除任意帖子。
使用文档侧边栏「📖 使用文档」，系统内置本使用与测试文档，随系统更新同步维护，可随时查阅（支持打印）。
数据清理写手管理页「🧹 数据清理」手动清理旧数据并显示数据库占用。

4写手使用手册（独立工作台）

✅ v1.2 起写手拥有独立工作台 https://xiaolu-tutoring.pages.dev/writer.html：登录后自动跳转，不再进入管理后台，只能看到分配给自己的订单。
登录访问系统首页（https://xiaolu-tutoring.pages.dev），选择「写手」身份，输入姓名（或手机号）+ 密码（示例：王老师 / writer123），自动进入写手工作台。
我的订单仅显示分配给自己的订单，支持按状态筛选；点击「去沟通」直接进入对应订单会话。
订单沟通与小陆、客户实时对话，支持文字 / 图片（自动压缩）/ 语音，5 秒自动刷新。
通讯录可见管理员「小陆」与全部写手，点击联系人即可私聊（文字 / 图片 / 语音），未读角标提醒。
内部论坛浏览帖子、发帖、回复；管理员帖子带 🏛️ 标识。
⚠️ 账号被停用后无法登录，提示「用户名或密码错误，或账号已被停用」。

5客户使用手册

5.1 下单流程

打开客户门户访问 https://xiaolu-tutoring.pages.dev/client.html（或管理后台登录页「我是客户？去下单」）。
浏览套餐首页热门套餐 / 套餐页全部套餐，点击卡片可选中。
填写并提交称呼、联系方式、套餐、学科、题目、备注 → 提交订单。
获取专属链接成功页显示订单号与专属链接，可一键复制或立即进入。

5.2 订单查看与沟通

自动登录凭专属链接（或输入访问口令）进入「我的订单」。
订单详情查看套餐、金额、辅导老师、状态。
沟通点击「与老师沟通」，与小陆和写手实时对话，支持文字 / 图片 / 语音。

6通讯录与私聊

v1.2 新增的站内即时通信能力，用于写手之间、写手与管理员的非订单事务沟通（如排班协调、请教经验）。

📇 通讯录成员

管理员可见：全部写手；写手可见：管理员「小陆」+ 全部写手。支持按姓名搜索。

💬 会话能力

文字、图片（自动压缩）、语音消息；未读消息数角标；会话列表显示最后一条消息与时间；5 秒自动刷新。

💡 私聊记录独立于订单对话存储；数据自动清理会同步清理 60 天前的私聊记录。

7内部论坛

v1.2 新增的内部交流区，管理员与写手均可参与，用于发布平台通知、经验分享、求助答疑。

浏览帖子列表按时间倒序，显示标题、作者、回复数、时间；管理员帖子带 🏛️ 标识。
发帖输入标题与内容，点击「发布」；管理员与写手均可发帖。
回复点击帖子进入详情，查看全部回复并发表回复。
删除仅管理员可删除帖子（写手无权限，接口返回 403）。

8系统自动功能说明

8.1 聊天记录自动清理（2 个月）

每次 API 请求有 10% 概率触发惰性清理，自动删除超过 60 天的订单消息与私聊记录，无需人工干预。

8.2 数据库容量自动保护

Cloudflare D1 免费版单库上限 500 MB，超过后无法写入[1]。系统在清理时读取数据库实时大小，达到 400 MB（80%）时自动深度清理：30 天前消息与日志、90 天前已完成/取消订单。

8.3 图片自动压缩

发送图片时前端自动处理：超过 1 MB 或宽度大于 1920px 的图片压缩为 JPEG（质量 80%），PNG 透明底转白底，GIF 动图不压缩。

8.4 语音消息

基于 MediaRecorder 录音（WebM/MP4），上传 R2 后以播放器展示；三端与私聊均可使用，单文件上限 20 MB。

8.5 会话安全

登录会话持久化存储于数据库，7 天自动过期；客户口令永久有效直至订单被清理。

9测试用例清单

共 53 条测试用例，覆盖管理员 / 写手 / 客户 / 通讯录私聊 / 内部论坛 / 系统自动六类。执行时按编号逐条测试，在「10. 测试记录表」中填写结果。

9.1 管理员模块 21 条

编号测试项操作步骤预期结果
TC-001管理员登录选择「管理员」，输入 admin / admin123登录成功，进入工作台，侧边栏显示「小陆」
TC-002工作台统计进入工作台查看统计卡片待处理/进行中/已完成/总收入与订单一致
TC-003新建订单订单管理 → 新建订单生成订单号、客户 token 与专属链接
TC-004订单详情点击订单「详情」展示套餐、金额、题目、学科、备注、写手、时间
TC-005分配写手待处理订单 → 分配 → 选择写手状态变「进行中」，写手收到系统通知
TC-006标记完成进行中订单 → 标记完成状态变「已完成」，收入统计更新
TC-007状态筛选按四种状态筛选列表正确过滤
TC-008新建套餐套餐管理 → 新建套餐创建成功，客户门户可见
TC-009编辑套餐套餐卡片 → 编辑 → 修改价格保存后价格立即生效
TC-010下架套餐套餐卡片 → 下架置灰显示「已下架」，客户门户不可见，历史订单不受影响
TC-011重新上架已下架套餐 → 重新上架套餐恢复正常，客户门户可见
TC-012添加写手写手管理 → 添加写手，设置密码创建成功，新写手可用该账号登录
TC-013编辑写手写手卡片 → 编辑 → 修改专业/评分信息更新成功
TC-014重置密码写手卡片 → 重置密码写手使用新密码可登录，旧密码失效
TC-015删除写手对无订单写手执行删除删除成功，账号消失
TC-016停用保护对王老师（有进行中订单）执行删除转为停用，订单不受影响，账号无法登录
TC-017管理员对话沟通中心选择订单，发送文字紫色气泡显示，发送者「小陆」
TC-018数据清理写手管理页 → 数据清理弹窗显示删除条数与数据库占用 MB
TC-019未授权拦截不带 token 调用管理 API返回 401「未授权，请以管理员身份登录」
TC-040订单客户链接订单列表点击任意订单「🔗链接」弹出提示并复制客户免登录链接到剪贴板
TC-041使用文档入口侧边栏点击「📖 使用文档」内容区展示本使用与测试文档，可滚动查看

9.2 写手模块 8 条

编号测试项操作步骤预期结果
TC-020写手登录选择「写手」，输入 王老师 / writer123登录成功，自动跳转独立写手工作台
TC-021订单隔离写手登录后查看「我的订单」仅显示分配给自己的订单（王老师 3 单）
TC-022写手发文字订单沟通选择订单，发送文字蓝色气泡显示，发送者为写手姓名
TC-023写手发图片发送 3MB 以上大图发送成功且图片被压缩
TC-024写手发语音点击 🎤 录音后结束发送消息包含可播放语音条
TC-025停用拦截用被停用账号尝试登录提示「用户名或密码错误，或账号已被停用」
TC-042写手访问管理后台写手登录态下直接访问 https://xiaolu-tutoring.pages.dev自动重定向到 https://xiaolu-tutoring.pages.dev/writer.html
TC-043写手无管理菜单检查写手工作台侧边栏仅含 我的订单/订单沟通/通讯录/内部论坛，无套餐/写手管理等

9.3 客户模块 10 条

编号测试项操作步骤预期结果
TC-026门户访问访问 https://xiaolu-tutoring.pages.dev/client.html展示品牌、热门套餐、下单表单
TC-027套餐浏览进入「套餐」页展示全部上架套餐
TC-028提交下单填写信息选择套餐提交成功卡片显示订单号 + 专属链接
TC-029链接自动登录访问专属链接免注册自动登录，进入「我的订单」
TC-030订单列表登录后查看我的订单仅显示自己的订单，含状态徽章
TC-031订单详情点击订单卡片展示套餐、金额、写手、状态、备注
TC-032客户发文字与老师沟通 → 发送文字灰色气泡显示
TC-033客户发图片发送大图图片自动压缩后上传成功
TC-034客户发语音点击 🎤 录音发送生成可播放语音消息
TC-035口令登录右上角登录 → 输入口令错误口令提示无效；正确口令进入订单

9.4 通讯录与私聊 6 条

编号测试项操作步骤预期结果
TC-044管理员发起私聊管理员 → 通讯录 → 选择写手 → 发送文字消息发送成功，写手端可见
TC-045未读提醒写手不打开通讯录，管理员再发一条写手通讯录侧边栏出现未读角标，列表显示未读数
TC-046写手回复管理员写手 → 通讯录 → 小陆 → 回复管理员通讯录出现未读角标与消息
TC-047写手之间私聊王老师 → 通讯录 → 张老师 → 发送消息张老师登录后可查看该会话
TC-048私聊发图片私聊窗口发送大图图片压缩后发送成功
TC-049私聊发语音私聊窗口 🎤 录音发送对端可见可播放的语音消息

9.5 内部论坛 4 条

编号测试项操作步骤预期结果
TC-050发帖与浏览管理员/写手在内部论坛发布帖子帖子出现在列表，显示作者与时间，管理员带 🏛️ 标识
TC-051回复帖子打开帖子详情 → 发表回复回复出现在详情页，回复数 +1
TC-052删除权限写手尝试删除帖子；管理员删除帖子写手被拒（仅管理员可删除）；管理员删除成功

9.6 系统自动模块 4 条

编号测试项操作步骤预期结果
TC-036消息自动清理执行 60 天清理 SQL 验证规则60 天前的消息可被清除，索引生效
TC-037容量保护检查清理接口 db_size_mb；模拟超 400MB自动深度清理旧数据
TC-038图片压缩效果上传 5MB、4000×3000 图片压缩后明显小于原图，可正常预览
TC-039会话过期等待 7 天或手动删除 sessions 记录旧 token 失效，需重新登录

9.7 测试进度统计

图 9-1：测试用例分布（执行时更新）

10测试记录表

按 TC 编号逐条执行，通过打 ✓，失败记录现象与截图。

编号执行人结果
✓ / ✗		发现的问题 / 备注
TC-001
TC-002
TC-003
TC-004
TC-005
TC-006
TC-007
TC-008
TC-009
TC-010
TC-011
TC-012
TC-013
TC-014
TC-015
TC-016
TC-017
TC-018
TC-019
TC-020
TC-021
TC-022
TC-023
TC-024
TC-025
TC-026
TC-027
TC-028
TC-029
TC-030
TC-031
TC-032
TC-033
TC-034
TC-035
TC-036
TC-037
TC-038
TC-039
TC-040
TC-041
TC-042
TC-043
TC-044
TC-045
TC-046
TC-047
TC-048
TC-049
TC-050
TC-051
TC-052

11附录

11.1 常用链接

用途地址
管理后台（管理员登录）https://xiaolu-tutoring.pages.dev
写手工作台https://xiaolu-tutoring.pages.dev/writer.html
客户门户（免登录下单）https://xiaolu-tutoring.pages.dev/client.html
使用与测试文档https://xiaolu-tutoring.pages.dev/docs/xiaolu-usage-guide.html
健康检查https://xiaolu-tutoring.pages.dev/api/health

11.2 核心 API 一览

方法路径说明鉴权
POST/api/orders客户下单，返回 token 与专属链接公开
GET/api/orders?writer_id=订单列表（写手按 ID 过滤）公开*
PUT/api/orders/:id/assign分配写手管理员会话
POST/api/packages新建套餐管理员会话
PUT/DELETE/api/packages/:id编辑 / 下架套餐管理员会话
POST/api/writers添加写手管理员会话
PUT/DELETE/api/writers/:id编辑 / 删除写手管理员会话
PUT/api/writers/:id/password重置写手密码管理员会话
POST/api/auth/client-login客户口令自动登录公开（需口令）
GET/api/client/orders客户查询自己的订单客户会话
GET/POST/api/messages(/:id)订单消息读取 / 发送（含图片、语音）公开*
POST/api/chat/send发送私聊消息管理员/写手会话
GET/api/chat/conversations私聊会话列表（含未读）管理员/写手会话
GET/api/chat/messages?with=私聊聊天记录管理员/写手会话
POST/api/forum/posts发布帖子管理员/写手会话
GET/api/forum/posts(/:id)帖子列表 / 详情（含回复）公开
POST/api/forum/posts/:id/replies回复帖子管理员/写手会话
DELETE/api/forum/posts/:id删除帖子仅管理员
POST/api/upload图片 / 音频上传（R2）公开*
POST/api/admin/cleanup手动数据清理管理员会话

* 标注「公开」的管理写操作需在系统运行中通过登录会话校验；会话有效期 7 天。

11.3 文档维护说明

📌 本使用与测试文档随系统功能同步维护：每次系统更新时，同步更新文档中的功能说明、测试用例清单与版本号。文档内嵌于管理员界面「📖 使用文档」，可直接查阅，支持浏览器打印。

11.4 常见问题

Q1：客户忘记保存专属链接怎么办？

回到客户门户点击右上角「登录」输入访问口令；口令丢失时，管理员在订单列表点击「🔗链接」重新获取并发送。

Q2：语音发送失败？

请使用 Chrome / Edge，允许麦克风权限；录音过短（<1 秒）会被拦截。

Q3：图片上传失败？

支持 JPG / PNG / GIF / WebP，单文件上限 20MB；大图自动压缩，仍超限请先手动缩小。

Q4：写手看不到订单？

请确认管理员已在订单上「分配」该写手；写手只能看到分配给自己的订单。

Q5：数据库满了怎么办？

系统在 400MB 时自动深度清理，也可在写手管理页手动清理；仍紧张可升级 Workers 付费版（单库上限 10GB）。

12更新历史

v1.4（2026-08-11）

  • 修复：手机端输入长句时输入法提前关闭的问题（所有聊天输入框统一使用 <textarea> + enterkeyhint="send" + 自动扩展高度）
  • 优化：管理后台订单列表和详情页增加一键复制客户免登录链接按钮
  • 优化：新建订单完成后自动复制客户链接到剪贴板
  • 文档：手册中所有平台入口使用完整网址

v1.3（2026-08-10）

  • 文档：管理后台使用文档入口，系统更新同步维护

v1.2（2026-08-10）

  • 新增：写手独立工作台（writer.html）
  • 新增：通讯录与私聊（写手之间、写手与管理员）
  • 新增：内部论坛（发帖、回复、管理员删除）
  • 新增：管理后台订单显示客户免登录链接