Análisis Técnico del Repositorio: Carpeta Ciudadana Backend
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 |
Control de Calidad
| 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 |
