AIGroupChat

AIGroupChat 是一个面向“单活动 AI 群聊导览剧本”的技术验证项目。它把管理端活动/讲解点数据、机器人模板、静态剧本生成、剧本发布校验，以及运行时用户插话回复串成一个完整闭环。

项目概述

后端框架: FastAPI
核心协议: Responses API
数据边界: 一个群聊实例只绑定一个活动，剧本中的讲解点卡片只保存 tourPointId
主要形态: 后端接口 + 内置测试页 + 静态 MVP 前端示例 + OpenAPI 描述
目标闭环: 管理端讲解点读取 → 机器人模板配置 → 静态剧本生成/发布 → 运行时插话“托住 + 绕回”

项目结构

AIGroupChat/
├── backend/
│   ├── main.py                         # FastAPI 入口
│   ├── routes/ai_group_chat.py         # 主业务路由
│   ├── services/
│   │   ├── admin_api_client.py         # 管理端活动/讲解点读取
│   │   ├── admin_auth_service.py       # 管理端自动登录
│   │   ├── llm_responses_service.py    # Responses API 适配
│   │   ├── bot_config_store.py         # 机器人模板文件存储
│   │   └── script_store.py             # 剧本文件存储/发布
│   ├── data/ai_chat_group/             # 模板与剧本持久化
│   └── static/ai-chat-group.html       # 后端内置手工测试页
├── frontend/ai-group-chat-mvp/         # 无构建依赖的静态前端示例
├── docs/AIGroupChat技术文档.md         # 功能说明
└── openapi/                            # 后端与生成相关 OpenAPI 文件