> For the complete documentation index, see [llms.txt](https://docs.oomus.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oomus.org/features/dashboard-analytics.md). # AI Dashboard & Analytics The Oomus CampaignID Dashboard is the operational control center for your health program. It provides a real-time view of all activities, metrics, and alerts in your infrastructure. *** ## Operational control center ### Automatic refresh The dashboard refreshes automatically **every 30 seconds** to display the latest data. The data freshness indicator is visible at the top of the page. *** ## Main KPI cards Six key indicators are displayed permanently at the top of the dashboard: | KPI | Description | Unit | | ------------------- | --------------------------------------------- | ----- | | **Balance** | Available credit on your account | FCFA | | **Cards generated** | Total number of cards produced (all time) | Count | | **Active jobs** | Generation jobs currently running | Count | | **Success rate** | Percentage of jobs completed successfully | % | | **Campaigns** | Total number of campaigns (active + archived) | Count | | **Remaining quota** | Beneficiaries remaining in the monthly quota | Count | *** ## Activity chart — Data Intelligence The main activity chart is a **"Data Intelligence"** multi-axis component. It displays four overlapping curves with time-period filters. ### Time period filters Three buttons let you choose the time granularity: | Filter | Period covered | Granularity | | --------- | --------------------------------- | ----------- | | **Week** | Last 7 days | Daily | | **Month** | Last 30 days | Daily | | **Year** | January → December (current year) | Monthly | ### Four overlapping curve series All series are smooth **Area** curves that overlap. Each can be enabled or disabled individually via the toggles at the top of the chart: | Series | Type | Axis | Color | Source | | ------------- | --------------------------- | -------------- | ------ | ---------------------------------------------------- | | **Cards** | Area | Left (volume) | Blue | Studio + DHIS2 combined | | **Studio** | Area | Left (volume) | Purple | `GenerationJob.card_count` (DB) | | **DHIS2** | Area | Left (volume) | Teal | `EngineUsageRecord` engine\_mode=`studio_print` (DB) | | **Success %** | Area (Area, without points) | Right (0–100%) | Green | Completed jobs / total | A **reference line** horizontal at 75% is drawn as a dashed orange line on the Success % axis — target operational threshold. ### Data sources — reliability guarantee The counters displayed come exclusively from the persistent database: * **Studio cards** : `SUM(GenerationJob.card_count WHERE status='completed')` — exact count of real cards * **DHIS2 cards** : `SUM(EngineUsageRecord.cards_generated WHERE engine_mode='studio_print')` — DB source of truth (no TTL, unlike the Redis cache) * No fake or seeded data — the chart displays **0** if no real activity has taken place Future months/days display zero and the chart remains visible even if no activity has yet been recorded. ### LIVE badge A **● LIVE** green badge is displayed in the chart header to indicate that the data is updated in real time (every 30 seconds). *** ## Quota consumption bars The quota gauges display in real time: | Resource | Display | | ----------------- | ----------------------------- | | **Beneficiaries** | X used out of Y allocated (%) | | **SMS** | X sent out of Y included (%) | | **WhatsApp** | X sent out of Y included (%) | | **Storage** | X GB used out of Y GB (%) | A visual alert appears when consumption exceeds 80% of the quota. *** ## Infrastructure health score A synthetic indicator (0–100) aggregates the health of all platform components: | Monitored component | Metrics | | ------------------- | ----------------------------------------- | | Backend API | Latency, error rate, availability | | Celery workers | Task queues, pending jobs, active workers | | Database | Connections, query time | | Redis cache | Memory usage, hit rate | | MinIO/S3 storage | Availability, space | | DHIS2 integration | Last successful sync, latency | *** ## Alerts panel Alerts are ranked by priority: | Priority | Examples | | ------------ | -------------------------------------------------------- | | **Critical** | Infrastructure unavailable, blocked job, quota exhausted | | **High** | Quota > 90% used, DHIS2 sync failed, job in error | | **Medium** | Quota > 80%, high latency, expiring certificate | | **Info** | Job completed, sync successful, new MPI beneficiary | *** ## Live activity feed The "Recent activity" panel displays the latest events in real time: * Cards generated (with campaign name and count) * Jobs started / completed * DHIS2 synchronizations (enrollments retrieved) * Cards distributed (WhatsApp / SMS / Google Wallet) * User logins * Configuration changes *** ## Governance section The Governance section of the dashboard displays: * **Pending approvals** : simulations and requests requiring admin action * **Recent audit log** : latest recorded actions (actor, action, resource, IP) * **Active user access** : list of logged-in users and their roles * **Top-up requests** : quota requests pending processing *** ## Advanced analytics (premium module) The Advanced Analytics module is available on the National Campaign and Sovereign Enterprise plans. ### Summary tab * Overall summary: unique beneficiaries, total cards, distribution rate * Previous period comparison * Top 3 most active campaigns ### Timeline tab Granular time-based visualization (day / week / month) of: * Card generations * Distributions by channel * DHIS2 synchronizations ### Spending over time tab Monthly evolution of budget spent, with breakdown by: * Card generation (by DPI) * SMS distribution * WhatsApp distribution * Storage * Premium modules ### Campaign types tab Distribution of activities by program type: * Vaccination, MILD, Nutrition, HIV, Insurance, etc. * Card volume by type * Distribution rate by type ### Top campaigns tab Ranking of the most active campaigns by: * Number of beneficiaries * Volume of cards generated * Distribution rate * Verification success *** ## Export of analytics data Dashboard data can be exported: | Format | Content | | --------- | -------------------------------------- | | **CSV** | Filtered raw data (date, type, volume) | | **Excel** | Formatted multi-tab report | | **JSON** | Structured data for BI integration | *** ## Next steps * [Campaign management](/features/campaigns.md) — View campaign details * [Simulation engine](/features/simulation-engine.md) — Schedule a deployment * [Plans & Features](/getting-started/plans-and-pricing.md) — Advanced Analytics module --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.oomus.org/features/dashboard-analytics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.