Skip to content

stefanbocane/ALS-hub

Repository files navigation

ALS Intelligent Hub

The operating system for families affected by ALS.
Logistics. Legacy. Intelligence. All in one place.

HIPAA Compliant Next.js 16 TypeScript 5 Firebase React 19 MIT


The Problem

An ALS diagnosis doesn't just affect one person — it reorganizes an entire family's life overnight. Families are suddenly managing medications, appointments, insurance claims, equipment logistics, legal documents, and emotional wellbeing across dozens of disconnected tools, spreadsheets, and phone calls. There is no single platform designed for the unique, evolving needs of ALS families.

The Solution

ALS Intelligent Hub is a unified, HIPAA-compliant platform that acts as a central command center for every aspect of the ALS journey. Instead of juggling separate apps for scheduling, finances, documents, and communication, families get one intelligent system that connects everything — and learns to anticipate what they'll need next.




Six Integrated Modules

Finance & Document Hub

Secure vault for critical documents — power of attorney, insurance policies, medical records. Expense tracker with automatic tax deduction flagging. Benefits navigator with AI-generated plain-English summaries.

Logistics Hub

Care Calendar — live, family-shared scheduling with email notifications and configurable reminders. Supply swap marketplace for community equipment sharing. Secure caregiver messaging.

Service Hub

Vetted local contractor directory with community-powered reviews. Home modification specialists, equipment vendors, therapy providers — all verified and rated by other ALS families.

Legacy Hub

AI-generated daily story prompts. Voice banking integration with Team Gleason. Photo and memory preservation — a time capsule that ensures family stories outlast the diagnosis.

Research & Advocacy Hub

AI-powered clinical trial matcher using Vertex AI + ClinicalTrials.gov. One-click advocacy emails to representatives. Research updates and participation opportunities.

Knowledge Hub

RAG-powered AI assistant built on Vertex AI Search. Natural language interface across all platform data. Ask a question, get an answer — with sources from your own documents and trusted ALS resources.




Architecture

                    ┌─────────────────────────────┐
                    │        Next.js 16 App        │
                    │    (React 19 + TypeScript)    │
                    └──────────┬──────────────────┘
                               │
              ┌────────────────┼────────────────┐
              │                │                │
              ▼                ▼                ▼
     ┌──────────────┐  ┌─────────────┐  ┌────────────┐
     │   Identity    │  │  Firestore   │  │   Cloud    │
     │   Platform    │  │  (NoSQL DB)  │  │  Storage   │
     │  (HIPAA Auth) │  │  Real-time   │  │  Documents │
     └──────────────┘  └─────────────┘  └────────────┘
              │                │                │
              └────────────────┼────────────────┘
                               │
                    ┌──────────┴──────────┐
                    │                     │
                    ▼                     ▼
           ┌───────────────┐    ┌─────────────────┐
           │ Cloud Functions│    │   Vertex AI      │
           │ (Server Logic) │    │  (RAG + Gemini)  │
           └───────────────┘    └─────────────────┘

All infrastructure runs on Google Cloud Platform under a signed Business Associate Agreement (BAA), ensuring every service that touches patient data meets HIPAA requirements.




Security & Compliance

This isn't a side project with security bolted on — HIPAA compliance is the foundation.

  • Family-scoped data isolation — Firestore security rules enforce that users can only access their own family's data. No cross-family data leakage is possible at the database level.
  • Identity Platform authentication — BAA-covered auth (not standard Firebase Auth). Supports MFA, session management, and audit logging.
  • End-to-end encryption — Data encrypted at rest (AES-256) and in transit (TLS 1.3).
  • Input validation — Every form field validated with Zod schemas. Server-side re-validation on all API routes.
  • Security headers — CSP, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy on every response.
  • No client-side PHI caching — Protected health information is never stored in localStorage, sessionStorage, or service workers.
  • Audit trail — All access to sensitive data is logged for compliance reporting.



Tech Stack

Layer Technology
Frontend Next.js 16, React 19, TypeScript 5, Tailwind CSS 4
Backend Firebase Cloud Functions, Next.js API Routes
Database Cloud Firestore (real-time NoSQL)
Auth Google Identity Platform (BAA-covered)
Storage Cloud Storage for Firebase
AI Vertex AI Search, Gemini (RAG system)
Validation Zod runtime schemas
Email SendGrid transactional email
Maps Google Maps Places API



Quick Start

# Clone
git clone https://github.com/stefanbocane/ALS-hub.git
cd ALS-hub

# Install
npm install

# Configure
cp .env.example .env.local
# Add your Firebase + GCP credentials

# Run
npm run dev
# → http://localhost:3000

See docs/GCP_SETUP.md for full infrastructure setup including BAA signing, Identity Platform configuration, and Firestore security rule deployment.




Current Status

The Care Calendar in the Logistics Hub is live and functional — real-time family-shared scheduling with 6 event types, email notifications, configurable reminders, and mobile-responsive design. The authentication system, Firestore security rules, and data model are complete.

The remaining five modules are in active development, with the platform transitioning toward a native iOS experience.




Why This Matters

There are 30,000 Americans living with ALS at any given time. Every one of them has a family behind them — partners, children, parents, siblings — suddenly thrust into a world of complex medical logistics, financial planning, and emotional weight. The tools available today are generic, disconnected, and not built for the reality of progressive illness.

ALS Intelligent Hub exists to change that. One platform. One login. Everything a family needs, in one place — intelligent enough to anticipate what comes next.



MIT License
Built by Stefan Bocanegra

About

The operating system for families affected by ALS — a HIPAA-compliant platform for logistics, legacy, finance, and AI-powered care coordination.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages