Skip to content

Dirman Assist Documentation Index

Welcome to the technical documentation suite for Dirman Assist, the self-hosted WhatsApp helpdesk, management dashboard, ticket triage platform, and PostgreSQL retrieval-augmented knowledge base for P3MDI Sudirman.

This index organizes the 7 canonical engineering documents across the Design, Data, and Software Engineering pillars alongside all 22 specialized feature and operational guides in docs/.


Document ID Document Standard Alignment Scope
DA-ARCH-001 ARCHITECTURE.md ISO/IEC/IEEE 42010 & IEEE 1016 Multi-container Docker Compose topology (postgres, api, worker, dashboard, topic-worker, pdf-worker, waha), network segmentation, end-to-end runtime flows, resource budgets, and provider fallback design.
DA-DES-001 DESIGN_SYSTEM.md WCAG 2.1 AA P3MDI Sudirman crest-inspired visual identity, CSS custom property palette, self-hosted Manrope typography, desktop sidebar and mobile (<=768px) navigation, data visualizations, and accessibility rules.
Document ID Document Standard Alignment Scope
DA-DATA-001 DATA_MODEL.md DAMA-DMBOK Complete PostgreSQL ERD, 53-table Data Dictionary across 7 domains, key state machines (tickets, handoff, KB intake, PDFs, broadcasts), retention rules, and pg_trgm/GIN retrieval design.
DA-SEC-001 SECURITY_AND_PRIVACY.md OWASP / ISO 27001 / UU PDP No. 27/2022 Container & OS hardening, WAHA HMAC webhook verification, dashboard auth/RBAC/CSRF/password resets, PII redaction, prompt-injection boundaries, UU PDP alignment, and third-party risk disclosures.
Document ID Document Standard Alignment Scope
DA-API-001 API_AND_INTERFACES.md Interface Control Document (ICD) Complete contract for all 103 HTTP routes across api (app/main.py) and dashboard (app/dashboard.py + 11 routers), WAHA outbound client, Google/Cloudflare AI adapters, and PG-backed worker queues.
DA-ENG-001 ENGINEERING_AND_SDLC.md ISO/IEC/IEEE 12207 & 29119 Backend Python (36 files) & frontend static (13 CSS, 14 JS) module map, schema migration conventions, 36-file verification & Playwright testing pyramid, CI/CD gates, and Architecture Decision Records (ADRs).
DA-OPS-001 OPERATIONS_AND_DEPLOYMENT.md ISO/IEC/IEEE 26514 / SRE Server prerequisites, bootstrap/configure/pairing runbook, 20-variable environment catalog, Traefik public overlay, automated deploy/rollback pipeline, backup & restore drills, and troubleshooting.

Feature & Operational Deep-Dive Guides (22 Existing Documents)

Section titled “Feature & Operational Deep-Dive Guides (22 Existing Documents)”
Guide Summary
brand-redesign.md P3MDI Sudirman crest-inspired visual refresh (#031e39 navy, #dab36b gold, #a41213 red, #fbf8ef ivory), self-hosted Manrope typography, and interactive overview trend/status charts.
mobile-ticket-ux.md Mobile navigation drawer (<=768px), bottom shortcut bar, default ticket Daftar/Tabel/Kanban modes, unified status colors, and bulk selection UX.
dashboard-plan.md Initial architecture and scope specification for the standalone FastAPI management dashboard and secure cookie/CSRF controls.
natural-ticket-plan.md Design plan for bounded single-call Gemma JSON ticket actions, consent enforcement, and polite out-of-scope referrals to Divisi Risdikti / Komandan Elemen.

Knowledge Base, Retrieval, PDFs & Topic Graph

Section titled “Knowledge Base, Retrieval, PDFs & Topic Graph”
Guide Summary
knowledge-retrieval.md PostgreSQL lexical/synonym/fuzzy RAG pipeline (pg_trgm + weighted tsvector), 10,000-character evidence budget, citation verification, and screenshot keyword extraction.
retrieval-acronyms-and-context.md Root-cause diagnosis and remediation for short acronyms (IB / Izin Bermalam, WA), heading vs. alias weights, 32-term query preservation, and excerpt selection.
pdf-knowledge.md Isolated pdf-worker ingestion pipeline (pdftotext, pdftoppm, tesseract ind+eng), page-level sectioning, private previews, document replacement, and admin account CRUD lifecycle.
knowledge-graph.md Knowledge Base coverage graph (Peta Pengetahuan) linking AI-classified content topics, published/review sources, governance relations, and saved retrieval checks.
content-topic-categorization.md Quota-budgeted, idle-only topic-worker classifier (knowledge_topics) with strict 20% RPM/RPD, 50% TPM, and 12 batches/day safety caps.
knowledge-intake.md Allowlisted WhatsApp contributor submissions (/pengetahuan, /adendum, forwarded text), before/after audit history, and WhatsApp profile name resolution (pushName//nama).
natural-language-intake.md Deterministic Indonesian/English natural-language knowledge creation/addendum parser (app/intake_language.py) with 15-minute multi-turn target selection.
trusted-knowledge-publication.md Trusted contributor auto_publish workflow requiring a single-line title (3–300 chars), optimistic revision checks, and non-destructive addendum replacements.

Helpdesk Operations, Ticketing, Cases & Broadcasts

Section titled “Helpdesk Operations, Ticketing, Cases & Broadcasts”
Guide Summary
accounts-and-cases.md Dashboard password-reset tokens (/reset#TOKEN), 30-day case archiving, human handoff (claim/release/resume), 2-working-hour SLA target, and WhatsApp app echo suppression.
ticket-management.md Ticket triage (Tabel/Papan Kanban), priorities/categories/due dates, atomic 50-item bulk updates, optimistic locking (version), and 15-exchange AI memory.
admin-duty-notifications.md Opt-in on-duty administrator alerts (admin_duty, ticket_open_events, ticket_notifications) with at-most-once delivery claims and 5-second shared send pacing.
broadcasts.md Opt-in WhatsApp announcements (DAFTAR PENGUMUMAN / STOP PENGUMUMAN), approval digest verification, 09.00–18.00 WIB window, 30s gap, and 100/day cap.
Guide Summary
ai-configuration.md Model parameters (gemma-4-26b-a4b-it, gemma-4-31b-it), 10-section prompt editor, dry-run draft testing, 3-second WhatsApp message batching, and Cloudflare Workers AI fallback.
default-system-prompt.md Complete compiled reference output of the default system prompt including fixed rules, action JSON contract, and knowledge-grounding instructions.
operational-analytics.md Repeatable-read operational telemetry (analytics_messages), backlog/completion metrics, 7-day rolling MAE baseline forecast, capacity simulator, and CSV export.
Guide Summary
CI-CD.md GitHub Actions syntax, isolated test, and restricted SSH forced-command deployment workflow (.github/workflows/ci-deploy.yml & scripts/deploy-server.sh).
dashboard-deployment.md Production deployment notes and security verification history for the Traefik-fronted HTTPS management dashboard (https://assist.p3mdi.id).
TESTING.md Isolated disposable PostgreSQL Compose test suite (scripts/run-verification.sh), connected user journeys (tests/test_workflow_journeys.py), and Playwright browser checks.