> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.vivla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VIVLA Docs

> Documentación técnica interna de la plataforma VIVLA

## Bienvenido a VIVLA

VIVLA es una plataforma de **co-ownership inmobiliario**. Permite a copropietarios reservar estancias, comunicarse entre sí, gestionar sus propiedades y acceder a servicios de atención al cliente — todo desde una app móvil y un conjunto de herramientas internas.

Esta wiki es la **fuente de verdad** para todo el equipo: ingeniería, producto, operaciones y CX. Aquí encontrarás cómo funciona cada sistema, cómo se conectan entre sí y cómo contribuir.

## Nuestros productos

<CardGroup cols={2}>
  <Card title="Vivla Tools" icon="wrench" href="/tools/index">
    **La plataforma interna.** Chat de soporte en tiempo real, encuestas NPS, community guidelines, notificaciones, gestión de equipos y permisos. Es el corazón operativo de Vivla.
  </Card>

  <Card title="Mobile App" icon="mobile" href="/mobile/index">
    **La app para copropietarios.** Reservar estancias, chatear, gestionar propiedades y perfil. iOS y Android con React Native + Expo.
  </Card>

  <Card title="Vivla API" icon="server" href="/backend/index">
    **El backend principal.** Auth, booking, propiedades, stays, invitaciones. Sirve a la app móvil y al panel de CX.
  </Card>

  <Card title="Panel CX" icon="headset">
    **Backoffice para agentes.** El nuevo panel de atención al cliente, conectado a la API principal.
  </Card>
</CardGroup>

## Cómo se conecta todo

La app móvil consume **dos backends**: la API principal (booking, auth, propiedades) y la Tools API (chat, encuestas). El panel de CX usa solo la API principal. Vivla Tools sirve además portales públicos para clientes y propietarios.

<Card title="Ver arquitectura completa" icon="diagram-project" href="/architecture">
  Diagrama de alto nivel, stack técnico y conexiones entre todos los sistemas.
</Card>

## Ecosistema completo

VIVLA está compuesto por **11 repositorios** organizados en 4 dominios:

| Dominio                  | Repos                                                         | Descripción                                               |
| ------------------------ | ------------------------------------------------------------- | --------------------------------------------------------- |
| **Plataforma principal** | `vivla-api`, `vivla-mobile-app`, `vivla-tools`, `vivla-panel` | Los 4 productos core del negocio                          |
| **Servicios**            | `booking-cloud-functions`, `calendar-manager`, `VivlaNPS`     | Automatizaciones, integraciones y herramientas auxiliares |
| **Deep links**           | `vivla-app-site`, `app-invites`                               | Redirects, verificación de links y landing pages          |
| **Externo**              | `propcos`                                                     | Desarrollo por contratista (Digio)                        |

<Card title="Ver todos los repositorios" icon="list" href="/repositories">
  Inventario detallado: propósito, stack, hosting, conexiones y estado de documentación de cada repo.
</Card>

<Note>
  Este sitio está protegido por Cloudflare Access en `wiki.vivla.com`. Solo miembros del equipo pueden acceder.
</Note>