Files
localesp/README.md
T
edgar.friendly 4d7d9e19dc
deploy-branch / deploy (push) Successful in 2m59s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m30s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(panel): el panel admin vive en la raíz del prefijo, /admin desaparece
La ruta fija /admin del enrutador SPA mostraba el panel sin importar el
prefijo configurado. Ahora AdminPanel se monta solo cuando el pathname
coincide con la raíz de LOCALESP_ADMIN_PREFIX (misma variable única que
backend, build y API): con /administrador, el panel queda en
/administrador y /admin pasa a mostrar la web pública.

- src/main.jsx: enrutado por ADMIN_RUTA derivada del prefijo
- README y artefactos openspec (spec/design) actualizados
2026-10-03 14:33:34 +02:00

2.2 KiB

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.

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.