ColGit
📋 Descripción
ColGit es una aplicación web moderna que combina control de versiones, gestión de proyectos y herramientas de colaboración en una única plataforma integrada. Diseñada para desarrolladores y equipos de todos los tamaños, ColGit facilita el seguimiento de cambios en el código, la organización de tareas y la comunicación efectiva entre miembros del equipo.
✨ Características Principales
- Control de Versiones Avanzado: Sistema completo para gestionar cambios en el código con soporte para commits, branches y merges.
- Gestión de Proyectos Integrada: Calendario, tareas y notas para mantener tus proyectos organizados.
- Colaboración en Tiempo Real: Herramientas de chat y colaboración para una comunicación efectiva.
- Asistente de IA: Depurador de código impulsado por IA para ayudarte a resolver problemas rápidamente.
- Interfaz Moderna: Diseño intuitivo con tema oscuro por defecto y completamente responsive.
- Multilenguaje: Soporte para múltiples idiomas, incluyendo Español, Inglés, Chino, Hindi y Árabe.
- Perfiles Personalizables: Perfiles de usuario completos con seguimiento de actividad y personalización.
- Comunidades: Crea y únete a comunidades para colaborar en proyectos específicos.
🛠️ Tecnologías Utilizadas
-
Frontend:
- Next.js 13 (App Router)
- React 18
- TypeScript
- Tailwind CSS
- shadcn/ui components
-
Backend:
- Next.js API Routes
- Arquitectura Hexagonal (Puertos y Adaptadores)
-
Autenticación:
- Sistema de autenticación personalizado
- Soporte para proveedores externos (Google, GitHub)
-
Integración de IA:
- OpenAI API para el asistente de código
- AI SDK para procesamiento de código
🔧 Requisitos del Sistema
- Node.js 18.x o superior
- npm 6.x o superior
- Conexión a Internet para funcionalidades de IA y colaboración
🌐 Arquitectura
ColGit implementa una arquitectura hexagonal (también conocida como arquitectura de puertos y adaptadores) para facilitar la escalabilidad, mantenibilidad y pruebas del código. Esta arquitectura separa claramente las preocupaciones y permite que la lógica de negocio sea independiente de los detalles de implementación.
Estructura
La arquitectura se divide en tres capas principales:
- Dominio: El núcleo de la aplicación que contiene la lógica de negocio.
- Puertos: Interfaces que definen cómo se comunica el dominio con el exterior.
- Adaptadores: Implementaciones concretas de los puertos que conectan el dominio con tecnologías específicas.
👥 Contribuciones
Proceso de Contribución
ColGit es un proyecto propietario con licencia Commons Clause + Apache 2.0. Antes de contribuir, por favor ten en cuenta lo siguiente:
- Acuerdo de Licencia de Contribuyente (CLA): Todos los contribuyentes deben firmar nuestro CLA, que otorga a YouBriefSoft los derechos necesarios sobre las contribuciones.
- Proceso de Pull Request:
- Crea un fork del repositorio.
- Crea una rama para tu característica o corrección.
- Envía un pull request con una descripción clara.
- Asegúrate de que tu código sigue nuestras guías de estilo.
- Guías de Código:
- Usa TypeScript para todo el código.
- Sigue las convenciones de estilo establecidas.
- Incluye pruebas para nuevas características.
- Documenta tu código adecuadamente.
Gobernanza del Proyecto
ColGit es propiedad y está mantenido por YouBriefSoft. Como propietario del proyecto, YouBriefSoft:
- Mantiene el control final sobre la dirección del proyecto.
- Aprueba o rechaza contribuciones.
- Gestiona los lanzamientos y versiones.
- Determina la hoja de ruta del proyecto.
📄 Licencia
Este proyecto está licenciado bajo Apache License 2.0 with Commons Clause.
Esto significa que:
- Puedes usar, modificar y distribuir este software libremente.
- Debes mantener el aviso de derechos de autor y reconocimiento al autor original.
- No puedes vender este software sin autorización explícita del propietario de los derechos.
Para uso comercial o para obtener una licencia que permita la venta de este software, contacta con el autor en contacto@youbriefsoft.com.
Licencias Comerciales
Para empresas que deseen utilizar ColGit en un contexto comercial o integrar ColGit en productos comerciales, ofrecemos varias opciones de licencia:
- Licencia Comercial Estándar: Permite el uso y distribución de ColGit como parte de un producto comercial.
- Licencia Empresarial: Incluye soporte prioritario, actualizaciones garantizadas y personalizaciones.
- Licencia OEM: Para integrar ColGit en tu propio producto de software.
Para más información sobre licencias comerciales, contacta con licencias@youbriefsoft.com.
📦 Instalación
- Clona este repositorio:
git clone https://github.com/tu-usuario/colgit.git
cd colgit