217 lines
4.1 KiB
Markdown
217 lines
4.1 KiB
Markdown
# 🚀 Guía Rápida de Uso
|
|
|
|
## Paso 1: Iniciar Dolibarr (Docker)
|
|
|
|
Si tienes Dolibarr en Docker:
|
|
|
|
```bash
|
|
docker start <nombre-contenedor-dolibarr>
|
|
# o
|
|
docker-compose up -d
|
|
```
|
|
|
|
Verifica que Dolibarr esté accesible en `http://localhost:8200`
|
|
|
|
---
|
|
|
|
## Paso 2: Iniciar la aplicación
|
|
|
|
```bash
|
|
# Asegúrate de estar en el directorio del proyecto
|
|
cd trello_fake
|
|
|
|
# Inicia el servidor de desarrollo
|
|
npm run dev
|
|
```
|
|
|
|
Espera a ver:
|
|
```
|
|
✓ Ready in 2.3s
|
|
○ Local: http://localhost:3000
|
|
```
|
|
|
|
---
|
|
|
|
## Paso 3: Crear proyectos de prueba
|
|
|
|
**Opción A: Usando el script (Recomendado)**
|
|
|
|
En una **nueva terminal** (dejando `npm run dev` corriendo):
|
|
|
|
```bash
|
|
npm run seed
|
|
```
|
|
|
|
Verás algo como:
|
|
```
|
|
🚀 SEED DE PROYECTOS DE PRUEBA PARA DOLIBARR
|
|
|
|
[1/12] Desarrollo de App Móvil
|
|
📈 Progreso: [▓▓▓▓▓▓░░░░] 65%
|
|
💰 Presupuesto: €45,000
|
|
✅ Creado con ID: 1
|
|
✓ Validado (estado: abierto)
|
|
|
|
...
|
|
|
|
✨ PROCESO COMPLETADO
|
|
✅ Proyectos creados exitosamente: 12
|
|
```
|
|
|
|
**Opción B: Crear proyectos manualmente en Dolibarr**
|
|
|
|
1. Accede a Dolibarr: `http://localhost:8200`
|
|
2. Login: admin / p4ssw0rd
|
|
3. Ve a Proyectos > Nuevo Proyecto
|
|
4. Completa el formulario y guarda
|
|
|
|
---
|
|
|
|
## Paso 4: Ver los proyectos
|
|
|
|
Abre tu navegador en: `http://localhost:3000`
|
|
|
|
Deberías ver:
|
|
- 📊 Dashboard con estadísticas
|
|
- 🎴 Proyectos en vista de grid (por defecto)
|
|
- 🔍 Barra de búsqueda funcional
|
|
- 🌓 Toggle de modo oscuro
|
|
|
|
---
|
|
|
|
## Paso 5: Explorar funcionalidades
|
|
|
|
### Vista de Lista
|
|
- Haz clic en el botón **☰** (lista) en el header
|
|
|
|
### Detalle de Proyecto
|
|
- Haz clic en cualquier tarjeta de proyecto
|
|
- Verás información completa: descripción, progreso, presupuesto, fechas
|
|
|
|
### Búsqueda
|
|
- Escribe en la barra de búsqueda
|
|
- Filtra por nombre, cliente o referencia
|
|
|
|
### Modo Oscuro
|
|
- Haz clic en el icono **☀️/🌙** en el header
|
|
- Elige: Claro, Oscuro o Sistema
|
|
|
|
---
|
|
|
|
## 🎯 Casos de Uso
|
|
|
|
### Ver proyectos completados
|
|
1. Busca proyectos con badge verde "Cerrado"
|
|
2. O con progreso del 100%
|
|
3. Ejemplos: "Dashboard Analítico BI", "Portal de Empleados"
|
|
|
|
### Ver proyectos en progreso
|
|
1. Busca proyectos con badge azul "Abierto"
|
|
2. Progreso entre 1% y 99%
|
|
3. Ejemplo: "App de Gestión de Proyectos" (75%)
|
|
|
|
### Ver borradores
|
|
1. Busca proyectos con badge gris "Borrador"
|
|
2. Progreso del 0%
|
|
3. Ejemplo: "Sistema CRM Personalizado"
|
|
|
|
### Comparar presupuestos
|
|
1. Cambia a vista de lista (☰)
|
|
2. Compara la columna "Presupuesto"
|
|
3. Proyecto más caro: "E-commerce con Marketplace" (€120k)
|
|
|
|
---
|
|
|
|
## 🐛 Solución de Problemas
|
|
|
|
### No veo proyectos
|
|
```bash
|
|
# 1. Verifica que Dolibarr esté corriendo
|
|
curl http://localhost:8200
|
|
|
|
# 2. Ejecuta el seed
|
|
npm run seed
|
|
|
|
# 3. Recarga la página (F5)
|
|
```
|
|
|
|
### Error 500 en la consola
|
|
- Revisa `.env.local`
|
|
- Verifica las credenciales de Dolibarr
|
|
- Comprueba que la API esté habilitada en Dolibarr
|
|
|
|
### Página en blanco
|
|
- Abre la consola del navegador (F12)
|
|
- Busca errores en rojo
|
|
- Verifica que `npm run dev` esté corriendo
|
|
|
|
---
|
|
|
|
## 🎨 Personalización
|
|
|
|
### Cambiar el número de proyectos de prueba
|
|
Edita `scripts/seed-projects-via-api.js`:
|
|
```javascript
|
|
// Comenta los proyectos que no quieras
|
|
const projectsData = [
|
|
// ... solo deja los que quieras
|
|
];
|
|
```
|
|
|
|
### Modificar datos de un proyecto
|
|
Edita el objeto correspondiente:
|
|
```javascript
|
|
{
|
|
title: "Tu Proyecto Personalizado",
|
|
ref: "PROJ-2024-XXX",
|
|
description: "Tu descripción...",
|
|
opp_amount: 75000, // Tu presupuesto
|
|
opp_percent: 80, // Tu progreso
|
|
// ...
|
|
}
|
|
```
|
|
|
|
Luego ejecuta:
|
|
```bash
|
|
npm run seed
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Resetear todo
|
|
|
|
### Limpiar proyectos en Dolibarr
|
|
1. Accede a Dolibarr
|
|
2. Ve a cada proyecto
|
|
3. Elimina uno por uno
|
|
|
|
### Limpiar caché de Next.js
|
|
```bash
|
|
rm -rf .next
|
|
npm run dev
|
|
```
|
|
|
|
### Empezar de cero
|
|
```bash
|
|
# Detén el servidor (Ctrl+C)
|
|
rm -rf .next
|
|
npm run dev
|
|
npm run seed
|
|
```
|
|
|
|
---
|
|
|
|
## 📚 Referencias Rápidas
|
|
|
|
| Acción | Comando |
|
|
|--------|---------|
|
|
| Iniciar desarrollo | `npm run dev` |
|
|
| Crear proyectos | `npm run seed` |
|
|
| Build producción | `npm run build` |
|
|
| Ver logs | Ver terminal donde corre `npm run dev` |
|
|
| Ver API calls | F12 > Network > Fetch/XHR |
|
|
|
|
---
|
|
|
|
¡Listo! Ya puedes explorar tu dashboard de proyectos Dolibarr 🎉
|