Saltar al contenido principal
NEURAPXNEURAPX
Registrarse

Design system · NEURAPX

Sistema de diseño y catálogo de servicios

Prescripción terapéutica digital con seguimiento inteligente. Fundamentos visuales (Material 3 + tokens de producto), componentes reutilizables y todos los servicios incluidos en la plataforma — live y planificados.

Fuente: Inter
Iconos: Material Symbols
A11y: WCAG 2.1 AA
i18n: es / en / pt

1. Fundamentos

Capa M3 para producto y marketing (`bg-m3-*`). Capa shadcn HSL para primitivas de @neuroapp/ui. Semáforo clínico para adherencia.

Color — Material 3

primary

secondary

tertiary

error

surface

surface-container

surface-container-high

inverse-surface

Primary light #1a40c2 · Secondary #0b6b4a · CSS vars en app/globals.css

Color — Compliance clínico

≥70% bueno
40–69% atención
<40% riesgo
82%Buen cumplimiento
55%Atención
28%Riesgo

Tipografía

display — The quick rehab jump

Hero marketing, números KPI grandes

headline-lg — The quick rehab jump

Títulos de sección / página

headline-md — The quick rehab jump

Subsecciones, cards destacadas

title-lg — The quick rehab jump

Títulos de card / dialog

body-lg — The quick rehab jump

Lead paragraphs

body-md — The quick rehab jump

Cuerpo por defecto

label-md — The quick rehab jump

Nav, botones, form labels

label-sm — The quick rehab jump

Badges, meta, captions

Espaciado y layout

  • Unit base: 8px (space-unit)
  • Touch target: 48px (min-h-touch-target)
  • Márgenes: px-margin-mobile (fluid) / px-margin-desktop (fluid)
  • Contenido: max-w-[1200px] marketing · max-w-6xl patient main

Motion

Subtle, clinical, professional — never playful bounce on clinical data

animate-fade-in-upanimate-scale-inanimate-page-enterReveal componentactive:scale-95 on CTAs

2. Componentes

Primitivas en @neuroapp/ui · chrome de app en components/ui · dominios en components/{portal}.

Default
Secondary
Icon

Button

@neuroapp/ui

packages/ui/src/button.tsx

CVA variants: default, destructive, outline, secondary, ghost, link

Card

@neuroapp/ui

packages/ui/src/card.tsx

Card + Header/Title/Description/Content/Footer

Badge

@neuroapp/ui

packages/ui/src/badge.tsx

Status chips

ComplianceBadge

@neuroapp/ui

packages/ui/src/compliance-badge.tsx

Semáforo clínico de adherencia

Spinner

@neuroapp/ui

packages/ui/src/spinner.tsx

Loading

Icon

apps/web

components/ui/icon.tsx

Material Symbols by name

Logo

apps/web

components/ui/logo.tsx

mark | full · light/dark auto

AppShell

apps/web

components/ui/app-shell.tsx

default (sidebar) | patient (bottom nav)

Sidebar / Topbar / BottomNav

apps/web

components/ui/{sidebar,topbar,bottom-nav,mobile-nav}.tsx

Navigation chrome

ThemeToggle / LanguageSwitcher

apps/web

components/ui/theme-toggle.tsx, language-switcher.tsx

Global chrome

DataTable / Skeleton / Reveal

apps/web

components/ui/

Lists, loading, scroll reveal

Marketing*

apps/web

components/marketing/

Landing blocks + MarketingPageShell

3. Shells por portal

Cada rol tiene un shell y prioridad de UX distinta.

patient

/patient/*

AppShell variant=patient

Mobile-first PWA + bottom nav + safe-area

therapist

/therapist/*

AppShell default + sidebar xl+

Desktop + tablet responsive

clinic

/clinic/*

AppShell default + CRM nav

Desktop-first operations

admin

/admin/*

AppShell default

Utility dense tables

marketing

/

MarketingHeader + MobileNav / MarketingPageShell

SEO, honesty, conversion

4. Servicios de producto

17 servicios live · 2 planificados / parciales. Catálogo en código: lib/design-system/services.ts.

Live (17)

Prescripción y notas con IA (Gemini)

live

Rutinas sugeridas, SOAP, análisis de movimiento y adherencia; el terapeuta siempre aprueba.

therapistpatient

Provider: Google Vertex AI / Gemini

Incluido en suscripción terapeuta/clínica

/therapist/ai · /api/gemini/prescribe · /api/gemini/analyze-posture

Rutinas y planes semanales

live

Prescripción de ejercicios, grilla semanal, envío al paciente y calendario de plan.

therapistpatient

Incluido

/therapist/patients · /patient/my-routine · /patient/my-plan

Biblioteca de ejercicios + video demo

live

Catálogo, categorías, video multi-dispositivo (Mux) y reproducción en PWA.

therapistpatientadmin

Provider: Mux (transcode HLS/MP4)

Incluido

/therapist/library · /therapist/exercises · /api/exercises

PWA paciente (en producción)

live

Experiencia móvil en el navegador: hoy / rutina / plan, check-ins, mensajes, teleconsulta, deudas y offline outbox. Sin tienda de apps.

patient

Gratis para el paciente invitado

/patient/*

Check-ins y adherencia

live

Dolor/fatiga diarios, ejercicios completados y semáforo de cumplimiento.

patienttherapist

Incluido

/patient/today · /api/checkins

Mensajería clínica in-app

live

Chat paciente ↔ terapeuta con contexto clínico.

patienttherapist

Incluido

/patient/messages · /therapist/messages · /api/messages

Teleconsulta

live

Videollamada en cita virtual (Jitsi/JaaS).

patienttherapist

Provider: Jitsi / 8x8 JaaS

Incluido

/patient/call · /therapist/call · /therapist/call/appointment/[id]

Reservas y agenda

live

Disponibilidad, reserva presencial/virtual/domicilio y agenda profesional.

patienttherapistclinic

Incluido; fee plataforma en cobros online

/patient/book · /therapist/agenda · /clinic/agenda

Nearby (descubrimiento)

live

Mapa/listado de terapeutas por cercanía, badges de pago y reserva.

patienttherapistpublic

Incluido en plataforma

/therapist/nearby · /api/nearby/**

Pagos y cobros (ONVO)

live

Checkout tarjeta/SINPE, marketplace split, payment requests, efectivo en consulta.

patienttherapistclinicadmin

Provider: ONVO Pay

5% fee por consulta cobrada en plataforma · comisión marketplace configurable

/patient/payment · /therapist/money · /api/payments/**

Suscripción SaaS

live

Plan terapeuta $9.99/mes · clínica $9.99/mes (2 asientos) + $2 extra · 1 mes gratis.

therapistclinicadmin

Provider: ONVO Pay

Suscripción recurrente

/pricing · /therapist/billing · /clinic/subscription

CRM / ERP clínica

live

Agenda extendida, expedientes, paquetes, deudas, caja, tratamientos y copilot.

clinictherapist

Plan clínica

/clinic/crm/** · /api/clinics/[id]/crm/**

WhatsApp clínico

live

Plantillas, recordatorios de cita/deuda/pago y campañas multi-clínica (Kapso).

clinictherapist

Provider: Kapso

Incluido en CRM (costos de canal según proveedor)

/clinic/crm/whatsapp · /api/webhooks/**

Facturación y deudas

live

Facturas paciente, deudas clínicas, earnings terapeuta y reportes de caja.

patienttherapistclinic

Incluido

/patient/invoices · /therapist/invoices · /clinic/crm/caja

Historial y cumplimiento

live

Consentimientos, clinical_records append-only, RLS y logs de acceso.

patienttherapistadmin

Incluido (requisito de confianza)

/patient/clinical-history · /api/**

Consola admin plataforma

live

Terapeutas, pacientes, ejercicios, marketplace y comisiones a nivel plataforma.

admin

Interno NeuraPX

/admin/**

Multi-idioma

live

Portales y marketing en español, inglés y portugués.

patienttherapistclinicpublic

Incluido

*

Roadmap (2)

App nativa iOS / Android

partial

En desarrollo (Expo, builds de preview). La vía de producción del paciente sigue siendo la PWA.

patient

En desarrollo

Pagos cripto (ETH / Stellar)

planned

Contratos y UI en repo; no es monetización activa.

therapistadmin

Fase 2

5. Plataforma e integraciones

Infraestructura y providers que sostienen los servicios de producto.

Web App (Next.js)

live

App Router, RSC, API Routes Node, i18n, marketing y portales.

publicsystem

Provider: Vercel

Backend de datos (Supabase)

live

Postgres + Auth + RLS + Storage + Realtime.

system

Provider: Supabase

Exercises API

live

Servicio Nest del catálogo de ejercicios.

system

PWA / Service Worker

live

Instalable, offline outbox y caching (Serwist).

patient

Provider: Serwist

Email transaccional

live

Magic link, notificaciones y templates.

system

Provider: Resend (config)

Push notifications

live

Opt-in y delivery de notificaciones web.

patienttherapist

Observabilidad

live

Errores y performance en producción.

system

Provider: Sentry + Vercel Analytics

Geocoding / distance

live

Nearby: geocode y matrices de distancia con cache.

system

Provider: Nominatim / Distance Matrix (config)

CI/CD y quality gates

live

GitHub Actions, husky, coverage gate, lint/typecheck.

system

Provider: GitHub Actions

6. Qué incluye cada plan

Precios canónicos: terapeuta $9.99/mes · clínica $9.99/mes (+ $2/asiento) · fee consulta 5%.

therapist

Terapeuta individual

$9.99/mes

  • IA clínica Gemini
  • Rutinas y planes
  • Biblioteca + video Mux
  • Pacientes PWA ilimitados (según fair use)
  • Mensajes y teleconsulta
  • Agenda y Nearby
  • Cobros en plataforma + fee 5%/consulta
  • i18n es/en/pt

clinic

Clínica

$9.99/mes · 2 asientos (+$2 extra)

  • Todo lo del plan terapeuta (por asiento)
  • CRM multi-tenant
  • Caja, deudas, paquetes, tratamientos
  • WhatsApp clínico (Kapso)
  • Roles owner/admin/therapist
  • Reportes y operaciones de clínica

patient

Paciente

Sin suscripción

  • PWA (rutina/plan del día)
  • Check-ins
  • Mensajes y teleconsulta
  • Reservas y pagos de citas
  • Historial y facturas

Para ingeniería y agentes

  • Tokens runtime: lib/design-system/tokens.ts
  • Catálogo de servicios: lib/design-system/services.ts
  • CSS vars: app/globals.css
  • Tailwind M3: tailwind.config.ts
  • Docs: docs/design-system/
  • Contrato agentes: AGENTS.md