Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AdriP-maker/JAAR_Antigravity/llms.txt

Use this file to discover all available pages before exploring further.

SIMAP Digital is an offline-first progressive web app built for Juntas de Acueductos Rurales (rural water boards) in Panama. It lets collectors register payments, track community work (jornales), manage expenses, generate official MINSA reports, and use AI to optimize collection routes — all without requiring an internet connection.

Quickstart

Get SIMAP Digital running locally in under five minutes.

Architecture

Understand the Offline-First design, sync queue, and tech stack.

Payments & Collections

Process all six payment types and track collection status in real time.

Roles & Permissions

Learn how the five-role RBAC system controls access across the app.

What SIMAP Digital does

Rural water boards face a hard operational problem: collectors visit homes in areas with no cell signal, yet every payment must be recorded accurately and reported to MINSA. SIMAP Digital solves this with an Offline-First approach — the entire app runs from local IndexedDB storage, syncing to Supabase in the cloud only when connectivity is restored.

Offline Collections

Register payments, jornales, and expenses with zero connectivity.

Six Payment Types

Mensual, diario, parcial, multi-mes, adelanto, puesta al día.

Gamification

Reward punctual payers with points redeemable as bill discounts.

AI Routing

Smart collection queue ordered by risk score and geography.

MINSA Reports

One-click export to multi-sheet Excel and PDF for regulators.

Cloud Sync

Pending-queue pattern pushes local data to Supabase on reconnect.

Getting started

1

Clone and install

Clone the repository and install dependencies with npm.
git clone https://github.com/AdriP-maker/JAAR_Antigravity.git
cd JAAR_Antigravity
npm install
2

Configure environment

Copy .env.example to .env and fill in your Supabase project URL and anon key.
cp .env.example .env
3

Start the dev server

npm run dev
Open http://localhost:5173 in your browser.
4

Log in with a demo account

Use the built-in demo credentials to explore each role — admin / admin123, cobrador / 1234, minsa / 1234, or cliente / 1234. See the Quickstart for the full credentials table.

Explore by role

Admin

Approve new residents, manage splits, configure gamification rules, and view audit logs.

Cobrador (Collector)

Register payments offline, use AI routing suggestions, record jornales and expenses.

MINSA Inspector

Download quarterly income/expense reports in Excel or PDF format.

Cliente (Resident)

View personal payment history, accumulated points, notifications, and forum announcements.

Build docs developers (and LLMs) love