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 un monolito modular construido sobre .NET 10 + React 19 SPA + PostgreSQL 17. El sistema se divide en 16 módulos confirmados, cada uno implementado como un csproj independiente que sigue la estructura de capas Domain / Application / Infrastructure / Presentation / Contracts. Los módulos se comunican exclusivamente a través de los contratos del módulo proveedor; ningún módulo referencia directamente el código interno de otro. Los tres módulos Tax, Rentals y Materials están pospuestos o en duda y no se crearon en el esqueleto actual de la solución.
Al día 11 de junio de 2026, solo el módulo Identity cuenta con implementación real. El resto de los 15 módulos confirmados (más Shared.Approvals) existen únicamente como esqueleto csproj sin código.

Fases de construcción

El roadmap divide el trabajo en cinco fases principales más una fase propia para RH.
FaseMódulosEstado
Fase 1 – FoundationIdentity (implementado; extensión RBAC pendiente), Tenants, Branches, Geo, Files, BillingSaasEsqueleto listo; Identity implementado
Fase 2 – Inmobiliario baseProperties, Contacts, LegalDocsPor construir
Fase 3 – Operación comercialSales, Financing, Collections, TreasuryPor construir
Fase 4 – Pagos en líneaPaymentsPor construir
Fase 5 – ReportesReportsPor construir (habilitación progresiva por fase)
Fase propia (fecha por definir)Hr (8 contextos internos)Por construir
El módulo Reports se habilita de forma progresiva: cada reporte individual se activa en cuanto su fuente de datos existe. No es necesario esperar a que todo el sistema esté completo.

Dependencias funcionales entre módulos

Cada dependencia se implementa a través del contrato público del módulo proveedor. Los módulos no se referencian internamente entre sí (regla del monolito modular).
MóduloDepende dePara qué
TenantsIdentityUsuarios de la empresa
BranchesTenants, Geo, Files, IdentityEmpresa dueña, ubicación, imagen de portada, membresías con rol
BillingSaasIdentity, TenantsCEO, empresa, estado de acceso (paywall)
PropertiesBranchesManzanas y lotes pertenecen al proyecto
ContactsGeo, FilesUbicación del cliente, adjuntos del expediente
LegalDocsFiles, Sales, HrPersistencia de PDFs, datos para variables de contrato
SalesProperties, Contacts, Branches, LegalDocs, FinancingLote, cliente, proyecto, contrato, planes de pago
FinancingSales, Tenants (modalidades)Planes de la venta, catálogo de modalidades
CollectionsSales, Financing, TenantsCuotas, amortización, conceptos de cobro
TreasuryBranches, TenantsGastos por proyecto y generales, tipos de recibo y cuentas destino
PaymentsCollections, BillingSaasAplicar el pago en línea a la cuota correspondiente
ReportsTodos los anterioresConsultas de datos operativos
HrIdentity, LegalDocs, Tenants, Shared.ApprovalsUsuarios y permisos, contratos laborales, festivos, flujos de aprobación

Orden de construcción recomendado

El siguiente orden minimiza bloqueos entre equipos y garantiza que cada módulo tenga sus dependencias disponibles antes de ser construido.
1

Identity RBAC (extensión)

Prácticamente todos los flujos del sistema citan permisos. Completar la extensión RBAC (roles personalizados, matriz de permisos, permisos protegidos, ADR-015) desbloquea la implementación correcta del control de acceso en todos los módulos siguientes.
2

Geo, Files, Tenants y Branches

Estos cuatro módulos de la Fase 1 habilitan el alta de proyecto de extremo a extremo (HU-01 a HU-09 del lote 1). Pueden construirse en paralelo dado que sus dependencias entre sí son mínimas.
3

BillingSaas

El paywall y las cuotas de recursos son necesarios antes de abrir el registro público a empresas reales. Depende de Identity y Tenants ya operativos.
4

Properties y Contacts

Con el proyecto existente (Branches listo), se puede construir el inventario inmobiliario (manzanas y lotes) y el directorio de clientes finales en paralelo.
5

LegalDocs

Requerido por Sales para generar el contrato y gestionar las firmas. Depende de Files (para la persistencia de PDFs).
6

Sales + Financing (juntos)

La venta crea sus planes de pago al mismo tiempo; el motor de amortización es parte del alta de venta. Se construyen en el mismo sprint.
7

Collections

Consume las cuotas generadas por Financing. Requiere que Sales y Financing estén completos.
8

Treasury (en paralelo con Collections)

Comparte pocas dependencias con Collections; puede avanzar de forma independiente una vez que Branches y Tenants estén listos.
9

Payments

Se implementa sobre el motor de cuotas de Collections ya construido. Requiere además la configuración de Stripe Connect Express (BillingSaas).
10

Reports (progresivo)

Se habilita al final de cada fase. Cada reporte individual se activa cuando su fuente de datos ya existe.
11

Hr (fase propia)

Su único prerequisito duro es Identity RBAC + Shared.Approvals + LegalDocs (contratos laborales) + el catálogo de festivos de Tenants. La fecha de inicio la fija el arquitecto.
Planes futuros: el módulo CRM (leads y pipeline) está en análisis; el puente lead → Contacto se definirá cuando se retome. Los módulos Tax, Rentals y Materials están pospuestos o en duda y no forman parte del roadmap activo.

Documentación por módulo

Identity

Autenticación JWT, gestión de usuarios, roles personalizados y matriz de permisos RBAC.

Tenants y Branches

Configuración de empresa, catálogos operativos, proyectos inmobiliarios y membresías.

Properties

Inventario inmobiliario: manzanas, lotes, estatus y actualización masiva de precios.

Contacts

Clientes finales, expediente, beneficiarios e historial de ventas por contacto.

Sales

Cotizaciones, reservas y ventas de lotes.

Financing

Planes de pago, amortización y tasas de interés.

Collections

Créditos, cobros, mora y carta de cobranza.

Treasury

Recibos de entrada/salida, gastos y panorama financiero.

LegalDocs

Plantillas de contrato, generación de PDF y firma electrónica.

Payments

Pagos en línea vía Stripe Connect Express.

Reports

Reportes operativos de ventas, lotes, finanzas y contactos.

Hr

Recursos humanos: organización, empleados, nómina, vacaciones y más.

Build docs developers (and LLMs) love