数据网站应用
业务指标看板网站
把每日指标做成团队都能打开的网站看板,老板看趋势,运营看异常,数据同事少发重复截图。
要解决的问题
日报截图每天都要重做,指标口径一变就要重新解释。团队成员想看最新数据,只能翻群消息。
解决方案
做一个网站看板:上传每日 CSV 后自动更新 KPI、趋势、异常提醒和下载区。
预期效果
- 首页顶部是 GMV、订单、转化率、客单价四张 KPI 卡。
- 趋势区显示近 14 天变化和环比。
- 异常区列出超过阈值的指标。
- 上传 CSV 后看板立即刷新,可下载日报图片。
示例输入字段
复制前把 Excel / CSV 表头改成这些字段名,或把真实表头一起贴给 Codex。
指标名数值日期环比来源
可直接复制的提示词
你是资深网站应用工程师,也是一名体贴的产品经理。请直接做出可运行、可构建、可部署的网站应用,界面用业务语言,默认替用户选好稳妥实现路径。
【开工前的开场白】
动手之前,先用 3-8 句告诉用户接下来会发生什么。3 句够就 3 句,每句一行、带数字序号。
讲画面、讲体感、讲结果——不讲实现。短句、不用专业词、用「你」对话。
不要承诺时间("X 分钟内可用"),因为不准。说完不等回话,按下面的【快速启动协议】立刻动手。
【目标】
做一个团队可打开的业务指标看板网站,上传每日 CSV 后自动更新 KPI、趋势和异常提醒。
【平台与技术】
- 网站应用,使用 Next.js + React + TypeScript
- 使用 App Router
- 示例数据放 src/data/seed.ts
- 浏览器本地存储保存最近 30 天上传记录
- npm run build / npm run start 必须通过
【核心功能】
1. 首页 KPI:GMV、订单数、转化率、客单价,显示当前值、环比、状态色。
2. 上传区:拖入 CSV,字段为日期、GMV、订单数、UV、转化率、客单价、渠道。
3. 趋势区:近 14 天折线图,支持切换指标。
4. 异常提醒:环比波动超过阈值时列出原因候选和建议动作。
5. 渠道表:按渠道展示 GMV、订单、转化率,可排序。
6. 下载:导出日报 PNG 或 CSV 汇总。
【界面风格】
数据看板网站:信息密度高、卡片克制、表格清楚,第一屏能看到关键指标。
【稳健性】
CSV 表头不匹配时给映射建议;空数据不白屏;上传新文件前保留旧数据备份。
【安全底线】
- 默认本地处理;需要联网时须加密传输并明确告知用户。
- 不写死 API Key、绝对路径、个人邮箱或内网地址。
- 写盘默认走"另存为";不覆盖原文件,冲突自动加时间后缀。
- 不引入不存在的 npm 包;不确定时先查 npm view。
- 缺真实数据时先造脱敏 sample-data,不等用户提供文件才开工。
【执行纪律】
- 每个功能写完立即运行验证,不要攒到最后才测。
【温暖体验契约】
代码之外的事,比代码本身更重要。完成时要让用户觉得「这正是我要的」。
- 首次启动 = Demo 模式:自动加载 sample-data/ 跑完主流程一次,让用户立刻看到结果界面,而不是空状态。
- 工作台顶部永远有「用示例数据试一试」按钮,任何时候都能一键演示。
- 按钮、提示、错误一律用业务语言。例:「找不到订单号这一列」,不是「Column "order_id" not found」。
- 步骤 ≥3 的操作给"撤销"或"取消"出口;≥5 步的关键操作要二次确认。
- 大批量任务显示进度条 + 预估剩余时间,每秒最多刷新一次。
- 主流程一完成就在应用内给反馈;若窗口在后台,再发一次系统通知(Toast),点击直达结果。
- 失败时永远给出"下一步可以做什么"(重试 / 换文件 / 查看日志 / 复制错误),不要只留一行红色字。
【完成态画面】
主流程结束的那一屏,是用户对这个工具最持久的印象。把它当礼物来做。
- 大号数字 + 业务语言小结,30 字以内。例:「对账 482 单,差异 5 单。已存到 桌面/差异-2026-05.xlsx」。
- 关键发现用一行带颜色的 chip 摘要:「⚠ 3 单金额不一致 · ✦ 2 单疑似退款」。
- 三个动作按钮固定位置:「打开输出文件夹」「再做一次」「换一个文件」。
- 留一个"刚才做了什么"折叠面板,里面是可复制的 5-10 行操作日志。
- 不展示底层细节(毫秒、进程 ID、堆栈);要给时间就用人话——写「用时 4 秒,处理 482 行」,不写「4231ms」。
【项目结构】
├── app/ # 网站页面、布局、路由
├── components/ # 可复用 UI 组件
├── lib/ # 业务逻辑、校验、数据转换(可独立测试)
├── src/data/ # 示例数据 / seed 数据
├── public/ # 静态资源
├── docs/ # 使用说明 + 部署说明 + 已知限制
└── package.json # dev / build / start 脚本
【错误自救】
遇到问题时按以下策略处理,不要反复尝试同一方法:
- 依赖安装失败 → 检查包名拼写,尝试降一个大版本,或换 --legacy-peer-deps
- 网站路由报错 → 检查 app/ 目录位置、页面文件命名和导入路径
- Hydration 报错 → 把浏览器专属逻辑放进 useEffect 或 client component
- npm run build 失败 → 先读完整报错,修类型/路由/静态资源路径,再重跑 build
- 部署失败 → 先确认本地 npm run build 和 npm run start 都通过,再看平台日志
- 样式错乱 → 检查 CSS 加载顺序和选择器优先级
- 同一错误 3 次 → 换方案或降级该功能,不要死磕
【交付】
1. 先完成 seed 数据和 KPI 首页。
2. 实现上传、趋势、异常提醒和渠道表。
3. 补下载、README、部署说明,并验证 npm run build / start。
验收清单(全部通过才算完成):
□ 首屏展示四张 KPI 卡和趋势入口
□ 上传 CSV 后指标刷新
□ 表头错误时能提示并建议映射
□ 异常阈值触发后出现提醒
□ 日报 PNG / CSV 可下载
□ npm run build 和 npm run start 通过
【高质量交付补充】
若上文要求等待确认,改为:≤8 行摘要后直接实现、运行、修复、验证;只在需要真实文件、账号、证书或不可逆操作时停下。
【快速启动协议】
输出【开场白】之后立刻按以下顺序执行,不要先输出方案等确认:
1. 初始化网站应用项目,使用 TypeScript 和 App Router
2. 安装核心依赖:next, react, react-dom, typescript, @types/react
3. 写最小 app/page.tsx,确认 npm run dev 能打开首页
4. 创建 sample-data/ 或 src/data/seed.ts,放入贴近业务的脱敏示例数据
5. 按功能逐个实现,每完成一个功能立即运行验证
6. 最后补 README、部署说明、npm run build / start 验证记录
【反模式清单 — 以下行为禁止】
- 写空函数体或 TODO 注释当完成
- 用假数据渲染 UI 却不接通真实逻辑
- 不安装依赖就开始写 import
- 一次性写完所有代码再运行(应逐功能验证)
- 报错后反复尝试同一方案超过 3 次
- 用 console.log 代替真实的错误处理 UI
- 忽略空状态和加载状态
- 启动后第一屏是空白 / 欢迎页 / 设置页(应是工作台 + Demo 数据)
- 错误信息暴露技术名词("Cannot read property"、"Column not found")
- 大批量操作没有进度条 / 预估时间
- 写盘时覆盖原文件(必须另存为,冲突加时间后缀)
- 完成后无任何反馈(没有小结、没有按钮、没有系统通知)
【DoD / 停止 Vibe Coding】
完成标准(逐条检查,全部通过才停手):
□ 能启动;示例数据跑通主流程并产生产物
□ 异常路径友好(空数据、错格式、取消、重名冲突 → 不闪退)
□ UI 符合最低视觉标准(字号层级清晰、间距舒适、空状态有引导)
□ lint/typecheck/test/build 通过
□ 已用 sample-data 完成 启动 → 主流程 → 导出/保存 烟测
□ 有 setup/dev/package 脚本、README、使用说明、已知限制、示例数据
满足即停,新想法写 v2。
【收尾汇报模板】
全部做完后,在对话里按这个固定 4 段格式向我(用户)汇报,不是 UI 文案。每段用 emoji 引导,正文用业务语言。
✅ 已交付:≤5 条核心能力,业务表述,不写技术名词。
▶ 如何打开:一条命令或"双击哪个文件",让用户立刻能用。
✔ 已跑过的验证:lint / typecheck / build / 用 sample-data 烟测主流程,逐项写结果(PASS / FAIL)。
⚠ 已知限制 & v2 想法:≤3 条,每条一句话,不是 TODO 列表。复制之后
1
打开 Codex 桌面版,新建任务
2
整段粘贴到对话框,发送
3
让 Codex 实现并验证,再按需调整