From ee746a032f92ad898108de3c8a3c4b7680d7b3bf Mon Sep 17 00:00:00 2001
From: Diego Ripley <diego@diegoripley.ca>
Date: Sat, 21 Feb 2026 21:31:24 -0500
Subject: [PATCH] Enhance README with financial transparency details

Good first draft.
---
 README.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2494c79..45bc83c 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,57 @@
-# d4c-financials
\ No newline at end of file
+# d4c-financials: Radical Transparency Ledger
+
+Welcome to the central financial repository for **Data for Canada**.
+
+In alignment with our mission to provide open, accessible, and decentralized geospatial data for all Canadians, we believe our funding and expenditures should be held to the same rigorous standards as our datasets. This repository serves as our **Public Financial Ledger**, providing transparency into the project's sustainability and growth.
+
+## ⚖️ Our Philosophy: Radical Transparency
+
+We operate on the principle of **Open-Book Accounting**. This means:
+
+* **Cloud-Native Ledger:** Our financials are stored in **Apache Parquet** format. This allows for high-performance, columnar analysis of our spending patterns and ensures our financial data is as technically modern as our geospatial data. The `ledger.parquet` file is indexed via our [FAIR Data Catalogue](https://stac-utils.github.io/stac-geoparquet/latest/spec/stac-geoparquet-spec/) and shared across our peer-to-peer network to ensure the record exists independently of any single hosting provider.
+* **Live Visibility:** Every donation received and every cent spent is recorded as quickly as we can get the invoices out of systems.
+* **Version-Controlled History:** Because this is a Git repository, the entire history of our financial state is immutable and verifiable through Git commits.
+
+## 🔄 The Funding Funnel
+
+**Data for Canada** utilizes a sustainable "Social Enterprise" model to maintain independence from volatile grant cycles:
+
+1. **Enterprise Services (`.com`):** High-availability products targeting the enterprise GIS market (e.g., Esri and other enterprise competitors) are hosted at **dataforcanada.com**.
+2. **The Funnel:** 100% of the net revenue generated from these commercial services is funneled directly into our community infrastructure.
+3. **Community Impact (`.org` / `.ca`):** These funds power the free, decentralized data mirrors and open-source tools hosted at **dataforcanada.org** and **dataforcanada.ca**.
+
+```mermaid
+graph TD
+    A[.com Enterprise Services] -->|100% Net Revenue| B[The D4C Funnel]
+    C[Community Donations] --> B
+    B --> D[.org / .ca Infrastructure]
+    B --> E[Open Source Development]
+    D --> F[Free Public Data Access]
+```
+
+## 📊 Ledger Structure
+
+The financial data in this repo is consolidated into a single, high-efficiency file to facilitate easy querying and integration with BI tools or Python/R notebooks:
+
+* **`ledger.parquet`**: The master record of all inflows and outflows.
+* **Schema includes:** `timestamp`, `category`, `source`, `amount_cad`, `original_amount`, `currency_code`, `description`, `transaction_id`, **`proof_link`** (ex. Link to the Open Collective expense or receipt), `hash`.
+
+## 🤝 Community-Based Funding
+
+We use **Open Collective** as our primary fiscal engine. This allows for:
+
+* **Public Accountability:** You can see our real-time balance and every transaction as it happens.
+* **Neutral Stewardship:** Funds are managed through a fiscal host to ensure professional and ethical handling of all contributions.
+
+### 🛠️ Verification & Analysis 
+To maintain the integrity of this ledger, we provide a basic Python snippet for community members to verify the `ledger.parquet` file locally:
+```python
+import pandas as pd
+df = pd.read_parquet('ledger.parquet')
+# Calculate total community-funded infrastructure spend
+print(df[df['category'] == 'Infrastructure']['amount_cad'].sum())
+```
+
+### 🛡️ Privacy Note
+
+While we strive for total transparency, we respect the privacy of our individual donors. Contributions can be made anonymously, and we redact personal identification from any public records in compliance with the highest privacy ethics.