Sovereign Modules Spec

Deep-dive technical architectural blueprints for India's first compiled serverless political engine.

Doctrine Engine

v0.1 CORE

Verifiable, git-style revision histories for organizational policy and principles. Solidifies ideological alignment before mobilization.

$ git log --oneline doctrine/water-policy.md
* 7a9c402 (HEAD) Improve Ward 45 municipal allocation target guidelines (R. Krish)
* f82d9a1 Revise corporate irrigation audit frameworks (S. Pillai)
* a401b8e Initial draft water access declaration (Admin)

$ git diff f82d9a1 7a9c402
- Target: Allocate 40L per family through tankers.
+ Target: Build direct piping to households, reducing tanker dependency by 60%.

State Primitive

Git-tree anchoring. Commit hashes are signed on-chain using PGP keys of council leads.

Verification

Decentralized replication. Merkle root hashes published weekly on public ledgers.

Edge Sync

Sub-millisecond diff generation. Syncs seamlessly over Cloudflare KV namespaces globally.

Mandate Ledger

AUDIT-READY

Public-facing ledger tracking all campaign commitments, milestones, and responsible parties. Every commitment has an accountability scorecard.

COMMITMENT_ID: MND-2026-0814
Title: "File RTI on drainage spending in Ward 4"
Custodian: S. Pillai (Trust Level 3)
Status: OVERDUE (By 4 Days)
Demurrage Log: -2.5 Aram Reputation points applied to custodian account.
Next Action: Reassign mandate or file extension request in Council.

SLA Enforcement

Auto-decay penalties. Overdue milestones programmatically reduce voting weights.

Data Sovereignty

SQLite D1 event logs. Commitments cannot be silently erased or altered after submission.

Reconciliation

Tied directly to bank expenditures using neobank ledger sync webhooks.

Member OS

IDENTITY

Trust-layered volunteer registry mapped against municipal ward boundaries. Replaces chaotic WhatsApp groups with cryptographically validated hierarchy.

MEMBER_INDEX // WARD_45_CHENNENI
[ID #1092] R. Krishnamurthy | Role: Coordinator | Trust: 87/100
└ [ID #2201] K. Raja | Role: Field Agent | Trust: 45/100
└ [ID #2203] M. Sundar | Role: Field Agent | Trust: 12/100

PERMISSIONS MATRIX:
- Read Ward Ledger: Enabled for all.
- Initiate UPI Disbursements: Trust Level 3 required (Krishnamurthy only).

Identity Guard

Passwordless biometric sign-in linked to dynamic Cloudflare KV sessions.

Ward Polygons

GeoJSON coordinates loaded at edge. Automatic verification of volunteer locations.

Security Rules

Row-level security. Members only view data relevant to their registered constituency.

Council Chamber

DECISIONS

Internal legislative chamber where policies, budgets, and internal rules are proposed, debated, and cryptographically voted on.

PROPOSAL #092: "Authorize ₹15,000 for local survey food stipends"
Sponsor: Meera Deshmukh | Status: PASSED
Quorum Check: 72% Participating (60% Minimum Required)
Voting Tallies:
- Ayes: 852.4 Aram Credits weighted (78%)
- Nays: 240.1 Aram Credits weighted (22%)
Recorded Dissent: V. Nair submitted minority objection report (ID #92B).

Voting Weights

Credits-based voting weight. Action-takers carry higher weight than commentators.

Dissent Audit

Minority opinions are permanently bound to passed acts to preserve context.

Quorum Guard

Serverless workers block execution of financial resolutions without quorum verification.

Aram Credit System

REPUTATION

Non-encashable, non-transferable reputation credits earned through documented and verified grassroots work. Defines internal leadership and trust.

REPUTATION_WEIGHT // TOP_MEMBERS
1. R. Krishnamurthy -- 4,520 AC (12.4% Voice Weight)
2. S. Pillai --------- 3,120 AC (8.5% Voice Weight)
3. Meera Deshmukh ---- 2,900 AC (7.9% Voice Weight)

Verified Contribution Log:
+15 AC to S. Pillai: Verifiably filed Ward 14 drainage RTI.

Meritocratic

Cannot be bought, sold, or inherited. Exclusively earned through public service.

Decay Engine

Passive reputation demurrage (1% weekly decay) encourages continuous ground action.

Audit Trail

Every transaction mapped to a verified completion certificate in the database.

Aram Jobs Board

LATEST ENGINE

A highly specialized internal gig economy for civic mobilization. Post micro-tasks with geo-tracked outcome requirements and automatic financial disbursements.

$ fetch-jobs --available --ward-45
- [ID: 9811] Conduct water pipe audit | Reward: ₹800 + 15 AC
- [ID: 9812] Collect 5 resident statements | Reward: ₹500 + 10 AC

$ submit-proof --job-id 9811 --lat 12.9712 --long 80.2411 --img_url img_281.jpg
Running automated verification on image/location...
SUCCESS: Image matches 'water pipe leak' description. Location matches Ward 45 polygon.
Disbursement Queued: ₹800 instantly sent to UPI (krish.m@okaxis).

Isomorphic Proof

Image verification via Gemini 3.5 Flash + GPS tracking on the edge.

Secure Escrow

Programmatically held escrow nodes automatically process UPI payouts.

Derived CRUD

Dynamically generate custom workflows without modifying database schemas.

AI Brief Engine

🧠 COGNITION

Powered by Gemini 3.5 Flash. Synthesizes municipal datasets, local news, and budgets to provide rookie volunteers with expert-tier situational briefings.

$ generate-brief --target ward-12
Querying: Census, municipal budget records, historical local polls...
Analyzing: Deficits, pending road contracts, sanitation filings...

SITUATION BRIEF // WARD 12 (Kallikuppam):
- Ground issue: 22% water supply deficit.
- Public spending: ₹40 Lakh road repairs awarded last September; 0% completed.
- Strategy: Focus questioning on municipal delays and audit-log gaps.

Multilingual

Dynamic translation into Tamil, Hindi, Marathi, and English as standard.

RAG Pipeline

Queries structured data pools directly, eliminating hallucinated statistics.

Instant Synthesis

Under 3 seconds latency from request to completed PDF/text printout.

Media Blitzkrieg Engine

📡 SENTINEL

Converts real-time Google Alerts and regional news RSS feeds into automated, lightning-fast grassroots action packages. Instantly translates municipal scandal into structured campaign momentum.

[ALERT INGESTED] Source: Google Alerts RSS (Tamil Nadu Civic)
Title: "Contaminated sewage water mixes with drinking pipeline in Chenneni Ward 45"
Matching polygon context... FOUND (Ward 45)

$ blitzkrieg-trigger --event-id alert_9921b
- RTI Form Generated: Pre-filled public records demand directed to PIO Chenneni.
- Aram Gig Deployed: Live task on board: "Inspect Ward 45 leak & film citizen interviews" (₹500 + 15 AC).
- Media contrast copy compiled: "Why is ABC Contractor silent? In ARAMARAN, this SLA is tracked..."

Active Scanning

Continuous monitoring of targeted keywords on Google Alerts & regional RSS feeds.

Isomorphic Link

Instantly maps news reports to local volunteers, converting outrage into on-site verification.

Systemic Contrast

Generates auto-drafted public copy pointing out the structural cure to the specific failure.

The Stack

Under the hood.
Sovereign serverless technology.

To ensure zero limitations on scalability, we designed ARAMARAN completely serverless. No expensive horizontal virtual machines. Everything compiles and runs on Cloudflare's globally distributed network edge close to your volunteers.

D1 SQL

Cloudflare D1

Serverless, highly compliant SQLite databases deployed isolated per movement instance. Ensures structural, un-hackable, zero-cost data segregation.

KV CACHE

Cloudflare KV

Global key-value data storage. Injects lightning-fast biometric authentication sessions and policy-version diffs at millisecond speeds.

UPI NODE

Decentro API

Dedicated payment webhook listener and bulk disbursement nodes executing direct, real-time escrow payments to mobile UPI VPAs.

FLASH AI

Gemini 3.5 Flash

Highly optimized cognitive compiler on the edge. Automatically parses uploaded task photos and generates hyper-localized constituency briefs.