Vivla Tools

Monorepo que contiene las herramientas internas de Vivla: un conjunto de aplicaciones para gestionar comunicación con huéspedes, propiedades, guías de mantenimiento, notificaciones y operaciones del equipo.

Estructura del monorepo

Frontend

apps/frontend — Panel interno principal construido con TanStack Start (React). Incluye los módulos de Chat, Community, Notificaciones, Teams y Dashboard.Puerto: 3000

Backend

apps/backend — API NestJS que sirve a todos los frontales y a la app mobile (vivla-mobile). Gestiona autenticación, permisos, chat, surveys, community, notificaciones e inbox.Puerto: 3001

Community Frontend

apps/community-frontend — Portal público Next.js 14 para que huéspedes y personal de limpieza accedan a guías de propiedades, inventario, planos y sesiones de limpieza.Puerto: 3002

Home Excellence

apps/home-excellence — Portal público Next.js 14 para propietarios: métricas de satisfacción NPS, estado de calidad, tickets, protocolos y resultados del Home Review 2026.Puerto: 3003

Packages compartidos

packages/common — Tipos, utilidades, constantes y validaciones compartidas (Zod).packages/ui — Librería de componentes React con shadcn/ui y Tailwind CSS.packages/eslint-config — Configuración ESLint compartida.

Módulos principales

Módulo	Frontend	Backend	Descripción
Chat	`/app/chat/`	`/api/chat/`	Mensajería en tiempo real con Stream Chat, tickets de soporte, gestión de canales y agentes
Surveys	`/app/chat/surveys/`	`/api/surveys/`, `/api/survey-types/`, `/api/survey-legacy-responses/`, `/api/survey-scores/`, `/api/chat/sync/firebase-legacy-responses`	Encuestas dinámicas con builder visual, versionado, 5 tipos (Casa, Estancia, Llegada, Onboarding, Financiero), resultados con sub-tabs, user matrix multi-source, rewards, action plans y sync automático desde Firebase via Windmill
Community	`/app/community/`	`/api/community/`	Gestión de propiedades: guías, inventario, limpieza, planos, fotos, styling
Notificaciones	`/app/notifications/`	`/api/notifications/`	Push notifications con templates, automaciones, deep links y analytics
Teams	`/app/teams/`	`/api/teams/`	Gestión de equipos, miembros y roles
Inbox	Sidebar	`/api/inbox/`	Bandeja de entrada unificada con notificaciones en tiempo real
Permisos	Integrado	`/api/permissions/`	Control de acceso granular por módulo (none/view/edit/admin)
Home Excellence	`apps/home-excellence/`	`/api/surveys/public/*`	Portal propietarios: NPS, satisfacción, tickets, Home Review 2026

Stack tecnológico

Capa	Tecnología
Frontend	TanStack Start, TanStack Router, TanStack Query, React 18, Tailwind CSS
Community Frontend	Next.js 14 (App Router), React PDF
Backend	NestJS 10, Express
Base de datos	Supabase (PostgreSQL con RLS)
Autenticación	Auth0 (JWT/JWKS), Stream Chat tokens para mobile
Chat en tiempo real	Stream Chat SDK
Push notifications	Firebase Admin SDK, Expo Server SDK, Web Push (VAPID)
Almacenamiento	Cloudinary (imágenes)
Email	SMTP2GO
Build	Turborepo, pnpm workspaces

Relación entre aplicaciones

┌─────────────────┐     ┌─────────────────┐     ┌──────────────────┐
│  vivla-mobile    │     │  Frontend        │     │ Home Excellence   │
│  (app externa)   │     │  (TanStack)      │     │ (Next.js, :3003)  │
└────────┬────────┘     └────────┬────────┘     └────────┬─────────┘
         │                       │                       │
         │  /api/chat/mobile/*   │  /api/*               │ /api/surveys/public/*
         │  /api/surveys/mobile/*│                       │
         │                       │                       │
         └───────────┬───────────┴───────────┬───────────┘
                     │                       │
              ┌──────▼──────┐         ┌──────▼──────────┐
              │   Backend    │         │ dashboard.vivla  │
              │  (NestJS)    │         │ api.vivla.com    │
              └──────┬──────┘         └─────────────────┘
                     │
         ┌───────────┼───────────┐
         │           │           │
    ┌────▼───┐  ┌───▼────┐  ┌──▼───────┐
    │Supabase│  │Stream  │  │Cloudinary│
    │  (DB)  │  │ Chat   │  │ (media)  │
    └────────┘  └────────┘  └──────────┘
                     │
              ┌──────▼──────┐
              │  Community   │
              │  Frontend    │
              │  (Next.js)   │
              └─────────────┘

La app mobile (vivla-mobile) consume endpoints específicos de este backend (/api/chat/mobile/* para chat, /api/surveys/mobile/* para encuestas), no del backend principal de Vivla.

Overview

Chat

Tickets

Encuestas

Community

Guías de mantenimiento

Notificaciones

Tools API

Plataforma

Integraciones

Vivla Tools

Vivla Tools

Estructura del monorepo

Frontend

Backend

Community Frontend

Home Excellence

Packages compartidos

Módulos principales

Stack tecnológico

Relación entre aplicaciones

​Vivla Tools

​Estructura del monorepo

Frontend

Backend

Community Frontend

Home Excellence

Packages compartidos

​Módulos principales

​Stack tecnológico

​Relación entre aplicaciones

Vivla Tools

Estructura del monorepo

Módulos principales

Stack tecnológico

Relación entre aplicaciones