NewsRadar es una plataforma para monitorizar noticias desde medios de comunicación y fuentes oficiales. Incluye autenticación, verificación de email, alertas, fuentes RSS, categorías IPTC, estadísticas y notificaciones por correo.
- Backend: FastAPI, SQLAlchemy y SQLite
- Frontend: React, Vite y TypeScript
- Tareas asíncronas: Celery, Redis y APScheduler
- Email: SMTP o MailHog en desarrollo
docker-compose up -d- API: http://localhost:8000/docs
- Frontend: http://localhost:5173
- MailHog: http://localhost:8025
El contenedor levanta backend, frontend, Redis y MailHog. Al iniciar, el backend crea las tablas, roles base, un usuario administrador y las fuentes RSS iniciales.
- Registro, login y verificación de email
- Gestión de usuarios y roles
- Alertas por usuario con notificaciones asociadas
- Fuentes informativas, canales RSS y categorías IPTC
- Noticias, estadísticas y endpoints de soporte para desarrollo
- Panel web con resumen, dashboard, alertas, fuentes, notificaciones y perfil
La configuración del backend se carga desde backend/.env. Las variables más relevantes son:
DATABASE_URL=sqlite:////app/data/newsradar.db
SECRET_KEY=change-me
FRONTEND_URL=http://localhost:5173
EMAILS_ENABLED=false
SMTP_HOST=mailhog
SMTP_PORT=1025
SMTP_USER=
SMTP_PASSWORD=
SMTP_USE_TLS=false
SMTP_USE_AUTH=false
EMAILS_FROM_EMAIL=noreply@newsradar.com
EMAILS_FROM_NAME=NewsRadar
REDIS_URL=redis://redis:6379/0Si EMAILS_ENABLED=false, el registro sigue funcionando y el enlace de verificación se imprime en consola.
Si vas a probar un mock RSS que corre en tu máquina host, no uses http://127.0.0.1:8100 desde el backend dentro de Docker. Usa http://host.docker.internal:8100/rss para que el contenedor pueda alcanzarlo.
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reloadcd frontend
npm install
npm run devEn este entorno conviene desactivar la carga automática de plugins de pytest:
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest backend/tests -vAntes de ejecutar los tests del profesor, deja la base de datos limpia con:
docker compose down
docker volume rm newsradar_sqlite_data
docker compose up -ddocs/README.mdes el índice principal de documentacióndocs/contiene arquitectura, requisitos y ADRsdocs/API_CONTRACT_ORIGINAL.mdrecoge el contrato original de la APIcopilot-instructions.mddefine reglas de compatibilidad de la API