Sistema de gestión de archivos con control de cuotas de almacenamiento, validación de contenido ZIP y gestión de usuarios basado en Symfony y EasyAdmin.

Aplicación web que permite a los usuarios subir y gestionar sus archivos con las siguientes características:

• ✅ Sistema de autenticación con roles (ROLE_USER, ROLE_SUPER_ADMIN)
• 📊 Control de cuotas de almacenamiento por usuario y grupo
• 📁 Gestión de archivos: subida, visualización y eliminación
• 🔒 Validación de seguridad: Rechaza extensiones prohibidas (.exe, .bat, .js, .php, .sh)
• 🗜️ Validación de ZIP: Escanea contenido de archivos ZIP antes de subir
• 👥 Gestión de usuarios y grupos (solo administradores)
• 🔐 Seguridad: Cada usuario solo ve sus propios archivos
• 📈 Dashboard con estadísticas de uso de almacenamiento en tiempo real
• ⚡ Validación AJAX: Validación de archivos antes de enviar el formulario con SweetAlert2

• Backend: Symfony 7.x + PHP 8.2
• ORM: Doctrine
• Admin Panel: EasyAdmin Bundle 4
• Frontend: Stimulus + Turbo + Tailwind CSS
• JavaScript: Axios + SweetAlert2
• Base de datos: PostgreSQL 16
• Containerización: Docker + Docker Compose + FrankenPHP

• Docker >= 20.10
• Docker Compose >= 2.0
• Node.js >= 18.x (para compilar assets)
• npm >= 9.x
• Git

git clone https://github.com/saulmoralespa/files-dashboard
cd files-dashboard

⚠️ IMPORTANTE: Instala las dependencias de PHP antes de levantar Docker:

composer install

Nota: Necesitas tener Composer instalado localmente. Si no lo tienes, puedes instalarlo desde getcomposer.org o usar Docker en el Paso 5.

# Copiar archivo de configuración
cp .env.setup .env

Editar el archivo .env con tus configuraciones:

# Entorno de aplicación
APP_ENV=dev
APP_SECRET=your-secret-key-here-change-this (opcional en desarrollo)

# Configuración de base de datos
DATABASE_URL="postgresql://app:!ChangeMe!@database:5432/app?serverVersion=16&charset=utf8"

Parámetros importantes a revisar:

• APP_SECRET: Genera una clave única con openssl rand -hex 32 (opcional en desarrollo)
• DATABASE_URL: Ajusta usuario, contraseña y nombre de BD si es necesario
• Para producción, cambia APP_ENV=prod

⚠️ IMPORTANTE: Antes de levantar Docker, instala las dependencias JavaScript:

# Instalar dependencias
npm install

# Compilar assets para desarrollo
npm run dev

Para desarrollo con watch mode:

npm run watch

# Construir imágenes y levantar servicios
docker compose up -d --build

# Verificar que los contenedores estén corriendo
docker compose ps

Deberías ver:

NAME                    STATUS
files-dashboard-php     Up
files-dashboard-db      Up

💡 Alternativa: Si no instalaste Composer en el Paso 2, puedes hacerlo ahora dentro del contenedor:

docker compose exec php composer install

# Crear base de datos
docker compose exec php bin/console doctrine:database:create --if-not-exists

# Ejecutar migraciones
docker compose exec php bin/console doctrine:migrations:migrate --no-interaction

# Cargar datos de prueba (fixtures)
docker compose exec php bin/console doctrine:fixtures:load --no-interaction

Accede a: https://localhost

Si todo está correcto, deberías ver la página de login.

┌─────────────────────────────────────────────────────────────────┐
│                            USERS                                 │
├─────────────────────────────────────────────────────────────────┤
│ id              INT PRIMARY KEY AUTO_INCREMENT                   │
│ email           VARCHAR(180) UNIQUE NOT NULL                     │
│ roles           JSON NOT NULL                                    │
│ password        VARCHAR(255) NOT NULL                            │
│ quota           BIGINT DEFAULT 10 NOT NULL    (Cuota en MB)     │
└─────────────────────────────────────────────────────────────────┘
         │
         │ 1:N
         │
         ▼
┌─────────────────────────────────────────────────────────────────┐
│                        FILE_UPLOAD                               │
├─────────────────────────────────────────────────────────────────┤
│ id              INT PRIMARY KEY AUTO_INCREMENT                   │
│ user_id         INT NOT NULL FOREIGN KEY → users(id)            │
│ filename        VARCHAR(255) NOT NULL      (Nombre generado)    │
│ original_name   VARCHAR(255) NOT NULL      (Nombre original)    │
│ size            BIGINT NOT NULL             (Tamaño en bytes)   │
│ mime            VARCHAR(255) NOT NULL       (Tipo MIME)         │
│ created_at      TIMESTAMP NOT NULL                              │
│ updated_at      TIMESTAMP NOT NULL                              │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                           GROUP                                  │
├─────────────────────────────────────────────────────────────────┤
│ id              INT PRIMARY KEY AUTO_INCREMENT                   │
│ name            VARCHAR(255) NOT NULL                            │
│ quota           BIGINT NOT NULL             (Cuota en MB)       │
└─────────────────────────────────────────────────────────────────┘
         │
         │ N:M (group_user)
         │
         ▼
┌─────────────────────────────────────────────────────────────────┐
│                        GROUP_USER                                │
├─────────────────────────────────────────────────────────────────┤
│ group_id        INT FOREIGN KEY → group(id)                     │
│ user_id         INT FOREIGN KEY → users(id)                     │
│ PRIMARY KEY (group_id, user_id)                                 │
└─────────────────────────────────────────────────────────────────┘

• User → FileUpload: Un usuario tiene muchos archivos (1:N)
• User ↔ Group: Relación muchos a muchos (N:M)
• Sistema de Cuotas:
  • Si usuario pertenece a grupo → usa group.quota
  • Si no pertenece a grupo → usa user.quota (default: 10 MB)

• Panel de administración: http://localhost/admin
• Login: http://localhost/login

Después de cargar los fixtures (doctrine:fixtures:load):

• Email: [email protected]
• Contraseña: pass#123
• Permisos: Acceso total (usuarios, grupos, archivos de todos)

• Email: [email protected]
• Contraseña: pass#123
• Permisos: Solo gestión de sus propios archivos

1. Cuota individual: Cada usuario tiene una cuota (default: 10 MB)
2. Cuota por grupo: Si un usuario pertenece a un grupo, hereda la cuota del grupo (tiene prioridad)
3. Validación: Antes de subir: (uso_actual + archivo_nuevo) <= cuota
4. Feedback visual:
   • Barra de progreso con colores
   • 🟢 Verde (<70%), 🟠 Naranja (70-90%), 🔴 Rojo (>90%)

Por seguridad, NO se permiten las siguientes extensiones:

.exe  .bat  .js   .php  .sh

El sistema escanea el contenido de archivos ZIP antes de subirlos:

• ✅ Si el ZIP solo contiene documentos → Subida permitida
• ❌ Si el ZIP contiene .exe, .bat, etc. → Subida bloqueada

Ejemplo de validación:

usuario selecciona archivo.zip
    ↓
Sistema valida:
  1. Extensión del ZIP ✅
  2. Tamaño vs cuota ✅
  3. Abre el ZIP
  4. Escanea archivos internos
  5. Detecta: virus.exe ❌
    ↓
Alerta: "ZIP contiene archivos prohibidos: virus.exe"
Campo se limpia automáticamente

1. Login como admin
2. Ir a /admin → "Grupos" → "Crear Grupo"
3. Ingresar:
   • Nombre: Ej. "Equipo Marketing"
   • Cuota (MB): Ej. 100
4. Guardar

1. Login como admin
2. Ir a /admin → "Usuarios" → "Crear Usuario"
3. Completar formulario:
   • Email: [email protected]
   • Cuota Individual (MB): 10 (o personalizar)
   • Grupos: Seleccionar grupo (opcional)
   • Password: contraseña segura
   • Roles: Seleccionar ROLE_USER
4. Guardar

1. Editar usuario existente
2. Campo "Grupos" → Seleccionar grupo
3. Guardar

Resultado: El usuario hereda la cuota del grupo automáticamente.

1. Ver archivos:

   • /admin → "Mis Archivos"
   • Dashboard muestra estadísticas de uso

2. Subir archivo:

   • Click "Subir Nuevo Archivo"
   • Seleccionar archivo
   • Sistema valida:
     • ✅ Extensión permitida
     • ✅ Cuota disponible
     • ✅ Contenido de ZIP (si aplica)
   • Alerta de éxito o error

3. Eliminar archivo:

   • Click en 🗑️
   • Espacio se libera automáticamente

• Ven todos los archivos de todos los usuarios
• Pueden eliminar cualquier archivo
• Ven el propietario de cada archivo

# Ver logs en tiempo real
docker compose logs -f

# Logs del contenedor PHP
docker compose logs -f php

# Detener contenedores
docker compose down

# Detener y eliminar volúmenes (⚠️ borra la BD)
docker compose down -v

# Reiniciar servicio
docker compose restart php

# Acceder al contenedor PHP
docker compose exec php bash

# Acceder a PostgreSQL
docker compose exec database psql -U app -d app

# Limpiar caché
docker compose exec php bin/console cache:clear

# Ver rutas disponibles
docker compose exec php bin/console debug:router

# Crear nueva migración
docker compose exec php bin/console make:migration

# Ejecutar migraciones
docker compose exec php bin/console doctrine:migrations:migrate

# Recargar fixtures (⚠️ borra datos)
docker compose exec php bin/console doctrine:fixtures:load

# Compilar assets en desarrollo
npm run dev

# Watch mode (recompila automáticamente)
npm run watch

# Build para producción
npm run build

# Limpiar caché
make cache-clear

# Ver logs
make logs-php

# Ejecutar migraciones
make db-migrate

# Acceder al shell
make shell