🧩 Documentación de Arquitectura Limpia - Fullstack .NET + MongoDB + React

🔧 Backend (.NET 8/9 + MongoDB)

Estructura de Carpetas

/RealEstateSolution
  /RealEstate.API
  /RealEstate.Application
  /RealEstate.Domain
  /RealEstate.Infrastructure
  /RealEstate.Tests

• /RealEstate.API
  Contiene los controladores y middlewares. Se encarga de recibir las solicitudes HTTP y delegar la lógica a la capa de aplicación. Separar esta capa asegura que el cambio de framework o protocolo (HTTP → gRPC, por ejemplo) no afecte la lógica de negocio.
• /RealEstate.Application
  Aloja los Use Cases o servicios de aplicación que contienen la lógica de negocio. Esto permite centralizar las reglas de negocio en una capa que no depende del framework o detalles de infraestructura.
• /RealEstate.Domain
  Define las entidades y DTOs. Esta capa representa el "corazón" del sistema y puede ser compartida por todas las demás capas. Al mantenerla independiente, garantizamos una mayor reutilización y claridad en el modelo de negocio.
• /RealEstate.Infrastructure
  Aquí se implementan los accesos a MongoDB y otros recursos externos. Separar esta capa permite cambiar la base de datos (por ejemplo, SQL Server) sin tocar la lógica de negocio ni los controladores.
• /RealEstate.Tests
  Incluye pruebas unitarias usando NUnit. Tenerlo separado fomenta pruebas más organizadas, facilita CI/CD, y mejora el mantenimiento del código.

Decisiones Técnicas Clave

• Se usa AutoMapper para transformar entidades ↔ DTOs: evita lógica de mapeo repetitiva.
• Filtros con Builders<Property>.Filter en MongoDB: permite construir consultas dinámicas de forma segura.
• Inyección de dependencias para servicios: mejora testabilidad y desacopla implementaciones.
• Manejo centralizado de errores: evita duplicación de try/catch y permite mejores logs.

🌐 Frontend (ReactJS o Next.js)

Estructura de Carpetas

/src
  /api
  /components
  /pages
  /services
  /hooks
  /types
  /tests

• /api
  Encapsula las llamadas al backend. Mantenerlas centralizadas permite reusar lógica, manejar errores globales y cambiar de Axios a Fetch sin tocar múltiples archivos.
• /components
  Contiene componentes reutilizables como PropertyCard o FilterForm. Se aplica el principio de reutilización y composición de UI.
• /pages
  Para Next.js, cada archivo representa una ruta. Esto facilita la navegación y división del sistema en vistas lógicas.
• /services
  Contiene lógica como filtros o paginación. Separar lógica de negocio del componente facilita mantenimiento y testing.
• /hooks
  Hooks como useProperties permiten reutilizar lógica de estado o efectos en múltiples componentes.
• /types
  Interfaces TypeScript para definir la forma de los datos. Ayuda al tipado estricto y la documentación del modelo.
• /tests
  Organiza pruebas unitarias y de integración. Permite pruebas automáticas sobre filtros, renderizado y llamadas a API.

Buenas Prácticas Aplicadas

• Se usan componentes controlados para formularios.
• Estado local con useState y global (si es necesario) con Context.
• Diseño responsive con Tailwind o CSS Grid.
• Test de componentes clave con Jest y React Testing Library.

📄 Documentación Incluida (README.md)

• Instalación
  Instrucciones paso a paso para levantar tanto el backend como el frontend. Se indica uso de dotnet run y npm run dev.
• Variables de entorno
  Se incluye un archivo .env.example para configurar el string de conexión a MongoDB y otros parámetros.
• Endpoints documentados
  Se lista cada endpoint de la API, su método HTTP, parámetros y respuesta esperada. Ejemplo: GET /api/properties?name=Casa.
• Backup de base de datos
  Se adjunta un respaldo de MongoDB (.bson o .json) para facilitar la carga inicial de datos.
• Capturas de pantalla
  Se agregan capturas del frontend navegando, filtrando y viendo detalles. Esto facilita la evaluación visual del resultado.