Plataforma inteligente de búsqueda y gestión documental con IA

DocMind centraliza, clasifica y comparte documentación corporativa de forma ágil. Combina extracción de texto (Apache Tika), análisis con LLM (Ollama / OpenAI), búsqueda híbrida (léxica + semántica + fuzzy) y un sistema granular de roles y permisos, todo envuelto en una interfaz moderna con animaciones fluidas.

• Requisitos previos
• Ejecución rápida (desarrollo local)
• Ejecución con Docker Compose
• Variables de entorno
• Arquitectura del proyecto
• Backend — API REST
• Modelo de datos
• Roles y permisos
• Control de acceso a documentos
• IA y búsqueda
• Frontend — Funcionalidades
• Stack tecnológico
• Convenciones del proyecto
• Licencia

cd docMind/backend
./mvnw spring-boot:run

Por defecto arranca con H2 embebido (sin dependencias externas). La base de datos se crea en backend/data/docmind.mv.db.

Al primer inicio se genera un usuario administrador global:

• Email: admin@docmind.local
• Contraseña: admin123

También se insertan 15 documentos de ejemplo con texto, categorías y metadatos.

cd docMind/frontend
npm install
npm run dev

Abre http://localhost:5173 en el navegador.

# Instalar Ollama: https://ollama.com
ollama pull qwen2.5:3b          # Modelo de chat
ollama pull nomic-embed-text    # Modelo de embeddings
ollama serve                    # Puerto 11434

Sin Ollama, la subida de documentos funciona pero sin resumen/tags IA ni búsqueda semántica.

cd docMind
docker compose up -d

pgAdmin: http://localhost:5055 — admin@admin.com / admin

Configuración IA:

Admin global:

docMind/
├── compose.yaml                           # Docker Compose
├── backend/                               # Spring Boot (Java 21)
│   ├── pom.xml
│   ├── mvnw / mvnw.cmd
│   ├── uploads/                           # Archivos subidos (disco)
│   ├── data/                              # Base H2 embebida
│   └── src/main/java/com/hackUdc2026/docMind/
│       ├── config/
│       │   ├── SecurityConfig.java            # Spring Security, CORS, filtro JWT
│       │   ├── GlobalAdminConfig.java         # Seed del admin global al arrancar
│       │   ├── DocumentSeedConfig.java        # Seed de 15 documentos de ejemplo
│       │   ├── UserRoleConstraintConfig.java  # Sincroniza CHECK constraints de roles
│       │   ├── ManagedTagConstraintConfig.java
│       │   └── security/
│       │       ├── JwtAuthenticationFilter.java   # Extrae JWT → SecurityContext
│       │       └── AuthenticatedUser.java         # Principal: (id, username, role)
│       ├── controller/
│       │   ├── UserController.java            # Auth + gestión de usuarios
│       │   ├── DocumentController.java        # CRUD docs, upload, share, IA, download
│       │   ├── FolderController.java          # CRUD carpetas, mover documentos
│       │   └── ManagedTagController.java      # CRUD etiquetas gestionadas
│       ├── service/
│       │   ├── UserService.java               # Auth, roles, perfil, operaciones admin
│       │   ├── DocumentService.java           # Upload, búsqueda híbrida, acceso, sharing
│       │   ├── FolderService.java             # Operaciones de carpetas
│       │   ├── ManagedTagService.java         # Etiquetas con scope global/departamento
│       │   ├── JwtService.java                # Generación y validación JWT (JJWT)
│       │   ├── LLMService.java                # Integración Ollama y OpenAI
│       │   ├── DocumentAnalysisService.java   # Análisis IA, consultas, categorías
│       │   ├── DocumentPostProcessingService.java  # Enriquecimiento asíncrono tras upload
│       │   ├── DocumentFileProcessor.java     # Extracción de texto (TXT, PDF)
│       │   ├── SemanticSearchService.java     # Búsqueda por embeddings
│       │   └── SupabaseAuthService.java       # Integración Supabase Auth
│       ├── repository/                        # Spring Data JPA Repositories
│       └── model/
│           ├── entities/                      # Entidades JPA + enums
│           ├── dto/                           # Objetos de transferencia
│           └── exceptions/                    # Excepciones de dominio
└── frontend/                              # React + TypeScript + Vite
    ├── package.json
    ├── vite.config.ts
    ├── tailwind.config.js
    ├── index.html
    └── src/
        ├── App.tsx                        # Componente raíz (flujo auth, vistas)
        ├── main.tsx                       # Punto de entrada
        ├── index.css                      # Estilos globales, liquid-glass tokens
        ├── components/
        │   ├── SplashScreen.tsx           # Pantalla de carga animada
        │   ├── AuthPage.tsx               # Login/Register a pantalla completa
        │   ├── Header.tsx                 # Barra superior con menú de usuario
        │   ├── Sidebar.tsx                # Navegación lateral con categorías
        │   ├── SearchBar.tsx              # Barra de búsqueda
        │   ├── DocumentList.tsx           # Lista paginada de documentos
        │   ├── DocumentCard.tsx           # Tarjeta individual de documento
        │   ├── DocumentDetail.tsx         # Vista detallada con preview
        │   ├── UploadModal.tsx            # Modal de subida de archivos
        │   ├── SettingsModal.tsx          # Configuración de la app
        │   ├── AccountModal.tsx           # Edición de perfil de usuario
        │   ├── PdfIframeViewer.tsx        # Visor de PDF en iframe
        │   ├── UiErrorBoundary.tsx        # Error boundary de UI
        │   └── ui/                        # Componentes shadcn/ui (Radix)
        ├── lib/
        │   ├── utils.ts                   # Utilidades (cn, etc.)
        │   ├── animations.ts              # Tokens de animación GSAP
        │   └── api/
        │       ├── http.ts                # Cliente HTTP base + gestión JWT
        │       ├── auth.ts                # Login, register, perfil, tipos
        │       ├── documents.ts           # CRUD docs, shares, tags, búsqueda
        │       ├── folders.ts             # CRUD carpetas
        │       ├── users.ts               # Gestión admin de usuarios
        │       └── rolePermissions.ts     # Gestión admin de permisos
        ├── types/
        │   └── document.ts                # Tipos de documento, categorías
        ├── data/
        │   ├── localSeed.ts               # Datos locales (localStorage)
        │   └── mockDocuments.ts           # Documentos mock
        └── hooks/
            └── use-mobile.ts              # Detección de pantalla móvil

Todos los endpoints (salvo login y register) requieren cabecera Authorization: Bearer <JWT>.

READ · WRITE · EXECUTE · DELETE · SHARE · MANAGE_USERS · MANAGE_ROLES · AUDIT

Los permisos son editables en tiempo real por el administrador global desde el panel de admin. Los cambios se persisten en la tabla role_permission_configs.

El rol se infiere a partir del departamento y tipo de persona seleccionados:

Se genera automáticamente al arrancar. Es el único usuario con rol ADMIN — este rol no puede asignarse a otros usuarios desde la API.

Un usuario puede acceder a un documento si cumple al menos una de estas condiciones:

1. Es el administrador global (rol ADMIN)
2. Es el propietario del documento (uploadedByUserId)
3. Tiene un DocumentShare aceptado (por targetUserId o targetIdentifier)
4. Aparece en los campos legacy sharedWithUserIds o sharedWithEmails
5. Su rol coincide con el visibilityRole del documento
6. El documento no tiene visibilityRole definido (compatibilidad)

Propietario comparte → Se crea DocumentShare (PENDING)
    → Destinatario ve la invitación en "Pendientes"
    → Acepta (ACCEPTED → obtiene acceso)
    → Rechaza (REJECTED → sin acceso)

1. Extracción de texto: Apache Tika procesa el archivo (PDF, Office, CSV, TXT…) y extrae texto + metadatos
2. Análisis LLM: El texto se envía al modelo de lenguaje que genera:
   • Resumen del contenido
   • Tags relevantes
   • Metadatos estructurados
3. Inferencia de categoría (sistema multicapa):
   • Categoría especificada por el usuario → Análisis del contenido por palabras clave empresariales → Fallback por tipo de archivo

Contratos · Facturas · Presupuestos · Informes · Fichas Técnicas · Documentación Legal · RRHH · Marketing · Proyectos · Otros

La búsqueda combina múltiples estrategias y devuelve un ranking fusionado:

Endpoint POST /api/documents/{id}/query — permite hacer preguntas en lenguaje natural sobre un documento específico. El LLM responde usando el contenido extraído como contexto.

Pantalla de inicio animada con GSAP:

• Logo con animación de entrada (scale + rotateY + bounce)
• Nombre de la aplicación con blur-to-focus
• Barra de carga progresiva
• Fade-out con blur al completarse

Layout dividido: panel izquierdo con branding + panel derecho con formulario.

• Login: por nombre de usuario o email + contraseña
• Register: nombre, email, departamento, tipo de persona, contraseña
• Tabs animados con indicador pill deslizante (GSAP)
• Formulario con stagger de campos (Framer Motion)
• Acceso rápido de administrador global
• Sesión persistida con JWT en localStorage; revalidación automática al recargar

• Sidebar: navegación por secciones (Buscar, Recientes, Favoritos, Subidos, Admin) y categorías (Contratos, Facturas, Informes, Presupuestos, Fichas Técnicas, Documentación Legal)
• Header: menú de usuario con perfil, configuración y cerrar sesión
• Barra de búsqueda: búsqueda en tiempo real con filtros avanzados

• Subida: drag-and-drop o selector de archivos; análisis IA automático tras la subida
• Lista paginada: vista en grid/lista con paginación server-side
• Tarjeta de documento: muestra título, categoría, tipo, tags, autor, fecha, preview
• Vista detallada: preview del archivo (PDF inline, texto), metadatos, resumen IA, tags, historial de acceso
• Edición: renombrar, cambiar categoría, editar autor
• Eliminación: solo propietario o admin
• Descarga: descarga directa del archivo original

• Crear, renombrar y eliminar carpetas
• Drag-and-drop de documentos a carpetas
• Mover/desasignar documentos entre carpetas

• Compartir por username o email
• Panel de invitaciones pendientes
• Aceptar/Rechazar invitaciones
• Visor de lista de acceso por documento

• Crear etiquetas con nombre y color personalizado
• Etiquetas globales (visibles para todos) o por departamento
• Asignar/desasignar etiquetas a documentos
• Filtrar documentos por etiqueta

• Gestión de usuarios: listar todos, asignar roles, cambiar departamento/tipo
• Editor de permisos por rol: ver y modificar permisos de cada rol en tiempo real
• Gestión de etiquetas: crear/eliminar etiquetas globales o de departamento

• Estilo liquid-glass: fondos translúcidos con backdrop-blur y bordes sutiles
• Paleta inspirada en Notion: #37352f (texto), #0A4B66 (acento), #2eaadc (enlace)
• Animaciones con GSAP (entradas de sidebar, header, selección) y Framer Motion (transiciones de formulario, aparición de contenido)
• Responsive: sidebar colapsable, layout adaptativo para móvil
• Soporte para prefers-reduced-motion

• Git Flow: ramas derivadas desde main (feat-*, fix-*, etc.)
• Conventional Commits: feat:, fix:, refactor:, docs:, etc.
• Arquitectura MVC: backend con separación controller → service → repository
• DTOs: comunicación frontend-backend mediante objetos de transferencia, nunca entidades directas

Se soporta PostgreSQL en Supabase con pgvector para búsqueda semántica sin cambiar controladores ni repositorios JPA.

Guía completa: backend/SUPABASE_MIGRATION.md

Este proyecto está liberado bajo la licencia MIT.

Escogemos MIT porque, al ser un proyecto nacido en un Hackathon, buscamos que sea Software Libre permisivo: cualquier individuo u organización puede tomar el trabajo, modificarlo para sus necesidades operativas (como conectar su propia RAG de IA) y usarlo libremente en entornos empresariales sin restricciones severas.