dienst_echo_whatsappgroep/docs/superpowers/plans/2025-05-12-daily-summary.md

Dagelijkse WhatsApp samenvatting — Implementation Plan

Voor agentic workers: REQUIRED SUB-SKILL: Gebruik superpowers:subagent-driven-development (aanbevolen) of superpowers:executing-plans om dit plan taak-voor-taak te implementeren. Stappen gebruiken checkbox (- [ ]) syntax voor tracking.

Goal: Elke dag om 10:00 een WhatsApp-bericht naar de admin sturen met het totaal aantal dienstaanvragen van de vorige dag.

Architecture: Nieuwe module dailyStats.js houdt een dagtotaal bij in memory. messageHandler.js roept increment aan bij elke aanvraag. node-cron triggert om 10:00 de reset en verzending via bestaande whatsappApi.sendTextMessage().

Tech Stack: Node.js, node-cron (nieuwe dependency), bestaande axios/express stack

Files:

• Create: src/dailyStats.js
• Modify: src/messageHandler.js
• Modify: src/index.js
• Modify: package.json

---

Task 1: Create dailyStats module

Files:

• Create: src/dailyStats.js

• Step 1: Write the dailyStats module

let dailyTotal = 0
let yesterdayTotal = 0

function increment() {
  dailyTotal++
}

function getYesterdayTotal() {
  return yesterdayTotal
}

function resetDay() {
  yesterdayTotal = dailyTotal
  dailyTotal = 0
}

module.exports = { increment, getYesterdayTotal, resetDay }

• Step 2: Verify the module loads without errors

Run: node -e "const m = require('./src/dailyStats'); m.increment(); m.increment(); m.resetDay(); console.log(m.getYesterdayTotal() === 2 ? 'OK' : 'FAIL')" Expected: OK

• Step 3: Commit

git add src/dailyStats.js
git commit -m "feat: add dailyStats module for tracking daily request totals"

---

Task 2: Integrate dailyStats into messageHandler

Files:

• Modify: src/messageHandler.js

• Step 1: Add dailyStats import and increment call

src/messageHandler.js line 1-4, add import:

const { findDienst, getPngFilePaths } = require('./dienstService')
const { sendTextMessage, sendImageMessage, notifyAdmin } = require('./whatsappApi')
const { checkLimit, increment, MAX_REQUESTS_PER_DAY } = require('./rateLimiter')
const { increment: incrementDaily } = require('./dailyStats')

src/messageHandler.js after increment(author) (line 51), add:

  increment(author)
  incrementDaily()

• Step 2: Verify messageHandler still loads

Run: node -e "require('./src/messageHandler'); console.log('OK')" Expected: OK (may show dotenv warning, that's fine)

• Step 3: Commit

git add src/messageHandler.js
git commit -m "feat: integrate dailyStats counter into message handler"

---

Task 3: Add node-cron and schedule daily 10:00 summary

Files:

• Modify: package.json

• Modify: src/index.js

• Step 1: Install node-cron

Run: npm install node-cron Expected: node-cron added to node_modules and package.json

• Step 2: Add cron job to index.js

src/index.js — replace the entire file:

require('dotenv').config()
const cron = require('node-cron')
const express = require('express')
const { handleWebhook } = require('./messageHandler')
const { loadDiensten } = require('./dienstService')
const { resetDay, getYesterdayTotal } = require('./dailyStats')
const { sendTextMessage } = require('./whatsappApi')

const app = express()
app.use(express.json({ limit: '10mb' }))

app.post('/webhook', async (req, res) => {
  try {
    await handleWebhook(req.body)
    res.json({ success: true })
  } catch (err) {
    console.error('Webhook processing error:', err.message)
    res.status(500).json({ success: false, error: err.message })
  }
})

app.get('/health', (req, res) => {
  res.json({ status: 'ok' })
})

const PORT = process.env.WEBHOOK_PORT || 3002

loadDiensten()

cron.schedule('0 10 * * *', () => {
  const adminNumber = process.env.ADMIN_NUMBER
  if (!adminNumber) {
    console.error('ADMIN_NUMBER not configured, skipping daily summary')
    return
  }

  resetDay()
  const total = getYesterdayTotal()

  sendTextMessage(adminNumber, `Aantal dienstaanvragen gisteren: ${total}`)
    .then(() => console.log(`Daily summary sent: ${total} requests`))
    .catch(err => console.error('Failed to send daily summary:', err.message))
})

app.listen(PORT, () => {
  console.log(`dienst-bot listening on port ${PORT}`)
  console.log(`Allowed group: ${process.env.ALLOWED_GROUP}`)
  console.log(`Bot name: ${process.env.BOT_NAME}`)
  console.log('Daily summary cron job scheduled for 10:00')
})

• Step 3: Verify server starts without errors

Run: timeout 3 node src/index.js || true Expected: Output shows dienst-bot listening on port ... and Daily summary cron job scheduled for 10:00

• Step 4: Test cron callback manually

Run: node -e " require('dotenv').config() const { increment, resetDay, getYesterdayTotal } = require('./src/dailyStats') increment() increment() increment() resetDay() console.log('Total:', getYesterdayTotal()) console.log(getYesterdayTotal() === 3 ? 'PASS' : 'FAIL') " Expected: Total: 3 followed by PASS

• Step 5: Commit

git add package.json package-lock.json src/index.js
git commit -m "feat: add node-cron daily summary job at 10:00"

---

Task 4: Verify end-to-end flow

Files: (none, verification only)

• Step 1: Start the server

Run: node src/index.js & Wait 2 seconds for startup.

• Step 2: Simulate a webhook request to increment the counter

Run:

curl -s -X POST http://localhost:3002/webhook \
  -H 'Content-Type: application/json' \
  -d '{"dataType":"message","sessionId":"EdGpt","data":{"message":{"from":"120363407356808413@g.us","fromMe":false,"author":"test@c.us","body":"@EdGpt 0001","_data":{"mentionedJidList":["bot@c.us"]}}}}}'

Expected: {"success":true}

• Step 3: Trigger the cron callback directly to verify summary message

Run:

node -e "
require('dotenv').config()
const { resetDay, getYesterdayTotal } = require('./src/dailyStats')
const { sendTextMessage } = require('./src/whatsappApi')
resetDay()
const total = getYesterdayTotal()
console.log('Would send to admin:', process.env.ADMIN_NUMBER)
console.log('Message:', 'Aantal dienstaanvragen gisteren: ' + total)
console.log(total > 0 ? 'PASS' : 'FAIL - expected >0')
"

Expected: PASS (shows message with total > 0)

• Step 4: Stop the server

Run: kill %1 2>/dev/null; true

• Step 5: Commit any remaining changes

git status
# Only commit if there are remaining changes