Public Guest / SOLIVIA
Sign In

Solivia Monitor

System Documentation

A complete reference for every module, interface element, and workflow within the Solivia Monitor platform. This guide covers all functional areas of the application, providing descriptions of screens, controls, and data fields.

02

Organisation Dashboard

The Dashboard is the primary landing screen following authentication. It presents an aggregated portfolio view without requiring navigation to individual programme records. The page header displays the authenticated user's name and job title.

Summary Stat Cards

Three headline metric cards are rendered across the top of the dashboard:

Total Programs

The count of all active programmes registered within the organisation.

On Track

The count of programmes whose status is classified as On Track in the current reporting cycle.

Total Indicators

The aggregate count of all active indicators tracked across the full programme portfolio.

Portfolio Charts

Program Status DensityA doughnut chart illustrating the distribution of programmes across operational status categories (On Track, At Risk, On Hold, Completed, etc.).
Lifecycle DistributionA polar area chart presenting the spread of programmes across development lifecycle stages (Design, Implementation, Scale-Up, Closure, etc.).

Recent Programs Table

A tabular list of the five most recently created active programmes. Each row displays the programme name, status badge, and start date. The Manage action navigates directly to the full programme detail page. The View All control at the table header navigates to the Projects Registry.

03

Projects Registry

Projects Registry

The Projects Registry maintains the master list of all programmes within the organisation. Records can be searched by title or code, filtered by operational status or developmental stage, and navigated to for in-depth execution management.

Toolbar Controls

Search BarFilters the programme list in real time to records matching the entered title or project code keyword. Submitting an empty search resets the filter.
+ New ProjectOpens a modal programme creation form. The new record is automatically assigned to the authenticated user's organisation.

Filter Bar

Status FilterNarrows the list to programmes matching a specific status: On Track, At Risk, On Hold, Extended, Completed, or Cancelled.
Stage FilterNarrows the list by programme lifecycle stage (e.g. Planning, Execution, Closing, Closed).
Filter / ResetSubmits the filter criteria or resets all active filters back to the full portfolio view.

Programme Table Columns

AchievementA donut chart representing the ratio of cumulative actual values to cumulative targets across all indicators, expressed as a percentage.
ProgressA donut chart representing the proportion of milestones (output activities) that have reached Completed status.
Title & DatesProgramme title, unique project code, start date, and scheduled end date.
Status BadgeColour-coded pill: Green = On Track; Yellow = At Risk / On Hold; Blue = Extended; Grey = Completed / Cancelled.
ViewNavigates directly to the comprehensive Programme Detail page.
UpdateOpens the Update Program Status modal, enabling rapid changes to Stage and Status without leaving the registry.
Projects – Detail Tabs
3b

Programme Detail Page

The Programme Detail page is accessible from the Projects Registry via the View action, or from the Dashboard via any Manage link. The page is structured around six comprehensive functional modules, each containing specialized sub-tabs covering all operational, financial, and strategic dimensions. Tab state is preserved in the URL query string, enabling direct bookmarked linking to any section. An Export PDF button produces formatted reporting briefs.

1

Module Tab: Overview

The Overview tab presents the programme summary in a responsive layout combining headline narrative descriptors with executive statistics.

Programme SummaryDisplays the programme title, unique project code, and full duration timeline (start date to end date).
Stage & Status BadgesColour-coded pills showing current lifecycle stage (Planning, Execution, Closing, Closed) and operational status.
Achievement BarHorizontal bar showing aggregate indicator achievement percentage (actual vs. cumulative target across all indicators).
Progress BarA second progress bar reflecting the proportion of programme milestones (output activities) marked Completed.
Budget CardDisplays the total allocated budget in the organisation's default currency.
Target BeneficiariesThe aggregate planned participant reach figure as configured during programme setup.
Coverage AreasPaginated list of geographic sub-national administrative locations linked to this programme (5 items per page).
Programme DescriptionFull narrative text, creation date, last updated date, and the user who created the record.
2

Module Tab: Implementation

The Implementation module consolidates field execution tracking into three specialized sub-tabs:

Sub-tab: Milestones/Workplan

An interactive Gantt chart tracking all output-level milestones and nested activities:

View Controls: Day, Week, Month (default), and Year zoom buttons (Year is auto-selected for durations exceeding 365 days).

Status Filters: Filter pills for All Tasks, Not Started, Ongoing, Completed, On Hold, Late, and Cancelled with counts.

Interactive Bars: Colour-coded Gantt timeline bars (Green = Completed, Amber = Ongoing, Red = Late, Blue = On Hold, Dark Grey = Cancelled) with detailed tooltips displaying date ranges and status.

Sub-tab: Beneficiaries

Multi-dimensional reach analytics disaggregated by participant category and geography:

Summary Cards: Target Beneficiaries (Planned total by gender), Direct Targets (direct recipients), and Indirect Targets (community spillover).

Location Breakdown Tree: Hierarchical drilldown tree (e.g. County → Sub-County → Ward) with searchable expandable nodes displaying demographic matrices (Male, Female, Total).

Interactive Map: Leaflet.js map with circle markers positioned at programme sites, with radii proportional to participant counts.

Sub-tab: Partners

Comprehensive partner and donor management dashboard:

Summary Cards: Total Donors, Total Contribution Received, Active Partners, and Pending Disbursements.

Visual Analytics: Donor Contribution Progress donut, Partner Type Distribution donut, Top 5 Donors bar chart, and stacked Disbursements Over Time chart.

Master Ledgers: Paginated Partners table (Type, contact, address, downloadable ToR) and Donors table (Funding type, contributed amounts, disbursement schedule, contract document).

3

Module Tab: Finance

The Finance module provides complete fiscal oversight across six dedicated sub-tabs:

Dashboard

High-level financial KPIs: Disbursed Rate %, Burn Rate (Spent ÷ Disbursed), Available Cash Balance, Cost per Beneficiary, Runway analysis, and Next Quarter deficit risk indicator.

Budget

Granular programme budget line-items, category cost allocations, and multi-year budget revision tracking.

Funding

Committed donor contribution tranches, inflow schedules, and funding gap / deficit analysis.

Committed Spend

Tracks purchase orders, operational commitments, and encumbered funds prior to actual disbursement.

Expenditures

Chronological ledger of actual expenditures (Date, Amount, Purpose, Receipt attachments) with pagination and sum totals.

Financial Register

Master reconciled transaction book comparing Budgeted vs. Committed vs. Disbursed vs. Spent amounts.

4

Module Tab: Operations

The Operations module governs programme logistics, procurement pipelines, and asset custody across six sub-tabs:

Approvals

Multi-tier requisition, purchase, and payment approval workflows with role-based sign-off stages.

Vendors

Supplier directory with tax registrations, performance ratings, banking info, and active contract files.

Procurements

Purchase requests, RFQs, competitive bid analyses, contract awards, and purchase order tracking.

Assets

Fixed asset registry documenting asset tags, serial numbers, custodians, conditions, and locations.

Accounting

Journal entries, payment vouchers, ledger postings, and financial balance reconciliations.

Registers

Operational custody, vehicle movement logs, compliance registries, and incident journals.

5

Module Tab: Documentations

The Documentations module serves as the programme's digital archive, structured into five specialized folders:

Documents

General document repository (Project proposals, MoUs, compliance agreements, photos) with download actions.

Reports

Formal programme progress reports (Monthly, Donor, Annual, Final) with executive summaries and attachments.

Evaluations

Baseline assessments, Mid-Term reviews, Endline evaluations, and external consultant reports.

Accountability

Community feedback logs, complaints response mechanisms (CRM), and stakeholder engagement notes.

History

Chronological audit log tracking lifecycle changes, status transitions, and user modifications.

6

Module Tab: Settings (Program Settings)

Formerly located in Framework Maintenance, Program Settings has been moved to Programme Detail Settings to act as the primary configuration engine. Data entered here populates dropdowns and calculations system-wide across six inner sub-tabs:

Identity

Configure core programme title, total budget capacity, unique project code, start date, and end date.

Sites & Beneficiaries

Define overall planned participant reach benchmark to drive portfolio-wide reach calculations.

Donors

Register financial contributors, funding categories (Grant, Loan, Co-funding), and committed funding amounts.

Partners

Onboard external entities and explicitly assign operational roles (Implementing, Technical, Funding, Advocacy).

Risks

Maintain the foundational risk register with descriptions, likelihood ratings, impact ratings, and risk owners.

Theory of Change

Wire the causal logic engine by explicitly linking Outputs to Outcomes using IF WE → THEN WE statements with explanatory rationales.

04

Strategic Framework

The Strategic Framework module provides the core interface for defining and maintaining the logical hierarchy of a programme — connecting overarching Goals to Outcomes, Outcomes to Outputs, and Outputs to Activities and Indicators. A programme selector dropdown at the top allows switching context seamlessly. The + Add New Program button opens a modal to provision new logframes directly.

Tab: Builder

Framework Builder

The Builder tab is an interactive hierarchical canvas for architecting the Theory of Change structure. Users can build, rename, and nest Goals, Outcomes, Outputs, Activities, and Indicators in real time with immediate database persistence. Each node includes inline controls for quick creation, renaming on blur, and node deletion.

Tab: Maintenance

Framework Maintenance

The Maintenance tab provides a dedicated granular editing interface for all logframe entities. With Program Settings moved to Programme Detail, Maintenance focuses strictly on the five logical Theory of Change levels:

GoalAllows editing of the overarching programme Goal title and narrative description.
OutcomeLists all defined strategic Outcomes. Each can be updated with full title and description.
OutputLists all deliverable Outputs. Each can be configured and connected to parent outcomes.
ActivityStreamlined operational activity editor. Fields include: Title, Description, Start Date, and End Date (these dates directly drive the Gantt chart in the Milestones/Workplan view).
Indicator

The most comprehensive configuration sub-tab, governing all indicator measurement parameters:

  • Core Configuration: Indicator Name, Description, and Logical Level (Goal, Outcome, Output).
  • Measurement Rules: Indicator Type (Percentage, Rate, Proportion, Average, Boolean, or Number) and reporting Frequency.
  • Cross-cutting Disaggregations: Multi-select assignment of disaggregation options (e.g. Gender, Age Brackets).
  • Targets: Base numeric Baseline value, cumulative Target value, and Means of Verification (MoV).
  • Manual Data Injection: A secondary form to inject historical or ad-hoc actual values outside the main Reporting module, complete with Organisational Unit assignment, calculation components (Numerator/Denominator), disaggregated values, and narrative notes.

Tab: Full View

Framework Full View

The Full View tab renders a read-only, top-down visual logframe representation of the complete programme architecture in a single scrollable view. Designed for stakeholder reporting, logical verification, and donor compliance audits.

05

Program Reporting

Reporting

The Reporting module serves as the primary operational hub for field data collection and M&E quality control. Accessible via Reporting in the sidebar, it incorporates a split-pane data collection interface alongside an enterprise-grade segregation-of-duties review workflow.

Top Tab: Data Entry & Progress Ledger

Framework MapA sticky hierarchical navigation tree on the left. Groups all indicators by Goal, Outcome, Output, and Activity. Selecting any indicator immediately loads its tracker in the right pane.
Indicator Identity CardDisplays the selected indicator's full description, baseline, cumulative target reach, latest actual value achieved, and a dynamic progress bar.
Data Entry FormThe primary submission interface for recording periodic actuals. Fields include reporting date/period, absolute recorded value, calculation components (Numerator/Denominator) if applicable, disaggregation breakdowns, narrative variance comments, and file upload for Means of Verification (MoV) evidence.
Progress LedgerA chronological table displaying recent submissions for the selected indicator. Shows reporting date, previous vs. current values, submitter, narrative comments, and verification status badges (Submitted / Approved / Rejected).
Reporting – Indicator Performance Progress Ledger

Top Tab: Indicator Reporting Review

A dedicated Quality Control panel implementing strict segregation of duties. M&E managers and administrators review submitted indicator actuals before they are factored into official scorecard calculations:

Summary KPI CountersFour headline metric cards: Total Submissions, Pending Approvals, Approved, and Rejected counts.
Status Filter PillsInstant filter controls to isolate records: All, Pending, Approved, or Rejected.
Review TableDisplays Indicator Name, Parent Program, Reporting Period, Value Reported, Submitter, Submission Date, and attached Evidence Files.
Approval / Rejection ModalAllows authorized reviewers to either approve or reject submissions, complete with compulsory reviewer feedback notes and timestamped audit logs.
06

Program Results & Scorecards

Scorecards

The Results module (accessible via Results in the sidebar) delivers automated performance intelligence derived directly from verified data entries. It features executive visual KPIs alongside an algorithmic RAG scorecards ledger across two specialized tabs.

Tab: Scorecards Grid

RAG DistributionA Doughnut chart illustrating the portfolio proportion of indicators in Green (≥90%), Amber (50–89%), and Red (<50%) performance bands.
Active Indicators KPICount of active indicators broken down by Goal, Outcome, and Output levels.
Avg Target ReachThe aggregate percentage achievement tracked across all framework indicators for the active programme.
Data Quality IndexCompleteness and timeliness rating derived from scheduled reporting frequencies and submission completeness.
Scorecards LedgerA comprehensive table grouping all indicators hierarchically (Goal → Outcome → Output → Activity) showing Baseline, Cumulative Target, Latest Aggregate Actual, Reach %, and auto-calculated RAG variance badges.

Tab: Progress Grid

The Progress Grid provides a multi-period execution matrix comparing planned milestone targets against cumulative achievements over time:

Time-Series MatrixDisplays milestone performance categorized by reporting cycle across all output activities.
Milestone GaugesHalf-doughnut gauge charts visualizing percentage achievement per output activity.
Scorecards – Detail
07

DataHub — Control Center

DataHub

The DataHub centralises all external datasets, automated AI analytical capabilities, and business intelligence export feeds. A programme selector dropdown at the top filters content by programme context across three operational tabs.

Tab: Overview (Datasets)

KPI MetricsHeadline cards displaying Total Records Synced, Active Datasets count, and Active Connections count.
Dataset CardsEach uploaded dataset displays its title, record count, and upload date. Actions include Open Data (tabular explorer with column search/filters), View Schema, and Download CSV/Excel.
+ Upload DatasetModal requiring Dataset Name, optional Description, and a file upload (CSV or Excel). Automatically parses columns and indexes tables into SQL for indicator calculations.
Indicator SQL LinkingUploaded datasets can be queried directly to drive framework indicators using the Calculated (Dataset SQL) tracking type.

Tab: AI Analytics

Natural Language AgentInteractive prompt box connecting via Server-Sent Events (SSE) to the streaming AI analytics engine (/framework/api/magic/stream/).
Dynamic Dashboard BlocksAutomatically parses plain-English requests and constructs real-time Theme Header blocks, KPI metric cards, interactive chart blocks, and data tables.

Tab: BI Export

Power BI ConnectorLive REST API JSON feeds accessible via Power BI's "Get Data → Web" interface, complete with one-click URL copy buttons.
Tableau ConnectorDirect Web Data Connector endpoints for feeding Tableau workbooks with live programme analytics.
Core EndpointsPre-built feed URLs for Programs & Budgets (/api/v1/analytics/programs/), Indicator Progress (/api/v1/analytics/indicator_progress/), and custom dataset tables.
API DocumentationDirect link to the Swagger / OpenAPI schema explorer for programmatic developers.
Integrations BridgeDirect tab bar link navigating to the Data Integrations connector hub.
08

Data Integrations

Integrations

The Integrations module enables automated synchronization with third-party survey tools, mobile data collection engines, and external SQL database servers. It is organised into two primary operational tabs:

Tab: Services

Available ConnectorsNative connectors for: KoboToolbox, DHIS2, CommCare, SurveyCTO, PostgreSQL, MySQL, SQL Server, and Google Sheets.
Connection ModalForm configuring Connection Name, Base URL, API Token (for Kobo/cloud services), or database credentials (Username/Password/Port).
Connected EcosystemLists all actively linked service instances with health indicators, manual sync triggers, and asset mapping tools (e.g. mapping Kobo form fields or DHIS2 elements into DataHub datasets).
Sync StatisticsLive counters displaying Total Data Points Synced, Active Indicator Maps, and automated CRON synchronization schedules.

Tab: Sync Logs

Transaction AuditAn immutable 30-day historical log detailing every synchronization operation. Each entry records the source service, exact timestamp, status (Success / Failure), and the volume of records retrieved.
09

Organisation Settings

Settings

The Settings page is restricted to users with the Administrator role. It provides governance controls for organisation branding, system-wide defaults, programmatic API security, and platform user administration across four dedicated tabs:

Tab: Profile

Organisation LogoUpload PNG or JPG image. Displayed in the sidebar header and embedded onto generated PDF exports.
Organisation NameThe registered title of the organisation, applied across all interfaces and reports.
WebsiteThe public URL of the organisation, linked on exported reports.
DescriptionA narrative description of the organisation's mandate or mission.

Tab: Global Settings

Default CurrencySets the currency symbol and code applied to all financial budgets and calculations. Options include USD, EUR, GBP, KES, UGX, TZS, and NGN.
TimezoneControls date/time presentation across all audit timestamps. Options include UTC, Africa/Nairobi, Africa/Lagos, Africa/Johannesburg, and Europe/London.
Fiscal Year StartDefines the financial year commencement date, used as the baseline for fiscal reporting periods.

Tab: API Keys

Generate New KeyCreates a new cryptographic credential with a custom description label. The complete secret is displayed once upon creation.
API Keys TableLists all generated keys with masked previews, creation dates, and Active/Revoked status management.

Tab: Team Management

Accessible directly from the Settings tab bar. Administrators can invite users by email, assign platform roles (Admin, Manager, Viewer), manage permissions, and deactivate accounts. This section governs organization-wide user accounts, distinct from programme-level assignments managed within Programme Detail.

Solivia Monitor · System Documentation · v2.0

For API integration reference, consult the BI Export section within DataHub and API Keys within Settings.