Sistema de documentación personal: captura rápida en un inbox único y procesado posterior a conocimiento en Markdown.

hack-udc-2026/
├── backend/              # API REST + Prisma
│   ├── prisma/           # schema.prisma, dev.db (SQLite)
│   ├── src/
│   │   ├── index.js      # Servidor Express
│   │   ├── routes/       # inbox, process, search, chat, eventos, topics
│   │   ├── services/     # aiService, chatService, classifyService, linkPreviewService,
│   │   │                 # markdownService, processService, searchService, fileExtractService
│   │   ├── middleware/   # upload (multer)
│   │   └── lib/          # prisma.js
│   ├── uploads/          # Archivos subidos (se crea al usar)
│   ├── knowledge/       # Markdown generado al procesar (notas/, enlaces/, archivos/, etc.)
│   ├── .env.example
│   └── .env              # No subir a Git
└── frontend/             # React (Vite)
    ├── index.html
    ├── vite.config.js    # Proxy /api → backend:3001
    └── src/
        ├── App.jsx, main.jsx, index.css
        ├── api/           # client.js (getInbox, processItems, chat, favoritos…)
        ├── components/    # Inbox, Vault, Process, Calendario, Temas, Settings, Layout
        │   ├── Inbox/     # Header, Sidebar, FooterCapture, InboxList, cards/
        │   ├── Vault/     # VaultScreen, ItemDetailPanel, FileSearchList
        │   ├── Process/   # ProcessScreen
        │   ├── Calendario/, Temas/, Settings/, Layout/, shared/
        ├── context/       # LanguageContext
        ├── i18n/          # translations.js
        ├── data/          # mockInbox.js
        ├── lib/, utils/

• Node.js 20 o superior
• npm 9 o superior
• Git

Copia backend/.env.example a backend/.env (y rellena las variables que necesites). Luego:

npm run setup && npm run dev

Instala dependencias, genera el cliente Prisma, inicializa la BD y arranca backend + frontend con hot reload.

🖥️ Backend

cd backend
cp .env.example .env
npm install
npx prisma generate
npm run db:push
npm run dev

🎨 Frontend (en otra terminal)

cd frontend
npm install
npm run dev

Asegúrate de que frontend/.env tenga VITE_USE_MOCK=false para usar el backend real.

1. Abre http://localhost:5173 en el navegador.
2. Añadir nota o enlace: escribe en la barra de abajo (texto o URL) y pulsa Enviar.
3. Añadir archivo: clic en el clip → "Subir archivo" y elige un PDF, imagen, etc.
4. Procesar: pulsa "Procesar X notas" → elige carpeta de destino → marca ítems → "Procesar seleccionado(s)". Se generan .md en backend/knowledge/<destino>/.
5. Filtros: usa el icono de filtro para filtrar por tipo (texto, enlaces, voz, archivos) o por fecha.

• Inbox unificado: un solo punto de entrada para notas, enlaces, archivos y voz.
• Identificación de tipo por heurísticas en backend.
• Procesado posterior: acción "Procesar" que genera Markdown en knowledge/.
• Almacenamiento abierto: conocimiento en Markdown; BD para estado y metadatos.

• Backend: copia backend/.env.example a backend/.env y rellena DATABASE_URL, PORT, y opcionalmente AZURE_OPENAI_* y GEMINI_API_KEY (ver CONTRIBUTING.md).
• Frontend: en frontend/.env usa VITE_USE_MOCK=false para conectar con el backend real.

• Bugs y mejoras: Issues de GitHub (usa las plantillas de bug o feature request).
• Contribuir: CONTRIBUTING.md — entorno de desarrollo, convenciones y PRs.
• Conducta: CODE_OF_CONDUCT.md.
• Seguridad: SECURITY.md — cómo reportar vulnerabilidades.

• 📜 Licencia: MIT — texto completo en LICENSES/MIT.txt (REUSE).
• 📋 Changelog: CHANGELOG.md.
• 🤝 Contribuciones: CONTRIBUTING.md.