edgar.friendly 3f0c58e26d feat(resenas): media en la cabecera, formulario bajo la barra y cajón solo de reseñas
- LocalCard: las estrellas de la media van arriba a la derecha, a la
  altura del título; el formulario de reseña se monta DEBAJO de la barra
  y solo al pulsar «Comentar», que queda en estado activo (aria-pressed).
- ResenasLocal pasa a ser presentacional: el cajón animado revela SOLO
  el resto de reseñas y el control de ampliar/plegar es de ancho completo
  y va debajo de ellas (Ver las N reseñas / Ver menos).
- Nuevo hook useResenas (dueño único del estado: lista, total, media,
  reseña propia, envío, borrado, reporte, error) y nuevo FormularioResena
  controlado. Desaparece el ref imperativo comentar().
- Tarjetas de comentario con padding uniforme y texto sin margen interno.
- StarRating exporta TAMANO_ESTRELLAS (14) y lo usan media, tarjetas e
  input: un único tamaño.
- Botones con hover/activo a superficie completa por clases CSS
  (.btn-hover, .btn-hover.activo, .btn-sobre-tarjeta, .btn-primario,
  .btn-verde); se retiran los background inline que anulaban el hover.

164/164 tests y build en verde.
2026-10-13 23:38:32 +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%