WhatsApp -> Jira Ticket Bot

This is the canonical entrypoint for the ab-ticket-bot repository.

  • Local docs module: http://127.0.0.1:18081/
  • Local jobs module: no HTTP endpoint, use logs and CSV runtime state
  • Production docs URL: https://ab-ticket-bot-docs.mathbox.90.cz/
  • Production jobs URL: no HTTP endpoint

Current Modules

  • ab-ticket-bot-jobs: long-running worker that polls WhatsApp Adapter, deduplicates messages, and creates or updates Jira issues
  • ab-ticket-bot-docs: packaging module that serves the canonical root documentation site

Canonical Project Docs

Kontext

Cilem je provozovat nastroj, ktery bude ze zprav ve WhatsApp skupine Tipy na AB testy automaticky zakladat a aktualizovat tickety v Jire.

Analyza

Navrh zadani chovani bota, obecny model temat a konkretni sledovana temata jsou v samostatnem dokumentu Analyza.

Minimalni scope MVP

  • Prijem a parsovani zprav s prefixem sledovaneho tematu (napr. ab<cislo> nebo zkl<cislo>).
  • Vytvoreni ticketu v Jire pro nove zadani ve sledovanem tematu.
  • Ukladani mapovani <tema><cislo> -> Jira issue key do CSV souboru.
  • Ukladani autor kontextu (author -> active_topic_id + closed) do samostatneho CSV souboru.
  • Pri chybejicim lokalnim mapovani dohledat existujici Jira ticket a napojit mapovani.
  • Moznost doplnovat dalsi zpravy ke stavajicimu ticketu.
  • Zpetna kontrola historie za poslednich 10 dni po startu sluzby.
  • Zakladni logovani a retry pri chybe API.
  • Ukladani logu na server.

Out of scope

  1. Dalsi prace s tickety, napriklad notifikace o vyreseni, zmena stavu nebo automaticke uzavirani.
  2. Pokud je zprava po odeslani editovana nebo smazana, bot na tuto zmenu nereaguje.

Souvisejici dokumentace