venue-operations-research-backlog.md 13.4 KB

Raw Blame History Permalink



场馆运营反馈调研平台实施 Backlog

版本：V1.1

状态：Draft

更新时间：2026-03-26

本文档用于把《场馆运营反馈调研平台 PRD》拆成可执行任务。原则上分为四个阶段推进，并按五个实施包协同落地：


前端与交互
后端 API 与任务编排
Agent / Prompt 与分析逻辑
数据模型与存储
报告模板与交付


1. 实施原则


保留现有三引擎分析界面与最终输出界面，不做推倒重写。
所有功能统一通过 Docker 容器启动与运行。
爬虫相关能力必须通过前端按钮触发，不再依赖人工 CLI。
新增能力优先围绕“场馆研究任务”组织，而不是继续围绕泛关键词查询。
每个阶段都要形成可演示、可验证、可回归的增量版本。


2. 当前进度快照（2026-03-26）

已完成首版：


P1-01 场馆研究任务入口
P1-02 前端爬虫控制台
P1-04 首版场馆报告模板
P1-05 本地模型与空 key 兼容收口
P1-07 Docker 统一运行校验
P1-08 前端状态保持与刷新恢复
P1-09 报告任务列表与历史恢复


已完成首版但仍需继续收口：


P1-03 三引擎语义重构
P1-06 UI 极简风格与高分辨率适配


已完成第二轮收口：


前端主界面已迁移为 Vue 3 + Vite + TypeScript 组件化工作台
顶部研究概览、快速跳转导航与高分辨率布局已完成首版落地
研究任务、爬虫控制、引擎工作台、报告中心已拆分为多组件结构，减少单文件前端代码体量


下一批优先推进：


P2-01 建立场馆核心实体
P2-02 建立证据与结论模型
P2-03 运营维度标签体系
报告页签交互锁定逻辑收口
竞品对比与结构化建议输出


说明：


当前任务与历史任务已分别通过 var/logs/venue_research_tasks.json 和 var/reports/final/.task_registry/ 持久化。
当前文档之外的长期交接信息统一维护在 docs/venue-operations-research-project-memory.md。


3. 实施包拆分


包 A：前端与交互

目标：把当前系统改造成一个可长期使用的场馆研究工作台，同时解决高分辨率适配、页面不可滚动与风格统一问题。

涉及模块：


frontend/src/
static/frontend/

templates/index.html（仅兜底）
app.py
SingleEngineApp/*.py


交付物：


场馆研究任务入口
数据采集中心
三引擎保留式重构界面
竞品对比与建议面板
极简主义 UI、响应式布局、高分辨率适配


包 B：后端 API 与任务编排

目标：把研究任务、爬虫控制、状态同步、报告生成组织成统一服务层。

涉及模块：


app.py
backend/crawler/
config.py
Docker 相关编排文件


交付物：


场馆研究任务 API
平台登录状态查询 API
爬虫启动 / 停止 / 模式切换 API
多引擎执行编排与任务状态追踪


包 C：Agent / Prompt 与分析逻辑

目标：将“舆情分析”语义替换为“场馆运营反馈研究”，并让三引擎与论坛协作输出运营改进结论。

涉及模块：


InsightEngine/
QueryEngine/
MediaEngine/
ForumEngine/
ReportEngine/prompts/


交付物：


新研究主题提示词
运营维度标签与分类逻辑
证据引用与建议生成逻辑
竞品 / 标杆分析提示词


包 D：数据模型与存储

目标：为任务、场馆、证据、标签、结论和建议建立结构化存储，为后续趋势与竞品分析打基础。

涉及模块：


db
config.py
引擎数据写入与读取逻辑


交付物：


Venue 相关实体
任务与证据表
运营维度标签体系
结论与建议持久化模型


包 E：报告模板与交付

目标：将最终报告从“舆情报告”改造成“场馆运营反馈调研报告”，并保留现有报告生产链路。

涉及模块：


ReportEngine/report_template/
ReportEngine/agent.py
ReportEngine/renderers/
var/reports/final/


交付物：


场馆运营反馈诊断报告模板
优点 / 待改进点 / 建议优先级展示模板
竞品与标杆对比模板
保留 HTML 输出，后续扩展 PDF


4. Phase 1：MVP 语义切换与最小可用版本

目标：在不推翻现有结构的前提下，让系统第一次真正可用于“场馆运营反馈调研”。


P1-01 场馆研究任务入口


优先级：P0
实施包：A + B
当前状态：已完成首版
任务内容：将首页主入口从泛查询改为“场馆研究任务”创建表单。
依赖：无
验收标准：


支持输入场馆名称、城市、场馆类型、研究主题、时间范围。
创建任务后可进入任务详情页并看到状态流转。


P1-02 前端爬虫控制台


优先级：P0
实施包：A + B
当前状态：已完成首版
任务内容：把现有爬虫控制能力统一成页面按钮触发流程。
依赖：backend/crawler/ 当前能力（根目录 crawler_web.py 仅保留兼容转发）
验收标准：


支持平台登录、登录状态检测、采集模式选择、手动启动。
登录失效时页面给出明确提示。
不再要求用户在容器内手工执行 CLI。


P1-03 三引擎语义重构


优先级：P0
实施包：A + C
当前状态：已完成首版，持续优化中
任务内容：保留三引擎界面和输出区域，但重命名与重构其研究语义。
依赖：现有 Streamlit 单引擎应用
验收标准：


页面仍保留 Insight / Query / Media 三类分析结果。
引擎说明、字段名称、示例结果切换为场馆运营反馈场景。


P1-04 首版场馆报告模板


优先级：P0
实施包：C + E
当前状态：已完成首版
任务内容：新增场馆调研报告模板，并让 ReportEngine 可以优先选择新模板。
依赖：P1-03
验收标准：


报告至少输出场馆概览、优点、待改进点、建议优先级、证据摘要。
报告正文不再使用“舆情”“危机公关”等旧术语作为主表达。


P1-05 本地模型与空 key 兼容收口


优先级：P0
实施包：B + C
当前状态：已完成
任务内容：统一本地 Ollama 配置与空 key 行为，避免引擎配置散落。
依赖：当前本地模型接入改造
验收标准：


主流程默认可使用 http://192.168.220.11 上的 qwen3.5:27b。
未配置 key 时系统不因校验失败而阻塞。


P1-06 UI 极简风格与高分辨率适配


优先级：P1
实施包：A
当前状态：已完成首版，持续优化中
任务内容：优化信息架构、布局、留白、字体层级与滚动体验。
依赖：P1-01
验收标准：


页面在 1440p、2K、4K 下布局稳定。
页面支持滚动，核心结果区不再被固定高度截断。
保留原有关键输出能力，同时视觉风格统一。
前端不再依赖超大单文件模板，核心工作台已拆分为可维护的 Vue 组件结构。


P1-07 Docker 统一运行校验


优先级：P0
实施包：B
当前状态：已完成
任务内容：保证主站、数据库、爬虫依赖与报告链路都纳入 docker compose。
依赖：P1-02
验收标准：


使用统一命令即可完成构建与启动。
文档、日志、浏览器数据、报告目录均能正确挂载。


P1-08 前端状态保持与刷新恢复


优先级：P0
实施包：A + B + E
当前状态：已完成
任务内容：让前端在刷新后恢复研究任务、爬虫配置、自定义模板、当前页签与报告查看状态。
依赖：P1-01、P1-02、P1-04
验收标准：


页面刷新后可恢复场馆研究表单与研究摘要。
页面刷新后可恢复爬虫配置与最近一次选择的平台参数。
页面刷新后可恢复报告页当前查看态与自定义模板内容。


P1-09 报告任务列表与历史恢复


优先级：P0
实施包：B + E
当前状态：已完成
任务内容：为报告模块增加任务列表、历史查询与容器重启后的结果恢复能力。
依赖：P1-04、P1-07
验收标准：


/api/report/tasks 可返回当前任务与历史任务快照。
报告任务快照会落盘到 var/reports/final/.task_registry/。
容器重建后仍可从历史任务重新预览和下载已生成的 HTML 结果。


5. Phase 2：场馆专用数据模型与结构化分析

目标：让系统从“会写一份报告”升级为“会沉淀结构化洞察”。


P2-01 建立场馆核心实体


优先级：P0
实施包：D
任务内容：新增 Venue、VenueAlias、VenueResearchTask 等核心实体。
依赖：P1-01
验收标准：


同一场馆的多次研究任务可归属到统一实体。
支持存储别名、城市、类型、竞品候选、票价区间等基础信息。


P2-02 建立证据与结论模型


优先级：P0
实施包：C + D
任务内容：将评论、帖子、页面摘要、证据引用、问题项、优点项、建议项结构化持久化。
依赖：P2-01
验收标准：


每条结论至少可映射到一个证据片段。
结论具备来源平台、时间、标签、情绪与置信信息。


P2-03 运营维度标签体系


优先级：P0
实施包：C + D
任务内容：建立面向场馆运营的统一标签体系。
依赖：P2-02
验收标准：


至少支持展陈内容、空间动线、服务、票价、排队、亲子友好、拍照出片、交通配套等维度。
支持同一证据多标签归类。


P2-04 问题优先级与建议结构化


优先级：P1
实施包：C + D + E
任务内容：让“建议”从自然语言段落变成结构化行动项。
依赖：P2-03
验收标准：


每条建议具备对应问题、影响范围、优先级、建议动作、预期收益字段。


6. Phase 3：竞品与标杆研究能力

目标：让平台从“只看自己”进化到“可对比同类场馆”。


P3-01 竞品输入与归档


优先级：P1
实施包：A + D
任务内容：支持手动指定或自动推荐竞品 / 标杆场馆。
依赖：P2-01
验收标准：


支持一个主场馆绑定多个竞品。
竞品可单独发起研究任务或复用已有任务结果。


P3-02 竞品分析 Prompt 与汇总逻辑


优先级：P1
实施包：C
任务内容：新增竞品对比提示词和多 Agent 汇总策略。
依赖：P2-03
验收标准：


输出至少包含好评点差异、差评点差异、传播亮点差异、可借鉴动作。


P3-03 竞品对比界面与报告


优先级：P1
实施包：A + E
任务内容：新增竞品对比视图与专门报告模板。
依赖：P3-02
验收标准：


支持表格式、卡片式或矩阵式展示多场馆差异。
报告中能明确标示“当前场馆短板”和“可借鉴做法”。


7. Phase 4：运营复盘与平台化增强

目标：把一次性调研工具扩展为持续可用的运营研究平台。


P4-01 趋势与周期复盘


优先级：P2
实施包：A + C + D
任务内容：支持按周、按月观察场馆反馈变化。
依赖：P2-02
验收标准：


可查看某维度的正负反馈变化趋势。
可查看某问题是否在连续任务中反复出现。


P4-02 建议跟踪与复盘闭环


优先级：P2
实施包：A + D
任务内容：支持对建议项标记状态并做后续复盘。
依赖：P2-04
验收标准：


建议项支持未处理、处理中、已验证等状态。
后续研究任务可回看某建议是否产生效果。


P4-03 权限与平台化增强


优先级：P3
实施包：B + D
任务内容：视实际需要追加任务共享、组织管理、权限控制等平台能力。
依赖：实际业务推广需求
验收标准：


需求明确前保持 TBD，不提前过度设计。


8. 推荐实施顺序


第一批必须落地


P1-01 场馆研究任务入口
P1-02 前端爬虫控制台
P1-03 三引擎语义重构
P1-04 首版场馆报告模板
P1-05 本地模型与空 key 兼容收口
P1-07 Docker 统一运行校验


第二批高价值增强


P1-06 UI 极简风格与高分辨率适配
P2-01 建立场馆核心实体
P2-02 建立证据与结论模型
P2-03 运营维度标签体系
P2-04 问题优先级与建议结构化


第三批形成差异化能力


P3-01 竞品输入与归档
P3-02 竞品分析 Prompt 与汇总逻辑
P3-03 竞品对比界面与报告


9. Definition of Done

每个阶段完成时，至少要满足以下通用标准：


功能能在 Docker 环境下构建、启动并执行主流程。
关键界面有最小可用交互，不依赖命令行兜底。
关键输出字段与产品定位一致，不再出现主语义漂移。
至少有一条从“创建任务 -> 采集 -> 分析 -> 报告”的端到端验证链路。
新增文档、配置项和运行方式已在仓库内可追溯。


10. 当前建议的下一开发步

如果现在继续推进代码实施，建议直接进入以下顺序：


先收口报告页签与三引擎完成态之间的交互逻辑，确保历史报告可以稳定查看、切换和恢复。
进入 P2-01、P2-02，优先建立 Venue、研究任务、证据、结论的结构化模型，避免核心结果继续只停留在文件快照层。
随后推进 P2-03、P2-04，把运营维度标签、问题优先级和建议动作做成可查询、可统计、可复盘的数据结构。
在结构化基础稳定后，启动 P3-01 至 P3-03，把竞品 / 标杆场馆对比做成平台差异化能力。