Skip to content

Refactorización integral y reestructuración idiomática del proyecto#58

Merged
thomas-vilte merged 2 commits into
masterfrom
dev
Dec 21, 2025
Merged

Refactorización integral y reestructuración idiomática del proyecto#58
thomas-vilte merged 2 commits into
masterfrom
dev

Conversation

@thomas-vilte

@thomas-vilte thomas-vilte commented Dec 21, 2025

Copy link
Copy Markdown
Owner

Resumen

Realicé una reestructuración masiva del repositorio para adoptar un estilo más idiomático en Go y simplificar la arquitectura general. El objetivo principal fue reducir la complejidad innecesaria en la jerarquía de directorios, desacoplar los servicios de la lógica de internacionalización y estandarizar el manejo de errores en toda la aplicación.

Cambios clave

  • Estructura de directorios: Eliminé niveles de anidamiento profundos (como internal/infrastructure) moviendo los paquetes a rutas más directas como internal/ai, internal/git, internal/github e internal/commands.
  • Módulo Go: Renombré el módulo a github.com/thomas-vilte/matecommit (en minúsculas) para cumplir con las convenciones de nombres de la comunidad Go.
  • Gestión de dependencias: Reemplacé el contenedor de inyección de dependencias y los registros complejos por un patrón de proveedores más liviano y explícito en internal/providers.
  • Sistema de errores: Implementé un nuevo paquete internal/errors con tipos de error categorizados (GIT, AI, VCS, etc.), permitiendo que los servicios reporten fallos de forma semántica.
  • Documentación: Establecí el inglés como idioma principal para la documentación raíz y moví las versiones en español a la carpeta docs/es/.
  • Calidad de código: Agregué un workflow para golangci-lint y plantillas estandarizadas para Issues y Pull Requests para mejorar la colaboración.

Impacto técnico

  • Cambio disruptivo (Breaking Change): El cambio en el nombre del módulo es una modificación mayor que requiere actualizar todas las referencias de importación.
  • Desacoplamiento: Los servicios ahora son agnósticos a la interfaz de usuario y a las traducciones, delegando la responsabilidad del feedback visual a la capa de comandos a través de eventos de progreso.
  • Mantenibilidad: La reducción del anidamiento y la eliminación de abstracciones excesivas en la DI facilitan la navegación del código y reducen la curva de aprendizaje para nuevos contribuidores.

@thomas-vilte thomas-vilte changed the title Dev Refactorización integral y reestructuración idiomática del proyecto Dec 21, 2025
@thomas-vilte thomas-vilte added docs Changes in documentation infra Infrastructure and DevOps refactor Code restructuring or cleaning without functional changes labels Dec 21, 2025
@thomas-vilte
thomas-vilte merged commit b8e9aac into master Dec 21, 2025
1 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Changes in documentation infra Infrastructure and DevOps refactor Code restructuring or cleaning without functional changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant