Skip to content

README.md

Latest commit

 

History

History
153 lines (106 loc) · 6.94 KB

README.md

File metadata and controls

153 lines (106 loc) · 6.94 KB

Humanos Foundation

The Advocacy Kernel & Human Operations Layer

License: MIT Node.js Vite React

Visit the Foundation • Read the Manifesto • Join the Revolution

"We are engineering the 256-bit AES-GCM local-first data vault to cryptographically secure your clinical narrative."

📱 Ecosystem Showcase

The Aura hOS Sovereign Architecture powers our federated clinic routing, generating Zero-SSN environments and absolute cryptographic isolation.

Zero-Knowledge Encryption Vault Zero-SSN Patient Dashboard

Medication Efficacy Telemetry Dynamic Care Team

🌍 The Mission

The Humanos Foundation is the 501(c)(3) Sovereign advocacy wing of the Aura hOS™ (Human Operating System). We are a global network of patients, clinicians, and technologists dedicated to dismantling the 15-20 page clinical clipboard penalty.

🏛️ The Foundation Vanguard

Our movement replaces the hostile "assembly-line" medical intake process with a cryptographic Digital Handshake, permanently securing patient data autonomy.

The Clipboard Penalty Clipboard vs Digital Handshake

Patient Data Sovereignty Vault Aura 60 Seconds Workflow

This repository powers our digital advocacy platform, designed to manage donor pathways, parse localized Markdown for our sovereign education library, and facilitate Federated Clinic Lead Generation via the FHIR R4 schema.

🏗️ Architectural Boundaries

To protect our regulatory standing, the ecosystem is strictly divided into two distinct perimeters:

1. The Human Operations Layer (This Repository)

Powers humanos.foundation. This is the administrative surface area of the NGO.

  • Frontend: React 18 SPA, deployed via Vercel Edge.
  • Backend (CRM): Bound directly to Odoo (teams.humanos.foundation) via internal iframes and XML-RPC webhook payloads.
  • Use Case: Recruiting, Helpdesk, GoFundMe routing, and Federal Grant validation.
  • Design System: Custom CSS, Tailwind, and Framer Motion decorative animations (No diagnostic logic).

2. The Machine Layer (External Repository)

Powers aurahos.io and the Clinical Patient Vault. For engineering the core software, please see the aura-health-os repository.

  • Frontend: Capacitor / React Native.
  • Backend: Local-First IndexedDB and PostgREST via Edge Functions.
  • Use Case: The Federated Clinic Route, FHIR R4 JSON Payload Generation, and AES-GCM encrypted vaults.

3. Cryptographic Data Flow (Zero-Knowledge Sync)

sequenceDiagram
    participant P as Patient Device (Local)
    participant Edge as Vercel Edge Runtime
    participant Vault as Core Database
    participant Clinic as Clinical FHIR Gateway (EHR)

    P->>P: 1. Generate Local AES-256 Key
    P->>P: 2. Encrypt Clinical Narrative
    P->>Edge: 3. POST /api/sync (Ciphertext Payload)
    Edge->>Vault: 4. Store Ciphertext (Zero Knowledge)
    Note over Edge,Vault: Servers mathematically cannot decrypt patient data
    
    Clinic->>Edge: 5. Request Authorized Data (OAuth 2.0 Webhook)
    Edge->>P: 6. Secure Push: "Clinic X Requesting Intake Data"
    P->>P: 7. User Approves -> Decrypt & Format to FHIR R4 JSON
    P->>Clinic: 8. Direct Local-to-Clinic P2P Handshake (E2E)
Loading

🚀 Presentation & Quick Start

1. Prerequisites

  • Node.js: v20 or higher
  • Git

2. Deployment

git clone https://github.com/RamonRiosJr/humanos.foundation.git
cd humanos.foundation
npm install

3. Launching the Advocacy Kernel

Executes the UI sequence and launches the local Vite development server (Note: executes zero local cryptographic operations).

npm run dev

Access Portal: http://localhost:7200

🔒 Security & FTC HBNR BAA Exemption

We believe Privacy is a request, but Sovereignty is mathematics.

By utilizing 256-bit AES-GCM Encryption with Web Crypto API key isolation on the Machine Layer, Aura hOS operates distinctly under the FTC Health Breach Notification Rule (HBNR) as a Personal Health Record. Although this repository strictly handles Human Operations, we enforce the same Zero-Trust standard:

  • Ethical Integrity: Contact and Waitlist nodes route strictly through authenticated Odoo CRM endpoints using webhook payload encryption. We do not sell analytics.
  • Zero Third-Party Trackers: We have purged all unauthorized Google/Meta marketing tracking scopes.
  • Privacy Handshake: Optional telemetry (PostHog) is loaded dynamically and strictly respects Edge rendering constraints without accessing persistent local state.

For more information on how we bypass FDA SaMD and HIPAA BAA traps, please see our Zero-Knowledge Whitepaper.

🤝 The Contributor's Path

We are scaling an sovereign-grade contributor network:

  • Data Scientists/Engineers: Help us harden the local encryption logic or optimize the UI compiling speeds locally.
  • Clinicians: Validate our UX logic against "Root-Cause" workflows.
  • Advocates: Help us scale the 501(c)(3) pipeline by driving awareness.
  1. Review the Code of Conduct.
  2. Read the Contributor Guidelines.
  3. Check the Project Board for active validation tasks.

Built by patients, for patients. Data Sovereignty is a Human Right.

Developed by Ramon Luis Rios Jr @ Coqui Cloud Dev Co.