Bienvenido

mseller es una plataforma de gestión de ventas y distribución organizada en cuatro repos:

• mseller-api — Backend .NET 10 (Portal, Ingestion y Consumo APIs).
• mseller-firebase — Cloud Functions, reglas de Firestore y Storage, configuración de los emuladores.
• mseller-cloud — Portal Next.js (la UI que usan los administradores).
• mseller-docs — Esta documentación.

¿Por dónde empiezo?

Si es tu primer día:

1. Activa tus cuentas y accesos (correo, GitHub, Linear, Slack, mseller.dev).
2. Revisa qué esperamos en las primeras dos semanas.
3. Lee Prerequisitos para instalar las herramientas.
4. Sigue Clonar los repos.
5. Instala dependencias en cada repo: Instalar dependencias.
6. Levanta el entorno local con Correr localmente.

Si ya tienes el entorno funcionando, ve directo a Arquitectura para entender cómo se comunican los servicios.

¿Cómo está organizada esta documentación?

• Nuevo integrante — Cuentas, accesos y qué esperar en las primeras dos semanas.
• Empezar — Todo lo que necesitas para tener tu entorno funcionando desde cero.
• Arquitectura — Cómo se conectan los servicios y dónde vive cada responsabilidad.
• Workflows (próximamente) — Flujos del día a día: cómo añadir un endpoint, cómo añadir una migración, cómo desplegar.
• Referencia (próximamente) — Tablas de puertos, variables de entorno, runbooks.

Convenciones de esta doc

• El texto está en español. Comandos, nombres de archivo, variables de entorno y mensajes de error se quedan en su idioma original (inglés) — son universales y traducirlos rompe la búsqueda en Google y en los logs.
• Los enlaces a otros repos del stack apuntan a GitHub. Cuando los repos se transfieran a la organización MSeller, las URLs se redirigen automáticamente.