FuelWatch — 南非众包燃油价格追踪器

概述

FuelWatch 是一款面向移动设备优先的 Web 应用，用于追踪南非各加油站柴油/汽油的价格与供应情况。该应用诞生于 2026 年伊朗战争引发的柴油短缺危机期间——当时柴油价格从约 R21 暴涨至 R28+，大量加油站断供。

在线访问地址： http://161.97.110.234:8080
文件路径： /root/fuelwatch/（含 index.html、style.css、app.js）
服务状态： systemctl status fuelwatch（自动重启，支持系统重启后持续运行）

架构设计

• 纯 HTML + 原生 JavaScript + CSS（无构建流程，不依赖任何前端框架）
• 数据暂存于 localStorage（原型阶段，尚无后端服务）
• 通过 systemd 托管的 Python HTTP 服务器提供静态资源服务

核心功能

• 加油站列表/卡片：名称、所在城区（suburb）、燃油类型、单价（每升）、供应状态
• 供应状态标识：🟢 有油 / 🟡 库存紧张 / 🔴 已售罄
• 超过 2 小时未更新的报告将标记为 ⚠️ 未经验证
• ➕ 报告表单（无需登录即可提交）
• 📤 分享按钮（调用系统原生分享或复制到剪贴板）
• 支持按城区/加油站名称搜索、按燃油类型筛选、按最新更新时间或价格排序
• 预置 8 条初始报告（若 localStorage 中已有数据则自动清空）
• 具备 XSS 防护能力（用户输入在渲染前已做转义处理）

应用扩展方案

参见 references/backend-plan.md 查看计划中的 Supabase 后端设计方案。

新增功能开发

修改 /root/fuelwatch/app.js 实现业务逻辑，style.css 调整样式，index.html 更新页面结构。无构建步骤——保存即生效，刷新浏览器即可查看变更效果。

部署更新

# 文件直出服务 —— 编辑后刷新浏览器即可生效
systemctl status fuelwatch   # 检查服务运行状态
systemctl restart fuelwatch  # 如需重启服务

接入真实后端（第二阶段）

• 采用 Supabase（免费版）：PostgreSQL 数据库 + REST API + 实时数据同步
• 在 app.js 中将 localStorage 的读写操作替换为 fetch() 请求
• 通过 CDN script 标签引入 Supabase JS 客户端
• 详见 references/backend-plan.md

WhatsApp 报告通道（第三阶段）

号码： +27822209212（Stef 的备用 WhatsApp 号码）

设计理念： 用户可通过 WhatsApp 发送文字消息或语音备忘录报告燃油供应情况；OpenClaw 接收后自动解析/转录，并提交至 FuelWatch 数据库。

工作流程：

1. 用户发送示例：“Shell Edenvale 柴油 R27.50 有油”（或发送语音备忘录）
2. OpenClaw 解析出结构化字段：加油站名称 / 所在城区 / 燃油类型 / 价格 / 供应状态
3. 自动写入 Supabase reports 表
4. Web 界面实时更新数据

设计原因： 卡车司机及道路使用者可在驾驶途中直接发送语音备忘录，实现零操作门槛，无需安装 App。

前提条件：

• WhatsApp 通道需对接 OpenClaw（使用 wacli 或 WAHA）
• Supabase 后端须已上线（须先完成第二阶段）
• 需实现自由文本报告的 NLP 解析能力（可基于 LLM 提取关键信息）
• 语音转文字：采用 OpenAI Whisper 或 Groq Whisper

参考文档： references/whatsapp-reporting.md（将在第三阶段开发启动时撰写）

公开发布营销计划（准备就绪后执行）

• 注册域名（如 fuelwatch.co.za 或类似域名）
• 部署至 Vercel（免费托管，执行 vercel --prod 命令，源路径为 /root/fuelwatch）
• 发布至南非主流 Facebook 社群（Arrive Alive、约翰内斯堡/开普敦/德班本地社群、卡车司机群组等）
• 推文推广：#DieselShortage #FuelCrisis #SouthAfrica —— @ArrivAlive @MyBroadband
• 在 IOL / MyBroadband 关于柴油危机的相关报道下留言互动
• 邮件联系 MyBroadband / CarMag 申请媒体报道（主题：“本地开发者在危机中快速构建的实用工具”）

竞品分析

myTank.co.za —— 当前主要竞品。提供油价对比与积分收益计算功能。缺失项：无供应状态显示、无众包机制、需注册账号方可查看价格、未针对紧急危机场景优化。

我方优势： “供应状态”（有油 / 库存紧张 / 已售罄）是本产品的核心差异化功能——这正是燃油短缺时期用户最迫切需要的信息。