Skip to content

GameProductions/ledger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

611 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LEDGER v3.33.0 (Forensic Edition)

Secure Financial Platform | Forensic Integrity & Agentic Reconciliation

LEDGER is a production-grade personal and household finance platform built for speed, transparency, and security. This release (v3.33.0) introduces Fleet Security v6.1 compliance, Forensic Telemetry, and Zero-Native UI interaction patterns.

🚀 Key Features

🛡️ Forensic Integrity (Fleet Security v6.1)

  • Dual-Stack Network Forensics: Full-stack transparency with labeled IPv4 and IPv6 chronology for every session and security event.
  • Human-Readable Audit Logs: Plain-English descriptions for all administrative and system actions, eradicating raw JSON jargon from the UI.
  • Zero-Native Dialog System: Complete eradication of browser-native alerts, confirms, and prompts in favor of a secure, promise-based toast utility.
  • Session Persistence Control: Granular "Stay Signed In" toggles for users and administrative overrides.

🤖 Agentic Intelligence

  • Reconciliation Agent: Stateful background matching of transactions using Cloudflare Agents SDK and internal SQLite.
  • Modular Schema: High-performance domain-specific database architecture (Auth, Financials, Planning, Loans, System).
  • Rule-Based Pairing: Automated transaction categorization and linking based on historical patterns and shared visibility rules.

🛡️ Security & Activity Tracking

  • Owner Access (Impersonation): Securely log in as users for support with a confirmation workflow and privacy masking.
  • Hardened Hashing: PBKDF2-SHA256 with 100,000 iterations for maximum password security.
  • Zero-Trust Validation: Strict Zod-powered input validation on all API endpoints.
  • Activity History: Detailed record of all administrative actions.

🧠 Financial Intelligence

  • Payment Orchestrator: Granular status tracking (Paid, Pending, Scheduled, Unpaid) with high-fidelity color coding.
  • Transaction Timeline: Chronological history of every note, confirmation number, and status change.
  • Multi-Note Support: Persistent, append-only notes for every financial record.
  • Bill Forecasting: Rolling 30-day and "Until Payday" projections.
  • Universal Currency Engine: Per-user currency preferences (USD, EUR, GBP) and platform-wide defaults.

👥 Collaboration & Households

  • Household Management: Collaborative finance with administrative role management (formerly Territory Data Ownership).
  • Social Accounts: Secure OAuth 2.0 integration for Discord and Google.
  • Premium Onboarding: Version-aware guided tours with "What's New" tracking.

🛠️ Deployment Options

1. Cloudflare Workers (Recommended)

Deploy directly to Cloudflare's global edge network:

npm run deploy:api
npm run deploy:web

2. Secure Self-Hosting (Docker Compose)

Take total command of your infrastructure. Deploy the entire ecosystem—API, Web UI, and Database—to your own private hardware in seconds.

Setup

  1. Pull the Image:
docker pull ghcr.io/gameproductions/ledger:latest
  1. Run the setup protocol:
docker compose run --rm setup
  1. Launch the stack:
docker compose up -d

📖 Included Documentation

  • User Guide: Navigation and feature how-tos.
  • Walkthrough: Technical details and platform evolution (v3.15.4 - v3.19.2).
  • Feature List: Detailed breakdown of all platform capabilities.

Historical Evolution

LEDGER is the direct successor to the CASH platform, evolving through several major architectural eras:

  • CASH Stable (Gold Era): Introduced the signature "Glassmorphism" UI and fluid Framer-motion transitions.
  • v3.11.x (Hardening Era): Transitioned authentication to Node.js Buffer logic for cross-environment Bit-Perfect Cryptographic Stability.
  • v3.13.x (Mobility Era): Full Mobile-First refactor and PWA Asset Hardening.
  • v3.15.x (Secure Era): Rebranded from "Territory" to "Household Management" and adopted Plain English terminology.
  • v3.19.2 (Secure Era): Implementation of the Payment Intelligence and Owner Impersonation.
  • v3.32.1 (Agentic Era): Transitioned to Modular Architecture and introduced the Cloudflare Agents SDK for stateful reconciliation.

© 2026 GameProductions. All Rights Reserved.

About

🛡️ LEDGER: Live Evaluation of Daily Gains & Expense Records. Automated sync, real-time insights, and proactive safety budgeting.

Topics

Resources

License

Stars

Watchers

Forks

Contributors