- 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)
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_PREFIXdel entorno y de.env(el fichero no sobrescribe variables ya presentes). - Frontend: Vite expone
LOCALESP_ADMIN_PREFIXal código cliente víaenvPrefix(.envo entorno en dev/build);npm run buildfalla si falta. - Desarrollo:
npm run devproxya/apiy el prefijo admin al backend enlocalhost:3000, leyendo ambos del entorno o de.env. - Despliegue CI (entorno por rama): el prefijo de cada entorno se declara
en
scripts/entornos.env(mappingslug=prefijo, en el repo): el workflow de deploy lo incrusta en el build ydeploy.shlo 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.