信息架构
路由组织
系统按角色入口分三类路由。客户路由包括 /widget/[slug] 聊天入口和嵌入式 /embed.js 脚本;管理员路由收敛在 /admin/* 下,包含登录、会话、工单、知识库、Prompt、订单、设置和数据看板;公开展示与文档路由是 /showcase 和 /docs/[...slug]。
商家后台导航
| 入口 | 路径 | 主要内容 |
|---|---|---|
| 数据看板 | /admin/dashboard | 顶部 6 数字、3 条自动洞察、6 张图表 |
| 会话管理 | /admin/conversations | 实时队列、待接管红点、详情接管 |
| 工单 | /admin/tickets | 列表筛选、详情处理、原会话上下文 |
| 知识库 | /admin/kb | 分类树、条目列表、编辑器、命中率统计 |
| Prompt 版本 | /admin/prompts | 版本卡片、行级 diff、一键激活 |
| 订单 | /admin/orders | 订单状态、骑手信息、预计送达 |
| 设置 | /admin/settings | 店铺信息、营业时间、品牌配置 |
后台采用左侧 sidebar 加右侧主内容区的两栏布局,所有页面共用同一个 AdminShell 组件,确保导航、登录态和品牌信息一致。
文档中心
文档中心 /docs 左侧为目录树,右侧为阅读面板,顶部为面包屑。目录按业务问题组织:产品视角、对话设计、知识库、转人工、Prompt 工程、数据与质检、案例复盘、技术实现、路线图。商家管理员、客服主管和接手维护的工程师都能从同一棵树进入感兴趣的主题。
设计原则
信息架构按「用户当前最关心什么」组织,而不是按代码模块组织。客户进入 Widget 直接聊天,不需要先注册或选择分类;商家管理员进入后台直接看待接管会话,不需要先配置工作台;阅读文档的人按问题("怎么定义解决率?")找入口,不需要先理解系统架构。