Guía de Contribución para ACAG-P

🎯 Cómo Contribuir

1. Reportar Problemas

• Usar la plantilla de reporte de issues
• Incluir logs, steps para reproducir y screenshots si aplica
• Especificar versión y entorno

2. Sugerir Mejoras

• Describir el caso de uso claro y el valor agregado
• Proponer diseño técnico inicial
• Evaluar impacto y esfuerzo estimado

3. Contribuir Código

• Seguir las convenciones de código establecidas
• Incluir tests unitarios y de integración
• Documentar los cambios adecuadamente

🛠️ Proceso de Desarrollo

Flujo de Trabajo

1. Fork del repositorio principal
2. Crear branch descriptivo (feature/nueva-caracteristica)
3. Desarrollar en entorno local
4. Ejecutar tests y verificaciones de calidad
5. Enviar Pull Request con descripción detallada

Convenciones de Código

• Seguir PEP 8 para Python
• Usar type hints en todas las funciones
• Documentar con docstrings completos
• Mantener cobertura de tests >80%

🧪 Testing y Calidad

Tests Requeridos

• Tests unitarios para todas las nuevas funcionalidades
• Tests de integración para componentes clave
• Tests de rendimiento para cambios significativos
• Tests de seguridad para funcionalidades sensibles

Control de Calidad

• Revisión de código por al menos 2 maintainers
• Verificación de cumplimiento de estándares
• Pruebas en entorno de staging
• Approbación final antes de merge

📊 Métricas de Contribución

Indicadores de Calidad

• Cobertura de tests
• Complejidad ciclomática
• Deuda técnica
• Velocidad de desarrollo

Reconocimiento

• Sistema de créditos por contribuciones
• Mención en release notes
• Posibilidad de convertirse en maintainer