📚 Stash - Personal Knowledge Manager

Tu bóveda personal de contenido para consumir después

---

🎯 Descripción

Stash es una aplicación de productividad "Read Later" diseñada para ser 100% gratuita de mantener. Permite guardar enlaces, clasificarlos automáticamente sin IA de pago, y agendar su consumo.

Características Clave

• 🆓 Coste Cero: Arquitectura diseñada para Free Tiers (Supabase, Render, Vercel).
• 🤖 IA Offline: Clasificación automática usando algoritmos de palabras clave y NLP ligero en Python.
• 📅 Agendamiento: Integración con Google Calendar para bloquear tiempo de lectura.
• 🕷️ Scraping Automático: Extracción de títulos e imágenes de enlaces.

---

🏗️ Estructura del Proyecto

PersonalTaskManager/
├── docs/                    # Documentación
│   ├── PRD.md              # Especificación funcional
│   ├── ARCHITECTURE.md     # Arquitectura técnica (Angular + Python)
│   └── API_INTEGRATIONS.md # Guía de conexión con Google/Spotify
│
├── database/               # Base de datos
│   └── schema.sql          # Esquema PostgreSQL para Supabase
│
├── backend/                # API Python (FastAPI)
│   ├── app/
│   │   ├── services/       # Lógica de negocio
│   │   │   ├── scraper.py    # Extracción de metadatos
│   │   │   └── classifier.py # Categorización offline
│   │   └── main.py         # Entry point
│   └── requirements.txt    # Dependencias Python
│
├── apps/
│   └── web/                # Frontend Angular 17+
│       ├── src/
│       │   ├── app/
│       │   │   ├── features/ # Componentes (Dashboard)
│       │   │   └── core/     # Servicios y Modelos
│       └── package.json
│
└── README.md               # Este archivo

---

🚀 Quick Start

1. Base de Datos (Supabase)

1. Crea un proyecto en Supabase.
2. Ve al SQL Editor y ejecuta el contenido de database/schema.sql.
3. Obtén tu SUPABASE_URL y SUPABASE_KEY.

2. Backend (Python)

cd backend
# Crear entorno virtual
python -m venv venv
source venv/bin/activate  # o venv\Scripts\activate en Windows

# Instalar dependencias
pip install -r requirements.txt

# Ejecutar servidor
uvicorn app.main:app --reload

El backend correrá en http://localhost:8000.

3. Frontend (Angular)

cd apps/web
# Instalar dependencias
npm install

# Ejecutar servidor de desarrollo
ng serve

La app abrirá en http://localhost:4200.

---

🛠️ Stack Tecnológico

Capa	Tecnología	Justificación
Frontend	Angular 17+	Robustez, tipado fuerte, standalone components.
Backend	Python (FastAPI)	Mejor ecosistema para Scraping y NLP gratuito.
Base de Datos	PostgreSQL (Supabase)	Relacional + JSON, Auth gratis, Capa gratuita generosa.
Scraping	BeautifulSoup4	Extracción eficiente de metadatos HTML.
NLP	Keyword Matching	Clasificación determinista sin coste de API.

---

📖 Documentación

• 📋 PRD - Requerimientos
• 🏗️ Arquitectura Técnica
• 🔌 Integraciones API

---

📄 Licencia

MIT License.