edgar.friendly dd6febf8b0 openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- spec principal pasarela-proponer-local sincronizado con el delta
  (descripción opcional, orden de 6 pantallas, filtro sobre descripción)
- cambio archivado en archive/2026-10-11-pasarela-descripcion-opcional
- nuevo cambio resenas-por-local: reseñas anónimas estilo 4chan, media
  agregada, publicación directa + reportes, rate-limit (artefactos 4/4)
2026-10-11 15:45:57 +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

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 y GET/POST /api/config/filtro_palabras.

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%