旺小宝地产营销周报生成器

周报里到底卡在哪

地产项目营销周报通常要拼三块东西：旺小宝里的来访与顾问接待、盘客 CSV / 成交台账里的结构与意向，再加上操盘手口吻的结论与下周动作。手工对齐日期（默认上周一至上周日）、统一 visitCount 判首访复访、把 JSON 字段和 HTML 模板变量一一对应，往往比写分析段落更耗时间。

技能如何跑通一条流水线

触发词如「生成周报」「营销周报」「weekly report」后，流程大致是：

1. 确认参数：项目名、周区间；tenant_id、project_id、KB_ID 等可从 MEMORY.md 读取。
2. prepare_data.py：调用旺小宝 API，解析盘客 CSV 与成交 xlsx，输出与 template.py 变量名一致的 weekly_report_data.json（含 week_days、consultants_this、deals_*、交叉表等）。
3. 洞察撰写：按营销总监视角填充 insight_xxx、suggestions、summary_text——必须引用真实数字，禁止照搬上期文案。
4. generate_report.py：覆盖模板变量并渲染；默认 HTML + PDF（html2pdf_fast.py + Playwright/Chromium）；--html-only 可跳过 PDF，约 0.3 秒出 HTML，浏览器打印即可。

交付通过 preview_url 预览 HTML，并用 deliver_attachments 交双文件；排版为深蓝 header、卡片布局、静态 SVG 图表（打印友好）。

边界与注意点

• Logo（logo_wangai.png、logo_wangxiaobao.png）需与生成 HTML 同目录。
• PDF 失败不会阻断 HTML；依赖 Python 3.8+ 与已生成的 weekly_report_data.json。
• 手动改 template.py DATA 区已废弃；交叉分析表由 prepare_data.py 自动生成。
• 日期用 datetime.weekday() 与 visitTime 过滤，勿硬编码星期。