ENGINEERING CASE STUDY · DWG FG-003 · IN DEVELOPMENT
Plataforma de Cuidados Zelo
Coordinación del Cuidado Familiar · Next.js & TypeScript · AWS Serverless
Replacing chaotic family messaging threads with structured shift calendars, targeted medication Web Push alerts, collaborative care logs, and transparent expense tracking.
| Proyecto | Zelo App | ID Doc | FG-003 |
|---|---|---|---|
| Rol | Fundadora & Arquitecta de Software (Finder Group) | ||
| Tecnologías | Next.js · TypeScript · MUI (M3) · Zod | Sheet | 4 / 5 |
| Cloud | DynamoDB Single-Table · Cognito · S3 · Textract · CloudFormation | ||
| Links | |||
01 / Definición del Problema & Flujos de Producto Modelo de dominio
Families coordinating care for aging parents or relatives typically rely on unstructured chat groups where critical medication confirmations get buried, medical appointments are missed, and shared pharmacy expenses cause friction.
Zelo organizes caregiving around an explicit family care team with role-based permissions (Admin, Caregiver, Observer) so both on-site and remote relatives share a single source of truth.
Módulos Principales de Cuidado
- Shift Calendar & iCal Sync: Visual rotation schedule assigning who is on duty for each day or medical appointment, with calendar feed integration (
node-ical). - On-Duty Medication Alerts: Per-medication schedules that route Web Push notifications specifically to the family member on shift that day.
- Care Log & Expense Ledger: Structured daily status entries (meals, vitals, mood) and shared expense balances with PDF report export (
@react-pdf/renderer) and receipt OCR (AWS Textract).
02 / Arquitectura Técnica Opciones de implementación
| Layer | Technology | Architectural Rationale |
|---|---|---|
| Frontend & PWA | Next.js (App Router), React 19, Material 3 (@mui/material) |
Mobile-first and offline-tolerant progressive web interface designed for high legibility across age groups, reusing Finder Group Material 3 design conventions. |
| Data & Auth | DynamoDB Single-Table, AWS Cognito (Google, Apple, Email, Phone) | Models family groups, member roles (GSI2), shift assignments, medication schedules, and financial ledgers in a single table with Zod schema validation at service boundaries. |
| Infra & Delivery | AWS CloudFormation, Lambda Bundler (esbuild), S3 Presigned Uploads | Declarative stack definition (infra/zelo-stack.yaml) paired with custom identity account-linking scripts (cognito-account-link.mjs) to prevent duplicate family profiles across social and email logins. |
03 / Estrategia de Calidad & Accesibilidad Verificación
Automated Verification
- Unit & Component Suites: Jest 30 and React Testing Library verify domain services, expense balance calculations, and UI components.
- End-to-End Journeys: Playwright suites configured for both local development (
e2e:local) and production smoke verification (e2e:prod).
Accessibility & Safety Guardrails
- WCAG 2.1 AA Focus: High-contrast Material 3 tokens and simplified navigation tailored for older family members and stressed caregiving contexts.
- Strict Type & Runtime Contracts: 100% TypeScript (`tsc --noEmit`) combined with Zod runtime parsing on every API payload and form submission.
Drawing Set Navigation Sheets 1 to 5
Explore how this portfolio itself is engineered on Sheet 5, or return to the executive overview.