Files
localesp/README.md
edgar.friendly 38ea2830fb
deploy-branch / deploy (push) Successful in 2m56s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m14s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m6s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
feat(resenas): reseñas anónimas múltiples por local (issue #6)
Una reseña por dispositivo (UNIQUE localId+deviceId, upsert editable),
puntuación 1-5 + comentario ≤500, publicación directa con filtro de
palabras server-side y reportes con resenaId; borrado admin desde el
panel. locales.puntuacion pasa a ser la media (ROUND) recalculada en
cada escritura; GET /api/locales añade totalResenas.

Identidad v1 anónima estilo 4chan: deviceId en localStorage, huella
corta por local (sha256(deviceId:localId)), nunca se expone el deviceId.
Anti-boicot base: rate-limit por IP (10/h, configurable con
LOCALESP_RESENAS_RATELIMIT_MAX, 429+Retry-After). UI: sección plegable
"Reseñas (N) · ★media" en la tarjeta con formulario inline.

Suite: 132/132 (+18 tests: rutas, rate-limit y componente).
2026-10-11 23:01:25 +02:00

87 lines
4.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
`<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.