edgar.friendly c381a4747f
deploy-branch / deploy (push) Successful in 2m47s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 2m58s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m57s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
openspec(tarjeta): anota el ajuste de padding de reseñas (6.7)
2026-10-12 22:44:14 +02:00

LocalESP

Registro colaborativo de negocios españoles.

Rutas de administración (prefijo configurable)

Las rutas de administración solo se sirven bajo un prefijo configurable; las rutas históricas (/api/pendientes, /api/reportes, /api/aprobar/:id, /api/rechazar/:id, DELETE /api/locales/:id, /api/reportes/:id/descartar) dejan de existir y devuelven 404. Además, el propio panel admin vive en la raíz del prefijo (p. ej. $ADMIN_PREFIX → https://…/administrador): la antigua /admin muestra la web pública. Todo ello oculta la superficie admin de la enumeración de rutas sin añadir autenticación (ocultación, no seguridad real).

Ruta admin Método
$ADMIN_PREFIX/pendientes GET
$ADMIN_PREFIX/aprobar/:id POST
$ADMIN_PREFIX/rechazar/:id POST
$ADMIN_PREFIX/locales/:id DELETE
$ADMIN_PREFIX/reportes GET
$ADMIN_PREFIX/reportes/:id/descartar POST
$ADMIN_PREFIX/resenas GET
$ADMIN_PREFIX/resenas/:id DELETE

Siguen siendo públicas (las usa la web): GET /api/locales, POST /api/propuestas, POST /api/check-duplicado, POST /api/locales/:id/confirmar, POST /api/locales/:id/reportar, GET/POST /api/locales/:id/resenas, DELETE /api/locales/:id/resenas y GET/POST /api/config/filtro_palabras.

Reseñas por local (issue #6)

Cada local publicado tiene reseñas anónimas múltiples: una por dispositivo, editable y borrable por su autor; locales.puntuacion es la media (redondeo de SQLite) de las reseñas vigentes y se recalcula al crear/editar/borrar.

  • Identidad anónima: deviceId aleatorio persistido en localStorage (sin cuentas ni datos personales, "estilo 4chan"). Cada reseña se muestra como Anónimo #xxx con una huella corta derivada de sha256(deviceId:localId): estable dentro del local, no reversible y no rastreable entre locales. El deviceId completo nunca sale del servidor.
  • Contrato público: GET /api/locales/:id/resenas (admite ?deviceId= para marcar la propia), POST /api/locales/:id/resenas ({ deviceId, puntuacion 1–5, comentario ≤500 }, upsert: crea 201 o edita 200) y DELETE /api/locales/:id/resenas?deviceId=… (borra la propia). GET /api/locales incluye totalResenas por local.
  • Moderación: publicación directa; el filtro de palabras se aplica al comentario server-side. Una reseña concreta se reporta con POST /api/locales/:id/reportar añadiendo resenaId; el admin la borra desde el panel (pestaña Reportes → «Borrar reseña», también vía DELETE $ADMIN_PREFIX/resenas/:id).
  • Anti-abuso: rate-limit por IP en las escrituras de reseñas (por defecto 10/hora, configurable con LOCALESP_RESENAS_RATELIMIT_MAX; responde 429 con Retry-After) más la unicidad por dispositivo. El DDoS volumétrico se mitiga en el borde (proxy/CDN), no en la app. Las cuentas de usuario quedarán como trabajo futuro (migración deviceId→userId prevista).

Configuración

LOCALESP_ADMIN_PREFIX es obligatoria, sin valor por defecto y la única variable necesaria: servidor, proxy de desarrollo y build del frontend leen la misma. Sin ella, node server/index.js y npm run build fallan con un error claro. La forma más cómoda de configurarla es copiar el template:

cp .env.example .env   # y rellena LOCALESP_ADMIN_PREFIX
  • Servidor: lee LOCALESP_ADMIN_PREFIX del entorno y de .env (el fichero no sobrescribe variables ya presentes).
  • Frontend: Vite expone LOCALESP_ADMIN_PREFIX al código cliente vía envPrefix (.env o entorno en dev/build); npm run build falla si falta.
  • Desarrollo: npm run dev proxya /api y el prefijo admin al backend en localhost:3000, leyendo ambos del entorno o de .env.
  • Despliegue CI (entorno por rama): el prefijo de cada entorno se declara en scripts/entornos.env (mapping slug=prefijo, en el repo): el workflow de deploy lo incrusta en el build y deploy.sh lo materializa como <dest>/.env. Sin entrada para la rama, el deploy falla con mensaje claro.

Nota: sin prefijo configurado el servidor no arranca (no existe modo sin ocultación). El prefijo viaja en el bundle del frontend, así que esto es ocultación básica frente a enumeración, no un mecanismo de seguridad; la autenticación real queda como trabajo futuro.

S
Description
No description provided
Readme
3.7 MiB
Languages
JavaScript 94.1%
Shell 4.7%
HTML 1.2%