Saltar a contenido

Dependencias reales entre capas — Backend GekkoCheckin

Contexto: Ver @CURSOR_AUDIT_PROMPT.md (líneas 3-4): Staff Engineer / Arquitecto senior, experto en arquitectura hexagonal. (Si abres desde el repo: el archivo está en la raíz del workspace de proyectos.)

Este documento describe las dependencias reales del código (no el ideal). Sirve como base para refactor hacia una hexagonal más estricta.


Diagrama de dependencias

Backend hexagonal


Resumen de capas

Capa Qué hace Depende de
adapters/ Handlers HTTP y WebSocket repository (→ infrastructure), db, error, domain/entities
domain/ Entidades y errores de dominio Solo módulos bajo domain/
infrastructure/ Persistencia, config, email, activity_log config, domain/entities (repos)
main Re-exporta repository desde infrastructure; no existe capa application/ -

Objetivo a medio plazo: que los handlers no llamen directamente a repository, sino a una capa de aplicación (use cases) que use puertos definidos en domain.