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. |
| 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. |
| 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. |
| 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. |