inmobiliaria-analytics/docs/00-vision-general/STACK-TECNOLOGICO.md
rckrdmrd f570727617 feat: Documentation and orchestration updates
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 05:35:40 -06:00

5.3 KiB

id title type version status created_date updated_date
STACK-IA Stack Tecnologico - Inmobiliaria Analytics Technical Document 1.0.0 Active 2026-01-04 2026-01-04

Stack Tecnologico - Inmobiliaria Analytics


Resumen

Documentacion detallada del stack tecnologico seleccionado para el proyecto Inmobiliaria Analytics.


Stack Principal

Backend

Componente Tecnologia Version Justificacion
Runtime Node.js 20.x LTS Estabilidad y soporte largo plazo
Framework NestJS 10.3.x Arquitectura modular, TypeScript nativo
ORM TypeORM 0.3.x Integracion con NestJS, migraciones
Validacion class-validator 0.14.x Decoradores para DTOs
Transformacion class-transformer 0.5.x Serializacion de objetos

Autenticacion

Componente Tecnologia Version Justificacion
Framework Passport 0.7.x Estrategias flexibles
Token JWT 10.x Stateless, escalable
Local passport-local 1.0.x Login con usuario/password
Hashing bcrypt 5.1.x Seguridad para passwords

Frontend

Componente Tecnologia Version Justificacion
Framework React 18.x Ecosistema maduro
Lenguaje TypeScript 5.3.x Type safety
Build Vite 5.x Desarrollo rapido
Estado Zustand 4.x Simple y performante
Estilos Tailwind CSS 3.x Utility-first
Charts Recharts 2.x React-native charts

Base de Datos

Componente Tecnologia Version Justificacion
RDBMS PostgreSQL 16.x ACID, extensiones geograficas
Cache Redis 7.x Alto rendimiento
Driver pg 8.11.x Driver PostgreSQL para Node

Infraestructura

Componente Tecnologia Version Justificacion
Contenedores Docker 24.x Portabilidad
Orquestacion Docker Compose 2.x Desarrollo local
Proxy/LB Traefik 3.x Routing dinamico

Dependencias del Backend

Produccion

{
  "@nestjs/common": "^10.3.0",
  "@nestjs/config": "^3.1.1",
  "@nestjs/core": "^10.3.0",
  "@nestjs/jwt": "^10.2.0",
  "@nestjs/passport": "^10.0.3",
  "@nestjs/platform-express": "^10.3.0",
  "@nestjs/typeorm": "^10.0.1",
  "bcrypt": "^5.1.1",
  "class-transformer": "^0.5.1",
  "class-validator": "^0.14.1",
  "passport": "^0.7.0",
  "passport-jwt": "^4.0.1",
  "passport-local": "^1.0.0",
  "pg": "^8.11.3",
  "reflect-metadata": "^0.2.1",
  "rxjs": "^7.8.1",
  "typeorm": "^0.3.19",
  "stripe": "^14.0.0"
}

Desarrollo

{
  "@nestjs/cli": "^10.3.0",
  "@nestjs/schematics": "^10.1.0",
  "@nestjs/testing": "^10.3.0",
  "@types/bcrypt": "^5.0.2",
  "@types/express": "^4.17.21",
  "@types/jest": "^29.5.11",
  "@types/node": "^20.10.6",
  "@types/passport-jwt": "^4.0.0",
  "@types/passport-local": "^1.0.38",
  "@typescript-eslint/eslint-plugin": "^6.18.0",
  "@typescript-eslint/parser": "^6.18.0",
  "eslint": "^8.56.0",
  "eslint-config-prettier": "^9.1.0",
  "eslint-plugin-prettier": "^5.1.2",
  "jest": "^29.7.0",
  "prettier": "^3.1.1",
  "supertest": "^6.3.4",
  "ts-jest": "^29.1.1",
  "ts-node": "^10.9.2",
  "typescript": "^5.3.3"
}

Configuracion de Puertos

Servicio Puerto Ambiente
Frontend 3100 Todos
Backend API 3101 Todos
WebSocket 3102 Todos
PostgreSQL 5439 Local
Redis 6386 Local

Variables de Entorno

Aplicacion

# App
APP_NAME=inmobiliaria-analytics
APP_PORT=3101
APP_ENV=development
API_PREFIX=api

# CORS
CORS_ORIGIN=http://localhost:3100

Base de Datos

# PostgreSQL
DB_HOST=localhost
DB_PORT=5439
DB_USERNAME=postgres
DB_PASSWORD=postgres
DB_DATABASE=inmobiliaria_analytics
DB_SYNCHRONIZE=true
DB_LOGGING=true

# Redis
REDIS_HOST=localhost
REDIS_PORT=6386

Seguridad

# JWT
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=1d
JWT_REFRESH_EXPIRES_IN=7d

Scripts de Desarrollo

Backend

# Desarrollo
npm run start:dev

# Build
npm run build

# Tests
npm run test
npm run test:cov
npm run test:e2e

# Linting
npm run lint
npm run format

Base de Datos

# Migraciones (futuro)
npm run migration:generate -- -n MigrationName
npm run migration:run
npm run migration:revert

Herramientas de Desarrollo

Herramienta Proposito
ESLint Linting de codigo
Prettier Formateo de codigo
Jest Testing unitario y e2e
Swagger Documentacion API
Docker Compose Ambiente local

Extensiones Futuras

Componente Tecnologia Proposito
Search Elasticsearch Busqueda avanzada
ML Python/FastAPI Predicciones
Queue BullMQ Jobs asinconos
Metrics Prometheus Monitoreo
Logs ELK Stack Centralizacion

Referencias


Documento: Stack Tecnologico Version: 1.0.0 Estado: Active Ultima actualizacion: 2026-01-04