Tenants and Branches: Company and Project Management

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DevCarlosRodriguez/Documentacion-Arccnova-2.0/llms.txt

Use this file to discover all available pages before exploring further.

​

Módulo 02 — Tenants (empresa y configuración)

​

Modelo de dominio

​

Catálogo de modalidades de pago (lista cerrada — C25)

​

Flujos principales

• Tipo de cambio: el usuario lo actualiza bajo demanda desde Banxico (C45). No hay actualización automática diaria; cada pago usa el tipo de cambio del día del pago (C32, RT-18).

1. La empresa captura su calendario (fecha, nombre, tipo, multiplicadores de nómina).
2. Los multiplicadores (1.00 = sin prima) los consume únicamente Nómina (Hr). El núcleo del sistema solo usa la fecha para calcular gracia en vencimientos de cobranza (C24).

​

Reglas de negocio

• RN-01. Los festivos se administran por empresa (C44); el modelo soporta ámbito Global / Empresa / Proyecto (Decisión 17).
• RN-02. El tipo de cambio se actualiza manualmente bajo demanda (C45).
• RN-03. La lista de modalidades de pago es cerrada: las nueve de la tabla anterior (C25).
• RN-04. Los catálogos de empresa son de ámbito solo-TenantId (RT-02, ADR-010).

​

Módulo 03 — Branches (proyectos inmobiliarios)

​

Modelo de dominio

​

Proyecto — campos obligatorios (C09)

​

Proyecto — campos opcionales

​

Membresía usuario-proyecto

​

Flujos

​

Reglas de negocio

• RN-01. Tipo de proyecto fijo en Lotificación en esta versión (C08).
• RN-02. El proyecto es operativo desde su creación (C10).
• RN-03. Eliminar = soft-delete, sin bloqueo por ventas activas (C11 + segunda ronda).
• RN-04. La tasa de incumplimiento y los días de gracia del proyecto son defaults; la venta captura su propio porcentaje de mora (C23) y la gracia del proyecto aplica a los vencimientos (C24).
• RN-05. TEA del proyecto = tasa de referencia para los planes de financiamiento de sus ventas (C09).
• RN-06. Membresía con rol por proyecto (C12).
• RN-07. El alta de proyecto está sujeta a la cuota del plan (recurso “proyectos”, C01 segunda ronda).

​

Módulo 04 — Geo (catálogos geográficos)

​

Flujo HU-06 — Selección en cascada

1. El usuario elige el País; el sistema devuelve sus Estados.
2. Al elegir Estado, el sistema devuelve sus Municipios.
3. Al elegir Municipio, el sistema devuelve sus Localidades.

​

Reglas de negocio

• RN-01. Seed inicial con México y Estados Unidos (T02).
• RN-02. Catálogo global del sistema, sin tenancy (lectura para todos los tenants).
• RN-03. Los catálogos son de solo lectura para el usuario final; no se editan desde el UI.

​

Módulo 05 — Files (archivos adjuntos)

​

Flujo de subida (HU-14)

​

Flujo de descarga

1. El front solicita la descarga de un archivo por su id.
2. El backend valida el permiso y emite una URL prefirmada GET temporal.
3. El front descarga el binario directamente desde S3.

​

Reglas de negocio

​

Módulo 06 — BillingSaas (suscripción y cuotas)

​

Estados de la suscripción

​

Sistema de cuotas por recurso (C01 segunda ronda)

• SNAPSHOT: valor fijo, sin reinicio (por ejemplo, espacio en GB).
• PERIODIC: se reinicia al llegar la fecha del período. El único recurso PERIODIC en el v1 es COBROS.

// Pseudocódigo del patrón de cuota atómica
var result = await quotaService.ExecuteWithQuotaAsync(
    tenantId,
    ResourceType.Lotes,
    quantity: 1,
    action: async () =>
    {
        // Lógica de creación del lote
        return await lotRepository.CreateAsync(lot);
    }
);
// Si la acción falla después de consumir, TryReleaseResource libera el recurso

​

Flujos principales

1. Identity crea usuario + empresa + rol CEO en todos los casos.
2. El CEO continúa a Stripe Checkout. Si la sesión (30 min) expira, se crea una nueva.
3. Webhook de pago exitoso: suscripción activa. La prueba aplica solo en la primera suscripción y solo si el plan la define (C03).

​

Reglas de negocio destacadas

• RN-01. Planes, precios, prueba, módulos y límites se configuran desde el sistema sin redeploy (C01).
• RN-05. Sin días de gracia propios ni dunning propio: Stripe gobierna reintentos y recordatorios (C02).
• RN-07. La cuenta nunca se borra por falta de pago en esta versión (C04).
• RN-09. Recursos SNAPSHOT no se reinician; PERIODIC se reinician por fecha de período. El job de reinicio queda pendiente de implementar.
• RN-10. Consumo atómico con liberación compensatoria (TryReleaseResource) si la acción falla (C01 segunda ronda).