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
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).
87 lines
4.3 KiB
Markdown
87 lines
4.3 KiB
Markdown
# 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.
|