Skip to main content

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.

ArccNova v2 es la reconstrucción greenfield del sistema v1 (ArcnovaApp): una plataforma SaaS multi-tenant de gestión inmobiliaria diseñada para los mercados de México y Estados Unidos desde el día uno. Cada empresa cliente administra sus proyectos de lotificación, su inventario de lotes, su ciclo comercial completo (cotización, reserva, venta), sus planes de financiamiento directo al cliente final, su cobranza, su tesorería y su área de recursos humanos con nómina, todo bajo un único sistema agnóstico al país. Esta versión es un rediseño completo; no hay migración de datos desde v1 y ambos sistemas corren en paralelo durante la transición.

Características principales

Núcleo inmobiliario completo

Proyectos de lotificación, inventario de manzanas y lotes, cotizaciones, reservas, ventas con hasta 4 planes de financiamiento y amortización francesa.

Cobranza y tesorería

Créditos con mora, períodos de gracia, liquidación anticipada y registro de recibos de entrada/salida a nivel proyecto.

Pagos en línea del cliente final

Stripe Connect Express (tarjeta, SPEI, OXXO) con comisión del 1 % para ArccNova. El dinero cae directamente en la cuenta bancaria de la empresa.

Suscripción SaaS

Planes configurables con límites por recurso, Stripe Checkout para el alta de empresas y portal de facturación integrado.

RH y nómina

Estructura organizacional, expediente de empleados, asistencia, horarios, solicitudes con aprobaciones, contratos laborales y motor de nómina por conceptos.

Documentos legales

Contratos con plantillas y variables, generados con QuestPDF + hash SHA-256, almacenados en S3 aislado. Firma electrónica fase 1 incluida.

Modelo de negocio y cadena operativa

La cadena operativa completa que ArccNova v2 soporta va desde el registro de la empresa hasta la cobranza de la última cuota de un financiamiento:
Empresa (Tenant)
  └── Proyecto inmobiliario (Branch)         ← lotificación
        └── Manzanas → Lotes                 ← inventario
              └── Contactos (clientes finales)
                    └── Cotizaciones (informativas)
                    └── Reservas → Ventas    ← ciclo comercial
                          └── Financiamientos (hasta 4 planes por venta)
                                └── Cuotas → Cobros → Mora   ← cobranza
                                └── Contratos firmados        ← documentos legales
        └── Tesorería (recibos de entrada/salida, gastos)
  └── RH y Nómina (a nivel empresa, no proyecto)
  └── Suscripción del SaaS (planes, límites, Stripe)

Tabla de conceptos clave

Algunos términos técnicos del sistema tienen una correspondencia de negocio específica que es importante no confundir:
Término técnicoTérmino de negocioNota importante
TenantEmpresa cliente del SaaSLa unidad de aislamiento multi-tenant.
BranchProyecto inmobiliarioNo es sucursal física. En el contexto de RH existe una tensión abierta (R20).
PropertyLoteEn v1 la manzana se llamaba “Apple”.
ContactCliente finalEl comprador de lotes; no confundir con la empresa cliente del SaaS.

Alcance de v2

Qué entra en esta versión

  • Núcleo inmobiliario completo: proyectos, inventario (manzanas y lotes), contactos, cotizaciones informativas, reservas, ventas con hasta 4 planes de financiamiento, amortización francesa, cobranza con mora, tesorería, reportes y contratos con firma electrónica fase 1.
  • Suscripción SaaS: planes configurables con límites por recurso y Stripe (checkout, portal, webhooks).
  • Pagos en línea del cliente final: Stripe Connect Express (tarjeta, SPEI, OXXO) con comisión del 1 % para ArccNova.
  • RH y nómina: estructura organizacional, empleados con contratos versionados, asistencia, horarios, solicitudes con aprobaciones, documentos del expediente, motor de nómina por conceptos (sin cálculo fiscal) y motor de vacaciones, todo a nivel empresa.
  • Solo proyectos de tipo Lotificación. Los tipos “Construcción” y “Venta de bienes raíces” siguen en análisis del requisitor y no aparecen en el alta de proyecto (C08).
Los tipos de proyecto “Construcción” y “Venta de bienes raíces” no están en scope de v2. Al crear un proyecto, el único tipo disponible es Lotificación.

Qué queda fuera y por qué

Fuera de alcanceRazónReferencia
CFDI / facturación fiscal (módulo Tax)“Esta versión no tendrá alcance para CFDI”T01; ADR-005 y ADR-006 pospuestos
Cálculo fiscal de nómina (ISR, IMSS, INFONAVIT) y CFDI de nóminaLa nómina es un motor de conceptos configurable, no un calculador fiscalR01, R04
Rentals (arrendamiento) y Materials (punto de venta)T04 quedó sin respuesta; en análisis del requisitorT04
CRMSe analiza por separado tras evaluar integraciones externas (Meta/WhatsApp)Decisiones internas §5
Importación masiva de lotes desde ExcelEl caso de uso de esta versión es captura manualC38
Notificaciones de cuota vencida, reserva por vencer y documento de empleado por vencerSolo 3 eventos de notificación están confirmados en la lista cerradaT05
Validación por geocerca o biometría en checadasLa ubicación se captura como evidencia, no como restricciónR09
Dispersión bancaria de nómina (layout SPEI)El sistema registra el pago, no es el medio de pagoR03

Roles y modelo de acceso

El sistema contempla cuatro roles principales que conviven con una matriz RBAC configurable por empresa:
RolTipoDescripción
SysAdminTécnico (ArccNova)Opera la plataforma: gestiona tenants, planes de precios e impersonación. No participa en la operación inmobiliaria de las empresas.
CEONegocio (Tenant)Dueño de la cuenta de la empresa. Rol protegido: no editable ni eliminable (C36).
AdminNegocio (Tenant)Delegado del CEO con permisos amplios configurables.
Asesor / VendedorNegocio (Tenant)Perfil operativo orientado al ciclo comercial (cotizaciones, reservas, ventas).
Un mismo usuario puede tener roles distintos en proyectos distintos (C12). La matriz RBAC incluye 18 permisos protegidos por contraseña para acciones sensibles (C33/C34), además de la matriz general de permisos por módulo.

Módulos por fase

La plataforma se construye en cinco fases incrementales más una fase propia para RH:
#MóduloFaseDescripción
01IdentityImplementado + extensión RBACAutenticación, usuarios y control de acceso
02TenantsFase 1Empresa y sus catálogos de configuración
03BranchesFase 1Proyectos inmobiliarios y membresías
04GeoFase 1Catálogos geográficos MX + US
05FilesFase 1Archivos con URLs prefirmadas a S3
06BillingSaasFase 1Suscripción del SaaS y límites por plan
07PropertiesFase 2Manzanas y lotes
08ContactsFase 2Clientes finales (directorio)
09LegalDocsFase 2Plantillas, contratos y firma electrónica
10SalesFase 3Cotizaciones, reservas y ventas
11FinancingFase 3Amortización y planes de pago
12CollectionsFase 3Créditos, cobros y mora
13TreasuryFase 3Tesorería: recibos y gastos
14PaymentsFase 4Pago en línea del cliente final (Stripe Connect Express)
15ReportsFase 5~20 reportes operativos + carta de cobranza
16HrFase propiaRecursos humanos y nómina (8 contextos internos)
99Fuera de alcanceTax, Rentals, Materials, CRM — no se construyen en v2
ArccNova v2 es una reconstrucción greenfield. El v1 (ArcnovaApp) continúa operando en paralelo y sirve como referencia de comportamiento: varias reglas de esta especificación provienen de su código real.

Build docs developers (and LLMs) love