# 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: ```bash 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 `/.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.