Skip to content

About

Sistema de monitorización de noticias en medios de comunicación y fuentes oficiales.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

NewsRadar

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.

Stack

  • Backend: FastAPI, SQLAlchemy y SQLite
  • Frontend: React, Vite y TypeScript
  • Tareas asíncronas: Celery, Redis y APScheduler
  • Email: SMTP o MailHog en desarrollo

Arranque rápido

docker-compose up -d

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.

Funcionalidades principales

  • 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

Configuración

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/0

Si 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.

Desarrollo local

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload
cd frontend
npm install
npm run dev

Pruebas

En este entorno conviene desactivar la carga automática de plugins de pytest:

PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest backend/tests -v

Antes 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 -d

Documentación adicional

  • docs/README.md es el índice principal de documentación
  • docs/ contiene arquitectura, requisitos y ADRs
  • docs/API_CONTRACT_ORIGINAL.md recoge el contrato original de la API
  • copilot-instructions.md define reglas de compatibilidad de la API

About

Sistema de monitorización de noticias en medios de comunicación y fuentes oficiales.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages