MiFamilias Architecture

Visual documentation for the MiFamilias platform

System Overview

High-level view of the MiFamilias platform architecture.

flowchart TB subgraph Clients["Client Applications"] iOS["iOS App"] Android["Android App"] Web["Web App"] end subgraph CDN["Content Delivery"] CF["CloudFront CDN"] end subgraph API["API Layer"] APIG["API Gateway"] Auth["Cognito Auth"] end subgraph Compute["Compute"] Users["Users Lambda"] Families["Families Lambda"] Content["Content Lambda"] Capsules["Capsules Lambda"] Posts["Posts Lambda"] Transcend["Transcend Lambda"] end subgraph Storage["Storage"] DDB[("DynamoDB")] S3["S3 Buckets"] OS["OpenSearch"] Pinecone[("Pinecone
Vectors")] end subgraph Media["Media Processing"] MC["MediaConvert"] Trans["Transcribe"] end subgraph AI["AI Services (Self-Hosted + Fallback)"] Claude["Claude API
(or Ollama)"] TTS["Coqui XTTS
(Self-Hosted)"] LipSync["Wav2Lip
(Self-Hosted)"] Whisper["Faster-Whisper
(Self-Hosted)"] end subgraph Events["Event Processing"] EB["EventBridge"] SQS["SQS Queues"] SNS["SNS Topics"] end iOS --> CF Android --> CF Web --> CF CF --> APIG APIG --> Auth Auth --> Users Auth --> Families Auth --> Content Auth --> Capsules Auth --> Posts Auth --> Transcend Posts --> DDB Users --> DDB Families --> DDB Content --> DDB Content --> S3 Capsules --> DDB Transcend --> DDB Transcend --> Pinecone Transcend --> Claude Transcend --> TTS Transcend --> LipSync Transcend --> Whisper S3 --> MC MC --> S3 S3 --> Trans Content --> OS EB --> SQS SQS --> Capsules

Core User Journeys

journey title User Journey: Create Time Capsule section Record Open app: 5: User Record video: 5: User Add message: 4: User section Configure Set unlock date: 5: User Select recipients: 4: User Review content: 3: User section Publish Confirm creation: 5: User Upload video: 3: System Process video: 2: System Store securely: 5: System section Wait Time passes: 1: System Unlock date arrives: 5: System Notify recipients: 5: System

Technology Stack

mindmap root((MiFamilias)) Frontend Ionic Angular TypeScript Capacitor Backend Node.js TypeScript Lambda API Gateway Database DynamoDB Single Table OpenSearch Storage S3 Glacier CloudFront Auth Cognito JWT OAuth2 Media MediaConvert Transcribe FFmpeg DevOps CDK Docker GitHub Actions

Quick Links