|
| 1 | +# CollabData - Plataforma Colaborativa de Ingeniería de Datos |
| 2 | + |
| 3 | +Esta es una aplicación Next.js construida con Firebase Studio. Es una plataforma diseñada para que equipos de datos colaboren en ingeniería y análisis de datos. |
| 4 | + |
| 5 | +## 📝 Descripción del Proyecto |
| 6 | + |
| 7 | +CollabData es una plataforma web que permite a los usuarios gestionar proyectos de análisis de datos, cargar conjuntos de datos (datasets), ejecutar análisis automatizados y visualizar los resultados. La aplicación está diseñada con un enfoque en la colaboración en tiempo real y la eficiencia del flujo de trabajo. |
| 8 | + |
| 9 | +## 🔑 Características Principales |
| 10 | + |
| 11 | +- **🔐 Autenticación de Usuarios:** Sistema completo de inicio de sesión, registro y autenticación social usando Google y GitHub. |
| 12 | +- **📊 Panel de Control (Dashboard):** Un panel central para ver, buscar, filtrar y gestionar todos los proyectos de análisis. |
| 13 | +- **✨ Creación de Nuevos Análisis:** Un flujo guiado para crear nuevos proyectos de análisis, configurar herramientas y cargar conjuntos de datos. |
| 14 | +- **📈 Visualización de Resultados:** Paneles de resultados dinámicos con KPIs, gráficos, tablas de estadísticas descriptivas e insights generados por IA. |
| 15 | +- **💻 Espacio de Trabajo Interactivo:** Un entorno similar a un IDE para explorar archivos de datos. |
| 16 | +- **👤 Gestión de Perfil:** Página de ajustes para que los usuarios actualicen su información personal y gestionen su cuenta. |
| 17 | +- **🤖 Integración de IA:** Utiliza Genkit para proporcionar sugerencias de análisis inteligentes basadas en las descripciones de los datasets. |
| 18 | + |
| 19 | +## 🛠️ Stack Tecnológico |
| 20 | + |
| 21 | +- **Framework:** [Next.js](https://nextjs.org/) |
| 22 | +- **Biblioteca UI:** [React](https://react.dev/) |
| 23 | +- **Lenguaje:** [TypeScript](https://www.typescriptlang.org/) |
| 24 | +- **Estilos:** [Tailwind CSS](https://tailwindcss.com/) |
| 25 | +- **Componentes UI:** [ShadCN UI](https://ui.shadcn.com/) |
| 26 | +- **Backend y Autenticación:** [Firebase](https://firebase.google.com/) (Authentication, Firestore) |
| 27 | +- **IA Generativa:** [Genkit](https://firebase.google.com/docs/genkit) (Google AI) |
| 28 | + |
| 29 | +## 🚀 Cómo Empezar |
| 30 | + |
| 31 | +Sigue estos pasos para poner en marcha el entorno de desarrollo. |
| 32 | + |
| 33 | +### Prerrequisitos |
| 34 | + |
| 35 | +- Node.js (v18 o superior) |
| 36 | +- npm |
| 37 | + |
| 38 | +### Instalación y Ejecución |
| 39 | + |
| 40 | +1. Instala las dependencias del proyecto: |
| 41 | + ```sh |
| 42 | + npm install |
| 43 | + ``` |
| 44 | +2. Inicia el servidor de desarrollo: |
| 45 | + ```sh |
| 46 | + npm run dev |
| 47 | + ``` |
| 48 | +3. Abre [http://localhost:9002](http://localhost:9002) en tu navegador para ver la aplicación. |
| 49 | + |
| 50 | +## 📁 Estructura del Proyecto |
| 51 | + |
| 52 | +Aquí tienes una descripción general de los archivos y directorios más importantes del proyecto: |
| 53 | + |
| 54 | +``` |
| 55 | +/ |
| 56 | +├── src/ |
| 57 | +│ ├── app/ |
| 58 | +│ │ ├── layout.tsx # Layout raíz de la aplicación |
| 59 | +│ │ ├── page.tsx # Landing Page |
| 60 | +│ │ ├── login/page.tsx # Página de autenticación |
| 61 | +│ │ ├── dashboard/ # Rutas del panel de control |
| 62 | +│ │ │ ├── page.tsx # Vista principal del dashboard |
| 63 | +│ │ │ ├── layout.tsx # Layout para las páginas del dashboard |
| 64 | +│ │ │ ├── new-analysis/page.tsx # Página para crear un nuevo análisis |
| 65 | +│ │ │ └── ... |
| 66 | +│ │ └── projects/[id]/ # Rutas para proyectos individuales |
| 67 | +│ │ ├── page.tsx # Espacio de trabajo del proyecto |
| 68 | +│ │ └── results/page.tsx # Página de resultados del análisis |
| 69 | +│ │ |
| 70 | +│ ├── components/ |
| 71 | +│ │ ├── layout/ # Componentes de layout (header, footer) |
| 72 | +│ │ ├── pages/ # Componentes específicos de cada página |
| 73 | +│ │ └── ui/ # Componentes UI reutilizables (ShadCN) |
| 74 | +│ │ |
| 75 | +│ ├── firebase/ |
| 76 | +│ │ ├── config.ts # Configuración de Firebase |
| 77 | +│ │ ├── index.ts # Inicialización y exportación de servicios Firebase |
| 78 | +│ │ ├── provider.tsx # Proveedor de contexto Firebase |
| 79 | +│ │ └── auth/use-user.tsx # Hook para obtener el usuario autenticado |
| 80 | +│ │ |
| 81 | +│ ├── ai/ |
| 82 | +│ │ ├── genkit.ts # Inicialización de Genkit |
| 83 | +│ │ └── flows/ # Flujos de IA con Genkit |
| 84 | +│ │ |
| 85 | +│ ├── hooks/ |
| 86 | +│ │ └── use-project-store.ts # Hook para la gestión del estado del proyecto |
| 87 | +│ │ |
| 88 | +│ └── lib/ |
| 89 | +│ ├── utils.ts # Funciones de utilidad |
| 90 | +│ ├── mock-data.ts # Datos de ejemplo para la aplicación |
| 91 | +│ └── types.ts # Definiciones de tipos TypeScript |
| 92 | +│ |
| 93 | +├── public/ # Archivos estáticos |
| 94 | +├── package.json # Dependencias y scripts del proyecto |
| 95 | +└── tailwind.config.ts # Configuración de Tailwind CSS |
| 96 | +``` |
0 commit comments