Análisis Técnico del Repositorio: Carpeta Ciudadana Backend
Información General
Nombre del Proyecto: Carpeta Ciudadana Backend
Repositorio: github.com/ogticrd/carpeta-ciudadana-backend
| Elemento | Descripción |
|---|---|
| Arquitectura | Microservicios |
| Framework principal | NestJS |
| Lenguaje | TypeScript |
| Comunicación entre servicios | gRPC |
| Contenedores | Docker, docker-compose, múltiples Dockerfiles |
| Gestión de paquetes | npm/yarn |
| Infraestructura como código | docker-compose.yml, múltiples archivos de entorno (.env.example) |
Análisis de Microservicios
| Microservicio | Funcionalidad |
|---|---|
| gateway | Punto de entrada, autenticación, health check, orquestación general |
| metadata | Gestión de usuarios, sesiones, OTPs, suscripciones de notificación |
| notification | Envío y manejo de notificaciones, workflows |
| wrapper-institutions | Integración con instituciones (ej. JCE, Edesur, pasaportes) |
DevOps e Integración Continua
| Elemento | Descripción |
|---|---|
| CI/CD | Workflows por microservicio (gateway-deployment.yml, etc.) |
| Limpieza de caché | cleanup-cache-branch.yml para mantener el entorno limpio |
| Dependabot | Actualización automática de dependencias (dependabot.yml) |
| Entornos definidos | .env.example, development.Dockerfile, múltiples Dockerfile |
| Linting y Formateo | .eslintrc.js, .prettierrc, uso de Biome |
| Debugging | Archivos .vscode/launch.json en cada microservicio |
Testing
| Elemento | Detalles |
|---|---|
| Framework de testing | jest |
| Tipo de pruebas | e2e (end-to-end), ejemplos: app.e2e-spec.ts |
| Cobertura | Se encuentran *.spec.ts para pruebas unitarias (ej: *.service.spec.ts) |
Seguridad
| Elemento | Descripción |
|---|---|
| API Key Middleware | auth/api-key.middleware.ts (wrapper-institutions) |
| Manejo de tokens OTP | Varios microservicios trabajan con OTPs y suscripciones seguras |
| Entornos seguros | .env.example usado en todos los servicios |
| Dependabot | Protege contra vulnerabilidades de paquetes |
| Sin SonarQube | No se encontró integración con SonarQube |
Herramientas y Librerías Detectadas
| Tipo | Herramientas / Librerías |
|---|---|
| Backend Framework | NestJS |
| Contenedores | Docker, Docker Compose |
| Proto/gRPC | Archivos .proto para cada servicio |
| Lint/Formato | ESLint, Prettier, Biome |
| Tests | Jest |
| Gestión de paquetes | Yarn o npm |
| VSCode Dev Env | .vscode en todos los servicios |