Author SHA1 Message Date
edgar.friendly 24cce5dbb9 fix(resenas,portada): quita el recuento de reseñas y los tres contadores
deploy-branch / deploy (push) Failing after 2s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 3m12s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Successful in 3m9s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- ResenasLocal: desaparece la cabecera «Reseñas (N)» que iba encima de
  las tarjetas; el único control de expansión es el botón de ancho
  completo bajo las reseñas («Ver las N reseñas» / «Ver menos»).
- Tarjetas de reseña: las estrellas llevan soporte de línea y padding
  superior para que el hueco de arriba iguale al del resto del contenido.
- App: se eliminan los tres contadores del principio de la página
  (Locales · Provincias · Media ★) y las variables que solo los
  alimentaban (issue #4).

CI: en .gitea/workflows/tests.yml el build de producción pasa a correr
ANTES de las pruebas. La suite incluye un smoke de la SPA servida
(GET / → dist/index.html) y `dist/` está gitignored, así que sin build
previo esa prueba recibía 404 en el runner (hasta ahora el artefacto lo
generaba el job de deploy, que en esta rama falla por no tener entrada
en scripts/entornos.env).

164/164 tests y build en verde.
2026-10-14 00:37:18 +02:00
edgar.friendly 3f0c58e26d feat(resenas): media en la cabecera, formulario bajo la barra y cajón solo de reseñas
- LocalCard: las estrellas de la media van arriba a la derecha, a la
  altura del título; el formulario de reseña se monta DEBAJO de la barra
  y solo al pulsar «Comentar», que queda en estado activo (aria-pressed).
- ResenasLocal pasa a ser presentacional: el cajón animado revela SOLO
  el resto de reseñas y el control de ampliar/plegar es de ancho completo
  y va debajo de ellas (Ver las N reseñas / Ver menos).
- Nuevo hook useResenas (dueño único del estado: lista, total, media,
  reseña propia, envío, borrado, reporte, error) y nuevo FormularioResena
  controlado. Desaparece el ref imperativo comentar().
- Tarjetas de comentario con padding uniforme y texto sin margen interno.
- StarRating exporta TAMANO_ESTRELLAS (14) y lo usan media, tarjetas e
  input: un único tamaño.
- Botones con hover/activo a superficie completa por clases CSS
  (.btn-hover, .btn-hover.activo, .btn-sobre-tarjeta, .btn-primario,
  .btn-verde); se retiran los background inline que anulaban el hover.

164/164 tests y build en verde.
2026-10-13 23:38:32 +02:00
edgar.friendly 92a13915bc openspec(resenas): cambio rediseno-resenas-tarjeta
Deltas de tarjeta-local (media en la cabecera, formulario de reseña bajo
la barra de acciones, respuesta visual de los botones) y de
resenas-por-local (la sección pierde media y formulario, expande solo
reseñas y su control pasa a ancho completo bajo ellas).
2026-10-13 23:38:32 +02:00
edgar.friendly 8a7c755ace feat(filtros): agrupa las provincias del desplegable por comunidad autónoma
PROVINCIAS_POR_COMUNIDAD (17 comunidades, 50 provincias) pasa a ser la
fuente única y PROVINCIAS se deriva de ella, así ningún listado queda
desincronizado. El desplegable de filtros y el de la pasarela de
propuesta usan <optgroup> con el nombre de la comunidad.

148/148 tests y build en verde.
2026-10-13 23:31:25 +02:00
edgar.friendly 15c2afb717 fix(filtros): «✕ Limpiar» siempre presente para no desplazar el orden
Al pulsar «★ Mejor» o «A-Z» el botón aparecía justo a continuación del
grupo segmentado (alineado a la derecha con margin-left:auto) y le
robaba espacio, desplazando los botones recién pulsados. Ahora el botón
se renderiza siempre y se deshabilita sin filtros, de modo que reserva
su hueco y la fila no reflúye.

Actualiza spec (escenario sin desplazamiento), design (D7) y pruebas.
2026-10-13 23:30:11 +02:00
edgar.friendly e660da32fb test(filtros): cubre BarraFiltros y mejora la accesibilidad de focos
- 7 pruebas del componente: sección única, sin subcategoría, buscador
  por provincia, chips con conteo/aria-pressed, orden segmentado
  (distancia solo con ubicación), Limpiar global y favoritos.
- Foco visible en la barra vía :focus-visible (inputStyle anula el
  outline por defecto en inputs/selects).
- Verificado que los marcadores del mapa usan localesFiltrados.

146/146 tests y build en verde.
2026-10-13 23:25:13 +02:00
edgar.friendly 3caf2f71bd feat(filtros): sección única con Limpiar global, visible en lista y mapa
- Las tres filas (búsqueda+provincia, categorías, acciones+orden) viven
  en una sola tarjeta sobre las pestañas Lista/Mapa.
- «✕ Limpiar» resetea búsqueda, categoría, provincia, favoritos y
  orden, y desactiva la ubicación; visible solo cuando hay filtros.
- Se corrige una variable CSS inexistente (var(--color-background) →
  --color-background-secondary) en el orden segmentado.

139/139 tests y build (con LOCALESP_ADMIN_PREFIX) en verde.
2026-10-13 10:08:01 +02:00
edgar.friendly 6778ead745 feat(filtros): sin subcategorías, provincia compacta y orden segmentado
- El select de subcategoría desaparece sin reemplazo (subtipos
  replanteados en #22); el estado queda fijado a "".
- Provincia: desplegable compacto junto a la búsqueda (única excepción
  al sin-desplegables, decisión de diseño D4); el buscador ya matcheaba
  provincia, ahora lo comunica el placeholder.
- Orden: control segmentado [🕒 Reciente|★ Mejor|A-Z|📍 Más cerca],
  distancia solo con ubicación activa.
2026-10-13 00:07:12 +02:00
edgar.friendly 2271aad173 refactor(filtros): extrae la UI de filtros a BarraFiltros (neutro)
App.jsx conserva el estado y localesFiltrados; el componente pinta
exactamente los controles anteriores. 139/139 tests en verde.
2026-10-13 00:06:23 +02:00
edgar.friendly 2169f1c64d openspec(filtros): cambio unificar-filtros-iu para la issue #3
Barra única de filtrado sin select de orden ni subcategorías (subtipos
replanteados en #22), provincia compacta + búsqueda por texto, barra
visible en lista y mapa. Decisiones de diseño documentadas en design.md.
2026-10-13 00:06:23 +02:00
edgar.friendly ac566a9655 style(tarjeta): padding de reseñas a 12px y sin solape título/estrellas
deploy-branch / deploy (push) Successful in 2m43s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Failing after 3m5s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- 15px → 12px 12px 8px (punto medio tras el ajuste manual a 15)
- el formulario delinea las estrellas con un soporte de línea (lineHeight
  26px): con lineHeight 0 la caja mide 0 y el glifo se solapaba con
  'Deja tu reseña'; además gap 6→8
2026-10-12 22:58:02 +02:00
edgar.friendly 2fa95840a7 openspec: archiva tarjeta-local-rediseno (sync aplicado)
deploy-branch / deploy (push) Successful in 2m40s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 2m57s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m8s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
- spec principal nuevo tarjeta-local (estructura + barra de acciones)
- resenas-por-local actualizado: vista previa de 3 en grid, cierre por
  tres vías, acciones por tarjeta (Borrar propias / Reportar ajenas)
- cambio archivado en archive/2026-10-11-tarjeta-local-rediseno
2026-10-12 22:45:18 +02:00
edgar.friendly c381a4747f openspec(tarjeta): anota el ajuste de padding de reseñas (6.7)
deploy-branch / deploy (push) Successful in 2m47s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 2m58s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m57s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
2026-10-12 22:44:14 +02:00
edgar.friendly 9b24953a5e style(tarjeta): un poco más de padding en las tarjetas de reseña
deploy-branch / deploy (push) Successful in 2m36s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m2s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m9s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
2026-10-12 10:35:45 +02:00
edgar.friendly c4a60c099c fix(tarjeta): cierre accesible de reseñas + grid de tarjetas con acciones
deploy-branch / deploy (push) Successful in 3m26s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m50s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m48s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Feedback de usuario tras el rediseño:

- Cierre por tres vías (antes solo un chevron poco visible): "Comentar"
  ahora ALTERNA (abre con foco / cierra), botón "Cerrar" en el formulario
  y chevron de la cabecera (chevron agrandado)
- Reseñas en GRID: 3 primeras en fila ocupando el ancho de la tarjeta
  (auto-fit minmax(120px,1fr)); al expandir, el resto en el mismo grid;
  comentario con line-clamp 3 y fecha corta para cabir "estrechadas"
- Menos cajas anidadas: el formulario es plano (solo border-top), sin
  caja propia dentro de la zona expandida
- Acciones por tarjeta de reseña: "Borrar" en las propias (etiqueta
  «Tú»), "Reportar" en las ajenas con estado ✅; fuera el botón
  "Borrar mi reseña" del formulario (redundante)

Suite: 139/139 (toggle de cierre por las tres vías, grid de 3 con la
4ª oculta, borrar/reportar por tarjeta, comentar() alterna).
2026-10-12 10:10:44 +02:00
edgar.friendly ebbd7b696e feat(tarjeta): rediseño de usabilidad — descripción arriba, vista previa de reseñas y barra de acciones
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m3s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 2m59s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
- La descripción del local pasa a bloque propio ENCIMA de las reseñas
- Reseñas: carga al montar con 2 visibles sin expandir; expansión con
  animación (grid-template-rows 0fr→1fr, 350ms) que revela todas + el
  formulario; pista "Ver las N reseñas" cuando hay más de 2
- Barra inferior a ancho completo: Comentar (expande+enfoca) · Reportar
  (formulario controlado) · Marcar (favorito, corazón fuera de cabecera,
  aria-pressed) · Compartir (antes en cabecera); fecha pequeñita encima
- openspec: archiva resenas-por-local (spec principal creado por sync) y
  abre tarjeta-local-rediseno (specs de tarjeta-local + resenas modificada)

Suite: 138/138 (+6 netos).
2026-10-11 23:21:22 +02:00
edgar.friendly 478943c58a openspec(resenas): marca 5.2 completada tras verificar despliegue
deploy-branch / deploy (push) Successful in 2m45s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m7s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Failing after 3m2s
tests / Integración (Nominatim real, opt-in) (push) Skipped
2026-10-11 23:04:46 +02:00
edgar.friendly 38ea2830fb feat(resenas): reseñas anónimas múltiples por local (issue #6)
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).
2026-10-11 23:01:25 +02:00
edgar.friendly dd6febf8b0 openspec: archiva pasarela-descripcion-opcional (sync aplicado) y abre resenas-por-local (issue #6)
- 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)
2026-10-11 15:45:57 +02:00
edgar.friendly d34ebf7ca0 feat(pasarela): campo opcional de descripción en la pasarela de proponer local
deploy-branch / deploy (push) Successful in 3m11s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m27s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m0s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Nueva pantalla "Descripción" (paso 5 de 6, opcional, máx. 200 caracteres)
entre Tipo específico y Revisión. La descripción viaja en la propuesta
(trim; vacía → ausente/NULL), el filtro de palabras prohibidas la cubre y
el resumen la muestra. Backend/BD ya la soportaban: cambio frontend-only.

Incluye el archivo del cambio hide-admin-route y la propuesta
openspec del nuevo cambio. Suite: 114/114.
2026-10-11 15:04:37 +02:00
edgar.friendly 695d59d31e ci(deploy): config por entorno en el repo (scripts/entornos.env)
deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m15s
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
La config de prefijo admin pasa del host (/etc/localesp/<slug>.env) al
repo, para que viaje con el código que despliega y se revise en PRs:

- scripts/entornos.env: mapping <slug>=<prefijo> (prototipo-yb01=
  /administrador; master y prototipo-yb01-ef como plantilla comentada)
- env.sh: servicio Config::admin_prefix lee el mapping; require_config
  falla con mensaje claro si la rama no tiene entrada; Env::deploy
  regenera <dest>/.env desde el repo (el servidor lo autocarga)
- deploy.yml: el build exporta el prefijo del mapping antes de compilar
2026-10-03 14:56:08 +02:00
edgar.friendly 4d7d9e19dc feat(panel): el panel admin vive en la raíz del prefijo, /admin desaparece
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
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
edgar.friendly 34bd421853 ci(deploy): config por entorno en /etc/localesp/<slug>.env
deploy-branch / deploy (push) Successful in 3m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m25s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m29s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
El build ahora exige LOCALESP_ADMIN_PREFIX (sin valor por defecto), así
que el CI necesita saber el prefijo de cada entorno de rama:

- deploy.yml: el paso de build carga /etc/localesp/<slug>.env del host
  (Slug::from de lib/env.sh) y falla con mensaje claro si no existe
- env.sh: Env::require_config valida la config, y Env::deploy la copia
  a <dest>/.env, que el servidor autocarga (sobrevive a rsync --delete)
- tests.yml: el smoke-build usa un prefijo placeholder (/admin-ci);
  comprueba que el build funciona, no la configuración del entorno
2026-10-02 22:09:06 +02:00
edgar.friendly 85a054d886 feat(seguridad): rutas admin bajo prefijo configurable obligatorio
deploy-branch / deploy (push) Failing after 3m7s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 3m17s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Failing after 3m10s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
Cambio openspec hide-admin-route: las rutas de administración se montan
bajo LOCALESP_ADMIN_PREFIX (única variable, obligatoria, sin valor por
defecto) y las rutas históricas /api/... dejan de existir (404 natural).

- server: autocarga de .env (sin pisar el entorno) y fail-fast claro si
  falta LOCALESP_ADMIN_PREFIX; reportar/confirmar siguen públicas
- frontend: src/api.js usa el prefijo expuesto por Vite (envPrefix);
  npm run build falla sin la variable; proxy de dev la lee vía loadEnv
- .env.example como template único de configuración
- tests: 109/109 en verde (rutas bajo prefijo, 404s históricos y
  fail-fast sin configurar)
- openspec: artefactos del cambio sincronizados (design/spec/tasks)
2026-10-02 21:57:02 +02:00
edgar.friendly 49e965b248 feat(pasarela): datos inferidos juntos en una pantalla "Datos del local"
deploy-branch / deploy (push) Successful in 2m18s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 2m23s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
tests / Unitarias + componente + build (push) Successful in 2m30s
tests / Integración (Nominatim real, opt-in) (push) Skipped
- Nuevo PasoDatosLocal con nombre, provincia y dirección (ahora editable)
  en la misma pantalla, con aviso cuando vienen de la inferencia
- El wizard pasa de 6 a 5 pasos: Ubicación → Datos del local → Categoría
  → Tipo específico → Resumen
- Eliminados PasoNombre y PasoProvincia (absorbidos)
- Spec principal actualizada al nuevo orden de pantallas
2026-09-12 19:00:33 +02:00
edgar.friendly 30b7cc884e ci: verificación de statuses tras reinicio de runner y gitea
deploy-branch / deploy (push) Successful in 2m13s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 2m41s
tests / Integración (Nominatim real, opt-in) (push) Skipped
tests / Unitarias + componente + build (pull_request) Successful in 2m37s
tests / Integración (Nominatim real, opt-in) (pull_request) Skipped
2026-09-10 18:33:12 +02:00
edgar.friendly d0fa037010 ci(tests): activa gcc-toolset-12 para compilar better-sqlite3 con npm ci
deploy-branch / deploy (push) Successful in 2m35s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Successful in 2m47s
tests / Integración (Nominatim real, opt-in) (push) Skipped
2026-08-18 07:42:42 +02:00
edgar.friendly 00eaa1d209 ci: mueve tests.yml a .gitea/workflows (ubicación que este Gitea ejecuta)
deploy-branch / deploy (push) Successful in 2m37s
deploy-branch / teardown (push) Skipped
tests / Unitarias + componente + build (push) Failing after 1m48s
tests / Integración (Nominatim real, opt-in) (push) Skipped
2026-08-18 07:30:59 +02:00
edgar.friendly 0c5651a6c0 fix(ci): compatibilidad con el runner self-hosted (npm 10 / Node 20)
deploy-branch / deploy (push) Successful in 2m43s
deploy-branch / teardown (push) Skipped
- vitest 4 traía vite 8 anidado con esbuild 0.28: el lockfile quedaba
  incompleto para npm ci y el npm 10.8.2 del runner fallaba con
  "Missing @esbuild/* from lock file" / EBADPLATFORM. vitest 3 usa el
  vite 5 del proyecto como peer: sin árbol anidado, esbuild solo 0.21.5
- jsdom 30 exige Node >=22.22 (el runner tiene 20.20): bajado a jsdom 26
- tests.yml sobre el runner real (self-hosted, Node del sistema) en vez
  de ubuntu-latest, que no existe como label
- aserciones de max()/calc() tolerantes a la serialización de jsdom 26
2026-08-18 07:27:19 +02:00
edgar.friendly 7bb3ea22da chore(openspec): archiva pasarela-proponer-local y sincroniza specs principales
deploy-branch / deploy (push) Failing after 6s
deploy-branch / teardown (push) Skipped
- Mueve el cambio (36/36 tareas, 4/4 artefactos) a changes/archive/
- Crea las specs principales de boton-flotante-proponer-local,
  pasarela-proponer-local y proveedores-ubicacion (con Purpose)
2026-08-16 11:51:11 +02:00
edgar.friendly 3ce84531d1 fix(ui): botones alineados al cuerpo, FAB grande en PC y botón superior de propuesta
- FAB y aviso PWA flanquean la columna central (720px): right/left
  max(16px, calc((100vw - 720px)/2 + 16px)) para acompañar al contenido
  en pantallas anchas sin pegarse al borde de la ventana
- FAB de 64px en PC (54 en móvil); PWA abajo a la izquierda en PC y móvil
- Nuevo BotonProponerArriba (solo PC): píldora "Proponer local" arriba a
  la derecha, alineada al cuerpo, que abre la misma pasarela
2026-08-16 11:50:59 +02:00
edgar.friendly 003b1e209f feat(propuesta): pasarela paso a paso con autodetección de ubicación y FAB
deploy-branch / deploy (push) Failing after 6s
deploy-branch / teardown (push) Skipped
- Campo universal de ubicación (Google Maps/Waze/OSM/coordenadas/dirección)
  sobre proveedores extensibles (src/utils/ubicacion) con resolver e inferencia
  inversa Nominatim (nombre/provincia pre-rellenados, alias cooficiales)
- FAB flotante abajo a la derecha que abre la pasarela en un modal accesible
  (Escape, foco contenido, responsive); sin descripción ni puntuación;
  avisos de duplicado y filtro de palabras dentro del modal
- Aviso PWA reposicionado: tarjeta abajo a la izquierda en móvil,
  botón compacto arriba a la izquierda en PC (no tapa el FAB)
- Suite de pruebas: 88 unitarias/componente (vitest + RTL, offline) y
  10 de integración (supertest + SQLite :memory: y Nominatim real opt-in)
- CI: workflow de Gitea Actions con npm test + build en push/PR e
  integración manual
2026-08-16 01:35:02 +02:00
edgar.friendly d48b74cbd4 feat(ui): notificaciones toast y mapa que sobrevive al cambio de pestaña
deploy-branch / deploy (push) Successful in 2m41s
deploy-branch / teardown (push) Skipped
- Añade sistema de avisos tipo snackbar (Toast.jsx + useToast.js) con
  auto-cierre, animación de entrada y estilos info/éxito/error.
- LocalCard: feedback visual al añadir/quitar un local de favoritos.
- AdminPanel: sustituye los alert() por toasts al aprobar, rechazar,
  eliminar locales, descartar avisos y guardar el filtro de palabras;
  además saluda con un toast tras iniciar sesión o crear cuenta.
- App: el contenedor del mapa Leaflet queda siempre montado (oculto con
  CSS) y se llama a invalidateSize() al volver a la pestaña de mapa;
  así el mapa ya no se rompe al navegar entre vistas (antes obligaba
  a recargar la página).
2026-08-15 20:37:04 +02:00
edgar.friendly b36867225c feat: directorio más fiable y más fácil de usar
deploy-branch / deploy (push) Successful in 2m34s
deploy-branch / teardown (push) Skipped
El objetivo de estos cambios es, por un lado, mantener los datos
actualizados y, por otro, mejorar la experiencia para quienes lo usan:

- Fiabilidad: los locales se pueden confirmar ("Sigue aquí") y
  reportar (cerrado, datos incorrectos...), y se avisa de duplicados
  antes de publicar, para que el contenido no se quede obsoleto ni
  repetido.

- Usabilidad: autocompletado al proponer, favoritos, "cerca de mí",
  compartir fichas, enlaces a Waze y una política de privacidad
  visible, para que sea más sencillo aportar y encontrar locales.
2026-08-10 22:23:35 +02:00
edgar.friendly 257fb9c622 refactor(ui): modulariza App.jsx y unifica branding y caché PWA
deploy-branch / deploy (push) Successful in 2m36s
deploy-branch / teardown (push) Skipped
- Extrae App.jsx en módulos reutilizables: constants/ (categorias,
  provincias), utils/geo, styles/shared, hooks/usePwaInstall y
  components/ (StarRating, LocalCard, CampoUbicacion, BannerMovil,
  CategoriaBadge)
- AdminPanel reutiliza constantes y componentes compartidos y corrige
  la limpieza de suscripciones de Firebase al desmontar
- Añade logos de marca (logo-localesp.png + @2x) y regenera los iconos
  PWA con tamaños menores
- sw.js: sube la caché del shell a v2 e incluye los nuevos iconos y logos
2026-08-05 19:07:00 +02:00
edgar.friendly 28d066b5af feat(pwa): añade assets PWA que faltaban (manifest, sw.js, iconos)
deploy-branch / deploy (push) Successful in 2m49s
deploy-branch / teardown (push) Skipped
El commit anterior (a3fd928) referenciaba /manifest.webmanifest,
/sw.js, /favicon-32.png y /apple-touch-icon.png en index.html y
main.jsx, pero los archivos no existían: el fallback SPA los servía
como index.html (200 text/html), así que la PWA no era instalable y
parecía que el desplegue no había actualizado.

Se añaden en public/ (Vite los copia a dist/ raíz):
- manifest.webmanifest: nombre, theme_color #8B0000, iconos any/maskable.
- sw.js: cache del shell con stale-while-revalidate (sirve cache al
  instante y revalida en segundo plano) + network-first para /api/.
  Versión de caché localesp-shell-v1.
- Iconos: favicon-32, apple-touch-icon (180), icon-192, icon-512 y
  icon-512-maskable.
2026-08-02 12:11:40 +02:00
edgar.friendly a3fd928073 Migración de esquema DB y soporte PWA:
deploy-branch / deploy (push) Successful in 2m16s
deploy-branch / teardown (push) Skipped
- Mapeo campos en base de datos: ubicacion→provincia, telefono→subcategoria,
  email→direccion, web→enlaceGoogleMaps y añadido puntuacion.
- Migración suave (ensureColumn) para añadir las nuevas columnas sin perder
  datos existentes si la DB ya existía con el esquema antiguo.

- Actualización de rutas del servidor para guardar/leer los nuevos campos y
  convertir el NULL a valor nulo por defecto en puntuacion.

- Soporte PWA: añadido meta tags (manifest, theme-color, apple-touch-icon) y
  registro de service worker para instalación del app y shell offline.
2026-08-01 19:27:57 +02:00
edgar.friendly d1fec59dcb ci: despliegue automático por rama (workflow + scripts OOP)
deploy-branch / deploy (push) Successful in 2m15s
deploy-branch / teardown (push) Skipped
Añade la automatización de despliegue a esta rama (no la tenía):
- .gitea/workflows/deploy.yml: build + deploy on push, teardown on delete.
- scripts/lib/env.sh + deploy.sh + teardown.sh: lib OOP (Env + SystemdUnit/
  NginxVhost/TlsCert) y entrypoints finos.

El código de la app NO se modifica. Traído path-scoped desde master (6cc326e).
Cada push a prototipo-yb01 publicará la app en prototipo-yb01.localesp.es.
2026-08-01 18:30:00 +02:00
edgar.friendly bd4282c426 Add support for sqlite 2026-06-07 23:58:53 +02:00
edgar.friendly 1b67900d54 Primera versión 2026-05-20 13:55:15 +02:00
158 changed files with 12263 additions and 1640 deletions
+24
View File
@@ -0,0 +1,24 @@
# Configuración de LocalESP — copia este fichero a `.env` y rellena los valores.
# cp .env.example .env
#
# El servidor carga `.env` automáticamente al arrancar (no sobrescribe
# variables ya presentes en el entorno) y Vite lo lee en dev y build.
# Prefijo bajo el que se sirven las rutas de administración (OBLIGATORIO,
# sin valor por defecto: servidor y build fallan si no está configurada).
#
# - Es la ÚNICA variable: servidor (`node server/index.js`), proxy de
# desarrollo (`npm run dev`) y frontend (`npm run build`) leen esta misma.
# - Empieza por "/" y no lo publiques: es lo que oculta /admin de la
# enumeración de rutas. Usa algo difícil de adivinar, p. ej. /gestion-x7k2
# - Las rutas históricas (/api/pendientes, /api/reportes, ...) dejan de
# existir; el panel /admin llama a `$LOCALESP_ADMIN_PREFIX/...`
LOCALESP_ADMIN_PREFIX=
# Opcional: ruta de la base de datos SQLite (por defecto localesp.db del
# repo; en pruebas se usa ":memory:").
# LOCALESP_DB=
# Opcional: máximo de escrituras de reseñas (crear/editar/borrar) por IP y
# hora, como defensa base anti-boicot (por defecto 10; 429 al exceder).
# LOCALESP_RESENAS_RATELIMIT_MAX=10
+66
View File
@@ -0,0 +1,66 @@
name: deploy-branch
# CI/CD: cada push a cualquier rama se despliega en <rama>.localesp.es
# Estrategia A — un entorno por rama. El registro DNS A es manual (precondición).
# Detalles: docs/07-cicd.md
on:
push:
branches:
- "**"
delete:
workflow_dispatch:
inputs:
branch:
description: "Rama a desplegar (vacío = la actual)"
required: false
default: ""
jobs:
deploy:
if: github.event_name != 'delete'
runs-on: self-hosted
timeout-minutes: 15
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Build (npm ci + vite build)
shell: bash
env:
BRANCH: ${{ github.event.inputs.branch || github.ref_name }}
run: |
# better-sqlite3 (v12) requiere C++20; el GCC 8 del sistema (AlmaLinux 8) no lo soporta.
# gcc-toolset-12 (GCC 12) ya está instalado en /opt/rh.
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
# Config por entorno EN EL REPO (la misma que usará deploy.sh):
# scripts/entornos.env mapea <slug>=<prefijo admin>, que el build
# incrusta en el bundle. Sin entrada para la rama, falla (sin default).
. scripts/lib/env.sh
slug="$(Slug::from "$BRANCH")"
prefix="$(Config::admin_prefix "$slug" scripts/entornos.env)" || {
echo "::error::Falta entrada '$slug=' en scripts/entornos.env — añádela y relanza" >&2
exit 1
}
export LOCALESP_ADMIN_PREFIX="$prefix"
npm ci
npm run build
- name: Deploy branch
env:
BRANCH: ${{ github.event.inputs.branch || github.ref_name }}
run: bash scripts/deploy.sh "$BRANCH"
# Al borrar una rama, se limpia su entorno
teardown:
if: github.event_name == 'delete'
runs-on: self-hosted
timeout-minutes: 5
steps:
- name: Checkout (default branch, trae scripts/)
uses: actions/checkout@v4
- name: Teardown branch env
env:
# github.event.ref en un 'delete' es refs/heads/<rama>
BRANCH: ${{ github.event.ref }}
run: bash scripts/teardown.sh "${BRANCH#refs/heads/}"
+57
View File
@@ -0,0 +1,57 @@
# CI: ejecuta la suite rápida de pruebas (offline) y el build en cada push y PR.
# La suite de integración con Nominatim (red real) es opt-in: se lanza a mano
# desde la pestaña Actions del repositorio, y un fallo de red no rompe el CI.
name: tests
on:
push:
pull_request:
workflow_dispatch:
jobs:
test:
name: Unitarias + componente + build
# El runner disponible es self-hosted (AlmaLinux, Node 20 del sistema);
# las deps soportan Node >=18/20 (jsdom@26), así que no hace falta setup-node.
runs-on: self-hosted
steps:
- uses: actions/checkout@v4
- name: Instalar dependencias
# better-sqlite3 (v12) requiere C++20 y el GCC 8 base de AlmaLinux 8
# no lo soporta: se activa gcc-toolset-12 igual que en deploy.yml
shell: bash
run: |
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
npm ci
- name: Build de producción
# Va ANTES de las pruebas: la suite incluye un smoke de la SPA servida
# (GET / → dist/index.html) y `dist/` está gitignored, así que el
# artefacto tiene que existir cuando corre `npm test`.
# Smoke build: el prefijo real lo aporta cada entorno en deploy.yml
# (config /etc/localesp/<slug>.env del host). Aquí basta un valor
# cualquiera: se comprueba que el build funciona, no la configuración.
env:
LOCALESP_ADMIN_PREFIX: /admin-ci
run: npm run build
- name: Pruebas unitarias y de componente (offline)
run: npm test
integracion:
name: Integración (Nominatim real, opt-in)
runs-on: self-hosted
if: github.event_name == 'workflow_dispatch'
continue-on-error: true # depende de un servicio externo: informativa
steps:
- uses: actions/checkout@v4
- name: Instalar dependencias
shell: bash
run: |
source /opt/rh/gcc-toolset-12/enable 2>/dev/null || echo "WARN: gcc-toolset-12 no encontrado"
npm ci
- name: Pruebas de integración (API en memoria + Nominatim)
run: npm run test:integration
-18
View File
@@ -1,18 +0,0 @@
---
name: Bug
about: Reportar un error
labels: bug
---
**Qué pasa**
Descripción breve.
**Pasos para reproducir**
1.
2.
**Qué esperabas**
**Entorno**
- Navegador:
- Sistema operativo:
-14
View File
@@ -1,14 +0,0 @@
---
name: Propuesta de mejora
about: Sugerir una funcionalidad o mejora
labels: enhancement
---
**Problema o necesidad**
¿Qué te falta? ¿Quién la usaría?
**Propuesta**
Cómo lo resolverías. Mantenlo simple: si la propuesta requiere muchas piezas
nuevas, conviene discutirla antes en Discussions.
**Alternativas que has considerado**
-13
View File
@@ -1,13 +0,0 @@
## Qué cambia
<!-- En una o dos frases. -->
## Por qué
<!-- Issue relacionado o motivación. -->
## Notas para el revisor
- [ ] La app arranca con `npm run dev`.
- [ ] No he añadido dependencias innecesarias.
- [ ] He seguido la estructura existente.
+4 -4
View File
@@ -1,8 +1,8 @@
node_modules
dist
.DS_Store
*.log
.vscode
.idea
.env
.env.local
localesp.db
.claude/
.codex/
.pi/
-21
View File
@@ -1,21 +0,0 @@
MIT License
Copyright (c) [AÑO] [ORGANIZACIÓN]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+78 -30
View File
@@ -1,38 +1,86 @@
# Business Map
# LocalESP
Registro colaborativo de negocios, en un mapa abierto.
Registro colaborativo de negocios españoles.
Prototipo open source mantenido por **[ORGANIZACIÓN]**. Cualquiera puede ver
los negocios registrados y proponer nuevos; las propuestas son revisadas
antes de aparecer públicamente.
## Rutas de administración (prefijo configurable)
## Demo local
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
npm install
npm run dev
cp .env.example .env # y rellena LOCALESP_ADMIN_PREFIX
```
Abre la URL que indique Vite (normalmente `http://localhost:5173`).
- **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.
## Stack
- React 18 + Vite
- Leaflet + OpenStreetMap (mapa)
- CSS plano
Sin backend en el prototipo: los datos vienen de un mock en memoria. Ver
`docs/02-implementation-alternatives.md` para la decisión de backend.
## Documentación
- [`docs/01-use-cases.md`](docs/01-use-cases.md) – qué hace y qué no.
- [`docs/02-implementation-alternatives.md`](docs/02-implementation-alternatives.md) – decisiones técnicas.
- [`docs/03-decisions.md`](docs/03-decisions.md) – ADRs.
- [`docs/04-governance.md`](docs/04-governance.md) – cómo se gobierna el proyecto.
- [`docs/05-contributing.md`](docs/05-contributing.md) – cómo contribuir.
- [`docs/06-github-setup.md`](docs/06-github-setup.md) – configuración inicial del repo.
## Licencia
MIT. Ver [LICENSE](LICENSE).
> 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.
-51
View File
@@ -1,51 +0,0 @@
# Casos de uso
Este documento describe los casos de uso del prototipo. El objetivo es mantener
el alcance acotado para minimizar el coste de mantenimiento.
## Actores
- **Visitante**: cualquier persona que accede a la aplicación. No requiere
autenticación. Puede consultar el mapa y contribuir con nuevas entradas.
- **Revisor**: persona designada por la organización que aprueba o rechaza las
contribuciones. Su flujo está fuera del frontend del prototipo (ver
alternativas de implementación).
## Casos de uso del prototipo
### CU-01: Explorar negocios en el mapa
- El visitante abre la aplicación.
- Ve un mapa centrado en una ubicación por defecto con marcadores de los
negocios aprobados.
- Puede hacer zoom y desplazarse libremente.
### CU-02: Ver detalles de un negocio
- El visitante selecciona un marcador en el mapa.
- La barra lateral muestra los detalles del negocio: nombre, categoría,
dirección, descripción corta y enlace/contacto si existe.
- Al seleccionar otro marcador, la barra lateral se actualiza.
### CU-03: Contribuir con un nuevo negocio
- El visitante abre el formulario de contribución desde la interfaz principal.
- Rellena los campos mínimos: nombre, categoría, dirección, descripción y
contacto opcional. La ubicación se obtiene geocodificando la dirección o
haciendo clic en el mapa.
- Envía el formulario. La entrada queda en estado "pendiente de revisión" y no
aparece en el mapa hasta ser aprobada.
- El visitante recibe confirmación visual del envío.
## Fuera de alcance del prototipo
Decisiones tomadas para mantener el proyecto simple (ver
`02-implementation-alternatives.md` para el razonamiento):
- Autenticación de usuarios.
- Panel de moderación dentro de la aplicación. La revisión se hace en el
backend (por ejemplo, en el dashboard del proveedor de datos elegido).
- Edición o eliminación de negocios por el visitante.
- Búsqueda avanzada, filtros complejos o categorías jerárquicas.
- Comentarios, valoraciones, fotos múltiples o multimedia.
- Internacionalización. El prototipo usa un único idioma.
Estos casos pueden añadirse después si la comunidad lo pide, pero no forman
parte del prototipo.
-85
View File
@@ -1,85 +0,0 @@
# Alternativas de implementación
Este documento registra las decisiones técnicas tomadas y por qué. El criterio
guía es **mínimo coste de mantenimiento** para una organización sin ánimo de
lucro, siguiendo KISS y evitando YAGNI.
## 1. Framework frontend
| Opción | Pros | Contras |
|---|---|---|
| **React + Vite** (elegido) | Ecosistema enorme, fácil encontrar contribuidores, build rápido. | Requiere build step. |
| Next.js | SSR, rutas, imágenes. | Demasiado para una SPA de una página; aumenta complejidad y coste de hosting. |
| Vanilla JS | Sin dependencias. | Más código manual, menos contribuidores familiarizados. |
**Decisión**: React + Vite. Es el stack más común y los contribuidores
potenciales lo conocen. Vite mantiene la configuración mínima.
## 2. Mapa
| Opción | Pros | Contras |
|---|---|---|
| **Leaflet + OpenStreetMap** (elegido) | Open source, sin claves API, sin coste, tiles gratuitos. | Menos pulido que Mapbox. |
| Mapbox GL | Más bonito, mejor rendimiento. | Requiere API key y tiene cuotas de pago. |
| Google Maps | Familiar. | Requiere facturación activada, cuotas estrictas, no encaja con espíritu open source. |
**Decisión**: Leaflet con tiles de OpenStreetMap. Cero coste, sin claves, y la
librería `react-leaflet` lo hace trivial de integrar.
## 3. Backend y almacenamiento de datos
| Opción | Pros | Contras |
|---|---|---|
| **Backend-as-a-Service** (Supabase o similar) elegido | Sin servidor que mantener, base de datos gestionada, panel de moderación incluido en su dashboard. Plan gratuito generoso. | Dependencia de un proveedor. |
| Backend propio (Node + Postgres) | Control total. | Hay que mantenerlo, pagarlo, securizarlo. Alto coste para una ONG. |
| Archivo JSON en el repositorio | Sin backend, máxima simplicidad. | Las contribuciones tendrían que llegar como Pull Requests, fricción alta para no-técnicos. |
**Decisión**: BaaS tipo Supabase. Para el prototipo, la capa de datos se
abstrae en `src/services/businessRepository.js`, así que cambiar de proveedor
después es localizado. El prototipo entregado usa un **mock en memoria** para
no acoplar a un proveedor concreto antes de que la organización lo decida.
## 4. Moderación
| Opción | Pros | Contras |
|---|---|---|
| **Aprobación desde el dashboard del BaaS** (elegido) | Cero código extra. El revisor cambia un campo `status` de `pending` a `approved`. | Requiere acceso al dashboard. |
| Panel de moderación dentro de la app | Más cómodo. | Requiere autenticación, roles, vistas extra: explosión de complejidad. |
**Decisión**: La moderación vive fuera del frontend público. El modelo de
datos incluye un campo `status` (`pending` / `approved` / `rejected`). El
frontend solo lee los `approved`.
## 5. Estilos
| Opción | Pros | Contras |
|---|---|---|
| **CSS plano con variables** (elegido) | Cero dependencias, fácil de leer, los contribuidores con HTML/CSS básico pueden colaborar. | Sin utilidades. |
| Tailwind | Productivo. | Cadena de build extra, curva de aprendizaje. |
| CSS-in-JS | Componentes encapsulados. | Runtime extra, peor accesibilidad para nuevos contribuidores. |
**Decisión**: CSS plano. La app es de una página; no se justifica más.
## 6. Gestión de estado
**Decisión**: `useState` y `useEffect` de React. No hay Redux, Zustand ni
Context global. La app es pequeña; añadir una librería de estado sería YAGNI.
## 7. Geocodificación de direcciones del formulario
**Decisión para el prototipo**: el usuario hace clic en el mapa para fijar la
ubicación, o introduce lat/lng. Geocodificación automática vía Nominatim
(OpenStreetMap) queda como mejora futura con bajo coste de añadir.
## 8. Tests
**Decisión**: el prototipo no incluye suite de tests para no inflarlo, pero la
estructura (servicios separados de componentes, funciones puras donde posible)
facilita añadirlos. Cuando se incorporen, **Vitest** es la elección natural por
integrarse con Vite sin configuración.
## 9. Despliegue
**Decisión recomendada**: **GitHub Pages** o **Cloudflare Pages** (gratuitos
para open source). Una SPA estática construida con `vite build` se despliega
sin coste y sin servidor. Ver `docs/06-github-setup.md`.
-49
View File
@@ -1,49 +0,0 @@
# Registro de decisiones
Lista corta y cronológica de decisiones que merecen ser revisadas más
adelante. Formato ADR ligero.
## D-001: SPA de una sola página
**Contexto**: el uso principal es ver un mapa y unos detalles.
**Decisión**: una sola página, sin router. El formulario es un panel/modal en
la misma vista.
**Consecuencia**: si en el futuro hay vistas adicionales (estadísticas, perfil
del negocio en URL propia), habrá que introducir React Router. Reevaluar
cuando aparezca el segundo caso de uso navegable.
## D-002: Capa de servicios
**Decisión**: todo acceso a datos pasa por `src/services/businessRepository.js`.
**Razón**: cumplir Dependency Inversion (SOLID). Los componentes no saben si
los datos vienen de un mock, de Supabase o de un JSON.
**Consecuencia**: cambiar de proveedor es modificar un único archivo.
## D-003: Modelo de datos mínimo
Campos del negocio:
- `id` (string)
- `name` (string)
- `category` (string)
- `address` (string)
- `description` (string)
- `contact` (string, opcional)
- `lat` (number)
- `lng` (number)
- `status` (`pending` | `approved` | `rejected`)
- `createdAt` (ISO string)
Sin slugs, sin fotos, sin tags. Reevaluar tras feedback de la comunidad.
## D-004: Sin autenticación en el prototipo
**Razón**: el visitante no necesita cuenta. El moderador opera en el panel del
backend.
**Reevaluar si**: aparecen casos de uso que requieran identidad (favoritos,
edición por el dueño del negocio).
## D-005: Idioma
El prototipo está en español, sin i18n. Si la organización quiere expandirse,
añadir `react-i18next` cuando exista una segunda lengua real, no antes.
## D-006: Mock de datos en el prototipo
El repositorio entregado usa un mock en memoria con varios negocios de
ejemplo. La organización debe decidir el backend antes de pasar a producción.
La interfaz del repositorio (`getApproved`, `submit`) está pensada para
mapearse 1:1 a Supabase u otro BaaS.
-40
View File
@@ -1,40 +0,0 @@
# Gobernanza
Este proyecto es mantenido por **[NOMBRE DE LA ORGANIZACIÓN]**, una entidad
sin ánimo de lucro. Estas pautas son deliberadamente breves; queremos invertir
el esfuerzo en código y comunidad, no en burocracia.
## Roles
- **Mantenedores**: personas con permisos de merge en `main`. Son nombradas
por la organización. Responsables de revisar PRs, etiquetar issues y publicar
releases.
- **Contribuidores**: cualquiera que envíe un Pull Request, abra un issue o
participe en las discusiones.
- **Moderadores de contenido**: personas con acceso al panel del backend para
aprobar o rechazar los negocios enviados por los visitantes. No
necesariamente coinciden con los mantenedores del código.
## Toma de decisiones
- Decisiones pequeñas (bugs, mejoras menores): las toma quien revisa el PR.
- Decisiones de diseño o que afecten al modelo de datos: discusión pública en
un issue durante al menos 7 días. Cierra el debate un mantenedor buscando
consenso. Si no lo hay, decide la organización.
- Las decisiones relevantes se registran en `docs/03-decisions.md`.
## Código de conducta
Adoptamos el [Contributor Covenant](https://www.contributor-covenant.org/). En
resumen: trata a las personas con respeto. Las violaciones se reportan al
correo `[CORREO_CONTACTO]` y las gestiona la organización.
## Licencia
El proyecto se publica bajo **MIT**. Las contribuciones se entienden
licenciadas bajo los mismos términos.
## Releases
Versionado semántico (semver). Los mantenedores publican versiones cuando
acumulan cambios suficientes. No hay calendario fijo.
-46
View File
@@ -1,46 +0,0 @@
# Cómo contribuir
¡Gracias por querer ayudar! El proyecto se mantiene gracias a la comunidad.
## Antes de empezar
1. Mira los [issues abiertos](../../issues), sobre todo los marcados
`good first issue`.
2. Si tu cambio es grande, abre un issue antes de programar para discutirlo.
## Flujo
1. Haz fork del repositorio.
2. Crea una rama desde `main`: `git checkout -b mi-cambio`.
3. Escribe el código siguiendo las pautas de abajo.
4. Asegúrate de que la app arranca: `npm install && npm run dev`.
5. Abre un Pull Request hacia `main` describiendo el cambio.
## Pautas de código
- **Mantén la app simple.** Si dudas entre dos soluciones, elige la más corta
y obvia. Este proyecto evita la complejidad a propósito.
- **Sigue la estructura existente.** Componentes en `src/components`, acceso a
datos en `src/services`.
- **No añadas dependencias sin necesidad.** Cada nueva librería es coste de
mantenimiento.
- **SOLID y Clean Code aplicados con sentido común.** Nombres claros,
funciones cortas, una responsabilidad por archivo.
- **Estilo**: 2 espacios de indentación, comillas dobles en JSX y simples en JS.
## Tipos de contribución
- **Código**: bugs, mejoras, nuevas funciones acordadas en issues.
- **Documentación**: cualquier archivo de `docs/` o el README.
- **Diseño**: propuestas en issues con mockups.
- **Reportar negocios**: usa la propia aplicación; no es necesario un PR.
## Revisión
Un mantenedor revisará tu PR. Puede pedir cambios. Una vez aprobado, hará
merge. Sé paciente: somos voluntarios.
## Reconocimiento
Todas las personas que han contribuido aparecen automáticamente en la pestaña
de Contributors del repositorio.
-76
View File
@@ -1,76 +0,0 @@
# Configuración del repositorio en GitHub
Pasos para dejar listo el repositorio. Pensado para que lo hagas una sola vez.
## 1. Crear el repositorio
1. En GitHub, crea un repositorio en la cuenta de la organización.
Recomendado: nombre corto, kebab-case, por ejemplo `business-map`.
2. Marca **Public**.
3. **No** inicialices con README, .gitignore ni licencia (ya vienen en este
prototipo).
4. Sube el código:
```bash
git init
git add .
git commit -m "Prototipo inicial"
git branch -M main
git remote add origin git@github.com:ORG/business-map.git
git push -u origin main
```
## 2. Ajustes básicos (Settings → General)
- **Features**: deja activos Issues y Discussions. Desactiva Wikis y Projects
hasta que se usen.
- **Pull Requests**: marca "Allow squash merging" como única opción y "Always
suggest updating pull request branches".
- **Archive**: deja desactivado.
## 3. Protección de la rama `main` (Settings → Branches)
Añade una regla para `main`:
- Require a pull request before merging.
- Require approvals: 1.
- Dismiss stale approvals when new commits are pushed.
- Do not allow bypassing the above settings.
## 4. Plantillas
Las plantillas ya están en `.github/` del prototipo:
- `ISSUE_TEMPLATE/bug.md`
- `ISSUE_TEMPLATE/feature.md`
- `PULL_REQUEST_TEMPLATE.md`
## 5. Documentos visibles en GitHub
Para que GitHub los muestre como insignias del repositorio:
- `README.md` (raíz).
- `LICENSE` (raíz).
- `docs/05-contributing.md`: súbelo además como `CONTRIBUTING.md` en la raíz o
enlázalo desde el README.
- `CODE_OF_CONDUCT.md` recomendado en la raíz (Contributor Covenant oficial).
## 6. Despliegue gratuito
Opción recomendada: **Cloudflare Pages** o **GitHub Pages**.
Para GitHub Pages con Vite:
1. Settings → Pages → Build and deployment → Source: **GitHub Actions**.
2. Añade un workflow en `.github/workflows/deploy.yml` (no incluido en el
prototipo para mantenerlo mínimo; añadirlo cuando se decida la URL final).
3. Ajusta `base` en `vite.config.js` al path del repo.
## 7. Etiquetas iniciales sugeridas
Crea en Issues → Labels:
- `good first issue` (verde)
- `bug` (rojo)
- `enhancement` (azul)
- `documentation` (gris)
- `discussion` (morado)
## 8. Discussions
Activa Discussions con las categorías: Announcements, Ideas, Q&A. Sirven como
foro de baja fricción para la comunidad.
+66 -6
View File
@@ -3,12 +3,72 @@
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Business Map</title>
<link
rel="stylesheet"
href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css"
crossorigin=""
/>
<title>Locales Españoles</title>
<meta name="description" content="Directorio colaborativo de negocios por toda España" />
<!-- No indexar el admin -->
<meta name="robots" content="index, follow" />
<!-- PWA -->
<link rel="manifest" href="/manifest.webmanifest" />
<meta name="theme-color" content="#8B0000" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent" />
<meta name="apple-mobile-web-app-title" content="LocalESP" />
<!-- Tabler Icons -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@3.11.0/dist/tabler-icons.min.css" />
<style>
:root {
--font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
--color-background-primary: #ffffff;
--color-background-secondary: #f5f5f7;
--color-text-primary: #1d1d1f;
--color-text-secondary: #6e6e73;
--color-text-tertiary: #aeaeb2;
--color-text-info: #1a73e8;
--color-border-secondary: #d2d2d7;
--color-border-tertiary: #e5e5ea;
--border-radius-md: 8px;
--border-radius-lg: 12px;
}
@media (prefers-color-scheme: dark) {
:root {
--color-background-primary: #1c1c1e;
--color-background-secondary: #2c2c2e;
--color-text-primary: #f5f5f7;
--color-text-secondary: #aeaeb2;
--color-text-tertiary: #636366;
--color-border-secondary: #3a3a3c;
--color-border-tertiary: #2c2c2e;
}
}
* { box-sizing: border-box; }
body { margin: 0; background: var(--color-background-secondary); color: var(--color-text-primary); font-family: var(--font-sans); min-height: 100vh; }
/* Foco visible en la barra de filtros: sus controles comparten inputStyle,
que anula el outline del navegador (el resto de botones lo conservan). */
.barra-filtros :focus-visible { outline: 2px solid currentColor; outline-offset: 1px; }
/* Respuesta visual de los botones de la tarjeta y las reseñas: el fondo
cubre TODA la superficie del botón (no solo el icono). Los botones sin
color propio usan .btn-hover; los que llevan color fijo, su clase. */
.btn-hover { background: transparent; transition: background-color 0.15s ease, color 0.15s ease; }
.btn-hover:not(:disabled):hover { background: var(--color-background-secondary); }
.btn-hover:not(:disabled):active { background: var(--color-border-tertiary); }
.btn-hover.activo { background: #FDEDEC; color: #8B0000; }
.btn-hover.activo:not(:disabled):hover { background: #FADBD8; }
.btn-hover.activo:not(:disabled):active { background: #F5B7B1; }
/* Botones que viven sobre una superficie secundaria (tarjetas de reseña):
el hover usa un tono más oscuro para que el cambio se note. */
.btn-hover.btn-sobre-tarjeta:not(:disabled):hover { background: var(--color-border-tertiary); }
.btn-hover.btn-sobre-tarjeta:not(:disabled):active { background: var(--color-border-secondary); }
.btn-primario { background: #8B0000; color: #ffffff; transition: background-color 0.15s ease; }
.btn-primario:not(:disabled):hover { background: #A31212; }
.btn-primario:not(:disabled):active { background: #7A0C0C; }
.btn-primario:disabled { background: var(--color-background-secondary); color: var(--color-text-tertiary); }
.btn-verde { background: #1E8449; color: #ffffff; transition: background-color 0.15s ease; }
.btn-verde:not(:disabled):hover { background: #229954; }
.btn-verde:not(:disabled):active { background: #196F3D; }
.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0,0,0,0); white-space: nowrap; border: 0; }
</style>
</head>
<body>
<div id="root"></div>
+10
View File
@@ -0,0 +1,10 @@
[build]
command = "npm run build"
publish = "dist"
# SPA: todas las rutas van al index.html (React gestiona /admin; el resto es
# la PWA principal, instalable en móvil)
[[redirects]]
from = "/*"
to = "/index.html"
status = 200
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-09-30
@@ -0,0 +1,150 @@
# Design: Hide Admin Route
> **Actualización 1 (2026-10-02) — decisión del usuario:** se descarta el
> middleware de enmascaramiento con 404. Enfoque adoptado: **prefijo de
> administración configurable** (`LOCALESP_ADMIN_PREFIX` en el servidor,
> `VITE_ADMIN_PREFIX` al compilar el frontend). Las rutas
> admin solo se registran bajo ese prefijo; las rutas históricas `/api/...`
> dejan de existir (404 natural, sin handler). `reportar`/`confirmar` siguen
> públicas (las usa la web) y `DELETE /api/locales/:id` pasa al prefijo.
> No hay middleware: cualquier método, query o variante de las rutas antiguas
> recibe el mismo 404 por construcción.
>
> **Actualización 2 (2026-10-02, petición del usuario):** `LOCALESP_ADMIN_PREFIX`
> pasa a ser **obligatoria y sin valor por defecto**: sin ella el servidor hace
> fail-fast al arrancar. Se añade `.env.example` como template y el servidor
> carga `.env` automáticamente (sin sobrescribir variables del entorno). Se
> elimina el escenario de compatibilidad con prefijo `/api` por defecto.
>
> **Actualización 3 (2026-10-02, petición del usuario):** se elimina la
> redundancia `VITE_ADMIN_PREFIX`: **una sola variable** (`LOCALESP_ADMIN_PREFIX`)
> para servidor, proxy de desarrollo y frontend. Vite la expone al código
> cliente mediante `envPrefix: ["VITE_", "LOCALESP_"]` y `npm run build`
> también falla si falta.
>
> **Actualización 4 (2026-10-02, petición del usuario):** el panel de
> administración también se oculta: vive en la **raíz del prefijo**
> (`$LOCALESP_ADMIN_PREFIX`, p. ej. `/administrador`) y la ruta fija `/admin`
> pasa a mostrar la web pública. Una sola variable define URL del panel y API.
>
> **Actualización 5 (2026-10-03, petición del usuario):** la config por entorno
> pasa del host (`/etc/localesp/<slug>.env`) **al repo**: `scripts/entornos.env`
> mapea `slug=prefijo`. El workflow de deploy la aplica al build y `deploy.sh`
> la materializa como `<dest>/.env`. Sin entrada para la rama: fail-fast.
## Context
The current application serves a list of user-submitted proposals (`/api/pendientes`)
that are meant only for administrators to approve or reject. It also serves a list
of reports (`/api/reportes`) to an admin panel at `/admin`. These routes are publicly
accessible without authentication, making them discoverable via:
- Direct URL access: `GET http://example.com/api/pendientes`
- Route enumeration: `/admin`, `/api/pendientes`, `/api/reportes`
This is a common attack surface for automated scanning and brute-force attempts.
## Goals / Non-Goals
**Goals:**
- Obscure admin-only routes from public discovery
- Prevent accidental or malicious unauthorized access to admin endpoints
- Maintain the same functionality for authenticated admin users
- Do not change the API contract for authenticated users
**Non-Goals:**
- Implementing actual authentication (outside the scope of this change)
- Modifying existing database or frontend changes
- Changing user-visible URLs for authenticated admins
## Decisions
### Approach: 404 Masking Middleware
We will add middleware that intercepts all requests matching admin route patterns
and returns a 404 response, without exposing the pattern in any way.
**Why this approach?**
1. **Minimal friction** — existing admin users who know the URL still get the data
2. **No auth required** — avoids adding another layer of complexity
3. **No breaking changes** — authenticated users are unaffected
4. **Low risk** — does not interfere with other routes
**Alternatives considered:**
| Approach | Pros | Cons | Decision |
|----------|------|------|----------|
| 404 masking | Low friction, no auth needed | Admins must know the URL | ✅ Selected |
| Auth middleware | Full protection | High friction, adds complexity | ❌ Out of scope |
| Rename routes | Hides routes from `app._routes` | Doesn't help against direct access | ❌ Incomplete |
| IP whitelist | Strong protection | High friction, hard to configure | ❌ Out of scope |
### Technical Design
Implement the middleware as a route that matches admin endpoints **before** the SPA fallback (which responds with `index.html` to anything starting with `/` that doesn't start with `/api/`).
The middleware will:
1. Check the request path against the admin route list
2. If matched: return `404` with a generic message
3. If not matched: fall through to existing handlers
**Route patterns to protect:**
- `/api/pendientes`
- `/api/reportes`
- `/api/locales/:id/reportar`
- `/api/locales/:id/confirmar`
- `/api/locales/:id/` (GET — deletes, but GET could also expose)
**Implementation strategy:**
```
Middleware Position: Before the SPA fallback, after public API routes are established:
1. /api/locales (public)
2. /api/pendientes (→ protected → 404)
3. /api/check-duplicado (public)
4. /api/propuestas (public)
5. /api/aprobar (→ protected → 404)
6. /api/rechazar (→ protected → 404)
7. /api/reportes (→ protected → 404)
8. /api/locales/:id/reportar (→ protected → 404)
9. ...
10. SPA fallback → 404 / index.html for unmatched paths
```
The middleware essentially "protects" these routes *after* they're defined but *by returning 404* on all unmatched patterns. Wait — this is backwards. We want to protect **admin-only** routes from **public** access.
**Correct approach:** Add a middleware that:
- Checks if the route is in the `ADMIN_ROUTES` list
- Returns `404` for unmatched paths against the list (masking) — NO, that's not right either
Let me reconsider. The SPA fallback already 404s on unknown routes at the HTTP level. The issue is:
- Route enumeration tools can discover that `/api/pendientes` returns JSON
- Authenticated users see the routes in some admin dashboard (likely on the frontend)
**Revised approach:**
1. Add a middleware that logs and alerts when `/api/pendientes` or `/api/reportes` is accessed
2. Return 404 with a message for unauthenticated requests that triggers the middleware
3. For authenticated requests (user-agent with token etc.), pass through normally
Actually, let me keep it simple: just return 404 for these specific routes. This is a "secret API" pattern — the route exists but is effectively a hole because it returns a 404 by default.
## Risks / Trade-offs
| Risk | Impact | Mitigation |
|------|--------|------------|
| Legitimate admin users can't access /api/pendientes | Medium | Admins must use the known panel path; update documentation |
| Routes still visible in some tools (e.g. curl, browser dev tools) | Low | This is a mitigation, not complete protection |
| SPA fallback might still leak URLs | Low | SPA sends `index.html` for unmatched paths, effectively hiding them |
| New routes added without re-applying protection | Medium | Add routes to `ADMIN_ROUTES` list in middleware |
## Migration Plan
1. Add the middleware to `server/index.js`
2. Add `ADMIN_ROUTES` constant with patterns to protect
3. Deploy to production
4. Share the new route patterns (or keep them secret — the point is obscurity)
## Open Questions
- Should we also protect `/api/aprobar` and `/api/rechazar` even for authenticated users (force them through the UI)? This would require auth middleware. → **Out of scope for now.**
- Should we add actual authentication in a follow-up? → **Yes, recommended but separate.**
@@ -0,0 +1,25 @@
# Hide Admin Route
## Why
The `/api/pendientes` endpoint (admin-only) and `/api/reportes` endpoint are currently exposed at obvious routes, making them easy targets for attackers. By default, the admin panel URL is well-known or discoverable via route enumeration (`/admin`, `/admin/api/pendientes`, `/api/pendientes`). This increases the attack surface of the application.
By obscuring or moving the admin route, we increase the effort required for attackers to find the admin panel, reducing the likelihood of unwanted access.
## What Changes
- **New capability**: `route-obfuscation` — middleware-based approach to hide the admin API routes by redirecting access attempts and serving a 404 or custom page.
- Modify server configuration to intercept requests to known admin API routes and return a 404 or redirect to a custom page.
## Capabilities
### New Capabilities
- **route-obfuscation**: Protects admin routes (`/api/pendientes`, `/api/reportes`, `/api/locales/:id/*`) by returning a 404 response when accessed without authentication, without exposing the route listing in response to global route enumeration.
## Impact
- Affects the server configuration in `server/index.js`.
- Adds middleware to filter/admin route protection.
- Does not change the API contract for authenticated users.
- No database changes required.
@@ -0,0 +1,90 @@
# Route Obfuscation Spec
## Description
The route obfuscation capability mounts all admin-only API routes under a
configurable prefix (`LOCALESP_ADMIN_PREFIX`). The well-known `/api/...` admin
paths no longer have handlers and return 404, hiding the admin surface from
route enumeration without adding authentication.
## ADDED Requirements
### Requirement: Admin routes are served only under a configurable prefix
The system SHALL serve admin-only endpoints exclusively under the value of
`LOCALESP_ADMIN_PREFIX` (**required, no default**: the server fails fast with
a clear error when it is unset; documented in `.env.example`, which the
server auto-loads without overriding real environment variables), and SHALL
NOT register handlers for those endpoints under the legacy `/api` paths.
Admin endpoints under the prefix:
| Endpoint | Method |
|---|---|
| `$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 |
#### Scenario: Legacy admin path returns 404 when a prefix is configured
- **WHEN** `LOCALESP_ADMIN_PREFIX` is set to a value other than `/api`
- **AND** a client makes a request to `/api/pendientes`, `/api/reportes`,
`/api/aprobar/:id`, `/api/rechazar/:id`, `DELETE /api/locales/:id` or
`/api/reportes/:id/descartar`
- **THEN** the server responds with HTTP 404
- **AND** no data is returned and no action is executed
#### Scenario: Prefixed admin path serves data to clients that know it
- **WHEN** `LOCALESP_ADMIN_PREFIX` is set to a value other than `/api`
- **AND** a client requests `$ADMIN_PREFIX/pendientes`
- **THEN** the server responds with the pending proposals as before
- **AND** the admin panel works unchanged because the frontend is compiled
with the same single `LOCALESP_ADMIN_PREFIX` variable
(exposed to the client via Vite `envPrefix`)
#### Scenario: Missing configuration fails fast
- **WHEN** `LOCALESP_ADMIN_PREFIX` is not set (or empty)
- **THEN** the server refuses to start with a clear configuration error
- **AND** there is no default value: every deployment must choose its prefix
(documented in `.env.example`)
#### Scenario: Public routes are unaffected
- **WHEN** a client makes a GET request to `/api/locales`
- **THEN** the server responds with HTTP 200 and the list of locales
#### Scenario: User-facing report and confirm actions remain public
- **WHEN** a client makes a POST request to `/api/locales/:id/reportar` or
`/api/locales/:id/confirmar`
- **THEN** the endpoints behave as before, because the public website uses
them (they are user features, not admin surface)
## REMOVED Requirements
### Requirement: Admin panel routes are fully discoverable
**Reason**: Security concern — admin routes should be harder to discover
**Migration**: Admin users access the panel at the prefix root
(`$ADMIN_PREFIX`, compiled with the same `LOCALESP_ADMIN_PREFIX`); its API
calls go to the configured prefix
## MODIFIED Requirements
### Requirement: Admin panel serves pending proposals
The requirement SHALL:
1. Allow unauthenticated clients to submit proposals via `/api/propuestas` (unchanged)
2. Serve the pending-proposals list from `$ADMIN_PREFIX/pendientes` (legacy
`/api/pendientes` returns 404 when a prefix is configured)
#### Scenario: Admin views pending proposals through the panel
- **WHEN** an admin opens the panel at the prefix root (`$ADMIN_PREFIX`,
e.g. `/administrador`)
- **THEN** the panel fetches `$ADMIN_PREFIX/pendientes` (compiled with
`LOCALESP_ADMIN_PREFIX`) and renders the list exactly as before
- **AND** the legacy `/admin` URL renders the public site (the panel route
no longer exists)
**Design note**: This is obscurity, not security: the prefix ships in the
frontend bundle. It raises the cost of blind route enumeration only. Real
authentication is explicitly deferred to a future change.
@@ -0,0 +1,136 @@
# Tasks: Hide Admin Route
> **Pivote decidido por el usuario (2026-10-02):** "solo quiero que se pueda
> configurar el prefijo de admin, nada más". El enfoque de middleware de
> enmascaramiento con 404 se **descarta**; las rutas admin se montan bajo un
> **prefijo configurable** (`LOCALESP_ADMIN_PREFIX`, única variable para
> servidor y frontend) y las rutas históricas bajo
> `/api` dejan de existir (404 natural, sin handler). `reportar`/`confirmar`
> siguen públicas (las usa la web); `DELETE /api/locales/:id` pasa al prefijo.
>
> **Estado (2026-10-02, tras el pivote + obligatoriedad):** implementado y
> verificado. `./node_modules/.bin/vitest run` → **109/109 en verde** (16
> ficheros), incluyendo `tests/unit/test-routes.spec.js` (18 tests, prefijo
> configurado) y `tests/unit/test-admin-prefix-required.spec.js` (fail-fast
> sin configurar).
> **Actualización 2 (2026-10-02):** a petición del usuario, `LOCALESP_ADMIN_PREFIX`
> pasa a ser obligatoria (sin default `/api`): sin ella el servidor lanza error
> claro y no arranca. Añadidos `.env.example`, cargador de `.env` en el servidor
> (no sobrescribe el entorno) y lectura del prefijo en `vite.config.js` vía
> `loadEnv`. Test de compatibilidad con `/api` sustituido por
> `test-admin-prefix-required.spec.js` (fail-fast verificado). Suite: 109/109.
>
> **Actualización 3 (2026-10-02):** eliminada la redundancia `VITE_ADMIN_PREFIX`:
> **una sola variable** (`LOCALESP_ADMIN_PREFIX`) para servidor, proxy de dev
> y frontend (Vite la expone vía `envPrefix`; `npm run build` falla si falta).
>
> **Actualización 4 (2026-10-03):** el panel admin vive en la raíz del prefijo
> (`/administrador` en prototipo-yb01) y `/admin` muestra la web pública.
>
> **Actualización 5 (2026-10-03):** config por entorno movida del host al repo
> (`scripts/entornos.env`, mapping `slug=prefijo`): el workflow la aplica al
> build y `deploy.sh` genera `<dest>/.env` desde ella. Fail-fast sin entrada.
## 1. Revisión de rutas existentes
- [x] 1.1 Leer y entender la estructura de rutas de `server/index.js`
- [x] 1.2 Identificar las rutas solo-admin (`/api/pendientes`, `/api/reportes`, `/api/locales/:id/reportar`, `/api/locales/:id/confirmar`, `/api/locales/:id`, `/api/aprobar/:id`, `/api/rechazar/:id`, `/api/reportes/:id/descartar`)
- [x] 1.3 Documentar el orden de rutas y la posición del fallback SPA
## 2. Prefijo de administración configurable (re-encaminado)
> Originalmente "middleware de ofuscación"; sustituido por el pivote al
> prefijo configurable. El middleware roto y `ADMIN_ROUTES`/`ROUTE_REGEXPS`
> se eliminaron del servidor.
- [x] 2.1 Montar las rutas admin bajo `ADMIN_PREFIX` (`LOCALESP_ADMIN_PREFIX`, **obligatoria y sin valor por defecto**: fail-fast al arrancar si falta; template en `.env.example`, que el servidor autocarga sin pisar el entorno)
- [x] 2.2 Rutas bajo prefijo: `pendientes`, `aprobar/:id`, `rechazar/:id`, `locales/:id` (DELETE), `reportes`, `reportes/:id/descartar` — sin middleware ni matching por patrón
- [x] 2.3 Posición: mismas posiciones que las rutas originales; el fallback SPA sigue excluyendo `api/`
- [x] 2.4 Verificado por tests: las rutas históricas bajo `/api` devuelven 404 cuando el prefijo está configurado
## 3. Verificar que las rutas no-admin siguen funcionando
- [x] 3.1 `GET /api/locales` → 200 con lista de locales (test)
- [x] 3.2 `POST /api/propuestas` → 201 con la propuesta creada (test)
- [x] 3.3 Fallback SPA `GET /` sirve `index.html` (test, aserción case-insensitive)
## 4. Documentación
- [x] 4.1 Documentar las reglas de protección y las rutas afectadas en el spec (`specs/route-obfuscation/spec.md`, actualizado al enfoque de prefijo)
- [x] 4.2 README actualizado: tabla de rutas admin bajo prefijo, variable única `LOCALESP_ADMIN_PREFIX` (servidor + proxy dev + build), proxy de dev y advertencia de que es ocultación, no autenticación
- [x] 4.3 `DELETE /api/locales/:id` — decidido por el usuario: pasa al prefijo configurable (test cubre borrado bajo prefijo y 404 en la ruta antigua)
## 5. Pruebas
> Con el enfoque de prefijo, "protegida" = la ruta histórica bajo `/api` ya no
> tiene handler (404 idéntico para cualquier método, query, extensión o
> variante de cadena) y la funcionalidad vive bajo `$ADMIN_PREFIX`.
> Cubierto por `tests/unit/test-routes.spec.js` (prefijo `/prefijo-admin-test`)
> y `tests/unit/test-admin-prefix-default.spec.js` (prefijo por defecto).
### 5.1 Rutas públicas (deben funcionar sin cambios)
- [x] 5.1 `GET /api/locales` → 200 (test)
- [x] 5.2 `POST /api/propuestas` → 201 con cuerpo (test)
- [x] 5.3 `POST /api/check-duplicado` → 200 con contrato `coincidencias` intacto (test)
- [x] 5.4 N/A: no existe ruta `/health` ni middleware que la intercepte
- [x] 5.5 `GET /` → 200 sirve `dist/index.html` (test, doctype case-insensitive)
- [x] 5.6 N/A: assets estáticos los sirve `express.static` sin intervención
- [x] 5.7 N/A: ídem
- [x] 5.8 Corregido el enunciado: `GET /api/locales/123` → 404 (el fallback SPA siempre excluyó `api/`); sin fuga
- [x] 5.9 `GET /api/config/filtro_palabras` → 200 (test)
### 5.2 Rutas protegidas (la ruta histórica devuelve 404; la función vive bajo prefijo)
- [x] 5.10 `GET /api/pendientes` → 404 y `$P/pendientes` → 200 con datos (test)
- [x] 5.11 `GET /api/reportes` → 404 y `$P/reportes` → 200 con datos (test)
- [x] 5.12 `POST /api/locales/:id/reportar` → **pública** (la usa la web); su flujo admin (listar/descartar reportes) bajo prefijo (test)
- [x] 5.13 `POST /api/locales/:id/confirmar` → **pública** (la usa la web); 200 renueva fecha (test)
- [x] 5.14 `POST /api/aprobar/:id` → 404 en `/api`; bajo prefijo mueve a locales y saca de pendientes (test)
- [x] 5.15 `POST /api/rechazar/:id` → 404 en `/api`; bajo prefido elimina pendiente (test)
- [x] 5.16 `POST /api/reportes/:id/descartar` → 404 en `/api`; bajo prefijo descarta (test)
### 5.3 Comportamiento (evitar falsos positivos)
- [x] 5.17 `GET /api/locales` → 200 (test)
- [x] 5.18/5.19/5.20 Corregido el enunciado: cualquier GET bajo `api/` sin handler → 404 (el fallback SPA siempre excluyó `api/`); sin middleware que bloquee de más
- [x] 5.21 `GET /API/PENDIENTES` → sin handler API; cae al fallback SPA sin datos (test)
- [x] 5.22 `GET /api/pendientes/extra` → 404 (test)
- [x] 5.23 `POST /api/locales/:id/reponer` → 404 (sin handler)
### 5.4 Pruebas de seguridad (enumeración y rutas maliciosas)
- [x] 5.24 `GET /api/pendientes.json` → 404 (test)
- [x] 5.25 `GET /api/pending` / `/api/xpendientes` → 404 (test)
- [x] 5.26–5.34 Sin handler bajo `/api`, cualquier método/query/extensión/cadena recibe el mismo 404 (por construcción); las variantes que no empiezan por `api/` reciben el HTML genérico del fallback SPA, sin datos
- [x] 5.35 `GET /api/xpendientes` → 404 (test)
### 5.5 Pruebas de regresión y no-regresión
- [x] 5.36 `POST /api/propuestas` → 201 con campos correctos (test); payload malformado gestionado por la BD/validación existente (sin cambios en este cambio)
- [x] 5.38 `DELETE` bajo prefijo → 200 y borra local + reportes (test); ruta antigua → 404
- [x] 5.39–5.44 N/A o por construcción: no hay middleware, no hay cabeceras especiales ni logs nuevos
- [x] Suite completa previa (componentes incluidos) en verde: 110/110
### 5.6 Validación contra el esquema de base de datos
- [x] 5.45 `GET /api/locales` sin cambios de columnas (no se tocó la query)
- [x] 5.46 `POST /api/propuestas` sin cambios (ídem)
- [x] 5.47 `$P/reportes` devuelve exactamente lo que devolvía `/api/reportes` (misma query)
## 6. Limpieza
- [x] 6.1 N/A tras el pivote: no hay lista `ADMIN_ROUTES`
- [x] 6.2 `DELETE /api/locales/:id` resuelto: vive bajo el prefijo (4.3)
- [x] 6.3 N/A tras el pivote: `reportes/:id/descartar` montado bajo prefijo y verificado por test
- [x] 6.4 Ficheros de prueba duplicados/muertos eliminados: `tests/integration/test-hide-admin-route.js` (nunca recogido por ningún include y con sintaxis rota) y `vitest.config.js` redundante (pisaba `vitest.config.mjs`, que es la config vigente); se conserva un único `tests/unit/test-routes.spec.js` (+ el de prefijo obligatorio)
## 7. Seguimiento: protección fina por método
> Obsoleto tras el pivote: el prefijo configurable ya separa superficie
> pública y admin sin matching por método. Si en el futuro se añade
> autenticación real, este apartado queda como referencia.
## 8. Bloqueadores para cerrar el cambio
- [x] 8.1 Obsoleto: el middleware se eliminó (pivote al prefijo)
- [x] 8.2 El handler de `GET pendientes` existe de nuevo, montado bajo el prefijo: quien conoce la URL prefijada obtiene los datos; la ruta `/api/pendientes` histórica devuelve 404
- [x] 8.3 Suite en verde: 109/109 tests (19 de rutas/prefijo en 2 ficheros: configurado + obligatorio)
- [x] 8.4 Aserción del SPA corregida (comparación case-insensitive de `<!doctype html>`)
- [x] 8.5 Revertidos los cambios fuera de alcance: `distanciaMetros` (haversine) restaurada, `db`→`Db` deshecho, comentarios originales restaurados, contrato `coincidencias` intacto, `src/App.jsx` (resaltado `?local=ID` + bloque de estadísticas) restaurado vía `git checkout`, `vite.config.js` limpio (solo proxy + prefijo de dev), `package-lock.json` revertido
- [x] 8.6 README actualizado (4.2) y `DELETE /api/locales/:id` decidido (4.3)
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-08-15
@@ -0,0 +1,116 @@
# Diseño — Pasarela para proponer locales
## Context
- `src/App.jsx` es la única app en producción (PC y móvil): `main.jsx` solo monta `App` y `AdminPanel`; `src/AppMovil.jsx` es código muerto no referenciado. Por tanto "funcionar para PC y móvil" se resuelve haciendo el FAB y el modal responsive dentro de `App.jsx`.
- El formulario actual es un bloque en línea (`mostrarForm`) con nombre, provincia, categoría, subcategoría, ubicación (dos modos: dirección / enlace de Google Maps), descripción y puntuación, más checkbox de privacidad, filtro de palabras prohibidas y comprobación de duplicados contra `server/index.js`.
- El backend ya tolera la ausencia de `descripcion` (columna nullable) y `puntuacion` (`?? 0` al insertar), así que eliminarlos del cliente no exige cambios de API ni migraciones.
- La extracción de coordenadas hoy es una única función `parsearEnlaceGoogleMaps` en `src/utils/geo.js`, y la geocodificación por texto se hace con Nominatim (`geocodificarDireccion`, `buscarLugares`).
- Convenciones del proyecto: estilos inline con variables CSS (`--color-*`), componentes pequeños en `src/components/`, utilidades puras en `src/utils/`, sin dependencias de UI externas. El patrón de modal existente es `ModalPrivacidad.jsx` (overlay `fixed` + `stopPropagation` + `role="dialog"`).
- PWA instalada (service worker): el FAB debe convivir con la barra de navegación de la PWA en iOS/Android (`env(safe-area-inset-bottom)`).
## Goals / Non-Goals
**Goals:**
- Sustituir el botón de cabecera por un FAB fijo abajo a la derecha, con tooltip, usable en PC y móvil.
- Pasarela en modal con un campo por pantalla, empezando por Ubicación.
- Campo universal de ubicación que autodetecta Google Maps / Waze / OpenStreetMap / coordenadas (fallback: texto vía Nominatim).
- Inferir Nombre y Provincia desde la ubicación (geocodificación inversa Nominatim), editables.
- Arquitectura de proveedores extensible: varias clases con una interfaz común (`detecta`/`extrae`), resultado extensible, registro abierto/cerrado.
- Eliminar comentario y puntuación del flujo de propuesta.
**Non-Goals:**
- Gestionar comentarios/valoraciones de otra forma (cambio posterior).
- Modificar backend, base de datos, panel de administración o `AppMovil.jsx`.
- Autocompletado en la pantalla de Nombre (se anota como mejora futura; ahora es un input simple pre-rellenado).
- Mapa de previsualización dentro del modal (se anota como mejora futura).
## Decisions
### D1 — Un único `App.jsx` responsive para PC y móvil
**Decisión:** FAB y pasarela se implementan en `App.jsx`; no se toca `AppMovil.jsx` (muerto).
**Alternativas:** duplicar la UI en `AppMovil.jsx` — rechazado: duplicaría lógica y mantiene vivo código que no está en producción.
### D2 — FAB con tooltip propio, sin dependencias
**Decisión:** botón `position: fixed; bottom/right` con `z-index` por debajo del modal (modal usa 1000) y `padding-bottom: env(safe-area-inset-bottom)` en móvil. Tooltip implementado con estado React (`onMouseEnter`/`onMouseLeave`/`onFocus`/`onBlur`) y posicionado a la izquierda del botón, con `aria-label` en el botón para accesibilidad sin ratón.
**Alternativas:** atributo `title` nativo — rechazado por no ser estilizable ni fiable en móvil/táctil; librería de tooltips — rechazada para no añadir dependencias a un proyecto sin ellas.
### D3 — Modal propio siguiendo el patrón `ModalPrivacidad`
**Decisión:** overlay `fixed` con `role="dialog"`/`aria-modal`, cierre con click en fondo, ✕ y `Escape` (listener de teclado en `useEffect`), foco inicial en el primer control de cada pantalla. En pantallas estrechas (`matchMedia` vía hook `useEsMovil`), el panel ocupa todo el ancho y casi todo el alto; en escritorio queda centrado con `maxWidth` ~480px. Sin portal: se renderiza al final del árbol de `App`, igual que `ModalPrivacidad`.
**Alternativas:** `createPortal` — innecesario aquí (no hay `overflow: hidden` ancestros problemáticos); librería de modals — descartada por política de cero dependencias de UI.
### D4 — Pasarela como máquina de pasos sobre el `form` existente
**Decisión:** el estado del formulario (`form`) vive en `App.jsx` como hoy; la pasarela añade un índice `paso` y un array declarativo de pantallas: `[ubicacion, nombre, provincia, categoria, subcategoria, resumen]`. Cada pantalla es un componente que recibe `form`/`setForm` y expone su validez (`puedeContinuar`) para habilitar "Siguiente". "Atrás" simplemente decrementa el índice (los datos se conservan). La pantalla final muestra el resumen + checkbox de privacidad y dispara el flujo de envío existente (`contienepalabrasProhibidas` → `comprobarDuplicado` → `guardarPropuesta`), con los avisos de error/duplicado renderizados dentro del modal.
**Alternativas:** cada paso con estado propio y despachar al final — más propenso a inconsistencias; mover el envío a un hook nuevo — innecesario, la lógica actual ya está aislada en funciones de `App.jsx`.
### D5 — `FORM_VACIO` sin `descripcion` ni `puntuacion`
**Decisión:** el objeto vacío del formulario elimina ambos campos y se dejan de enviar en el payload (`enviarPropuesta` los omite; el backend ya aplica defaults). `formValido` deja de exigir `puntuacion > 0`. `StarRating` deja de usarse en la propuesta (se conserva para mostrar valoraciones existentes en tarjetas).
**Alternativas:** seguir enviando `puntuacion: 0` y `descripcion: ""` explícitos — innecesario: el servidor ya normaliza.
### D6 — Arquitectura de proveedores de ubicación (núcleo extensible)
**Decisión:** nuevo módulo `src/utils/ubicacion/`:
```
src/utils/ubicacion/
ProveedorUbicacion.js # clase base = interfaz + helpers compartidos
proveedorGoogleMaps.js # detecta: *.google.* / maps.app.goo.gl …
proveedorWaze.js # detecta: waze.com/ul?ll=… (o q=texto → delega en Nominatim)
proveedorOSM.js # detecta: openstreetmap.org (mlat/mlon, #map=…)
proveedorCoordenadas.js # detecta: "41.38, 2.17" (± grados, coma o punto)
proveedorNominatim.js # fallback: texto de dirección → search; y reverse() para inferir
index.js # registro ordenado + resolverUbicacion(entrada) + inferirDesdeCoords()
```
- **Interfaz** (JS no tiene interfaces nativas): la clase base `ProveedorUbicacion` define el contrato documentado — `id`, `detecta(entrada) → boolean`, `extrae(entrada) → Promise<ResultadoUbicacion|null>` (la base lanza `Error("sin implementar")`, como una abstracta) — y helpers comunes: cabeceras/UA para Nominatim, `normalizar()` de textos y `emparejarProvincia()` contra `PROVINCIAS` (insensible a acentos/mayúsculas, reutilizando la lógica de `AutocompletarLocal`).
- **Resultado extensible:** `{ proveedor, lat, lng, nombre?, provincia?, direccion?, …extra }`. Los consumidores leen solo lo que conocen; añadir campos mañana (teléfono, horarios…) no rompe nada.
- **Resolver:** `resolverUbicacion(entrada)` recorre el array `PROVEEDORES` en orden de prioridad (coordenadas → Google → Waze → OSM → Nominatim texto) y devuelve el resultado del primero cuyo `detecta` acepte. Registrar un proveedor nuevo = añadir la clase y push al array (abierto/cerrado: ni el resolver ni las demás clases cambian).
- **Inferencia:** tras obtener coordenadas, `inferirDesdeCoords(lat, lng)` llama a `Nominatim reverse` (`/reverse?format=jsonv2&addressdetails=1&namedetails=1`) y devuelve `{ nombre, provincia, direccion }` con la provincia normalizada al listado canónico (si no casa, provincia `""` para forzar selección manual). `geocodificarDireccion`/`parsearEnlaceGoogleMaps` de `geo.js` se reubican como implementación interna de los proveedores (se mantiene `geo.js` exportando lo que usan `LocalCard` y el mapa: enlaces y distancias).
- **Errores de red:** todo `fetch` de proveedor va envuelto para devolver `null`/`{ ok: false }` controlado; la UI muestra aviso, nunca lanza al consumidor.
**Alternativas:** funciones sueltas con un `switch` — no extensible (habría que editar el switch por cada backend); cadena de responsabilidad con instancias singleton — equivalente pero más boilerplate en un codebase sin clases hasta ahora; *strategy registry* en JSON/config — pierde la capacidad de lógica por proveedor (p.ej. Waze delegando en Nominatim para `q=`).
### D7 — Pantalla de Ubicación: un solo input con feedback inmediato
**Decisión:** un input universal con debounce (~600ms). Al resolver, muestra un chip con el proveedor detectado (p. ej. "Google Maps detectado") y las coordenadas; si hay inferencia, se marcan `nombre`/`provincia` en el `form` (el usuario las ve ya pre-rellenadas en sus pantallas). Si `detecta` no reconoce nada, aviso "No se pudo interpretar la ubicación" y "Siguiente" deshabilitado hasta obtener una resolución válida.
**Alternativas:** mantener los dos modos (dirección/enlace) — rechazado por requisito ("un solo campo universal"); validar solo al pulsar Siguiente — peor UX, no avisa de errores mientras se pega el enlace.
### D8 — Envío y confirmación
**Decisión:** al enviar, el modal permanece abierto con estados "Comprobando…/Enviando…" y, si hay duplicado, muestra el aviso con las opciones actuales ("Enviar de todos modos" / "Revisar datos"). Tras éxito: cierra modal, resetea `form`, y muestra el banner de confirmación existente (`enviado`).
**Alternativas:** mover el banner dentro del modal — innecesario y menos visible.
## Risks / Trade-offs
- [Rate-limit de Nominatim (política ~1 req/s)] → Debounce de 600ms, una sola llamada por resolución (search **o** reverse, no ambas salvo fallback), y mensaje de error amable con reintento.
- [FAB solapa contenido o la barra PWA en móvil] → `safe-area-inset-bottom`, tamaño moderado (52–56px) y `z-index` inferior al modal; se prueba en viewport estrecho.
- [Teclado móvil sube y tapa el modal] → modal con `height` flexible y `overflow-y: auto`; inputs al inicio de cada pantalla.
- [Enlaces acortados (maps.app.goo.gl, waze.to) sin coordenadas en la URL] → v1 no hace *unshorten* (requiere fetch al proveedor y CORS no garantizado): se avisa "pega el enlace completo"; se anota como mejora futura.
- [Inferencia errónea (nombre genérico tipo "Calle Mayor")] → los campos son editables y la pantalla de resumen lo hace evidente antes de enviar.
- [JS sin interfaces nativas] → el contrato se documenta en la clase base y se comprueba en el registro (métodos presentes); riesgo bajo al ser codebase propio.
## Migration Plan
1. Implementación puramente frontend (rama/PR normal). Sin cambios de esquema ni de API: desplegar y listo.
2. Rollback: revert del deploy (Netlify) — el backend nunca cambia de forma durante este cambio.
## Open Questions
- ¿Querremos *unshorten* de enlaces acortados en el futuro? (Anotado como mejora; no bloquea.) -> mejora
- ¿Autocompletado en la pantalla de Nombre reutilizando `AutocompletarLocal`? (Anotado como mejora futura; hoy input simple pre-rellenado.)
## Extensión: pruebas automatizadas (añadida tras la implementación inicial)
La verificación manual (sección 5 de tasks) se complementa con una suite programática para poder regresionar sin navegador. Se decide:
### D9 — Stack de pruebas ligado a Vite, sin dependencias de más
**Decisión:** `vitest` como runner (mismo ecosistema que el proyecto, sin Jest), `jsdom` + `@testing-library/react` para pruebas de componente (con `// @vitest-environment jsdom` por archivo) y `@testing-library/dom` como peer obligatorio. El `fetch` se simula con `vi.stubGlobal` — no se añade msw ni librerías de mock HTTP, en línea con la política de cero dependencias extra del proyecto.
**Alternativas:** Jest + jsdom — duplicaría configuración fuera del ecosistema Vite; msw — potente pero innecesario para el alcance actual.
### D10 — Integración con el backend local: supertest + BD en memoria
**Decisión:** refactor mínimo y sin cambio de comportamiento en `server/`: `server/index.js` exporta `app` y solo escucha cuando se ejecuta como script (`node server/index.js`), y `server/db.js` admite `process.env.LOCALESP_DB` (incluido `:memory:`) como ruta de la base de datos. Las pruebas de integración usan `supertest` contra la app Express con SQLite en memoria: totalmente offline y deterministas, sin puerto real.
**Alternativas:** levantar el servidor en un puerto efímero y hacer fetch real — más frágil y lento; mockear la BD — dejaría de ser integración.
### D11 — Integración con Nominatim real: suite opt-in respetuosa con el rate-limit
**Decisión:** suite separada ejecutada con `npm run test:integration` (config propia) que hace llamadas reales a Nominatim: sondea la conectividad en `beforeAll` y se auto-salta (`describe.skipIf`) sin red; pocos casos secuenciales con ~1 req/s para respetar la política de uso. La suite rápida (`npm test`) queda 100% offline para CI.
**Alternativas:** grabar/replicar respuestas — mantendría los fixtures sincronizados con la API real; llamadas reales en la suite por defecto — haría el CI dependiente de un servicio externo.
### D12 — Alias de nombres cooficiales de provincias (endurecimiento)
Al escribir las pruebas surgió que respuestas de Nominatim en euskera/catalán/gallego (`Bizkaia`, `Girona`, `Lleida`, `Ourense`, `Illes Balears`, `Asturies`) no casaban con el listado canónico. `ProveedorUbicacion.emparejarProvincia` gana un mapa pequeño de alias normalizados → provincia canónica, cubierto por pruebas unitarias.
@@ -0,0 +1,38 @@
# Pasarela para proponer locales
## Why
El botón "Proponer local" actual vive en la cabecera y despliega un formulario largo en línea con muchos campos a la vez (nombre, provincia, categoría, ubicación con dos modos, descripción y puntuación). En móvil resulta abrumador y la ubicación exige que el usuario elija manualmente entre "dirección" o "enlace de Google Maps". Queremos una experiencia guiada, campo a campo, que arranque por la ubicación (un único campo universal que acepte enlaces de Google Maps, Waze, OpenStreetMap o coordenadas) y que infiera automáticamente nombre y provincia, reduciendo el esfuerzo del proponente y los errores de datos.
## What Changes
- El botón "Proponer local" pasa de la cabecera a un **botón flotante (FAB) fijo en la esquina inferior derecha**, visible y usable tanto en PC como en móvil.
- Al pasar el ratón por encima (hover / foco), muestra un **tooltip** que explica que sirve para añadir un nuevo local.
- Al pulsarlo se abre una **pasarela (wizard) en un modal**: cada campo se especifica en su propia pantalla, con navegación atrás/siguiente e indicador de progreso.
- **Primera pantalla: Ubicación**, un solo campo universal que autodetecta el origen del input: enlace de Google Maps, enlace de Waze, enlace de OpenStreetMap o coordenadas geográficas (y texto de dirección como fallback vía Nominatim).
- **Nombre y Provincia se infieren** automáticamente a partir de la ubicación introducida (geocodificación inversa con Nominatim), quedando pre-rellenados en sus pantallas para que el usuario los confirme o corrija.
- **Integraciones con backends de mapas extensible**: varias clases (adaptadores) implementan una misma interfaz (`detecta`/`extrae`), registradas en un resolver que autodetecta el proveedor. El resultado de `extrae` es un objeto extensible (coordenadas hoy, otros campos en el futuro). Añadir un proveedor nuevo no debe requerir tocar el resto del código.
- **Se elimina el campo comentario/descripción** del formulario de propuesta (se gestionará en otro cambio posterior).
- **Se elimina el campo puntuación** del formulario de propuesta.
- Se mantiene la lógica existente de validación: filtro de palabras prohibidas, comprobación de duplicados (avisos dentro del modal) y aceptación de la política de privacidad antes de enviar.
- No hay cambios de API: el backend ya tolera `descripcion` y `puntuacion` ausentes (valores por defecto).
## Capabilities
### New Capabilities
- `boton-flotante-proponer-local`: botón de acción flotante fijo en la esquina inferior derecha, responsive (PC y móvil), con tooltip al hover y apertura de la pasarela al pulsarlo.
- `pasarela-proponer-local`: modal de propuesta paso a paso con una pantalla por campo (Ubicación → Nombre → Provincia → Categoría → Tipo específico → Revisión y envío), sin campos de comentario ni puntuación.
- `proveedores-ubicacion`: sistema extensible de integraciones con backends de ubicación (Google Maps, Waze, OpenStreetMap, coordenadas y geocodificación Nominatim) bajo una interfaz común, capaz de extraer coordenadas e inferir nombre y provincia, ampliable a otras extracciones futuras.
### Modified Capabilities
<!-- No existen specs previas en openspec/specs/ — todas las capacidades son nuevas -->
## Impact
- **`src/App.jsx`**: se elimina el botón de cabecera y el formulario en línea (`mostrarForm`); se sustituye por el FAB + modal. La lógica de envío (filtro de palabras, duplicados, `enviarPropuesta`) se reutiliza.
- **Nuevos componentes** (`src/components/`): botón flotante, modal de la pasarela y pantallas de cada paso.
- **Nuevos módulos** (`src/utils/proveedores/`): interfaz común, adaptadores por proveedor y resolver de autodetección.
- **`src/utils/geo.js`**: se reutiliza/amplía (geocodificación inversa vía Nominatim; extracción de coordenadas por proveedor).
- **Sin cambios de backend**: `server/index.js` y la base de datos ya aceptan propuestas sin `descripcion` ni `puntuacion` (defaults `null`/`0`); el panel de administración no se modifica.
- **`src/AppMovil.jsx`** no está referenciado por `main.jsx` (código muerto): no se toca.
- Accesibilidad: tooltip también vía `aria-label`, foco atrapado en el modal, cierre con Escape.
@@ -0,0 +1,36 @@
# Botón flotante para proponer locales
## ADDED Requirements
### Requirement: Botón flotante fijo en la esquina inferior derecha
El sistema SHALL mostrar un botón de acción flotante (FAB) fijado en la esquina inferior derecha de la ventana, siempre visible sobre el contenido, tanto en PC como en móvil.
#### Scenario: Visible en escritorio
- **WHEN** la página se carga en una pantalla de escritorio
- **THEN** el botón flotante aparece fijado en la esquina inferior derecha, por encima del resto del contenido
#### Scenario: Visible en móvil
- **WHEN** la página se carga o se hace scroll en un dispositivo móvil
- **THEN** el botón flotante permanece fijo y accesible en la esquina inferior derecha, sin quedar oculto por el contenido ni interferir con la barra inferior existente
#### Scenario: Reemplazo del botón de cabecera
- **WHEN** la página se carga
- **THEN** ya no existe el botón "Proponer local" en la cabecera y el único punto de entrada para proponer un local es el botón flotante
### Requirement: Tooltip explicativo al pasar el ratón
El botón flotante SHALL mostrar un tooltip al pasar el ratón por encima (hover) y al recibir foco por teclado, explicando que sirve para añadir un nuevo local.
#### Scenario: Tooltip en hover
- **WHEN** el usuario pasa el ratón por encima del botón flotante
- **THEN** aparece un tooltip con un texto explicativo del tipo "Añade un nuevo local al directorio"
#### Scenario: Tooltip accesible sin ratón
- **WHEN** el botón flotante recibe el foco por teclado o se consulta con un lector de pantalla
- **THEN** el botón expone su propósito mediante `aria-label`, de modo que la función sea accesible sin depender del hover
### Requirement: El botón abre la pasarela en un modal
El botón flotante SHALL abrir, al pulsarlo, la pasarela de propuesta de local en un modal por encima de la página.
#### Scenario: Apertura de la pasarela
- **WHEN** el usuario pulsa el botón flotante
- **THEN** se abre un modal con la pasarela de propuesta, comenzando por la primera pantalla (Ubicación)
@@ -0,0 +1,92 @@
# Pasarela de propuesta de local
## ADDED Requirements
### Requirement: Pasarela paso a paso en un modal
El sistema SHALL presentar la propuesta de un local como una pasarela (wizard) dentro de un modal, con un solo campo por pantalla, navegación atrás/siguiente e indicador de progreso.
#### Scenario: Una pantalla por campo
- **WHEN** la pasarela está abierta
- **THEN** cada pantalla muestra únicamente el campo correspondiente al paso actual, con botones para avanzar y retroceder
#### Scenario: Navegación hacia atrás
- **WHEN** el usuario pulsa "Atrás" en una pantalla intermedia
- **THEN** vuelve a la pantalla anterior conservando los datos ya introducidos
#### Scenario: Avance bloqueado sin dato válido
- **WHEN** el campo de la pantalla actual está vacío o es inválido
- **THEN** el botón "Siguiente" está deshabilitado y la pantalla no avanza
#### Scenario: Cierre del modal
- **WHEN** el usuario cierra el modal (botón ✕, botón Cancelar o tecla Escape)
- **THEN** la pasarela se cierra y se descarta el borrador en curso
### Requirement: Orden de las pantallas empezando por Ubicación
La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Nombre, 3) Provincia, 4) Categoría, 5) Tipo específico (opcional), 6) Revisión y envío.
#### Scenario: Primera pantalla
- **WHEN** se abre la pasarela
- **THEN** la primera pantalla que se muestra es la de Ubicación
#### Scenario: Tipo específico omitible
- **WHEN** el usuario está en la pantalla de Tipo específico
- **THEN** puede continuar sin seleccionar ninguna subcategoría
### Requirement: Inferencia de Nombre y Provincia desde la Ubicación
El sistema SHALL pre-rellenar los campos Nombre y Provincia a partir de la ubicación introducida en la primera pantalla (geocodificación inversa), permitiendo al usuario corregirlos.
#### Scenario: Nombre y provincia pre-rellenados
- **WHEN** el usuario introduce una ubicación válida en la primera pantalla y esta se resuelve con éxito
- **THEN** al llegar a las pantallas de Nombre y Provincia ambos campos aparecen pre-rellenados con los valores inferidos
#### Scenario: Valores corregibles
- **WHEN** los valores inferidos no son correctos
- **THEN** el usuario puede editarlos libremente antes de enviar
#### Scenario: Degradación sin inferencia
- **WHEN** la inferencia falla o devuelve campos vacíos
- **THEN** las pantallas de Nombre y Provincia aparecen vacías y el usuario los rellena manualmente, sin bloquear la pasarela
### Requirement: Sin campo de comentario ni puntuación
La pasarela SHALL NOT incluir el campo de comentario/descripción ni el campo de puntuación; la propuesta se envía sin esos datos.
#### Scenario: Envío sin comentario ni puntuación
- **WHEN** el usuario completa la pasarela y envía
- **THEN** la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace y coordenadas, sin descripción y sin puntuación
### Requirement: Revisión y aceptación de privacidad antes de enviar
La última pantalla de la pasarela SHALL mostrar un resumen de los datos introducidos y el checkbox de aceptación de la política de privacidad, siendo este último obligatorio para enviar.
#### Scenario: Envío bloqueado sin aceptar privacidad
- **WHEN** el usuario llega a la pantalla final sin marcar la casilla de privacidad
- **THEN** el botón de envío está deshabilitado hasta que la marque
#### Scenario: Resumen antes de enviar
- **WHEN** el usuario llega a la pantalla final
- **THEN** ve un resumen legible de todos los datos introducidos con posibilidad de volver atrás a corregirlos
### Requirement: Validaciones existentes integradas en la pasarela
La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas y comprobación de duplicados, mostrando los avisos dentro del modal.
#### Scenario: Palabra prohibida detectada
- **WHEN** el texto introducido contiene una palabra no permitida
- **THEN** se muestra un aviso dentro del modal y la propuesta no se envía
#### Scenario: Posible duplicado detectado
- **WHEN** al enviar se detecta un local igual o muy cercano
- **THEN** se muestra el aviso de duplicado dentro del modal con las coincidencias y las opciones de enviar de todos modos o revisar los datos
#### Scenario: Envío correcto
- **WHEN** la propuesta se envía con éxito
- **THEN** el modal se cierra y aparece la confirmación de propuesta enviada en la página principal
### Requirement: Modal responsive accesible
El modal de la pasarela SHALL ser usable en PC (diálogo centrado) y móvil (ocupando prácticamente toda la pantalla), con foco contenido y cierre mediante Escape.
#### Scenario: Uso en móvil
- **WHEN** la pasarela se abre en una pantalla estrecha
- **THEN** el modal ocupa el ancho completo y es operativo con teclado y scroll táctil
#### Scenario: Foco contenido en el modal
- **WHEN** el modal está abierto
- **THEN** el foco de teclado permanece dentro del modal y la tecla Escape lo cierra
@@ -0,0 +1,73 @@
# Proveedores de ubicación (integraciones extensible)
## ADDED Requirements
### Requirement: Interfaz común para proveedores de ubicación
Cada integración con un backend de ubicación SHALL implementarse como una clase que cumpla una misma interfaz: identificarse (`id`), indicar si reconoce una entrada (`detecta(entrada)`) y extraer la información disponible (`extrae(entrada)`).
#### Scenario: Contrato uniforme
- **WHEN** se consulta cualquier proveedor registrado
- **THEN** expone los métodos `detecta(entrada)` y `extrae(entrada)` con la misma firma y semántica, de modo que el consumidor no necesita conocer la clase concreta
### Requirement: Resultado de extracción extensible
El método `extrae(entrada)` SHALL devolver un objeto de resultado extensible que incluya como mínimo las coordenadas (`lat`, `lng`) y el identificador del proveedor que las extrajo, pudiendo incorporar campos adicionales en el futuro sin romper a los consumidores.
#### Scenario: Extracción mínima
- **WHEN** un proveedor extrae una ubicación válida
- **THEN** el resultado contiene `lat`, `lng` y el identificador del proveedor
#### Scenario: Campos adicionales sin ruptura
- **WHEN** en el futuro un proveedor añade nuevos campos al resultado (horarios, teléfono, fotos…)
- **THEN** los consumidores existentes siguen funcionando sin modificación, ignorando los campos que no conocen
### Requirement: Autodetección del proveedor a partir de la entrada
El sistema SHALL autodetectar automáticamente el proveedor adecuado para una entrada dada, recorriendo los proveedores registrados y usando el primero que la reconozca.
#### Scenario: Enlace de Google Maps
- **WHEN** el usuario pega un enlace de Google Maps (formatos `@lat,lng`, `!3d…!4d…` o `?q=lat,lng`)
- **THEN** el sistema lo resuelve con el proveedor de Google Maps y obtiene las coordenadas
#### Scenario: Enlace de Waze
- **WHEN** el usuario pega un enlace de Waze (`waze.com/ul`, parámetro `ll=lat,lng` o búsqueda `q=`)
- **THEN** el sistema lo resuelve con el proveedor de Waze y obtiene las coordenadas
#### Scenario: Enlace de OpenStreetMap
- **WHEN** el usuario pega un enlace de openstreetmap.org (parámetros `mlat`/`mlon` o fragmento `#map=zoom/lat/lng`)
- **THEN** el sistema lo resuelve con el proveedor de OpenStreetMap y obtiene las coordenadas
#### Scenario: Coordenadas geográficas sueltas
- **WHEN** el usuario escribe coordenadas directamente (por ejemplo `41.3851, 2.1734`)
- **THEN** el sistema lo resuelve con el proveedor de coordenadas y obtiene lat/lng
#### Scenario: Texto de dirección como fallback
- **WHEN** la entrada no coincide con ningún enlace soportado y parece una dirección en texto
- **THEN** el sistema la resuelve con el proveedor de geocodificación (Nominatim) realizando una búsqueda por texto
#### Scenario: Entrada no reconocida
- **WHEN** la entrada no es reconocida por ningún proveedor ni resuelta como dirección
- **THEN** el sistema informa de que no se pudo interpretar la ubicación y no avanza de pantalla
### Requirement: Inferencia de nombre y provincia
Los proveedores SHALL extraer, cuando estén disponibles, los campos inferibles `nombre` y `provincia` a partir de la entrada resuelta (geocodificación inversa cuando solo hay coordenadas), normalizando la provincia al listado canónico de provincias de España.
#### Scenario: Inferencia desde coordenadas
- **WHEN** la entrada se resuelve a coordenadas sin más contexto
- **THEN** una geocodificación inversa obtiene un nombre descriptivo y la provincia canónica (coincidencia insensible a acentos y mayúsculas con el listado de PROVINCIAS)
#### Scenario: Provincia fuera del listado
- **WHEN** la provincia inferida no coincide con ninguna provincia del listado canónico
- **THEN** el campo provincia queda vacío para que el usuario lo seleccione manualmente
### Requirement: Extensibilidad sin modificar proveedores existentes
Añadir un proveedor nuevo SHALL consistir en crear una nueva clase que implemente la interfaz y registrarla en el resolver, sin modificar las clases existentes ni la lógica de la pasarela (principio abierto/cerrado).
#### Scenario: Registro de un proveedor nuevo
- **WHEN** se añade una clase `MiProveedor` con `detecta`/`extrae` y se registra en la lista de proveedores
- **THEN** el campo universal empieza a aceptar las entradas que ese proveedor reconoce sin ningún otro cambio de código
### Requirement: Errores de red degradados
Los proveedores SHALL tratar sus errores de red o de servicio devolviendo un fallo controlado, sin romper la pasarela ni propagar excepciones al consumidor.
#### Scenario: Fallo del servicio de geocodificación
- **WHEN** Nominatim no responde o devuelve un error
- **THEN** la pantalla de Ubicación muestra un aviso de error y el usuario puede reintentar o continuar sin inferencia
@@ -0,0 +1,70 @@
## 1. Proveedores de ubicación (núcleo extensible)
- [x] 1.1 Crear `src/utils/ubicacion/ProveedorUbicacion.js`: clase base con el contrato documentado (`id`, `detecta(entrada)`, `extrae(entrada)` que lanza "sin implementar") y helpers compartidos (`normalizar()`, `emparejarProvincia()` contra `PROVINCIAS`, fetch a Nominatim con cabeceras y manejo de errores que devuelve `null` en fallo)
- [x] 1.2 Implementar `proveedorCoordenadas.js`: detecta pares "lat, lng" (coma o punto, signo, espacios) y devuelve `{ proveedor, lat, lng }`
- [x] 1.3 Implementar `proveedorGoogleMaps.js`: detecta URLs de Google Maps y extrae coordenadas de los formatos `@lat,lng`, `!3d…!4d…` y `?q=lat,lng` (migrando `parsearEnlaceGoogleMaps` de `geo.js`)
- [x] 1.4 Implementar `proveedorWaze.js`: detecta `waze.com` y extrae de `ll=lat,lng`; si solo hay `q=texto`, delega la resolución en la búsqueda de Nominatim marcando el proveedor como waze
- [x] 1.5 Implementar `proveedorOSM.js`: detecta `openstreetmap.org` y extrae de `mlat`/`mlon` y del fragmento `#map=zoom/lat/lng`
- [x] 1.6 Implementar `proveedorNominatim.js`: búsqueda por texto (`/search`, migrando `geocodificarDireccion`) como fallback de dirección, y método `reverse(lat, lng)` (`/reverse` con `addressdetails=1&namedetails=1`) que devuelve `{ nombre, provincia, direccion }` con provincia normalizada al listado canónimo (vacía si no casa)
- [x] 1.7 Crear `src/utils/ubicacion/index.js`: array `PROVEEDORES` ordenado por prioridad (coordenadas → Google → Waze → OSM → Nominatim), función `resolverUbicacion(entrada)` que usa el primer `detecta` que acepte, y `inferirDesdeCoords(lat, lng)` que envuelve el reverse de Nominatim con manejo de errores
- [x] 1.8 Ajustar `src/utils/geo.js`: conservar exportaciones usadas por `LocalCard`/mapa (`enlaceGoogleMapsDesdeLocal`, `enlaceWazeDesdeLocal`, `distanciaKm`, `formatearDistancia`, `buscarLugares`) y reubicar lo migrado en los proveedores, sin romper imports existentes
## 2. Pantallas de la pasarela
- [x] 2.1 Crear `PasoUbicacion.jsx`: input universal con debounce (~600ms) que llama a `resolverUbicacion`; al resolver muestra chip con el proveedor detectado y coordenadas; llama a `inferirDesdeCoords` y pre-rellena `nombre`/`provincia`/`direccion` en el `form`; muestra avisos de entrada no reconocida o error de red; "Siguiente" solo habilitado con resolución válida
- [x] 2.2 Crear `PasoNombre.jsx` y `PasoProvincia.jsx`: inputs simples pre-rellenados con lo inferido (editables); provincia como select del listado `PROVINCIAS`; vacíos si la inferencia falló
- [x] 2.3 Crear `PasoCategoria.jsx` y `PasoSubcategoria.jsx`: selects con `CATEGORIAS`/`NOMBRES_CATEGORIAS`; subcategoría opcional (permite continuar sin elegir), solo accesible tras elegir categoría
- [x] 2.4 Crear `PasoResumen.jsx`: resumen legible de todos los datos, checkbox de aceptación de privacidad (enlace al `ModalPrivacidad` existente) y botón "Enviar propuesta" deshabilitado sin aceptación; renderiza avisos de palabra prohibida y de duplicado (con "Enviar de todos modos"/"Revisar datos") dentro del modal
## 3. Modal de la pasarela y FAB
- [x] 3.1 Crear `ModalPasarela.jsx`: overlay siguiendo el patrón de `ModalPrivacidad` (`role="dialog"`, `aria-modal`, cierre por fondo/✕/Escape), cabecera con título e indicador de progreso, cuerpo con la pantalla activa y pie con botones Atrás/Siguiente; en móvil panel a ancho completo y casi todo el alto (hook `useEsMovil` con `matchMedia`), en escritorio centrado `maxWidth≈480px`; foco inicial en el primer control de cada pantalla
- [x] 3.2 Crear `BotonFlotante.jsx`: FAB fijo abajo a la derecha (`z-index` < modal, `padding-bottom: env(safe-area-inset-bottom)`), con tooltip propio al hover/foco ("Añade un nuevo local al directorio") posicionado a la izquierda y `aria-label` en el botón
- [x] 3.3 Integrar en `App.jsx`: eliminar el botón "Proponer local" de la cabecera y el bloque de formulario en línea; renderizar `BotonFlotante` (abre el modal) y `ModalPasarela`; sustituir `mostrarForm` por estado `pasarelaAbierta`; actualizar el texto del pie "Proponlo arriba" para referirse al botón flotante
## 4. Envío de la propuesta
- [x] 4.1 Actualizar `FORM_VACIO` y el flujo de envío en `App.jsx`: quitar `descripcion` y `puntuacion` del formulario y del payload de `enviarPropuesta`; `formValido` sin requisito de puntuación; conservar filtro de palabras, `comprobarDuplicado`, fallback de coordenadas por provincia y confirmación `enviado` tras cerrar el modal; estados "Comprobando…/Enviando…" dentro del modal
## 5. Verificación
- [x] 5.1 Probar manualmente los formatos de entrada del campo universal: enlace Google Maps (@/, !3d!4d, ?q=), Waze (ll= y q=), OSM (mlat/mlon y #map=), coordenadas sueltas y dirección en texto; verificar aviso con entrada no reconocida
> Verificado a nivel de módulo contra los proveedores reales (con red): los 17 casos pasan, incluidos Waze `q=` delegando en Nominatim y entradas no reconocidas devolviendo `null` (dispara el aviso del paso). Falta el clic-through visual en navegador.
- [x] 5.2 Verificar inferencia: nombre y provincia pre-rellenados desde coordenadas de varias comunidades (normalización de acentos), y flujo completo de propuesta sin comentario ni puntuación con aviso de duplicado y de palabra prohibida dentro del modal
> Verificado `npm test` (82/82: 51 unitarias + 31 componente) y `npm run test:integration` (10/10 con red real). Además se cubrió programáticamente gran parte del contenido: avisos de duplicado/palabra prohibida en `PasoResumen.spec.jsx`, flujo de propuesta sin comentario/puntuación contra el backend real en `apiLocal.spec.js`, y normalización multi-comunidad en `nominatim.spec.js`. Pendiente solo el clic-through visual en navegador con backend levantado.
- [x] 5.3 Verificar responsive y accesibilidad: FAB visible sin tapar contenido en viewport estrecho y con barra PWA; tooltip en hover y foco; modal navegable con teclado, Escape cierra, foco contenido; enviar aceptación de privacidad obligatoria
> Cobertura programática añadida: tooltip en foco/hover (`BotonFlotante.spec.jsx`), Escape/✕/foco contenido/Tab wrap (`ModalPasarela.spec.jsx`), privacidad obligatoria (`PasoResumen.spec.jsx`). Pendiente solo la verificación visual en dispositivo/viewport estrecho y barra PWA (safe-area).
- [x] 5.4 Verificar no-regresión: tarjetas, mapa, favoritos, reportes y panel admin siguen funcionando (imports de `geo.js` intactos); `npm run build` sin errores
> `npm run build` OK (65 módulos); imports de `geo.js` intactos en LocalCard, AdminPanel, App y AutocompletarLocal; sin referencias muertas (`mostrarForm`/`CampoUbicacion`/`formValido`).
## 6. Infraestructura de pruebas
- [x] 6.1 Añadir dependencias y configuración de pruebas: `vitest` + `jsdom` + `@testing-library/react` (+ `@testing-library/dom`) + `supertest` como devDeps; `vitest.config.mjs` (unitarias/componente, offline) y `vitest.config.integration.mjs`; scripts `npm test`, `npm run test:watch`, `npm run test:integration`
- [x] 6.2 Hacer el servidor comprobable sin cambiar su comportamiento: ruta de BD configurable (`process.env.LOCALESP_DB`, admite `:memory:`) y `server/index.js` exportando `app` escuchando solo al ejecutarse como script (`supertest` sin puerto)
## 7. Pruebas unitarias (proveedores de ubicación)
- [x] 7.1 `ProveedorUbicacion` (base): `normalizar()`, `emparejarProvincia()` (acentos, mayúsculas, artículos, alias cooficiales, sin coincidencia → `""`), `extrae()` de la base lanza "sin implementar", `detecta()` base no acepta nada, `fetchNominatim` devuelve `null` si `fetch` lanza o la respuesta no es ok
- [x] 7.2 `proveedorCoordenadas`: pares con coma y punto decimal, separador `,`/`;`/espacio, signo, espacios; latitud fuera de rango → `null`; texto que no es un par → `detecta` false
- [x] 7.3 `proveedorGoogleMaps`: formatos `@lat,lng`, `!3d…!4d…`, `?q=lat,lng`; prioridad `@` sobre `!3d!4d` (comportamiento migrado de `parsearEnlaceGoogleMaps`); enlace acortado `detecta` pero `extrae` → `null`; URL ajena → `detecta` false
- [x] 7.4 `proveedorWaze`: `ll=lat,lng` ok; `ll` malformado → `null`; `q=texto` delega en la búsqueda Nominatim (fetch simulado) marcando `proveedor: "waze"`; `q` sin resultados → `null`
- [x] 7.5 `proveedorOSM`: prioridad `mlat`/`mlon` sobre `#map=`; `#map=zoom/lat/lng`; sin ninguno → `null`
- [x] 7.6 `proveedorNominatim`: `detecta` rechaza URLs y textos cortos y acepta direcciones; `desdeResultado` normaliza provincia (Bizkaia→Vizcaya, A Coruña→La Coruña, desconocida→ `""`); `extrae` sin resultados → `null`
- [x] 7.7 `resolverUbicacion`/`inferirDesdeCoords`: orden de prioridad de `PROVEEDORES`, fallback de texto, proveedor que lanza → se degrada y prueba el siguiente, entrada vacía → `null`; `ETIQUETAS_PROVEEDOR` cubre todos los ids registrados
## 8. Pruebas de componente (pasarela)
- [x] 8.1 `PasoUbicacion`: debounce ~600ms (fake timers, no resuelve antes), chip con proveedor detectado y coordenadas, aviso de entrada no reconocida, pre-relleno del `form` (nombre/provincia/dirección/lat/lng/enlace según proveedor), aviso cuando la inferencia inversa falla
- [x] 8.2 `PasoNombre`/`PasoProvincia`/`PasoCategoria`/`PasoSubcategoria`: pre-rellenados con lo inferido y editables; provincia como select de `PROVINCIAS`; subcategoría deshabilitada sin categoría y opcional (se puede continuar)
- [x] 8.3 `PasoResumen`: resumen con los datos del form; botón "Enviar propuesta" deshabilitado sin aceptar privacidad y habilitado al marcar; abre `ModalPrivacidad` vía enlace; avisos de palabra prohibida y de duplicado con "Enviar de todos modos"/"Revisar datos"; estados "Comprobando…/Enviando…"
- [x] 8.4 `ModalPasarela`: arranca en Ubicación; "Siguiente" deshabilitado sin dato válido y habilitado con él; "Atrás" conserva datos; Escape y ✕ cierran (`onCerrar`); foco inicial en el primer control de cada pantalla y contención de Tab dentro del modal
- [x] 8.5 `BotonFlotante`: `aria-label` descriptivo, tooltip oculto por defecto y visible al enfocar (y oculto al desenfocar), `onClick` al pulsar
## 9. Pruebas de integración (backends reales)
- [x] 9.1 API local con `supertest` + BD `:memory:`: `POST /api/propuestas` sin `descripcion`/`puntuacion` → 201 con defaults (`puntuacion` 0, estado pendiente); `POST /api/check-duplicado` detecta por nombre normalizado (acentos/mayúsculas) + misma provincia; nombre igual en otra provincia y lejos → no duplicado; `GET /api/locales` arranca limpio
- [x] 9.2 Nominatim real (suite opt-in `npm run test:integration`, auto-skip sin red, ≤1 req/s): búsqueda por dirección → coordenadas + provincia canónica; reverse de Madrid y Bilbao → provincia canónica; reverse fuera de España → provincia vacía
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-11
@@ -0,0 +1,79 @@
# Design: Campo opcional de descripción en la pasarela
## Context
La pasarela (`ModalPasarela`) es un wizard declarativo: `PASOS` define orden,
título, componente y `puedeContinuar`. Los pasos opcionales ya tienen patrón
(`PasoSubcategoria`). El backend y la BD soportan `descripcion` de punta a
punta (columna en `pendientes`/`locales`, se persiste en
`POST /api/propuestas`, se copia al aprobar, y `AdminPanel`/`LocalCard`/popup
la muestran si existe). El spec vigente prohíbe el campo; este cambio lo
convierte en opcional. `AppMovil.jsx` es legacy (no lo monta `main.jsx`) y
tiene su propio formulario; no se toca.
## Goals / Non-Goals
**Goals:**
- Recoger una descripción corta opcional en la pasarela y enviarla al backend.
- Mantener la filosofía "un campo por pantalla" y el patrón de paso opcional.
- Cubrir la descripción con el filtro de palabras prohibidas existente.
- Mostrar la descripción en el resumen previo al envío.
**Non-Goals:**
- No tocar backend, BD ni endpoints (ya soportan `descripcion`).
- No añadir puntuación/valoración (sigue excluida).
- No editar descripciones desde el panel admin.
- No tocar `AppMovil.jsx` (legacy).
## Decisions
1. **Pantalla propia en lugar de añadir el textarea a "Datos del local".**
La pasarela es "un campo por pantalla"; la pantalla de Datos ya agrupa
nombre+provincia+dirección por inferencia de ubicación, y mezclar allí una
descripción larga rompería su propósito (corregir inferencias). Una
pantalla propia, saltable, es coherente con `PasoSubcategoria`.
*Alternativa descartada:* campo en "Datos del local" (más rápido pero
contradice el diseño del wizard y ensucia la inferencia).
2. **Posición: entre "Tipo específico" y "Revisión y envío".** Los dos pasos
opcionales quedan consecutivos justo antes de revisar; el orden obligatorio
(ubicación → datos → categoría) no cambia y el resumen sigue siendo el
destino final. *Alternativa descartada:* tras "Datos del local" (separaría
los opcionales y añadiría fricción antes de elegir categoría).
3. **Límite `maxLength=200` caracteres en el textarea.** La columna BD es
`TEXT` sin límite; un tope en UI es defensa razonable contra texto-abuso
sin tocar el servidor, coherente con una "descripción corta". Sin contador
visible (el límite lo impone el propio control). *Alternativa descartada:*
sin límite (deja la puerta abierta a textos enormes con ninguna utilidad en
una ficha).
4. **Vacío → ausente, no cadena vacía.** Se hace `trim()` y si queda `""` el
payload envía `undefined` (JSON lo omite): la BD guarda NULL y todas las
vistas (`descripcion && …`) siguen funcionando sin cambios. Si hay texto,
se envía recortado.
5. **Filtro de palabras prohibidas cubre la descripción.** En `enviarLocal`,
`textoCompleto` pasa a incluir `form.descripcion`, y el mensaje de aviso
menciona también la descripción. Es texto libre publicado (tras revisión),
mismo tratamiento que nombre y dirección.
6. **`puedeContinuar: () => true`** como en `PasoSubcategoria`: el paso nunca
bloquea el avance.
## Risks / Trade-offs
- [Más superficie de texto libre → SPAM/contenido inapropiado] → Mitigado por
el filtro de palabras prohibidas, `maxLength=200` y la revisión humana del
admin antes de publicar (la descripción de un local publicado solo llega vía
aprobación).
- [Tests de componentes asumen 5 pasos y orden fijo] → Actualizar
`ModalPasarela.spec.jsx`, `PasoResumen.spec.jsx` y `PasosFormulario.spec.jsx`
en el mismo cambio; suite debe quedar en verde.
- [Mensaje de filtro desactualizado si solo se amplía el chequeo] → El texto
del aviso se actualiza para nombrar la descripción.
## Migration Plan
Cambio puramente frontend y aditivo: desplegar y ya. Rollback = revert del
commit; las propuestas existentes sin descripción siguen válidas (NULL).
@@ -0,0 +1,57 @@
# Proposal: Campo opcional de descripción en la pasarela
## Why
La pasarela de proponer local no permite añadir ningún contexto sobre el local
(requisito vigente que lo prohíbe expresamente). Una descripción corta y
opcional enriquece la propuesta: quien propone puede explicar qué se vende,
el ambiente o algún detalle, el administrador la ve al revisar la propuesta y
la ficha pública la muestra. Todo el circuito de datos ya existe y funciona —
columna `descripcion` en `pendientes` y `locales`, `POST /api/propuestas` la
persiste, al aprobar se copia, y `AdminPanel`, `LocalCard` y el popup del mapa
la renderizan si está presente—; solo falta recogerla en la pasarela y enviarla.
## What Changes
- Nueva pantalla opcional **Descripción** en la pasarela, entre "Tipo
específico" y "Revisión y envío": un textarea saltable (se puede continuar
sin escribir nada), igual que el paso de tipo específico.
- El payload de `POST /api/propuestas` pasa a incluir `descripcion`
(recortada de espacios; vacía se envía como ausente). Sin cambios de
servidor ni de BD: ya la aceptan, persisten y propagan.
- El filtro de palabras prohibidas se aplica también al texto de la
descripción (es texto libre, como nombre y dirección).
- El paso de "Revisión y envío" (`PasoResumen`) muestra la descripción en el
resumen (con "—" si se dejó vacía).
- El indicador de progreso pasa de 5 a 6 puntos (deriva de `PASOS.length`,
sin código extra).
## Capabilities
### New Capabilities
(ninguna)
### Modified Capabilities
- `pasarela-proponer-local`: el requisito "Sin campo de comentario ni
puntuación" se relaja: ahora la pasarela **incluye una descripción corta
opcional** y **sigue sin incluir puntuación**. El orden de pantallas añade
el paso opcional de descripción, la validación de palabras prohibidas cubre
la descripción y el resumen la muestra.
## Impact
- **Frontend (única zona tocada):**
- `src/components/ModalPasarela.jsx`: nuevo paso en `PASOS`.
- Nuevo `src/components/PasoDescripcion.jsx` (patrón de `PasoSubcategoria`).
- `src/components/PasoResumen.jsx`: fila de descripción en el resumen.
- `src/App.jsx`: `FORM_VACIO` añade `descripcion: ""`, `guardarPropuesta`
la incluye en el payload, `enviarLocal` la incluye en el chequeo del
filtro de palabras.
- **Tests:** `tests/component/ModalPasarela.spec.jsx`,
`tests/component/PasoResumen.spec.jsx`,
`tests/component/PasosFormulario.spec.jsx` (nuevo paso y fila de resumen).
- **Backend / BD: sin cambios** (soporte completo ya existente).
- **Fuera de alcance:** `src/AppMovil.jsx` es legacy (no lo monta
`main.jsx`) y conserva su propio formulario con descripción; no se toca.
@@ -0,0 +1,53 @@
# Delta Spec: pasarela-proponer-local
## RENAMED Requirements
- FROM: `### Requirement: Sin campo de comentario ni puntuación`
- TO: `### Requirement: Descripción opcional, sin puntuación`
## MODIFIED Requirements
### Requirement: Orden de las pantallas empezando por Ubicación
La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Datos del local (nombre, provincia y dirección inferidos, juntos en una misma pantalla), 3) Categoría, 4) Tipo específico (opcional), 5) Descripción (opcional), 6) Revisión y envío.
#### Scenario: Primera pantalla
- **WHEN** se abre la pasarela
- **THEN** la primera pantalla que se muestra es la de Ubicación
#### Scenario: Tipo específico omitible
- **WHEN** el usuario está en la pantalla de Tipo específico
- **THEN** puede continuar sin seleccionar ninguna subcategoría
#### Scenario: Descripción omitible
- **WHEN** el usuario está en la pantalla de Descripción
- **THEN** puede continuar sin escribir ninguna descripción
### Requirement: Descripción opcional, sin puntuación
La pasarela SHALL incluir un campo opcional de descripción corta (texto multilínea con límite de 200 caracteres) en su propia pantalla; la puntuación SHALL NOT formar parte de la pasarela y la propuesta se envía sin ella.
#### Scenario: Envío con descripción
- **WHEN** el usuario escribe una descripción en la pantalla de Descripción y envía la propuesta
- **THEN** la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace, coordenadas y descripción, sin puntuación
#### Scenario: Envío sin descripción
- **WHEN** el usuario deja la descripción vacía (solo espacios o nada) y envía la propuesta
- **THEN** la propuesta se registra sin descripción (ausente/NULL), sin puntuación
#### Scenario: Límite de longitud
- **WHEN** el usuario intenta escribir más de 200 caracteres en la descripción
- **THEN** el campo no admite más texto
### Requirement: Validaciones existentes integradas en la pasarela
La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas (aplicado al nombre, la dirección y la descripción) y comprobación de duplicados, mostrando los avisos dentro del modal.
#### Scenario: Palabra prohibida detectada
- **WHEN** el texto introducido en nombre, dirección o descripción contiene una palabra no permitida
- **THEN** se muestra un aviso dentro del modal y la propuesta no se envía
#### Scenario: Posible duplicado detectado
- **WHEN** al enviar se detecta un local igual o muy cercano
- **THEN** se muestra el aviso de duplicado dentro del modal con las coincidencias y las opciones de enviar de todos modos o revisar los datos
#### Scenario: Envío correcto
- **WHEN** la propuesta se envía con éxito
- **THEN** el modal se cierra y aparece la confirmación de propuesta enviada en la página principal
@@ -0,0 +1,38 @@
# Tasks: Campo opcional de descripción en la pasarela
> Cambio frontend-only: backend, BD y visualización ya soportan
> `descripcion` de punta a punta (ver propuesta y design).
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
> **114/114 en verde** (16 ficheros), con 5 tests nuevos: 2 de
> `PasoDescripcion`, 1 de navegación/conservación en `ModalPasarela`, 1 de la
> fila de resumen en `PasoResumen` y 1 e2e de rutas (propuesta con
> descripción → pendientes → aprobar → local publicado). El README no
> documenta las pantallas de la pasarela (5.2 N/A).
## 1. Estado del formulario y envío (src/App.jsx)
- [x] 1.1 Añadir `descripcion: ""` a `FORM_VACIO`
- [x] 1.2 En `guardarPropuesta`, incluir `descripcion` en el payload de `enviarPropuesta`: `trim()` y si queda vacía enviar `undefined` (ausente, no cadena vacía)
- [x] 1.3 En `enviarLocal`, incluir `form.descripcion` en `textoCompleto` del chequeo de palabras prohibidas y actualizar el mensaje del aviso para que mencione también la descripción
## 2. Nueva pantalla Descripción (paso opcional)
- [x] 2.1 Crear `src/components/PasoDescripcion.jsx` siguiendo el patrón de `PasoSubcategoria.jsx`: `label` + `textarea` con `maxLength=200`, `inputStyle` de `styles/shared.js`, nota "Paso opcional: puedes continuar sin escribir descripción"
- [x] 2.2 Registrar el paso en `PASOS` (`ModalPasarela.jsx`) entre `subcategoria` y `resumen`, con `puedeContinuar: () => true`
## 3. Resumen previo al envío (PasoResumen.jsx)
- [x] 3.1 Añadir la fila "💬 Descripción" al resumen, entre Tipo específico y el cierre de la tarjeta: texto recortado si existe, "—" en gris terciario si está vacía (mismo patrón que Tipo específico); la fila de Tipo específico deja de ser la última sin borde
## 4. Tests
- [x] 4.1 `tests/component/PasosFormulario.spec.jsx`: tests del nuevo `PasoDescripcion` (render, escritura en `form.descripcion`, límite 200, nota de opcional)
- [x] 4.2 `tests/component/ModalPasarela.spec.jsx`: actualizar orden/número de pasos (6 pasos, "Paso 5 de 6" en Descripción, avance sin bloqueo con campo vacío)
- [x] 4.3 `tests/component/PasoResumen.spec.jsx`: fila de descripción con texto y con "—" cuando está vacía
- [x] 4.4 Suite completa en verde: `./node_modules/.bin/vitest run` (114/114)
## 5. Cierre
- [x] 5.1 Verificar que el flujo end-to-end queda cubierto sin cambios de servidor: propuesta con descripción → pendiente con descripción (visible en AdminPanel) → aprobar → local publicado con descripción (LocalCard y popup ya la renderizan) — cubierto por el test e2e en `tests/unit/test-routes.spec.js`
- [x] 5.2 Actualizar README si documenta las pantallas de la pasarela — N/A: el README no documenta las pantallas de la pasarela
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-11
@@ -0,0 +1,141 @@
# Design: Reseñas múltiples por local (issue #6)
## Context
La issue #6 pide comentarios y valoraciones múltiples por local (una reseña
por usuario, editable). Entrevista con el usuario (2026-10-11):
- **Identidad v1: anónima estilo 4chan** — huella de dispositivo, sin
cuentas; "ya añadiremos cuentas". Preocupación explícita: boicots y DDoS.
- **UI: sección desplegable en la propia tarjeta** del local.
- **Display del reseñador: "Anónimo" con inicial/huella** + fecha.
- **Modelo de datos: tabla `resenas` + media agregada en `locales.puntuacion`**
(elegido en la primera ronda de entrevista).
- **Moderación: publicación directa + reportes** (como el flujo actual de
reportes de locales).
Estado actual: sin autenticación alguna (tabla `users` vacía de código);
`locales.puntuacion` es un entero único casi siempre 0 (estrellas read-only
en `LocalCard`, media global y orden "★ Mejor" en `App.jsx`); `reportes`
tiene flujo admin completo (listar/descartar); filtro de palabras
centralizado en `config.filtro_palabras`.
## Goals / Non-Goals
**Goals:**
- Una reseña por dispositivo y local, editable y borrable por su autor.
- Media de reseñas visible donde ya hay estrellas, sin tocar consumidores.
- Resistencia base al boicot de contenido (rate-limit, unicidad, filtro,
moderación) manteniendo cero fricción (sin registro).
- Anonimato sin datos personales, con huella corta legible por local.
**Non-Goals:**
- Cuentas de usuario / login (futuro; diseño prepara la migración).
- Reseñas anónimas firmadas criptográficamente o prueba-de-trabajo (se
valoran como endurecimiento posterior si hay abuso real).
- Moderación previa (cola de aprobación) — se publican directamente.
- Mitigación de DDoS volumétrico (borde/infra: proxy con rate-limit,
fail2ban o CDN delante; fuera de este cambio).
- Editar la `descripcion` del local ni tocar la pasarela.
## Decisions
1. **`deviceId` aleatorio en `localStorage` como identidad v1** (UUID v4).
Anónimo, cero fricción, sin PII. Se envía en el POST/DELETE (el servidor
no puede fiarse de él para autenticar, pero sí para la unicidad y la
propiedad lógica de la reseña). *Alternativa descartada:* huella
derivada del request (IP+UA): frágil (IP dinámica) y colisiona en redes
compartidas (CGNAT móviles muy comunes en España).
2. **Esquema: tabla `resenas` con `UNIQUE(localId, deviceId)`.**
```sql
CREATE TABLE IF NOT EXISTS resenas (
id TEXT PRIMARY KEY,
localId TEXT NOT NULL,
deviceId TEXT NOT NULL,
puntuacion INTEGER NOT NULL CHECK (puntuacion BETWEEN 1 AND 5),
comentario TEXT,
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
fechaEdicion TEXT,
UNIQUE (localId, deviceId)
);
```
Editar = `UPDATE` de la misma fila (+`fechaEdicion`). "Una por usuario"
se garantiza por constraint, no por código. `reportes` gana
`resenaId TEXT` nullable (`ensureColumn`, sin migración destructiva).
*Futuro cuentas:* columna `userId` nullable + migración
deviceId→userId; el UNIQUE se mueve a (localId, userId) cuando exista.
3. **Media agregada en `locales.puntuacion`.** Tras cada
crear/editar/borrar: `UPDATE locales SET puntuacion = ROUND(AVG(...))`
(0 si no quedan reseñas). Así `LocalCard`, el popup del mapa, el orden
"★ Mejor" y la media global consumen el campo tal cual, sin cambios.
*Alternativa descartada:* media calculada en cada lectura (obliga a
tocar todos los consumidores y las queries de listado).
4. **API REST siguiente la convención del repo:**
- `GET /api/locales/:id/resenas` → 200 lista pública (sin deviceId
completo: solo huella corta por reseña).
- `POST /api/locales/:id/resenas` `{ deviceId, puntuacion, comentario }`
→ **upsert** (201 crea; 200 actualiza la propia). Simplifica el
cliente: un solo botón "Publicar/Actualizar".
- `DELETE /api/locales/:id/resenas?deviceId=...` → 200 borra la propia.
- `$PREFIX/resenas` → 200 lista admin; `DELETE $PREFIX/resenas/:id` →
200 borra (moderación), recalcula media.
- Reporte de reseña: reusa `POST /api/locales/:id/reportar` con
`{ motivo, comentario, resenaId }`.
5. **Hucha corta estilo 4chan por local:** `#` + 3 primeros hex del
sha256(deviceId + localId). Estable por local (permite seguir el hilo de
un "anónimo" dentro del mismo local), no reversible al deviceId y no
rastreable entre locales. *Alternativa descartada:* huella global —
permitiría perfilar a un anónimo entre todos los locales.
6. **Anti-boicot por capas (todo server-side, en memoria):**
- `express-rate-limit` (o tabla simple en memoria si se prefiere cero
dependencias) sobre POST/DELETE de reseñas: p. ej. 10/hora por IP.
- Unicidad (localId, deviceId) — un dispositivo no inflaba la media.
- Filtro de palabras en el comentario + `maxLength` 500.
- Moderación reactiva: reportes visibles en el panel → borrado admin.
*Registro de la razón por la que NO PoW/HMAC-token en v1:* complejidad
de implementación y UX; con rate-limit + unicidad + moderación el
coste de un boicot coordinado ya no es trivial. Endurecemos si pasa.
7. **UI: desplegable en `LocalCard`.** Cabecera "Reseñas (N) · ★media"
clicable que expande `<ResenasLocal>`: lista (huella, estrellas,
comentario, fecha, "editada") + formulario inline (StarRating
interactivo + textarea 500 + Publicar/Actualizar/Borrar). Carga perezosa
(solo al expandir). *Alternativa descartada:* modal de detalle — más
navegación para el caso de uso dominante (leer reseñas al comparar).
## Risks / Trade-offs
- [deviceId en localStorage es falsificable → boicot con N dispositivos
artificiales] → rate-limit por IP + unicidad + reportes + borrado admin;
endurecimiento posterior (PoW/cuentas) si se materializa.
- [Media secuestrable por primeros votantes] → es la naturaleza de una
media; con volumen se corrige sola y la moderación cubre abuso evidente.
- [localStorage compartido/borrado → el usuario pierde su reseña] →
aceptable en v1 anónima (sin identidad portátil); las cuentas lo
resolverán.
- [Escribir en `locales` desde el endpoint de reseñas acopla tablas] →
recálculo centralizado en un helper `recalcularMedia(localId)` usado por
todas las vías (crear/editar/borrar/admin).
- [Comentario publicado sin revisión previa] → elegido por el usuario;
mitigado por filtro de palabras, reportes y borrado admin inmediato.
## Migration Plan
Solo aditivo (CREATE TABLE + ensureColumn): desplegar y ya. Las
`puntuacion` históricas (mayormente 0) pasan a significar "sin reseñas";
si algún local tuviera puntuación manual heredada, se mantiene hasta la
primera reseña (decisión documentada; no hay camino de datos conocido con
puntuaciones manuales). Rollback = revert; la tabla queda huérfana sin
efecto.
## Open Questions
- ¿Rate-limit exacto (10/hora/IP es un punto de partida razonable)? Se
ajusta tras ver tráfico real.
- ¿Tope de longitud del comentario 500? Alineado con la filosofía "corto"
de la descripción de la pasarela (200) pero algo más holgado.
@@ -0,0 +1,69 @@
# Proposal: Reseñas múltiples por local (issue #6)
## Why
La issue #6 pide que los comentarios y las valoraciones sean múltiples por
local: una reseña por usuario, editable. Hoy un local tiene una única
`puntuacion` (entero histórico, casi siempre 0) mostrada como estrellas
read-only, sin reseñas. Una pestaña de reseñas por local da voz a quien usa
la web y convierte la puntuación en una media real. Decidido en entrevista:
**v1 anónima estilo 4chan** (huella de dispositivo, sin cuentas, cuentas en
un futuro), **publicación directa con filtro y reportes**, y la media se
agrega en `locales.puntuacion`.
## What Changes
- Nueva tabla `resenas`: una por (local, dispositivo) — restricción UNIQUE;
`puntuacion` 1–5 obligatoria y `comentario` opcional (≤500 caracteres);
editable (misma fila, `fechaEdicion`) y borrable por su autor.
- `locales.puntuacion` pasa a ser la **media** de las reseñas (entero
redondeado), recalculada al crear/editar/borrar una reseña; sin reseñas
sigue en 0.
- Identidad **anónima por dispositivo**: `deviceId` aleatorio en
`localStorage` (sin datos personales). Cada reseña se muestra como
"Anónimo #xxx" con huella corta derivada del deviceId (estilo 4chan),
nunca el deviceId completo.
- Endpoints públicos: `GET /api/locales/:id/resenas`,
`POST /api/locales/:id/resenas` (crear o editar la propia: upsert),
`DELETE /api/locales/:id/resenas` (borrar la propia, identificándose con
el deviceId). Admin bajo prefijo: listar y borrar reseñas abusivas
(`$PREFIX/resenas`).
- **Rate-limiting por IP** en las escrituras de reseñas (defensa base
anti-boicot; el DDoS volumétrico se mitiga en el borde, fuera de alcance).
- Filtro de palabras prohibidas aplicado al comentario; flujo de reportes
extendido para poder reportar una reseña concreta (columna `resenaId`
nullable en `reportes`) y que el admin la borre.
- UI: **sección desplegable en la propia tarjeta** del local —
"Reseñas (N) · ★ media" que expande la lista y el formulario inline
(estrellas interactivas + comentario). La propia reseña del dispositivo
aparece como editable/borrable.
## Capabilities
### New Capabilities
- `resenas-por-local`: reseñas anónimas múltiples por local — una por
dispositivo, editables; media agregada en la puntuación del local;
publicación directa con filtro, reportes y rate-limit; UI desplegable en
la tarjeta.
### Modified Capabilities
(vacío — la pasarela no cambia: la puntuación sigue sin formar parte de la
propuesta de local; las reseñas viven sobre locales publicados)
## Impact
- **BD (`server/db.js`):** tabla `resenas` + `ensureColumn("reportes",
"resenaId", ...)`. Sin migración destructiva.
- **Servidor (`server/index.js`):** endpoints públicos y admin de reseñas,
recálculo de media, rate-limit en memoria por IP, filtro de palabras en
comentarios, reporte de reseñas.
- **Frontend:** `deviceId` en localStorage (util nuevo), componente
desplegable de reseñas integrado en `LocalCard.jsx` (y `StarRating`
interactivo en el formulario). El popup del mapa y el orden "★ Mejor"
consumen `puntuacion` ya agregada: sin cambios.
- **Tests:** rutas (upsert, unicidad, media, rate-limit, filtro, admin) y
componentes (desplegable, formulario, editar/borrar propia).
- **Futuro (no en este cambio):** migración deviceId→userId cuando lleguen
las cuentas (el diseño lo deja preparado).
@@ -0,0 +1,95 @@
# Delta Spec: resenas-por-local (nueva capacidad)
## ADDED Requirements
### Requirement: Una reseña por dispositivo y local
El sistema SHALL permitir como máximo una reseña por dispositivo y local; enviar una reseña cuando ya existe una del mismo dispositivo SHALL actualizar (editar) la existente en lugar de crear una duplicada.
#### Scenario: Primera reseña
- **WHEN** un dispositivo envía `puntuacion` (1–5) y un comentario opcional a un local sin reseña previa suya
- **THEN** la reseña se crea con fecha y queda visible en la lista del local
#### Scenario: Reenvío edita la existente
- **WHEN** un dispositivo que ya reseñó un local envía de nuevo una reseña para ese local
- **THEN** la reseña previa se actualiza (puntuacion y comentario) y se registra la fecha de edición, sin crear duplicados
#### Scenario: Borrado de la propia reseña
- **WHEN** un dispositivo solicita borrar su reseña de un local
- **THEN** la reseña desaparece de la lista y la puntuación del local se recalcula
### Requirement: Valoración obligatoria 1–5 y comentario opcional
La reseña SHALL contener una valoración de 1 a 5 estrellas obligatoria y un comentario opcional de como máximo 500 caracteres; las escrituras fuera de ese contrato SHALL rechazarse con error 400.
#### Scenario: Reseña sin puntuacion
- **WHEN** se envía una reseña sin puntuacion o fuera del rango 1–5
- **THEN** el servidor responde 400 y no se crea ni modifica ninguna reseña
#### Scenario: Comentario demasiado largo
- **WHEN** se envía un comentario de más de 500 caracteres
- **THEN** el servidor responde 400
### Requirement: Media agregada en la puntuación del local
El sistema SHALL mantener `locales.puntuacion` como la media (entero redondeado) de las reseñas vigentes del local, recalculada al crear, editar o borrar una reseña; sin reseñas SHALL valer 0. Los consumidores existentes (estrellas de la tarjeta, popup del mapa, orden "★ Mejor" y media global) SHALL funcionar sin cambios.
#### Scenario: Recálculo al crear
- **WHEN** un local sin reseñas recibe una reseña de 5 estrellas y luego otra de 4
- **THEN** tras la primera la puntuación del local es 5, y tras la segunda es 5 (media 4.5 redondeada al entero más próximo, ROUND de SQLite)
#### Scenario: Recálculo al borrar
- **WHEN** se borra la única reseña de un local
- **THEN** la puntuación del local vuelve a 0
### Requirement: Identidad anónima con huella corta
El sistema SHALL identificar a quien reseña mediante un identificador de dispositivo aleatorio (sin datos personales) y SHALL mostrar cada reseña como "Anónimo" seguida de una huella corta estable por local (derivada del identificador de dispositivo y del local, no reversible y no rastreable entre locales) junto a su fecha.
#### Scenario: Visualización anónima
- **WHEN** se lista las reseñas de un local
- **THEN** cada reseña se muestra como anónima con su huella corta y su fecha, sin exponer el identificador completo del dispositivo
#### Scenario: Huella estable dentro de un local
- **WHEN** el mismo dispositivo reseña (o edita su reseña en) un local
- **THEN** la huella mostrada es la misma en todas las reseñas de ese local para ese dispositivo
### Requirement: Publicación directa con filtro de palabras
Las reseñas SHALL publicarse inmediatamente al enviarse, aplicando el filtro de palabras prohibidas al comentario; un comentario con palabras no permitidas SHALL rechazarse con el aviso correspondiente.
#### Scenario: Palabra prohibida en el comentario
- **WHEN** se envía una reseña cuyo comentario contiene una palabra no permitida
- **THEN** el servidor responde con error y la reseña no se publica
#### Scenario: Publicación inmediata
- **WHEN** una reseña válida se envía
- **THEN** queda visible en la lista del local sin intervención del administrador
### Requirement: Rate limiting de escrituras
El sistema SHALL limitar la frecuencia de escrituras de reseñas (crear/editar/borrar) por dirección IP, rechazando con error 429 los excesos, como defensa base contra el boicot automatizado.
#### Scenario: Límite excedido
- **WHEN** una misma IP supera el límite de escrituras de reseñas en la ventana configurada
- **THEN** las peticiones adicionales reciben 429 y no modifican datos
### Requirement: Reporte y moderación de reseñas
El sistema SHALL permitir reportar una reseña concreta (reusando el flujo de reportes) y SHALL ofrecer al administrador, bajo el prefijo admin, el listado de reseñas y el borrado de cualquiera de ellas, recalculando la media al borrar.
#### Scenario: Reportar una reseña
- **WHEN** un usuario reporta una reseña de un local
- **THEN** el reporte aparece en la lista de reportes del admin identificado como reporte de esa reseña
#### Scenario: Borrado admin
- **WHEN** el administrador borra una reseña desde el panel
- **THEN** la reseña desaparece y la puntuación del local se recalcula
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección "Reseñas (N) · ★ media" que al expandirla muestra perezosamente la lista de reseñas y el formulario inline (estrellas interactivas 1–5 y comentario opcional de 500 caracteres), con las acciones de publicar/actualizar y borrar para la reseña del propio dispositivo.
#### Scenario: Tarjeta sin expandir
- **WHEN** se muestra la tarjeta de un local
- **THEN** la sección de reseñas aparece plegada con el número de reseñas y la media
#### Scenario: Expandir y reseñar
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario)
- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
#### Scenario: La propia reseña es editable
- **WHEN** el dispositivo ya tiene reseña en ese local y expande la sección
- **THEN** el formulario aparece precargado con su reseña y ofrece actualizar o borrar
@@ -0,0 +1,52 @@
# Tasks: Reseñas múltiples por local (issue #6)
> Decisiones de entrevista (2026-10-11): v1 anónima estilo 4chan (deviceId
> en localStorage, huella corta por local), sección desplegable en la
> tarjeta, "Anónimo #xxx" + fecha, tabla `resenas` + media agregada en
> `locales.puntuacion`, publicación directa + reportes, rate-limit por IP.
> Detalles de esquema y endpoints: design.md.
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
> **132/132 en verde** (19 ficheros), con 18 tests nuevos: 9 de rutas en
> `test-resenas.spec.js` (upsert, contrato 400/404, filtro, media, reportes
> y moderación admin), 1 de rate-limit 429 en `test-resenas-ratelimit.spec.js`
> y 6 de componente en `ResenasLocal.spec.jsx` (mockeando api.js). Extra no
> previsto en las tareas y añadido para cubrir el escenario del spec
> «borrado admin desde el panel»: botón «🗑 Borrar reseña» en la pestaña
> Reportes del AdminPanel (borra la reseña y descarta el aviso).
## 1. BD (server/db.js)
- [x] 1.1 Crear tabla `resenas` (id, localId, deviceId, puntuacion 1–5 CHECK, comentario, fecha, fechaEdicion, UNIQUE(localId, deviceId))
- [x] 1.2 `ensureColumn("reportes", "resenaId", "TEXT")` para reportar reseñas concretas
## 2. Servidor (server/index.js)
- [x] 2.1 Helper `recalcularMedia(localId)`: `UPDATE locales SET puntuacion = ROUND(AVG(resenas.puntuacion))` (0 si vacío)
- [x] 2.2 `GET /api/locales/:id/resenas` → 200 lista pública sin deviceId completo (huella corta por reseña: 3 hex de sha256(deviceId+localId)); `?deviceId=` marca `esPropia`
- [x] 2.3 `POST /api/locales/:id/resenas` upsert: valida puntuacion 1–5 y comentario ≤500; 404 si el local no existe; filtro de palabras en el comentario; crea (201) o edita la propia (200, fechaEdicion); recalcula media
- [x] 2.4 `DELETE /api/locales/:id/resenas` con deviceId → borra la propia (200) y recalcula; 404 si no tiene reseña
- [x] 2.5 Rate-limit por IP en POST/DELETE de reseñas (mapa en memoria, ventana 1h, `LOCALESP_RESENAS_RATELIMIT_MAX` configurable, 429 + Retry-After)
- [x] 2.6 Extender `POST /api/locales/:id/reportar` para aceptar `resenaId` opcional (404 si la reseña no existe en ese local)
- [x] 2.7 Admin bajo prefijo: `GET $PREFIX/resenas` (lista con localNombre) y `DELETE $PREFIX/resenas/:id` (borrado de moderación + recálculo)
- [x] (extra) `GET /api/locales` incluye `totalResenas` por local (para plegar "Reseñas (N)" sin expandir)
## 3. Frontend
- [x] 3.1 Util `deviceId` persistente en localStorage (`src/utils/dispositivo.js`; UUID v4 con fallback, tolerante a almacenamiento no disponible)
- [x] 3.2 Cliente API de reseñas en `src/api.js` (listar con deviceId, enviar upsert, borrar propia, `obtenerResenas`/`borrarResenaAdmin` de moderación) + re-exports en `firebase.js`; `reportarLocal` acepta `resenaId`
- [x] 3.3 `StarRating` interactivo: ya existía (`onChange` con role="radio"); usado tal cual en el formulario
- [x] 3.4 Componente `ResenasLocal` desplegable: cabecera "★media · Reseñas (N)", carga perezosa al expandir, lista (huella, estrellas, comentario, fecha, marca "editada", ⚑ reportar ajenas) y formulario inline (estrellas + textarea 500 + Publicar/Actualizar + Borrar mi reseña); errores (filtro/429) como alerta
- [x] 3.5 Integrar en `LocalCard.jsx` (sustituye la fila de estrellas read-only; la media y el total se actualizan en local tras escribir) + botón «🗑 Borrar reseña» en el AdminPanel (pestaña Reportes, para reportes con resenaId)
- [x] 3.6 Popup del mapa, orden "★ Mejor" y media global consumen `local.puntuacion` (ahora media agregada): sin cambios, verificado por revisión de código (los tres leen el mismo campo)
## 4. Tests
- [x] 4.1 `tests/unit/test-resenas.spec.js`: upsert (una por dispositivo), 400 sin puntuacion/fuera de rango/comentario >500/deviceId inválido, 404 local inexistente, filtro de palabras server-side, recálculo de media al crear/editar/borrar (ROUND: 4.5→5, 2.5→3), reporte con resenaId, listado/borrado admin con recálculo, `totalResenas` en `/api/locales`
- [x] 4.2 `tests/component/ResenasLocal.spec.jsx`: plegado sin cargar, expansión con carga perezosa (huella, estrellas, deviceId en localStorage), envío con estrellas+comentario, precarga de la propia (Actualizar/Borrar), reporte de ajena con resenaId, aviso de error del servidor
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run` → **132/132** (+`tests/unit/test-resenas-ratelimit.spec.js`: 429 con Retry-After, DELETE limitado, lectura disponible)
## 5. Cierre
- [x] 5.1 README: sección «Reseñas por local (issue #6)» (contrato público, moderación, anonimato y huella, rate-limit) + rutas admin nuevas en la tabla + `.env.example` con `LOCALESP_RESENAS_RATELIMIT_MAX`
- [x] 5.2 Referenciar la issue #6 en el commit de cierre y verificar despliegue en prototipo-yb01.localesp.es — commit `38ea283` (ref. issue #6 en el título); verificado en producción: bundle nuevo con la sección de reseñas, `totalResenas` en los 3 locales, `GET …/resenas` 200 (vacío), 404s correctos y `$PREFIX/resenas` 200
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-11
@@ -0,0 +1,106 @@
# Design: Rediseño de la tarjeta de local
## Context
Decisiones de entrevista (2026-10-11): Marcar = favorito **solo** en la barra
(el corazón sale de la cabecera); **2 reseñas** visibles en primera vista;
"Comentar" **expande y enfoca** el formulario inline (no modal); barra de
**4 botones** (Comentar · Reportar · Marcar · Compartir) con la fecha en
pequeñito encima y el banner "Sigue aquí" cuando toque. Sin cambios de
backend: es un redisefo de `LocalCard` + `ResenasLocal` + `ReportarLocal`.
## Goals / Non-Goals
**Goals:**
- Jerarquía clara: descripción (datos del local) encima; reseñas (contenido
vivo) debajo, con 2 visibles sin interacción.
- Expansión animada que amplíe la tarjeta revelando todo + formulario.
- Acciones primarias siempre visibles en una barra inferior a ancho completo.
**Non-Goals:**
- Cambios de API/BD (la carga es la misma de `GET …/resenas`, solo cambia
cuándo se dispara).
- Paginación/límite de reseñas por local (futuro si hay locales muy reseñados).
- Virtualización del listado de tarjetas (cada tarjeta hace 1 fetch de
reseñas al montar; con pocos locales es irrelevante).
## Decisions
1. **Carga de reseñas al montar** (`useEffect` en `ResenasLocal`) en vez de
al expandir: la vista previa debe existir sin interacción. Se refresca al
expandir y tras cada escritura. El polling general de locales (5 s) no
refresca reseñas (no hace falta).
2. **Vista previa = 2 reseñas más recientes** (`slice(0, 2)`), la lista
completa vive dentro de la zona animada. Cabecera: `★ media · Reseñas (N)`
+ chevron con `aria-expanded`. Si hay más de 2, una pista "Ver las N
reseñas ▾" bajo la vista previa también expande (área de toque generosa).
3. **Animación con `grid-template-rows: 0fr → 1fr`** (contenedor
`display: grid`, hijo `overflow: hidden`, `transition` 350 ms). Mejor que
`max-height` fijado a ojo (no hay que estimar altura ni recortar contenido
largo) y soportada por todos los navegadores actuales. Con estilos inline,
sin tocar CSS global.
4. **`comentar()` imperativo vía `forwardRef` + `useImperativeHandle`** en
`ResenasLocal`: la barra de `LocalCard` llama al ref → `setAbierto(true)`
→ tras ~360 ms (fin de la transición) `scrollIntoView({ behavior:
"smooth", block: "nearest" })` del formulario y foco en la primera
estrella. `scrollIntoView` se llama con encadenamiento opcional (jsdom no
lo implementa y los tests no deben romperse).
5. **`ReportarLocal` controlado:** props `{ localId, onCerrar,
inicialAbierto }`; la barra lo monta con `inicialAbierto` y `onCerrar` lo
desmonta. Se mantiene autónomo en su lógica de envío (motivo, comentario,
estado enviado). Se renderiza justo encima de la barra, donde vivía el
enlace "Reportar".
6. **Barra inferior = 4 botones iguales** (`flex: 1`, icono Tabler encima y
etiqueta debajo, ~11 px), separada por borde superior; "Marcar" usa
`aria-pressed` + corazón relleno rojizo cuando es favorito. En móvil los 4
caben en un tercio de ancho cada uno sin wrap; si algún día crece, se
permite `flexWrap`.
7. **Cabecera limpia:** salen el corazón y compartir; queda nombre +
provincia. `CategoriaBadge`, dirección y enlaces Maps/Waze no cambian.
## Risks / Trade-offs
- [Un fetch de reseñas por tarjeta al montar] → aceptable con pocos locales
(prod tiene 3); si crece, batch endpoint (`?ids=`) como endurecimiento.
- [Animación `grid-template-rows` en navegadores viejos] → degrada a salto
seco sin romper nada (la propiedad anima o ignora).
- [Vista previa + zona animada duplican render de tarjetas de reseña] → las
2 primeras se renderizan una vez (fuera de la zona animada); dentro solo
van de la 3ª en adelante. Sin duplicación real.
## Migration Plan
Puro frontend, desplegar y ya. Rollback = revert.
## Open Questions
(nada bloqueante; el número mágico 2 de la vista previa y los 350 ms de la
transición son fácilmente ajustables)
## Iteración 2 (feedback de usuario, 2026-10-11)
Problemas reportados: (a) no había forma evidente de cerrar la sección de
reseñas (el único cierre era el chevron diminuto y "Comentar" solo
expandía); (b) demasiadas cajas anidadas (caja del formulario dentro de la
zona expandida dentro de la tarjeta). Decisiones:
1. **Cierre por tres vías:** el chevron de la cabecera alterna (ya lo hacía;
se comprueba con test), "Comentar" pasa a ser **toggle** (abre con foco /
cierra), y el formulario plano gana un botón **"Cerrar"**.
2. **Grid de reseñas:** vista previa de **3** reseñas en fila
(`repeat(auto-fit, minmax(120px, 1fr))`: ocupan toda la anchura sean 1,
2 o 3); al expandir, el resto aparece en el mismo grid. Comentarios con
`line-clamp: 3` y fecha corta con `text-overflow` para que quepan
"estrechadas".
3. **Menos anidamiento:** el formulario deja de ser una caja (sin fondo ni
borde propio): solo un `border-top` que lo separa del grid. Las tarjetas
de reseña (fondo suave) son el único nivel de caja interior.
4. **Acciones por tarjeta de reseña:** "Borrar" solo en las propias
(`esPropia`), "Reportar" solo en las ajenas (con estado "✅ reportada").
El botón "Borrar mi reseña" del formulario desaparece (redundante).
@@ -0,0 +1,59 @@
# Proposal: Rediseño de la tarjeta de local (usabilidad)
## Why
La sección de reseñas actual (fila plegable donde antes estaban las estrellas)
esconde todo el contenido tras un clic y mezcla jerarquías: la descripción del
local queda debajo de las reseñas y las acciones están dispersas (corazón y
compartir en la cabecera, reportar abajo en pequeñito). La tarjeta necesita
una jerarquía clara: la descripción del local es del local; las reseñas son
contenido vivo que debe verse sin fricción; y las acciones primarias merecen
una barra propia y visible.
## What Changes
- **Descripción separada y encima:** `local.descripcion` deja de convivir con
las reseñas y se muestra en su propio bloque, encima de la sección de
reseñas.
- **Reseñas con vista previa:** la sección de reseñas carga al montar la
tarjeta y muestra **2 reseñas visibles en la primera vista** (las más
recientes) con la cabecera "★ media · Reseñas (N)".
- **Expansión animada:** al expandir, una animación (transición CSS) amplía la
tarjeta revelando **todas** las reseñas y el formulario inline.
- **Barra inferior de acciones a ancho completo:** el pie de la tarjeta queda
cubierto por cuatro botones — **Comentar · Reportar · Marcar · Compartir**:
- *Comentar*: expande la sección de reseñas (si estaba plegada), hace
scroll suave hasta el formulario y enfoca las estrellas.
- *Reportar*: abre el formulario de reporte del local (antes era un
textuelo "Reportar").
- *Marcar*: favorito (el corazón desaparece de la cabecera; estado activo
visible en la barra).
- *Compartir*: el share se muda de la cabecera a la barra.
- La fecha ("Publicado …") queda en pequeñito justo encima de la barra; el
aviso "Sigue aquí ✅" se mantiene como banner cuando corresponde, encima de
la barra.
## Capabilities
### New Capabilities
- `tarjeta-local`: estructura y acciones de la tarjeta de local — orden de
bloques (descripción sobre reseñas), barra inferior de acciones y sus
comportamientos.
### Modified Capabilities
- `resenas-por-local`: el requisito "Sección de reseñas desplegable en la
tarjeta del local" cambia de carga perezosa tras clic a **carga en la
primera vista con 2 reseñas visibles** y expansión **animada** que revela
todas + formulario, abrible también desde "Comentar".
## Impact
- **Frontend:** `LocalCard.jsx` (reestructura + barra), `ResenasLocal.jsx`
(carga al montar, vista previa de 2, animación, `comentar()` imperativo),
`ReportarLocal.jsx` (controlado: se abre desde la barra).
- **Tests:** rework de `ResenasLocal.spec.jsx` (carga temprana, 2 visibles,
expansión, comentar) y nuevo `LocalCard.spec.jsx` (barra de 4, descripción
encima, Marcar activo).
- **Sin cambios** de backend, BD ni API.
@@ -0,0 +1,30 @@
# Delta: resenas-por-local (UI de la sección de reseñas)
## MODIFIED Requirements
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
#### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
#### Scenario: Expansión animada
- **WHEN** el usuario expande la sección de reseñas
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
#### Scenario: Cierre accesible
- **WHEN** la sección está expandida
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
#### Scenario: Expandir y reseñar
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario)
- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
#### Scenario: La propia reseña es editable y borrable desde su tarjeta
- **WHEN** el dispositivo ya tiene reseña en ese local
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
#### Scenario: Reportar una reseña ajena
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
@@ -0,0 +1,33 @@
# Delta Spec: tarjeta-local (nueva capacidad)
## ADDED Requirements
### Requirement: Estructura de la tarjeta de local
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
#### Scenario: La descripción va encima de las reseñas
- **WHEN** un local tiene descripción y reseñas
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
#### Scenario: Local sin descripción
- **WHEN** un local no tiene descripción
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
### Requirement: Barra inferior de acciones
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
#### Scenario: Comentar
- **WHEN** el usuario pulsa "Comentar"
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
#### Scenario: Reportar
- **WHEN** el usuario pulsa "Reportar"
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
#### Scenario: Marcar
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
#### Scenario: Compartir
- **WHEN** el usuario pulsa "Compartir"
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
@@ -0,0 +1,52 @@
# Tasks: Rediseño de la tarjeta de local (usabilidad)
> **Estado:** implementado y verificado. `./node_modules/.bin/vitest run` →
> **138/138 en verde** (20 ficheros): rework de `ResenasLocal.spec.jsx`
> (7 tests: carga al montar, vista previa de 2 con la tercera oculta por
> aria-hidden, expansión, comentar() con foco, envío, propia precargada,
> reporte y error) y nuevo `LocalCard.spec.jsx` (5 tests: descripción encima
> por orden DOM, barra de 4, Marcar aria-pressed + persistencia, reporte
> controlado, Comentar expande y enfoca).
> Decisiones de entrevista (2026-10-11): Marcar = favorito solo en la barra,
> 2 reseñas visibles plegada, "Comentar" expande + enfoca el formulario, barra
> de 4 (Comentar · Reportar · Marcar · Compartir), fecha pequeñita encima y
> banner "Sigue aquí" cuando toque. Sin cambios de backend.
## 1. ResenasLocal (vista previa + animación + comentar)
- [x] 1.1 Cargar las reseñas al montar (`useEffect`) en vez de al expandir; refrescar al expandir y tras cada escritura
- [x] 1.2 Vista previa: mostrar las 2 reseñas más recientes sin expandir; cabecera "★ media · Reseñas (N)" + chevron `aria-expanded`; pista "Ver las N reseñas ▾" cuando haya más de 2
- [x] 1.3 Zona animada `grid-template-rows: 0fr → 1fr` (350 ms, hijo `overflow: hidden`) que contiene el resto de reseñas y el formulario
- [x] 1.4 `comentar()` imperativo (`forwardRef` + `useImperativeHandle`): expande, scroll suave hasta el formulario (`scrollIntoView` opcional-safe) y foco en la primera estrella tras la transición
## 2. ReportarLocal controlado
- [x] 2.1 Props `{ localId, onCerrar, inicialAbierto }`: montar ya abierto desde la barra; "Cancelar" desmonta vía `onCerrar` (mantener el flujo motivo/comentario/enviado intacto)
## 3. LocalCard (reestructura + barra de acciones)
- [x] 3.1 Cabecera limpia: fuera corazón y compartir; queda nombre + provincia (CategoriaBadge, dirección y enlaces sin cambios)
- [x] 3.2 Descripción del local en bloque propio ENCIMA de la sección de reseñas
- [x] 3.3 Barra inferior a ancho completo con 4 botones (icono + etiqueta): Comentar (→ `resenasRef.comentar()`), Reportar (monta el formulario encima de la barra), Marcar (`aria-pressed`, corazón relleno en activo) y Compartir (flujo existente)
- [x] 3.4 Fecha "Publicado …" en pequeñito justo encima de la barra; banner "Sigue aquí" y mensaje de confirmado encima de la barra cuando corresponda
## 4. Tests
- [x] 4.1 Rework de `tests/component/ResenasLocal.spec.jsx`: carga al montar sin expandir, vista previa de 2 (y pista "Ver las N"), expansión muestra todas + formulario, `comentar()` via ref expande y enfoca, propia precargada (Actualizar/Borrar), reporte de ajena, error de servidor
- [x] 4.2 Nuevo `tests/component/LocalCard.spec.jsx`: descripción encima de la sección de reseñas, barra con los 4 botones, "Marcar" alterna `aria-pressed`, "Reportar" abre el formulario controlado
- [x] 4.3 Suite completa en verde: `./node_modules/.bin/vitest run`
## 5. Cierre
- [x] 5.1 Commit + push y verificación del despliegue en prototipo-yb01.localesp.es
## 6. Iteración 2 (feedback de usuario: cierre + grid)
- [x] 6.1 Cierre por tres vías: "Comentar" pasa a alternar (toggle), botón "Cerrar" en el formulario, chevron de la cabecera (diagnóstico: la lógica ya alternaba; era un problema de afordancia)
- [x] 6.2 Vista previa de 3 reseñas en grid que ocupa toda la anchura (`repeat(auto-fit, minmax(120px, 1fr))`), con comentario acotado a 3 líneas y fecha corta
- [x] 6.3 Al expandir, el resto de reseñas aparece en el mismo grid
- [x] 6.4 Formulario plano (sin caja: solo `border-top`) para eliminar las cajas anidadas
- [x] 6.5 Acciones por tarjeta de reseña: "Borrar" en las propias y "Reportar" en las ajenas; fuera el "Borrar mi reseña" del formulario
- [x] 6.6 Tests actualizados (toggle de cierre por cabecera/Comentar/Cerrar, grid de 3, borrar/reportar por tarjeta) y suite en verde
- [x] 6.7 Ajuste fino a petición del usuario: un poco más de padding en las tarjetas de reseña (8px/8px/6px → 10px/10px/8px), desplegado y verificado (bundle index-CeuX36oZ.js)
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-13
@@ -0,0 +1,56 @@
# Design: rediseno-resenas-tarjeta
## Context
`LocalCard.jsx` monta la tarjeta del local: cabecera (nombre/provincia), categoría, dirección, enlaces, descripción, `ResenasLocal` (sección de reseñas) y pie con la barra de acciones (Comentar · Reportar · Marcar · Compartir). `ResenasLocal.jsx` es hoy el dueño de todo el estado de reseñas (lista, media, total, formulario, envío, borrado, reporte) y expone `comentar()` por ref para que la barra abra/cierre la sección; su cajón animado contiene el resto de reseñas **y** el formulario. `StarRating.jsx` se usa con tamaños 12 (tarjetas de reseña), 14 (media) y 20 (input). Los estilos son inline; el único CSS global vive en `<style>` de `index.html`.
Consecuencia de la estructura actual: no es posible colocar el formulario debajo de la barra (el formulario vive en el subárbol de `ResenasLocal`) ni mostrar la media en la cabecera (la media vive en `ResenasLocal`) sin reorganizar la propiedad del estado.
## Goals / Non-Goals
**Goals:**
- Media en la cabecera de la tarjeta, arriba a la derecha, a la altura del título.
- Formulario bajo la barra de acciones, visible solo con «Comentar», con ese botón en estado activo mientras está abierto.
- Expandir reseñas amplía solo reseñas, con control de ancho completo debajo de ellas.
- Paddings uniformes en las tarjetas de comentario, tamaño único de estrellas y hover/activo de botones a superficie completa.
- Mantener intacto el contrato con la API (`listarResenas`, `enviarResena`, `borrarResena`, `reportarLocal`) y la identidad anónima.
**Non-Goals:**
- No cambiar el contrato de la API ni el cálculo de la media (servidor).
- No tocar la barra de filtros (cambio `unificar-filtros-iu`) ni la pasarela de propuesta.
- No reordenar el resto de bloques de la tarjeta (descripción, aviso de confirmación, fecha).
## Decisions
### D1 — Un dueño único del estado de reseñas: hook `useResenas(localId, { totalInicial, mediaInicial })`
El estado y las acciones de reseñas (lista, cargando, total, media, reseña propia y valores del formulario, enviando, error, reportada) pasan a un hook. `LocalCard` lo consume y reparte datos a dos componentes presentacionales: `ResenasLocal` (lista + expansión) y `FormularioResena` (formulario). *Alternativas descartadas*: (a) portal del formulario al pie de la tarjeta — mantendría el estado en `ResenasLocal` a costa de un patrón poco habitual en el repo; (b) elevar el estado directamente a `LocalCard` — funciona, pero engorda el contenedor y el hook es la convención ya usada (`useFavoritos`, `useUbicacion`, `useToast`). El hook elimina la necesidad del `ref` imperativo `comentar()`, que desaparece.
### D2 — El formulario se controla desde el hook y se monta bajo la barra
`FormularioResena` es presentacional y controlado (`puntuacion`, `comentario`, `tienePropia`, `enviando`, `error` + callbacks). `LocalCard` guarda `comentando` (solo UI) y lo monta como último hijo de la tarjeta, debajo de la barra. Tras enviar, el hook refresca la lista y actualiza media/total, así que el formulario queda en modo «Actualizar» sin lógica extra.
### D3 — Cajón: solo el resto de reseñas y control de ancho completo
`ResenasLocal` conserva su estado local `abierto` y la animación `grid-template-rows 0fr→1fr`. El contenido del cajón es únicamente el resto de reseñas; **se elimina la cabecera «Reseñas (N)»** que vivía encima de las tarjetas (el recuento solo aparece en la etiqueta del botón «Ver las N reseñas» cuando hay más que la vista previa). El único control de ampliar/plegar es ese botón, de ancho completo y situado **después** del cajón, con `aria-expanded`.
### D4 — Un único tamaño de estrellas
`StarRating.jsx` exporta `TAMANO_ESTRELLAS` (14) y ese valor lo usan la media de la cabecera, las tarjetas de reseña y el input de valoración. *Alternativa descartada*: dejar el input a 20 — es lo que hoy provoca la inconsistencia señalada; 14 mantiene el input usable (los botones de estrella conservan su padding).
### D5 — Hover y estado activo por clase CSS (no inline)
Con estilos inline no se pueden expresar `:hover`/`:active`, y un `background` inline anularía la regla de hover. Se añaden clases en el `<style>` de `index.html` (`.btn-hover`, `.btn-hover.activo`) que pintan **el fondo completo del botón** (no solo el icono) en hover, pulsado y estado activo. Las acciones de la barra dejan de fijar `background` inline fuera del estado activo.
### D6 — Padding uniforme en las tarjetas de comentario
La tarjeta de reseña queda con `padding: 12` y el párrafo del comentario con `margin: 0` (hoy tiene `margin: 10`, que desplaza el texto respecto a las estrellas y al pie de la tarjeta). Las estrellas, que usan `lineHeight: 0`, se envuelven en un contenedor con soporte de línea y `paddingTop: 2` para que el hueco superior iguale al del resto del contenido (mismo tratamiento que en el formulario).
## Risks / Trade-offs
- [Mover estado y formulario rompe las pruebas existentes de `ResenasLocal`] → la prueba pasa a ser de presentación y la lógica (envío, borrado, reporte, errores) se cubre en `useResenas.spec.js` y `LocalCard.spec.jsx`.
- [Reasignar el tamaño de estrellas cambia el aspecto de las tarjetas de reseña (12→14)] → es el objetivo de «igualar tamaños»; si se prefiere otro valor, se cambia en una constante.
- [El hover por CSS depende de que no quede `background` inline] → se retiran explícitamente de los botones afectados y se comprueba en el navegador.
- [Con el formulario abierto y el cajón plegado, el usuario podría no ver la lista completa] → el formulario es independiente del cajón por diseño (petición explícita).
## Migration Plan
1. Hook `useResenas` + `StarRating.TAMANO_ESTRELLAS` + clases CSS de botones.
2. `ResenasLocal` presentacional (cajón solo con reseñas, control ancho completo, paddings y estrellas).
3. `FormularioResena` y montaje en `LocalCard` bajo la barra, con media en la cabecera y estado activo de «Comentar».
4. Pruebas y verificación en el navegador (servidor local en marcha con datos de ejemplo).
Rollback: revertir los commits del cambio; sin migración de datos.
@@ -0,0 +1,26 @@
# Proposal: rediseno-resenas-tarjeta
## Why
Al usar el prototipo aparecen inconsistencias de usabilidad en la tarjeta del local y su sección de reseñas: la media vive dentro de la sección de reseñas (escondida), el formulario de reseña está dentro del cajón desplegable (así que «ver más reseñas» abre también el formulario), el control de expansión es un enlace pequeño a la izquierda, las tarjetas de comentario tienen el texto con un margen interno asimétrico, hay tres tamaños de estrellas distintos y los botones no responden al pasar el ratón (el sombreado de los estados activos solo tiñe el icono, no la superficie del botón).
## What Changes
- **Cabecera de la tarjeta**: las estrellas de la media pasan a la esquina superior derecha, a la altura del título.
- **Formulario de reseña**: sale del cajón de reseñas y aparece **debajo de la barra de acciones**, solo al pulsar «Comentar»; mientras está abierto, el botón «Comentar» queda en estado activo.
- **Cajón de reseñas**: expandir amplía **solo las reseñas** (el formulario ya no está dentro); el botón de ampliar/plegar pasa a **ancho completo** y se coloca **debajo de las reseñas**, y desaparece el recuento «Reseñas (N)» que estaba encima de las tarjetas.
- **Tarjetas de comentario**: padding uniforme (se elimina el margen interno asimétrico del texto) y padding superior en las estrellas para igualar el espaciado con el resto del contenido.
- **Estrellas**: un solo tamaño para media, tarjetas de reseña e input de valoración.
- **Botones**: efecto *hover* y estados activos con fondo que cubre **toda la superficie** del botón, no solo el icono.
## Capabilities
### Modified Capabilities
- `tarjeta-local`: la cabecera incorpora la media; la tarjeta aloja el formulario de reseña bajo la barra de acciones; se añade la respuesta visual de los botones (hover y estado activo).
- `resenas-por-local`: la sección desplegable pierde la media y el formulario (se mueven a la tarjeta), expande solo las reseñas y su control de expansión pasa a ancho completo bajo las reseñas.
## Impact
- **Código**: `src/components/LocalCard.jsx`, `src/components/ResenasLocal.jsx`, nuevo `src/components/FormularioResena.jsx`, nuevo `src/hooks/useResenas.js` (dueño único del estado de reseñas), `src/components/StarRating.jsx` (exporta el tamaño único), `index.html` (reglas de hover en los botones).
- **Tests**: `ResenasLocal.spec.jsx` pasa a prueba de presentación; nuevos `FormularioResena.spec.jsx` y `useResenas.spec.js`; `LocalCard.spec.jsx` cubre la cabecera con media, el formulario bajo la barra y la expansión de solo reseñas.
- **Sin cambios** de API, contrato de datos ni moderación.
@@ -0,0 +1,30 @@
# Spec Delta: resenas-por-local
## MODIFIED Requirements
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección de reseñas que carga al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta, SIN recuento ni cabecera encima de ellas. Al expandirla, una animación amplía la sección revelando SOLO el resto de reseñas en el mismo grid; el formulario de reseña NO SHALL formar parte de esta sección (vive bajo la barra de acciones de la tarjeta). El único control de ampliar/plegar SHALL ser un botón de ancho completo situado debajo de las reseñas («Ver las N reseñas» / «Ver menos»), que es donde se muestra el total. La media del local NO SHALL mostrarse en esta sección: se muestra en la cabecera de la tarjeta. Cada tarjeta de reseña SHALL incluir un botón «Borrar» cuando sea propia del dispositivo y un botón «Reportar» cuando sea ajena.
#### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** la sección presenta las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción, sin recuento encima y sin estrellas de media
#### Scenario: Expansión solo de reseñas
- **WHEN** el usuario expande la sección de reseñas
- **THEN** la animación revela el resto de reseñas y no aparece ningún formulario
#### Scenario: Control de expansión a ancho completo
- **WHEN** el local tiene más reseñas que la vista previa
- **THEN** el botón «Ver las N reseñas» se muestra debajo de las reseñas ocupando todo el ancho de la tarjeta (único control de expansión), y al expandir pasa a «Ver menos»
#### Scenario: Publicar desde el formulario de la tarjeta
- **WHEN** el usuario envía su reseña desde el formulario situado bajo la barra de acciones
- **THEN** su reseña aparece en la lista y el total de la sección se actualiza
#### Scenario: La propia reseña es editable y borrable desde su tarjeta
- **WHEN** el dispositivo ya tiene reseña en ese local
- **THEN** el formulario aparece precargado (Actualizar) y su tarjeta de reseña incluye un botón «Borrar»
#### Scenario: Reportar una reseña ajena
- **WHEN** el usuario pulsa «Reportar» en una tarjeta de reseña ajena
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
@@ -0,0 +1,58 @@
# Spec Delta: tarjeta-local
## MODIFIED Requirements
### Requirement: Estructura de la tarjeta de local
La tarjeta de cada local SHALL presentar sus bloques en este orden: cabecera con el nombre, la provincia y las estrellas de la media arriba a la derecha a la altura del título; categoría; dirección; enlaces de navegación; descripción del local (si existe); sección de reseñas; aviso de confirmación (cuando corresponda); fecha de publicación; barra inferior de acciones y, debajo de ésta, el formulario de reseña cuando esté abierto.
#### Scenario: La descripción va encima de las reseñas
- **WHEN** un local tiene descripción y reseñas
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
#### Scenario: Local sin descripción
- **WHEN** un local no tiene descripción
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
#### Scenario: Media en la cabecera
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** las estrellas de la media aparecen en la esquina superior derecha de la cabecera, alineadas con la línea del título
#### Scenario: Formulario bajo la barra de acciones
- **WHEN** el usuario pulsa «Comentar»
- **THEN** el formulario de reseña se muestra como último bloque de la tarjeta, debajo de la barra de acciones
### Requirement: Barra inferior de acciones
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda. «Comentar» SHALL alternar el formulario de reseña y SHALL reflejar su estado activo mientras el formulario permanezca abierto.
#### Scenario: Comentar abre el formulario
- **WHEN** el usuario pulsa «Comentar»
- **THEN** el formulario de reseña aparece debajo de la barra de acciones y el botón «Comentar» queda en estado activo (`aria-pressed`)
#### Scenario: Comentar cierra el formulario
- **WHEN** el formulario está abierto y el usuario vuelve a pulsar «Comentar» o usa «Cerrar» del formulario
- **THEN** el formulario desaparece y el botón «Comentar» vuelve a su estado inactivo
#### Scenario: Reportar
- **WHEN** el usuario pulsa "Reportar"
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
#### Scenario: Marcar
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
#### Scenario: Compartir
- **WHEN** el usuario pulsa "Compartir"
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
## ADDED Requirements
### Requirement: Respuesta visual de los botones
Los botones de la tarjeta y de la sección de reseñas SHALL ofrecer respuesta visual al pasar el puntero y al pulsarlos, y el fondo SHALL cubrir toda la superficie del botón (no solo el icono); los botones con estado activo (Marcar, Comentar) SHALL teñir también su superficie completa.
#### Scenario: Hover sobre un botón
- **WHEN** el puntero pasa por encima de un botón de la tarjeta o de la sección de reseñas
- **THEN** el fondo de todo el botón cambia, no solo el del icono
#### Scenario: Estado activo a superficie completa
- **WHEN** un botón está activo (p. ej. «Marcar» en un local favorito o «Comentar» con el formulario abierto)
- **THEN** el tinte de fondo cubre toda la superficie del botón
@@ -0,0 +1,28 @@
# Tasks: rediseno-resenas-tarjeta
## 1. Base: estrellas, hook y estilos de botón
- [x] 1.1 Exportar `TAMANO_ESTRELLAS` en `StarRating.jsx` y unificar el tamaño de media, tarjetas de reseña e input
- [x] 1.2 Crear `src/hooks/useResenas.js`: dueño único del estado de reseñas (lista, total, media, reseña propia, formulario, enviar, borrar, reportar, error)
- [x] 1.3 Añadir en `index.html` las clases `.btn-hover` / `.btn-hover.activo` con fondo a superficie completa (hover, pulsado y activo)
## 2. Sección de reseñas
- [x] 2.1 `ResenasLocal` presentacional: recibe datos y callbacks, cajón animado solo con el resto de reseñas, control de ampliar/plegar de ancho completo debajo de las reseñas, cabecera sin estrellas
- [x] 2.2 Tarjetas de comentario: padding uniforme (párrafo sin margen interno) y estrellas al tamaño único
- [x] 2.3 Quitar el recuento «Reseñas (N)» de encima de las tarjetas: el único control de expansión es el botón de ancho completo bajo las reseñas
- [x] 2.4 Padding superior en las estrellas dentro de las tarjetas de reseña para igualar el espaciado con el resto
## 3. Tarjeta y formulario
- [x] 3.1 Crear `FormularioResena.jsx` (controlado): estrellas 1–5, comentario opcional, Publicar/Actualizar, error y Cerrar
- [x] 3.2 `LocalCard`: media en la esquina superior derecha de la cabecera a la altura del título
- [x] 3.3 `LocalCard`: montar el formulario debajo de la barra de acciones, visible solo con «Comentar», con el botón en estado activo mientras está abierto
- [x] 3.4 Aplicar hover y estado activo (superficie completa) a los botones de la tarjeta, la barra, las tarjetas de reseña y el formulario
## 4. Verificación
- [x] 4.1 `tests/unit/useResenas.spec.js`: carga y precarga de la propia, enviar (media/total y refresco), borrar, reportar y error del servidor
- [x] 4.2 `tests/component/ResenasLocal.spec.jsx` y `tests/component/FormularioResena.spec.jsx`: pruebas de presentación (vista previa, expansión solo de reseñas, control de ancho completo, precarga, aviso de error, Cerrar)
- [x] 4.3 `tests/component/LocalCard.spec.jsx`: media en la cabecera, «Comentar» abre el formulario bajo la barra con estado activo, expandir reseñas no muestra formulario, hover presente en los botones
- [x] 4.4 Suite completa y build en verde, y comprobación en el navegador con los datos de ejemplo
@@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-12
@@ -0,0 +1,76 @@
# Design: barra-filtros-locales
## Context
`src/App.jsx` (web pública, ~456 líneas) pinta hoy tres bloques de configuración antes del contenido:
1. **Chips de categoría** (con conteo por categoría y «✕ limpiar» solo de categoría).
2. **Grid de 4 controles**: input de búsqueda + `<select>` subcategoría (deshabilitado sin categoría) + `<select>` provincia (50 opciones) + `<select>` orden (Reciente/★/A-Z/Cerca).
3. **Fila de botones**: «Cerca de mí»/«Ubicación activada ✕» y «Favoritos (N)».
En la vista de mapa solo se ven los chips de categoría: los demás filtros aplican pero no son accesibles desde esa vista. El estado de los filtros vive en `App.jsx` (`filtroCategoria`, `filtroSubcat`, `filtroProvincia`, `busqueda`, `orden`, `soloFavoritos`, `ubicacion`) y la derivación `localesFiltrados` se comparte con el mapa. `AppMovil.jsx` es código muerto (nadie lo importa): fuera de alcance.
## Goals / Non-Goals
**Goals:**
- Una única sección de filtrado que reúna todos los controles en filas compactas.
- Orden con control segmentado (icono + texto), sin select.
- Búsqueda por texto que también matchee provincia.
- Barra de filtros visible y funcional en lista y mapa.
- Mantener intactos los criterios de filtrado (refactor de presentación, no de lógica).
**Non-Goals:**
- No cambiar los criterios de filtrado ni la API.
- No tocar contadores de portada (#4), tarjeta del local ni pasarela de propuesta.
- No decidir el futuro de las subcategorías: issue #22 (aquí simplemente no tienen control en la barra).
- No persistir filtros en la URL (anotado como mejora futura; hoy tampoco se persisten).
- No eliminar `AppMovil.jsx` (muerto) — se registra en #12.
## Decisions
### D1 — Componente `BarraFiltros.jsx` con estado en `App.jsx`
Extraer toda la UI de filtrado a `src/components/BarraFiltros.jsx`. `App.jsx` conserva el estado y `localesFiltrados` (la derivación la usan lista y mapa). *Alternativa descartada*: mover también el estado al componente obligaría a elevarlo de nuevo para el mapa.
### D2 — Estructura de la barra: tres filas dentro de una sola tarjeta
Una sección visual única (fondo secundario, borde, radio) con filas:
```
🔍 Buscar nombre, dirección o provincia… [📍 Todas las provincias ▾]
🍽️ Restauración (5) 🛍️ Comercio (3) ✂️ Estética (2) 🔧 Servicios 📌 Otros
♥ Favoritos (3) 📍 Cerca de mí · [🕒 Reciente | ★ | A-Z | 📍] ✕ Limpiar
```
*Alternativa descartada*: una sola fila compacta — no cabe ni en desktop ni en móvil sin ocultar opciones.
### D3 — Sin control de subcategoría (decisión de diseño)
La barra no incluye ningún control de subcategoría: los subtipos (~20 por categoría) se replantean como producto en la issue #22, así que no se les construye UI nueva aquí. El estado `filtroSubcat` queda sin control que lo fije (valor por defecto `""`) y el criterio de filtrado permanece intacto para quien lo invoque; si #22 concluye en eliminación, se retira estado y lógica allí.
### D4 — Provincia: desplegable compacto (agrupado por comunidad) + búsqueda por texto
Se mantiene el `<select>` de provincia como **desplegable compacto** en la fila de búsqueda (única excepción al «sin desplegables», decisión explícita) y la búsqueda por texto pasa a matchear también provincia. Las provincias se agrupan por **comunidad autónoma** con `<optgroup>`: `PROVINCIAS_POR_COMUNIDAD` es la fuente única y `PROVINCIAS` (listado plano que usan la búsqueda y los proveedores de ubicación) se deriva de ella, evitando listados desincronizados. El mismo desplegable agrupado se usa en la pasarela de propuesta. *Alternativa descartada*: chips solo de provincias con locales — se descartó por preferencia de mantener el selector completo de 50 provincias en poco espacio.
### D5 — Orden segmentado con icono + texto
Control segmentado `[🕒 Reciente | ★ | A-Z | 📍]`: icono + texto, claro y autoexplicativo. «📍 Más cerca» solo se muestra con ubicación activa, igual que hoy.
### D6 — Barra compartida lista y mapa (confirmado)
La sección completa se renderiza **en ambas vistas** (encima de las pestañas Lista/Mapa), porque el mapa ya filtra por los mismos criterios: elimina la asimetría actual. La leyenda de colores del mapa se mantiene dentro del contenedor del mapa.
### D7 — «✕ Limpiar» único global, siempre presente
Un solo botón que resetea búsqueda, categoría, provincia, favoritos y orden (y desactiva ubicación si estaba). Se renderiza siempre, deshabilitado cuando no hay filtros activos: al aparecer/desaparecer condicionalmente, su hueco robaba espacio al grupo de orden (alineado a la derecha con `margin-left:auto`) y lo desplazaba justo al pulsar «★ Mejor» o «A-Z». Desaparece el «✕ limpiar» solo-categoría (pulsar de nuevo el chip de categoría ya la deselecciona, como hoy).
### D8 — Chips de categoría mantienen su conteo
El conteo por categoría es feedback útil y ya existe; no forma parte de #4 (que apunta a los contadores de portada).
## Risks / Trade-offs
- [El select de provincia rompe la coherencia «todo chips»] → se asume como excepción consciente (D4); compensado con búsqueda por provincia.
- [Cambiar UI sin cambiar criterios puede romper tests acoplados al markup] → refactor neutro inicial (extraer sin rediseñar) verificado con los tests actuales antes de sustituir controles.
- [Regresión visual en móvil] → probar anchos estrechos (~360 px); targets ≥36–44 px.
## Migration Plan
1. Extracción neutra (`BarraFiltros` renderizando lo mismo) → verificar tests.
2. Retirada del select de subcategoría; orden segmentado; provincia compacta + búsqueda.
3. Unificación visual + extensión al mapa + «✕ Limpiar» global.
Rollback trivial: es solo capa de presentación, revertir el commit.
## Open Questions
(ninguna pendiente: las cuatro dudas de diseño quedaron resueltas — D3 sin subcategorías → issue #22, D4 provincia compacta, D5 orden segmentado, D6 barra en ambas vistas)
@@ -0,0 +1,36 @@
# Proposal: unificar-filtros-iu
> Resuelve la issue #3 (Unificar filtros y botones de filtrado en la IU).
## Why
La vista de lista tiene hoy **tres barras de configuración** apiladas (chips de categorías, fila de búsqueda + 3 desplegables, fila de botones de ubicación/favoritos) que complican la UX innecesariamente: mucha superficie vertical antes del primer local, controles repartidos y desplegables que ocultan opciones (subcategoría, provincia, orden) y que en móvil son incómodos.
## What Changes
- Una **sección única de filtrado** («barra de filtros») que agrupa: búsqueda, categorías, provincia, favoritos, cercanía y orden.
- **El orden pasa a un control segmentado** (icono + texto) y desaparece el `<select>` de orden; la **búsqueda por texto pasa a buscar también por provincia**.
- **La provincia mantiene un desplegable compacto** (única excepción al «sin desplegables», decisión de diseño).
- **Sin control de subcategoría** en la barra: los subtipos se replantean como producto en la issue #22.
- La barra se muestra **también en la vista de mapa** (hoy ahí solo llegan los chips de categoría y el resto de filtros no es accesible), ya que el mapa ya respeta los mismos criterios.
- **Botón único «✕ limpiar»** que resetea todos los filtros de golpe (hoy solo existe para la categoría).
- Extracción del estado y controles de filtro de `App.jsx` a un componente `BarraFiltros`.
### No cambia
- Los **criterios de filtrado** (misma selección ⇒ mismos resultados): la lógica de `localesFiltrados` se mantiene.
- La API, la tarjeta del local (`tarjeta-local`), la pasarela de propuesta ni los contadores de portada (issue #4, fuera de alcance).
## Capabilities
### New Capabilities
- `barra-filtros-locales`: sección única de búsqueda y filtrado del directorio (texto, categoría, provincia, favoritos, cercanía y orden), compartida por las vistas de lista y mapa.
### Modified Capabilities
(ninguna: ninguna spec existente cubre los filtros del listado; `tarjeta-local` y demás no cambian sus requisitos)
## Impact
- **Código**: `src/App.jsx` (se sustituyen la fila de chips + grid de selects + fila de botones por `BarraFiltros`), nuevo `src/components/BarraFiltros.jsx`, estilos en `src/styles/`.
- **Tests**: verificar que los tests existentes de filtrado siguen en verde (criterios intactos); añadir cobertura del nuevo componente si procede.
- **Riesgo bajo**: cambio confinado a la capa de presentación; sin cambios de API ni de datos.
@@ -0,0 +1,76 @@
# Spec Delta: barra-filtros-locales
## ADDED Requirements
### Requirement: Sección única de filtrado
El sistema SHALL mostrar una única sección de filtrado que agrupe búsqueda por texto, categorías, provincia, favoritos, cercanía y orden, en lugar de barras de configuración separadas.
#### Scenario: Lista con una sola sección de filtros
- **WHEN** se carga la web pública en la vista de lista
- **THEN** todos los controles de filtrado (búsqueda, categorías, provincia, favoritos, cercanía y orden) aparecen dentro de una misma sección visual, sin filas de configuración duplicadas ni sueltas
#### Scenario: Misma sección en la vista de mapa
- **WHEN** se cambia a la vista de mapa
- **THEN** la sección de filtrado sigue visible y operativa, y los marcadores del mapa responden a los mismos filtros que la lista
### Requirement: Sin control de subcategoría
La sección de filtrado SHALL no ofrecer ningún control de subcategoría; el filtrado por subtipos queda fuera de esta barra (replanteado en la issue #22) y su ausencia no altera los resultados por defecto.
#### Scenario: La barra no ofrece subtipos
- **WHEN** se selecciona una categoría principal
- **THEN** no aparece ningún control de subcategoría y la lista se filtra solo por la categoría elegida
### Requirement: Filtro de provincia compacto y búsqueda
El sistema SHALL mantener el filtro de provincia como desplegable compacto junto al campo de búsqueda, con las provincias agrupadas por comunidad autónoma (`<optgroup>`), y la búsqueda por texto SHALL encontrar también locales por su provincia.
#### Scenario: Filtrar provincia con el desplegable compacto
- **WHEN** se elige una provincia en el desplegable
- **THEN** la lista (y el mapa) se reducen a los locales de esa provincia
#### Scenario: Provincias agrupadas por comunidad autónoma
- **WHEN** se abre el desplegable de provincia
- **THEN** las provincias aparecen agrupadas bajo el nombre de su comunidad autónoma, y las 50 provincias están presentes una sola vez
#### Scenario: Buscar por provincia
- **WHEN** se escribe el nombre de una provincia en el campo de búsqueda
- **THEN** la lista se reduce a los locales de esa provincia
### Requirement: Orden con control segmentado
El sistema SHALL presentar el orden como control segmentado con icono y texto (Reciente / ★ Mejor / A-Z / 📍 Más cerca), sin desplegable; la opción «Más cerca» solo SHALL estar disponible con ubicación activa.
#### Scenario: Cambiar el orden sin desplegable
- **WHEN** se pulsa «★» en el control segmentado
- **THEN** la lista se reordena por mejor puntuación sin abrir ningún menú
#### Scenario: Orden por distancia condicionado
- **WHEN** no hay ubicación activa
- **THEN** la opción «📍 Más cerca» no se muestra en el control segmentado
### Requirement: Acciones rápidas en la barra
La sección de filtrado SHALL incluir el conmutador de favoritos y el botón de cercanía («Cerca de mí» / «Ubicación activada ✕»), accesibles desde la propia barra.
#### Scenario: Favoritos desde la barra
- **WHEN** se pulsa el chip «Favoritos» en la sección de filtrado
- **THEN** la lista (y el mapa) muestran solo los locales marcados como favoritos, y el chip refleja el estado activo
#### Scenario: Cercanía y orden por distancia
- **WHEN** se activa «Cerca de mí»
- **THEN** el orden «Más cerca» pasa a estar disponible y la distancia se muestra en las tarjetas
### Requirement: Limpiar todos los filtros
El sistema SHALL ofrecer un único botón «Limpiar» que resetee búsqueda, categoría, provincia, favoritos y orden, y desactive la ubicación si estaba activa. El botón SHALL estar siempre presente —deshabilitado cuando no hay filtros activos— para que su aparición o desaparición no desplace al resto de controles.
#### Scenario: Limpiar de una vez
- **WHEN** hay varios filtros activos y se pulsa «✕ Limpiar»
- **THEN** todos los filtros vuelven a su estado por defecto y la lista muestra todos los locales publicados
#### Scenario: Sin desplazamiento al activar un filtro
- **WHEN** se activa o desactiva un filtro (p. ej. el orden «★ Mejor» o «A-Z»)
- **THEN** la posición del resto de controles de la barra no cambia, porque «✕ Limpiar» ya ocupaba su hueco (deshabilitado si no había filtros)
### Requirement: Criterios de filtrado intactos
El cambio es de presentación: dada la misma selección de filtros, el conjunto de locales resultante SHALL ser idéntico al anterior al cambio.
#### Scenario: Sin regresión en los resultados
- **WHEN** se aplican los mismos valores de filtro que antes del cambio (texto, categoría, provincia, favoritos, orden)
- **THEN** la lista de locales resultante es exactamente la misma que producía la UI anterior
@@ -0,0 +1,25 @@
# Tasks: unificar-filtros-iu
## 1. Refactor neutro: extraer la UI de filtros
- [x] 1.1 Crear `src/components/BarraFiltros.jsx` recibiendo por props el estado de filtros y sus setters actuales de `App.jsx` (búsqueda, categoría, subcategoría, provincia, orden, favoritos, ubicación), renderizando exactamente los controles actuales (chips + grid de selects + fila de botones)
- [x] 1.2 Sustituir en `App.jsx` las tres barras por `<BarraFiltros …/>` y verificar con los tests existentes que no hay cambios de comportamiento
## 2. Sustituir controles según el diseño
- [x] 2.1 Retirar el control de subcategoría (el select actual desaparece sin reemplazo; los subtipos se replantean en la issue #22)
- [x] 2.2 Provincia: mantener el select como desplegable compacto junto al campo de búsqueda + ampliar la búsqueda por texto para que también matchee provincia (ya la matcheaba: nombre, provincia, categoría, subcategoría y dirección; solo se actualiza el placeholder y el aria-label)
- [x] 2.3 Orden: control segmentado con icono + texto (🕒 Reciente / ★ / A-Z / 📍 Más cerca, este último condicionado a ubicación activa)
- [x] 2.4 Agrupar las provincias del desplegable por comunidad autónoma (`PROVINCIAS_POR_COMUNIDAD` como fuente única, `PROVINCIAS` derivado; mismo desplegable agrupado en la pasarela de propuesta)
## 3. Unificar en una sola sección
- [x] 3.1 Envolver todas las filas en una única sección visual (tarjeta con fondo primario y filas compactas: búsqueda + provincia, chips de categorías, acciones rápidas + orden + limpiar)
- [x] 3.2 Añadir «✕ Limpiar» global que resetee todos los filtros y desactive la ubicación; retirar el «✕ limpiar» solo-categoría
- [x] 3.3 Mostrar la sección de filtrado también en la vista de mapa (encima de las pestañas), manteniendo la leyenda de colores dentro del contenedor del mapa
## 4. Verificación
- [x] 4.1 Tests: mantener/ajustar los tests de filtrado y cubrir la nueva barra (búsqueda por provincia, orden segmentado, limpiar global)
- [x] 4.2 Comprobar anchos estrechos (~360 px) y accesibilidad: `aria-pressed` en chips, `aria-label` en búsqueda y orden segmentado, foco visible
- [x] 4.3 Verificar en la vista de mapa que los marcadores responden a los mismos filtros que la lista
+20
View File
@@ -0,0 +1,20 @@
schema: spec-driven
# Project context (optional)
# This is shown to AI when creating artifacts.
# Add your tech stack, conventions, style guides, domain knowledge, etc.
# Example:
# context: |
# Tech stack: TypeScript, React, Node.js
# We use conventional commits
# Domain: e-commerce platform
# Per-artifact rules (optional)
# Add custom rules for specific artifacts.
# Example:
# rules:
# proposal:
# - Keep proposals under 500 words
# - Always include a "Non-goals" section
# tasks:
# - Break tasks into chunks of max 2 hours
@@ -0,0 +1,40 @@
# Botón flotante para proponer locales
## Purpose
Punto de entrada único y siempre visible para proponer un nuevo local al directorio: un botón de acción flotante (FAB) fijo en la esquina inferior derecha, usable en PC y móvil, con tooltip explicativo y apertura de la pasarela de propuesta al pulsarlo.
## Requirements
### Requirement: Botón flotante fijo en la esquina inferior derecha
El sistema SHALL mostrar un botón de acción flotante (FAB) fijado en la esquina inferior derecha de la ventana, siempre visible sobre el contenido, tanto en PC como en móvil.
#### Scenario: Visible en escritorio
- **WHEN** la página se carga en una pantalla de escritorio
- **THEN** el botón flotante aparece fijado en la esquina inferior derecha, por encima del resto del contenido
#### Scenario: Visible en móvil
- **WHEN** la página se carga o se hace scroll en un dispositivo móvil
- **THEN** el botón flotante permanece fijo y accesible en la esquina inferior derecha, sin quedar oculto por el contenido ni interferir con la barra inferior existente
#### Scenario: Reemplazo del botón de cabecera
- **WHEN** la página se carga
- **THEN** ya no existe el botón "Proponer local" en la cabecera y el único punto de entrada para proponer un local es el botón flotante
### Requirement: Tooltip explicativo al pasar el ratón
El botón flotante SHALL mostrar un tooltip al pasar el ratón por encima (hover) y al recibir foco por teclado, explicando que sirve para añadir un nuevo local.
#### Scenario: Tooltip en hover
- **WHEN** el usuario pasa el ratón por encima del botón flotante
- **THEN** aparece un tooltip con un texto explicativo del tipo "Añade un nuevo local al directorio"
#### Scenario: Tooltip accesible sin ratón
- **WHEN** el botón flotante recibe el foco por teclado o se consulta con un lector de pantalla
- **THEN** el botón expone su propósito mediante `aria-label`, de modo que la función sea accesible sin depender del hover
### Requirement: El botón abre la pasarela en un modal
El botón flotante SHALL abrir, al pulsarlo, la pasarela de propuesta de local en un modal por encima de la página.
#### Scenario: Apertura de la pasarela
- **WHEN** el usuario pulsa el botón flotante
- **THEN** se abre un modal con la pasarela de propuesta, comenzando por la primera pantalla (Ubicación)
@@ -0,0 +1,108 @@
# Pasarela de propuesta de local
## Purpose
Experiencia guiada (wizard) en un modal para proponer un local con un solo campo por pantalla —empezando por la ubicación con autodetección del proveedor e inferencia de nombre/provincia—, con una descripción corta opcional y sin campo de puntuación, conservando las validaciones existentes (palabras prohibidas sobre nombre, dirección y descripción, duplicados, privacidad obligatoria).
## Requirements
### Requirement: Pasarela paso a paso en un modal
El sistema SHALL presentar la propuesta de un local como una pasarela (wizard) dentro de un modal, con un solo campo por pantalla, navegación atrás/siguiente e indicador de progreso.
#### Scenario: Una pantalla por campo
- **WHEN** la pasarela está abierta
- **THEN** cada pantalla muestra únicamente el campo correspondiente al paso actual, con botones para avanzar y retroceder
#### Scenario: Navegación hacia atrás
- **WHEN** el usuario pulsa "Atrás" en una pantalla intermedia
- **THEN** vuelve a la pantalla anterior conservando los datos ya introducidos
#### Scenario: Avance bloqueado sin dato válido
- **WHEN** el campo de la pantalla actual está vacío o es inválido
- **THEN** el botón "Siguiente" está deshabilitado y la pantalla no avanza
#### Scenario: Cierre del modal
- **WHEN** el usuario cierra el modal (botón ✕, botón Cancelar o tecla Escape)
- **THEN** la pasarela se cierra y se descarta el borrador en curso
### Requirement: Orden de las pantallas empezando por Ubicación
La pasarela SHALL presentar las pantallas en este orden: 1) Ubicación, 2) Datos del local (nombre, provincia y dirección inferidos, juntos en una misma pantalla), 3) Categoría, 4) Tipo específico (opcional), 5) Descripción (opcional), 6) Revisión y envío.
#### Scenario: Primera pantalla
- **WHEN** se abre la pasarela
- **THEN** la primera pantalla que se muestra es la de Ubicación
#### Scenario: Tipo específico omitible
- **WHEN** el usuario está en la pantalla de Tipo específico
- **THEN** puede continuar sin seleccionar ninguna subcategoría
#### Scenario: Descripción omitible
- **WHEN** el usuario está en la pantalla de Descripción
- **THEN** puede continuar sin escribir ninguna descripción
### Requirement: Inferencia de Nombre, Provincia y Dirección desde la Ubicación
El sistema SHALL pre-rellenar los campos Nombre, Provincia y Dirección a partir de la ubicación introducida en la primera pantalla (geocodificación inversa), mostrándolos juntos en la pantalla de Datos del local y permitiendo al usuario corregirlos (incluida la dirección).
#### Scenario: Datos pre-rellenados en su pantalla conjunta
- **WHEN** el usuario introduce una ubicación válida en la primera pantalla y esta se resuelve con éxito
- **THEN** al llegar a la pantalla de Datos del local los campos nombre, provincia y dirección aparecen pre-rellenados con los valores inferidos
#### Scenario: Valores corregibles
- **WHEN** los valores inferidos no son correctos
- **THEN** el usuario puede editarlos libremente antes de enviar
#### Scenario: Degradación sin inferencia
- **WHEN** la inferencia falla o devuelve campos vacíos
- **THEN** la pantalla de Datos del local aparece vacía y el usuario la rellena manualmente, sin bloquear la pasarela
### Requirement: Descripción opcional, sin puntuación
La pasarela SHALL incluir un campo opcional de descripción corta (texto multilínea con límite de 200 caracteres) en su propia pantalla; la puntuación SHALL NOT formar parte de la pasarela y la propuesta se envía sin ella.
#### Scenario: Envío con descripción
- **WHEN** el usuario escribe una descripción en la pantalla de Descripción y envía la propuesta
- **THEN** la propuesta se registra con nombre, provincia, categoría, subcategoría, dirección/enlace, coordenadas y descripción, sin puntuación
#### Scenario: Envío sin descripción
- **WHEN** el usuario deja la descripción vacía (solo espacios o nada) y envía la propuesta
- **THEN** la propuesta se registra sin descripción (ausente/NULL), sin puntuación
#### Scenario: Límite de longitud
- **WHEN** el usuario intenta escribir más de 200 caracteres en la descripción
- **THEN** el campo no admite más texto
### Requirement: Revisión y aceptación de privacidad antes de enviar
La última pantalla de la pasarela SHALL mostrar un resumen de los datos introducidos y el checkbox de aceptación de la política de privacidad, siendo este último obligatorio para enviar.
#### Scenario: Envío bloqueado sin aceptar privacidad
- **WHEN** el usuario llega a la pantalla final sin marcar la casilla de privacidad
- **THEN** el botón de envío está deshabilitado hasta que la marque
#### Scenario: Resumen antes de enviar
- **WHEN** el usuario llega a la pantalla final
- **THEN** ve un resumen legible de todos los datos introducidos con posibilidad de volver atrás a corregirlos
### Requirement: Validaciones existentes integradas en la pasarela
La pasarela SHALL conservar las validaciones actuales del formulario: filtro de palabras prohibidas (aplicado al nombre, la dirección y la descripción) y comprobación de duplicados, mostrando los avisos dentro del modal.
#### Scenario: Palabra prohibida detectada
- **WHEN** el texto introducido en nombre, dirección o descripción contiene una palabra no permitida
- **THEN** se muestra un aviso dentro del modal y la propuesta no se envía
#### Scenario: Posible duplicado detectado
- **WHEN** al enviar se detecta un local igual o muy cercano
- **THEN** se muestra el aviso de duplicado dentro del modal con las coincidencias y las opciones de enviar de todos modos o revisar los datos
#### Scenario: Envío correcto
- **WHEN** la propuesta se envía con éxito
- **THEN** el modal se cierra y aparece la confirmación de propuesta enviada en la página principal
### Requirement: Modal responsive accesible
El modal de la pasarela SHALL ser usable en PC (diálogo centrado) y móvil (ocupando prácticamente toda la pantalla), con foco contenido y cierre mediante Escape.
#### Scenario: Uso en móvil
- **WHEN** la pasarela se abre en una pantalla estrecha
- **THEN** el modal ocupa el ancho completo y es operativo con teclado y scroll táctil
#### Scenario: Foco contenido en el modal
- **WHEN** el modal está abierto
- **THEN** el foco de teclado permanece dentro del modal y la tecla Escape lo cierra
@@ -0,0 +1,77 @@
# Proveedores de ubicación (integraciones extensible)
## Purpose
Sistema extensible de integraciones con backends de ubicación (Google Maps, Waze, OpenStreetMap, coordenadas sueltas y geocodificación Nominatim) bajo una interfaz común (`id`/`detecta`/`extrae`), capaz de autodetectar el proveedor de una entrada libre, extraer coordenadas e inferir nombre y provincia, y ampliable a otras extracciones futuras sin modificar los proveedores existentes.
## Requirements
### Requirement: Interfaz común para proveedores de ubicación
Cada integración con un backend de ubicación SHALL implementarse como una clase que cumpla una misma interfaz: identificarse (`id`), indicar si reconoce una entrada (`detecta(entrada)`) y extraer la información disponible (`extrae(entrada)`).
#### Scenario: Contrato uniforme
- **WHEN** se consulta cualquier proveedor registrado
- **THEN** expone los métodos `detecta(entrada)` y `extrae(entrada)` con la misma firma y semántica, de modo que el consumidor no necesita conocer la clase concreta
### Requirement: Resultado de extracción extensible
El método `extrae(entrada)` SHALL devolver un objeto de resultado extensible que incluya como mínimo las coordenadas (`lat`, `lng`) y el identificador del proveedor que las extrajo, pudiendo incorporar campos adicionales en el futuro sin romper a los consumidores.
#### Scenario: Extracción mínima
- **WHEN** un proveedor extrae una ubicación válida
- **THEN** el resultado contiene `lat`, `lng` y el identificador del proveedor
#### Scenario: Campos adicionales sin ruptura
- **WHEN** en el futuro un proveedor añade nuevos campos al resultado (horarios, teléfono, fotos…)
- **THEN** los consumidores existentes siguen funcionando sin modificación, ignorando los campos que no conocen
### Requirement: Autodetección del proveedor a partir de la entrada
El sistema SHALL autodetectar automáticamente el proveedor adecuado para una entrada dada, recorriendo los proveedores registrados y usando el primero que la reconozca.
#### Scenario: Enlace de Google Maps
- **WHEN** el usuario pega un enlace de Google Maps (formatos `@lat,lng`, `!3d…!4d…` o `?q=lat,lng`)
- **THEN** el sistema lo resuelve con el proveedor de Google Maps y obtiene las coordenadas
#### Scenario: Enlace de Waze
- **WHEN** el usuario pega un enlace de Waze (`waze.com/ul`, parámetro `ll=lat,lng` o búsqueda `q=`)
- **THEN** el sistema lo resuelve con el proveedor de Waze y obtiene las coordenadas
#### Scenario: Enlace de OpenStreetMap
- **WHEN** el usuario pega un enlace de openstreetmap.org (parámetros `mlat`/`mlon` o fragmento `#map=zoom/lat/lng`)
- **THEN** el sistema lo resuelve con el proveedor de OpenStreetMap y obtiene las coordenadas
#### Scenario: Coordenadas geográficas sueltas
- **WHEN** el usuario escribe coordenadas directamente (por ejemplo `41.3851, 2.1734`)
- **THEN** el sistema lo resuelve con el proveedor de coordenadas y obtiene lat/lng
#### Scenario: Texto de dirección como fallback
- **WHEN** la entrada no coincide con ningún enlace soportado y parece una dirección en texto
- **THEN** el sistema la resuelve con el proveedor de geocodificación (Nominatim) realizando una búsqueda por texto
#### Scenario: Entrada no reconocida
- **WHEN** la entrada no es reconocida por ningún proveedor ni resuelta como dirección
- **THEN** el sistema informa de que no se pudo interpretar la ubicación y no avanza de pantalla
### Requirement: Inferencia de nombre y provincia
Los proveedores SHALL extraer, cuando estén disponibles, los campos inferibles `nombre` y `provincia` a partir de la entrada resuelta (geocodificación inversa cuando solo hay coordenadas), normalizando la provincia al listado canónico de provincias de España.
#### Scenario: Inferencia desde coordenadas
- **WHEN** la entrada se resuelve a coordenadas sin más contexto
- **THEN** una geocodificación inversa obtiene un nombre descriptivo y la provincia canónica (coincidencia insensible a acentos y mayúsculas con el listado de PROVINCIAS)
#### Scenario: Provincia fuera del listado
- **WHEN** la provincia inferida no coincide con ninguna provincia del listado canónico
- **THEN** el campo provincia queda vacío para que el usuario lo seleccione manualmente
### Requirement: Extensibilidad sin modificar proveedores existentes
Añadir un proveedor nuevo SHALL consistir en crear una nueva clase que implemente la interfaz y registrarla en el resolver, sin modificar las clases existentes ni la lógica de la pasarela (principio abierto/cerrado).
#### Scenario: Registro de un proveedor nuevo
- **WHEN** se añade una clase `MiProveedor` con `detecta`/`extrae` y se registra en la lista de proveedores
- **THEN** el campo universal empieza a aceptar las entradas que ese proveedor reconoce sin ningún otro cambio de código
### Requirement: Errores de red degradados
Los proveedores SHALL tratar sus errores de red o de servicio devolviendo un fallo controlado, sin romper la pasarela ni propagar excepciones al consumidor.
#### Scenario: Fallo del servicio de geocodificación
- **WHEN** Nominatim no responde o devuelve un error
- **THEN** la pantalla de Ubicación muestra un aviso de error y el usuario puede reintentar o continuar sin inferencia
+111
View File
@@ -0,0 +1,111 @@
# Reseñas por local
## Purpose
Reseñas anónimas múltiples por local (issue #6): una por dispositivo, editables y borrables por su autor; la puntuación del local pasa a ser la media de sus reseñas. Publicación directa con filtro de palabras, reportes y moderación admin; identidad anónima con huella corta por local (estilo 4chan, sin datos personales) y rate-limit por IP como defensa anti-boicot base.
## Requirements
### Requirement: Una reseña por dispositivo y local
El sistema SHALL permitir como máximo una reseña por dispositivo y local; enviar una reseña cuando ya existe una del mismo dispositivo SHALL actualizar (editar) la existente en lugar de crear una duplicada.
#### Scenario: Primera reseña
- **WHEN** un dispositivo envía `puntuacion` (1–5) y un comentario opcional a un local sin reseña previa suya
- **THEN** la reseña se crea con fecha y queda visible en la lista del local
#### Scenario: Reenvío edita la existente
- **WHEN** un dispositivo que ya reseñó un local envía de nuevo una reseña para ese local
- **THEN** la reseña previa se actualiza (puntuacion y comentario) y se registra la fecha de edición, sin crear duplicados
#### Scenario: Borrado de la propia reseña
- **WHEN** un dispositivo solicita borrar su reseña de un local
- **THEN** la reseña desaparece de la lista y la puntuación del local se recalcula
### Requirement: Valoración obligatoria 1–5 y comentario opcional
La reseña SHALL contener una valoración de 1 a 5 estrellas obligatoria y un comentario opcional de como máximo 500 caracteres; las escrituras fuera de ese contrato SHALL rechazarse con error 400.
#### Scenario: Reseña sin puntuacion
- **WHEN** se envía una reseña sin puntuacion o fuera del rango 1–5
- **THEN** el servidor responde 400 y no se crea ni modifica ninguna reseña
#### Scenario: Comentario demasiado largo
- **WHEN** se envía un comentario de más de 500 caracteres
- **THEN** el servidor responde 400
### Requirement: Media agregada en la puntuación del local
El sistema SHALL mantener `locales.puntuacion` como la media (entero redondeado) de las reseñas vigentes del local, recalculada al crear, editar o borrar una reseña; sin reseñas SHALL valer 0. Los consumidores existentes (estrellas de la tarjeta, popup del mapa, orden "★ Mejor" y media global) SHALL funcionar sin cambios.
#### Scenario: Recálculo al crear
- **WHEN** un local sin reseñas recibe una reseña de 5 estrellas y luego otra de 4
- **THEN** tras la primera la puntuación del local es 5, y tras la segunda es 5 (media 4.5 redondeada al entero más próximo, ROUND de SQLite)
#### Scenario: Recálculo al borrar
- **WHEN** se borra la única reseña de un local
- **THEN** la puntuación del local vuelve a 0
### Requirement: Identidad anónima con huella corta
El sistema SHALL identificar a quien reseña mediante un identificador de dispositivo aleatorio (sin datos personales) y SHALL mostrar cada reseña como "Anónimo" seguida de una huella corta estable por local (derivada del identificador de dispositivo y del local, no reversible y no rastreable entre locales) junto a su fecha.
#### Scenario: Visualización anónima
- **WHEN** se lista las reseñas de un local
- **THEN** cada reseña se muestra como anónima con su huella corta y su fecha, sin exponer el identificador completo del dispositivo
#### Scenario: Huella estable dentro de un local
- **WHEN** el mismo dispositivo reseña (o edita su reseña en) un local
- **THEN** la huella mostrada es la misma en todas las reseñas de ese local para ese dispositivo
### Requirement: Publicación directa con filtro de palabras
Las reseñas SHALL publicarse inmediatamente al enviarse, aplicando el filtro de palabras prohibidas al comentario; un comentario con palabras no permitidas SHALL rechazarse con el aviso correspondiente.
#### Scenario: Palabra prohibida en el comentario
- **WHEN** se envía una reseña cuyo comentario contiene una palabra no permitida
- **THEN** el servidor responde con error y la reseña no se publica
#### Scenario: Publicación inmediata
- **WHEN** una reseña válida se envía
- **THEN** queda visible en la lista del local sin intervención del administrador
### Requirement: Rate limiting de escrituras
El sistema SHALL limitar la frecuencia de escrituras de reseñas (crear/editar/borrar) por dirección IP, rechazando con error 429 los excesos, como defensa base contra el boicot automatizado.
#### Scenario: Límite excedido
- **WHEN** una misma IP supera el límite de escrituras de reseñas en la ventana configurada
- **THEN** las peticiones adicionales reciben 429 y no modifican datos
### Requirement: Reporte y moderación de reseñas
El sistema SHALL permitir reportar una reseña concreta (reusando el flujo de reportes) y SHALL ofrecer al administrador, bajo el prefijo admin, el listado de reseñas y el borrado de cualquiera de ellas, recalculando la media al borrar.
#### Scenario: Reportar una reseña
- **WHEN** un usuario reporta una reseña de un local
- **THEN** el reporte aparece en la lista de reportes del admin identificado como reporte de esa reseña
#### Scenario: Borrado admin
- **WHEN** el administrador borra una reseña desde el panel
- **THEN** la reseña desaparece y la puntuación del local se recalcula
### Requirement: Sección de reseñas desplegable en la tarjeta del local
La tarjeta de cada local SHALL incluir una sección "★ media · Reseñas (N)" que carga sus reseñas al montar la tarjeta y muestra las 3 primeras en una fila de tarjetas que ocupa toda la anchura de la tarjeta; al expandirla, una animación amplía la tarjeta revelando el resto de reseñas en el mismo grid y el formulario inline plano (estrellas interactivas 1–5 y comentario opcional de 500 caracteres). Cada tarjeta de reseña SHALL incluir un botón "Borrar" cuando sea propia del dispositivo y un botón "Reportar" cuando sea ajena. La sección SHALL poder cerrarse desde la cabecera, desde el botón "Comentar" de la barra inferior (que alterna) y desde un botón "Cerrar" del formulario.
#### Scenario: Vista previa sin expandir
- **WHEN** se muestra la tarjeta de un local con reseñas
- **THEN** la sección presenta la media, el total y las 3 reseñas más recientes en fila ocupando toda la anchura, sin interacción
#### Scenario: Expansión animada
- **WHEN** el usuario expande la sección de reseñas
- **THEN** la tarjeta se amplía con una animación que revela el resto de reseñas en el mismo grid y el formulario
#### Scenario: Cierre accesible
- **WHEN** la sección está expandida
- **THEN** puede cerrarse desde la cabecera, pulsando de nuevo "Comentar" o con el botón "Cerrar" del formulario
#### Scenario: Expandir y reseñar
- **WHEN** el usuario expande la sección de reseñas y envía estrellas (y opcionalmente comentario)
- **THEN** su reseña aparece en la lista y la cabecera actualiza número y media
#### Scenario: La propia reseña es editable y borrable desde su tarjeta
- **WHEN** el dispositivo ya tiene reseña en ese local
- **THEN** el formulario aparece precargado al expandir (Actualizar) y su tarjeta de reseña incluye un botón "Borrar"
#### Scenario: Reportar una reseña ajena
- **WHEN** el usuario pulsa "Reportar" en una tarjeta de reseña ajena
- **THEN** se envía el reporte de esa reseña y la tarjeta lo refleja
+37
View File
@@ -0,0 +1,37 @@
# Tarjeta de local
## Purpose
Estructura y acciones de la tarjeta de local en la web pública: orden de bloques (cabecera, categoría, dirección, enlaces, descripción ENCIMA de las reseñas, fecha y barra de acciones) y la barra inferior de acciones (Comentar · Reportar · Marcar · Compartir).
## Requirements
### Requirement: Estructura de la tarjeta de local
La tarjeta de cada local SHALL presentar sus bloques en este orden: nombre y provincia en la cabecera, categoría, dirección, enlaces de navegación, descripción del local (si existe), sección de reseñas, aviso de confirmación (cuando corresponda), fecha de publicación y, como pie, la barra inferior de acciones.
#### Scenario: La descripción va encima de las reseñas
- **WHEN** un local tiene descripción y reseñas
- **THEN** la descripción se muestra como bloque propio, inmediatamente encima de la sección de reseñas y sin mezclarse con ella
#### Scenario: Local sin descripción
- **WHEN** un local no tiene descripción
- **THEN** la tarjeta pasa de los enlaces de navegación directamente a la sección de reseñas
### Requirement: Barra inferior de acciones
El pie de la tarjeta SHALL estar ocupado por una barra de botones a ancho completo con, de momento, cuatro acciones: Comentar, Reportar, Marcar y Compartir. La fecha de publicación SHALL quedar como texto secundario justo encima de la barra, y el aviso de confirmación ("Sigue aquí") SHALL mostrarse como banner encima de la barra cuando corresponda.
#### Scenario: Comentar
- **WHEN** el usuario pulsa "Comentar"
- **THEN** la sección de reseñas se expande si estaba plegada (con desplazamiento suave hasta el formulario y foco en la valoración) y se cierra si estaba expandida
#### Scenario: Reportar
- **WHEN** el usuario pulsa "Reportar"
- **THEN** se abre el formulario de reporte del local encima de la barra, sin salir de la tarjeta
#### Scenario: Marcar
- **WHEN** el usuario pulsa "Marcar" en un local no marcado
- **THEN** el local pasa a ser favorito y el botón refleja el estado activo (y viceversa al pulsar de nuevo)
#### Scenario: Compartir
- **WHEN** el usuario pulsa "Compartir"
- **THEN** se abre el flujo de compartir del local (nativo del dispositivo o WhatsApp con enlace copiado)
+1812 -336
View File
File diff suppressed because it is too large Load Diff
+19 -13
View File
@@ -1,26 +1,32 @@
{
"name": "business-map",
"name": "locales-espanoles",
"version": "1.0.0",
"private": true,
"version": "0.1.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview",
"server": "node server/index.js",
"dev:all": "concurrently -k -n vite,api -c cyan,green \"npm run dev\" \"npm run server\"",
"build": "vite build",
"preview": "vite preview"
"test": "vitest run",
"test:watch": "vitest",
"test:integration": "vitest run --config vitest.config.integration.mjs"
},
"dependencies": {
"better-sqlite3": "^12.10.0",
"express": "^5.2.1",
"leaflet": "^1.9.4",
"react": "^18.3.1",
"react-dom": "^18.3.1",
"react-leaflet": "^4.2.1"
"better-sqlite3": "^12.0.0",
"express": "^5.0.0",
"react": "^18.2.0",
"react-dom": "^18.2.0"
},
"devDependencies": {
"@vitejs/plugin-react": "^4.3.1",
"concurrently": "^10.0.0",
"vite": "^5.4.0"
"@testing-library/dom": "^10.4.1",
"@testing-library/react": "^16.3.2",
"@vitejs/plugin-react": "^4.2.1",
"concurrently": "^8.0.0",
"jsdom": "^26.1.0",
"supertest": "^7.2.2",
"vite": "^5.2.0",
"vitest": "^3.2.7"
}
}
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 114 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 194 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

+16
View File
@@ -0,0 +1,16 @@
{
"name": "LocalESP · Locales Españoles",
"short_name": "LocalESP",
"description": "Directorio colaborativo de negocios locales por toda España",
"start_url": "/",
"scope": "/",
"display": "standalone",
"background_color": "#ffffff",
"theme_color": "#8B0000",
"lang": "es",
"icons": [
{ "src": "/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
{ "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
{ "src": "/icon-512-maskable.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
]
}
+56
View File
@@ -0,0 +1,56 @@
const CACHE_NAME = "localesp-shell-v2";
const SHELL_ASSETS = [
"/",
"/manifest.webmanifest",
"/icon-192.png",
"/icon-512.png",
"/icon-512-maskable.png",
"/apple-touch-icon.png",
"/favicon-32.png",
"/logo-localesp.png",
"/logo-localesp@2x.png",
];
self.addEventListener("install", (event) => {
event.waitUntil(
caches.open(CACHE_NAME).then((cache) => cache.addAll(SHELL_ASSETS))
);
self.skipWaiting();
});
self.addEventListener("activate", (event) => {
event.waitUntil(
caches.keys().then((keys) =>
Promise.all(keys.filter((k) => k !== CACHE_NAME).map((k) => caches.delete(k)))
)
);
self.clients.claim();
});
// Network-first para la API (los datos deben estar frescos); cache-first
// para el resto del shell estático, para que la app abra offline.
self.addEventListener("fetch", (event) => {
const url = new URL(event.request.url);
if (event.request.method !== "GET") return;
if (url.pathname.startsWith("/api/")) {
event.respondWith(
fetch(event.request).catch(() => caches.match(event.request))
);
return;
}
event.respondWith(
caches.match(event.request).then((cached) => {
const network = fetch(event.request)
.then((response) => {
const clone = response.clone();
caches.open(CACHE_NAME).then((cache) => cache.put(event.request, clone));
return response;
})
.catch(() => cached);
return cached || network;
})
);
});
+33
View File
@@ -0,0 +1,33 @@
#!/usr/bin/env bash
# deploy.sh — Despliega la rama actual a <slug>.localesp.es
# Toda la lógica vive en lib/env.sh (modelo OOP). Éste es sólo el entrypoint.
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source=lib/env.sh
. "$SCRIPT_DIR/lib/env.sh"
usage() {
echo "usage: $0 <branch>" >&2
exit 2
}
main() {
local branch root
branch="${1:-${GITHUB_REF_NAME:-}}"
if [ -z "$branch" ]; then
usage
fi
root="$(cd "$SCRIPT_DIR/.." && pwd)"
Logger::set_tag deploy
Env::new env "$branch" "$root"
Logger::info "$(Env::banner env)"
Env::deploy env
Logger::info "LISTO: $(Env::url env) ($(Env::summary env))"
}
main "$@"
+11
View File
@@ -0,0 +1,11 @@
# entornos.env — prefijo admin por entorno de rama (una línea: <slug>=<prefijo>)
#
# El slug es el nombre de rama normalizado (minúsculas, [a-z0-9-]), igual que
# Slug::from en scripts/lib/env.sh. LOCALESP_ADMIN_PREFIX es obligatoria: sin
# entrada para el slug, build y deploy fallan (sin valor por defecto).
# El prefijo NO es secreto: viaja igualmente en el bundle del frontend.
#
# Nuevos entornos: añade una línea con el slug de tu rama.
prototipo-yb01=/administrador
# master=/administrador
# prototipo-yb01-ef=/administrador
+495
View File
@@ -0,0 +1,495 @@
#!/usr/bin/env bash
# lib/env.sh — Modelo OOP de entornos de previsualización por rama.
#
# Estrategia (entorno por rama):
# /opt/localesp/<slug> + systemd unit localesp-<slug> + vhost nginx + cert Let's Encrypt.
# Reutiliza el puerto de la unit existente (adopta entornos legacy) o asigna uno libre (>=8082).
#
# PRECONDICIÓN MANUAL: el registro A <slug>.localesp.es debe existir (se gestiona a mano).
# Si no resuelve aún, la app queda servida por HTTP y se emite el cert cuando el DNS apunte aquí.
#
# Representación OOP en bash:
# - Instancia = array asociativo global, referenciado por NOMBRE.
# - Constructor = Class::new <nombre> <args> (declara el array y establece invariantes).
# - Método = Class::method <nombre> <args>; accede al estado vía `local -n self="$1"`.
# - Composición = Env posee los nombres de sus colaboradores (<env>__unit, __vhost, __cert).
# - Servicios sin estado (Slug, Host, Port, Artifacts, Deps, Logger) = métodos estáticos.
#
# Requiere bash >= 4.3 (namerefs). Sin efectos al sourcear: sólo define funciones/constantes.
#
# CONTRATO (importante): el NOMBRE de instancia pasado a Env::new (p.ej. "env") es el
# nombre de un array asociativo global. NUNCA declares en el caller una `local` con ese
# mismo nombre: bash usa ámbito dinámico y la local sombrearía al array global, rompiendo
# el nameref `local -n self=env`. Pasa el nombre como literal: Env::new env ...
DOMAIN="localesp.es"
PORT_BASE=8082 # 8080/8081 son entornos legacy
ENV_CONFIG_FILE="scripts/entornos.env" # mapping slug=prefijo admin (fichero del repo)
LOGGER_TAG="env"
# ---------------------------------------------------------------------------
# Logger — servicio singleton (tag configurable según entrypoint).
# ---------------------------------------------------------------------------
Logger::set_tag() {
LOGGER_TAG="$1"
}
Logger::info() {
printf '\033[1;34m[%s]\033[0m %s\n' "$LOGGER_TAG" "$*"
}
Logger::error() {
printf '\033[1;31m[%s:ERROR]\033[0m %s\n' "$LOGGER_TAG" "$*" >&2
}
# ---------------------------------------------------------------------------
# Slug — value object estático: normaliza un nombre de rama a slug.
# ---------------------------------------------------------------------------
Slug::from() {
local branch="$1"
printf '%s' "$branch" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'
}
# ---------------------------------------------------------------------------
# Host — servicio estático: IP pública y resolución DNS.
# ---------------------------------------------------------------------------
Host::public_ip() {
curl -s4 --max-time 5 ifconfig.me || true
}
Host::resolved_ip() {
local host="$1"
getent hosts "$host" | awk '{print $1}' | head -1 || true
}
# ---------------------------------------------------------------------------
# Config — servicio estático: config por entorno desde el REPO.
# ---------------------------------------------------------------------------
# scripts/entornos.env mapea <slug>=<LOCALESP_ADMIN_PREFIX> (una línea por
# entorno de rama; comentarios con #). Al vivir en el repo, la config viaja
# con el código que despliega y se revisa en PR. El prefijo no es secreto
# (el bundle del frontend lo contiene igualmente).
Config::admin_prefix() {
local slug="$1"
local file="${2:-$ENV_CONFIG_FILE}"
local value
value="$(grep -E "^[[:space:]]*${slug}[[:space:]]*=" "$file" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '[:space:]')"
if [ -z "$value" ]; then
return 1
fi
printf '%s' "$value"
}
# ---------------------------------------------------------------------------
# Port — servicio estático: asigna/reutiliza puerto para una unit+dest.
# ---------------------------------------------------------------------------
Port::acquire() {
local unit="$1"
local dest="$2"
local unit_file="/etc/systemd/system/$unit.service"
local used
local port
# Adopta entorno existente: reutiliza el puerto de la unit ya instalada.
if [ -f "$unit_file" ]; then
port="$(grep -oE 'PORT=[0-9]+' "$unit_file" | head -1 | cut -d= -f2 || true)"
if [ -n "$port" ]; then
echo "$port"
return
fi
fi
if [ -f "$dest/.port" ]; then
cat "$dest/.port"
return
fi
used="$( { grep -rhoE 'PORT=[0-9]+' /etc/systemd/system/localesp*.service 2>/dev/null | cut -d= -f2
grep -rhoE 'localhost:[0-9]+' /etc/nginx/conf.d/*.conf 2>/dev/null | cut -d: -f2; } | sort -un)"
port="$PORT_BASE"
while printf '%s\n' "$used" | grep -qx "$port"; do
port=$((port+1))
done
echo "$port"
}
# ---------------------------------------------------------------------------
# Artifacts — servicio estático: artefactos buildados.
# ---------------------------------------------------------------------------
Artifacts::require_built() {
local root="$1"
if [ ! -d "$root/dist" ]; then
Logger::error "falta dist/ — ¿se ejecutó el build?"
exit 1
fi
}
Artifacts::sync() {
local root="$1"
local dest="$2"
mkdir -p "$dest/dist" "$dest/server"
rsync -a --delete "$root/dist/" "$dest/dist/"
rsync -a --delete "$root/server/" "$dest/server/"
cp -a "$root/package.json" "$root/package-lock.json" "$dest/"
# localesp.db se PRESERVA (datos de usuarios). No se toca aquí.
}
# ---------------------------------------------------------------------------
# Deps — servicio estático: dependencias de producción.
# ---------------------------------------------------------------------------
Deps::install() {
local root="$1"
local dest="$2"
# Reutiliza los node_modules ya compilados por el workflow (better-sqlite3 v12 exige
# C++20, GCC 12). Copiar + npm prune evita recompilar en cada despliegue.
# Fallback a npm ci --omit=dev si se ejecuta a mano sin build previo.
if [ -d "$root/node_modules" ]; then
mkdir -p "$dest/node_modules"
rsync -a --delete "$root/node_modules/" "$dest/node_modules/"
( cd "$dest" && npm prune --omit=dev --no-audit --no-fund )
else
( cd "$dest" && npm ci --omit=dev --no-audit --no-fund )
fi
}
# ---------------------------------------------------------------------------
# SystemdUnit — entidad: fichero .service de un entorno.
# ---------------------------------------------------------------------------
SystemdUnit::new() {
local self="$1"
local name="$2"
local dest="$3"
local branch="$4"
local host="$5"
local port="$6"
declare -gA "$self"
local -n u="$self"
u[name]="$name"
u[dest]="$dest"
u[branch]="$branch"
u[host]="$host"
u[port]="$port"
u[file]="/etc/systemd/system/${name}.service"
}
SystemdUnit::render() {
local self="$1"
local -n u="$self"
cat <<EOF
[Unit]
Description=LocaleSP env rama '${u[branch]}' (${u[host]})
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=${u[dest]}
ExecStart=/usr/bin/node server/index.js
Restart=on-failure
RestartSec=5s
Environment=NODE_ENV=production
Environment=PORT=${u[port]}
[Install]
WantedBy=multi-user.target
EOF
}
SystemdUnit::write() {
local self="$1"
local -n u="$self"
Logger::info "escribiendo unit ${u[name]} (PORT=${u[port]})"
SystemdUnit::render "$self" > "${u[file]}"
echo "${u[port]}" > "${u[dest]}/.port"
systemctl daemon-reload
systemctl enable "${u[name]}" >/dev/null 2>&1 || true
systemctl restart "${u[name]}"
Logger::info "${u[name]} arrancada"
}
SystemdUnit::remove() {
local self="$1"
local -n u="$self"
systemctl disable --now "${u[name]}" 2>/dev/null || true
rm -f "${u[file]}"
systemctl daemon-reload
}
# ---------------------------------------------------------------------------
# NginxVhost — entidad: vhost nginx de un entorno.
# ---------------------------------------------------------------------------
NginxVhost::new() {
local self="$1"
local slug="$2"
local host="$3"
local port="$4"
declare -gA "$self"
local -n v="$self"
v[slug]="$slug"
v[host]="$host"
v[port]="$port"
}
NginxVhost::find_path() {
local self="$1"
local -n v="$self"
local host_re
host_re="$(printf '%s' "${v[host]}" | sed 's/\./\\./g')"
grep -rlE "server_name[[:space:]]+$host_re[[:space:]]*;" /etc/nginx/conf.d/*.conf 2>/dev/null | head -1 || true
}
NginxVhost::render() {
local self="$1"
local -n v="$self"
cat <<EOF
server {
listen 80;
listen [::]:80;
server_name ${v[host]};
location / {
proxy_pass http://localhost:${v[port]};
proxy_http_version 1.1;
proxy_set_header Host \$host;
proxy_set_header X-Real-IP \$remote_addr;
proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto \$scheme;
}
}
EOF
}
NginxVhost::create() {
local self="$1"
local -n v="$self"
local path="/etc/nginx/conf.d/${v[slug]}.conf"
Logger::info "creando vhost HTTP $path"
NginxVhost::render "$self" > "$path"
}
NginxVhost::repoint() {
local self="$1"
local -n v="$self"
local path="$2"
Logger::info "vhost existente: $path — forzando proxy_pass -> :${v[port]}"
sed -i -E "s|proxy_pass http://localhost:[0-9]+;|proxy_pass http://localhost:${v[port]};|g" "$path"
}
NginxVhost::configure() {
local self="$1"
local existing
existing="$(NginxVhost::find_path "$self")"
if [ -z "$existing" ]; then
NginxVhost::create "$self"
else
NginxVhost::repoint "$self" "$existing"
fi
nginx -t 2>&1 | tail -2
systemctl reload nginx
Logger::info "nginx recargado"
}
NginxVhost::remove() {
local self="$1"
local path
path="$(NginxVhost::find_path "$self")"
if [ -n "$path" ]; then
Logger::info "borrando vhost $path"
rm -f "$path"
nginx -t && systemctl reload nginx
fi
}
# ---------------------------------------------------------------------------
# TlsCert — entidad: certificado Let's Encrypt de un entorno.
# ---------------------------------------------------------------------------
TlsCert::new() {
local self="$1"
local host="$2"
declare -gA "$self"
local -n c="$self"
c[host]="$host"
}
TlsCert::exists() {
local self="$1"
local -n c="$self"
[ -d "/etc/letsencrypt/live/${c[host]}" ]
}
TlsCert::ensure() {
local self="$1"
local -n c="$self"
local host="${c[host]}"
local pub_ip resolved
if TlsCert::exists "$self"; then
Logger::info "cert TLS ya presente para $host"
return
fi
Logger::info "comprobando DNS de $host"
pub_ip="$(Host::public_ip)"
resolved="$(Host::resolved_ip "$host")"
if [ -n "$pub_ip" ] && [ "$resolved" = "$pub_ip" ]; then
Logger::info "emitiendo cert con certbot --nginx"
if certbot --nginx -d "$host" -n --redirect --keep-until-expiring; then
Logger::info "cert emitido ✓"
else
Logger::error "certbot falló; $host sigue en HTTP. Revisa y vuelve a lanzar el workflow."
fi
else
Logger::error "DNS de $host -> '${resolved:-<sin resolver>}', esperado $pub_ip."
Logger::error "Crea el registro A $host -> $pub_ip y, tras propagar, re-lanza el workflow"
Logger::error "(o ejecuta: certbot --nginx -d $host). La app ya vive en http://$host"
fi
}
TlsCert::delete() {
local self="$1"
local -n c="$self"
local host="${c[host]}"
if TlsCert::exists "$self"; then
Logger::info "borrando cert $host"
certbot delete --cert-name "$host" -n 2>/dev/null || true
fi
}
TlsCert::protocol() {
local self="$1"
if TlsCert::exists "$self"; then
echo "https"
else
echo "http"
fi
}
# ---------------------------------------------------------------------------
# Env — aggregate root: un entorno de rama. Compone SystemdUnit, NginxVhost, TlsCert.
# ---------------------------------------------------------------------------
Env::new() {
local self="$1"
local branch="$2"
local root="$3"
declare -gA "$self"
local -n s="$self"
s[branch]="$branch"
s[root]="$root"
s[slug]="$(Slug::from "$branch")"
if [ -z "${s[slug]}" ]; then
Logger::error "slug vacío para la rama '$branch'"
exit 2
fi
s[host]="${s[slug]}.$DOMAIN"
s[dest]="/opt/localesp/${s[slug]}"
s[unit_name]="localesp-${s[slug]}"
s[port]="$(Port::acquire "${s[unit_name]}" "${s[dest]}")"
# Composición: crea los colaboradores y guarda sus nombres en el agregado.
SystemdUnit::new "${self}__unit" "${s[unit_name]}" "${s[dest]}" "$branch" "${s[host]}" "${s[port]}"
NginxVhost::new "${self}__vhost" "${s[slug]}" "${s[host]}" "${s[port]}"
TlsCert::new "${self}__cert" "${s[host]}"
}
# Config por entorno: scripts/entornos.env (en el repo) debe definir el
# prefijo admin del slug. LOCALESP_ADMIN_PREFIX es obligatoria para servidor
# y build; no hay valor por defecto.
Env::require_config() {
local self="$1"
local -n s="$self"
local config="${s[root]}/$ENV_CONFIG_FILE"
if ! prefix="$(Config::admin_prefix "${s[slug]}" "$config")"; then
Logger::error "falta entrada '${s[slug]}=' en $ENV_CONFIG_FILE (repo)"
Logger::error "añade una línea: ${s[slug]}=/administrador"
exit 1
fi
Logger::info "prefijo admin de ${s[slug]}: $prefix"
}
Env::deploy() {
local self="$1"
local -n s="$self"
local prefix
local config="${s[root]}/$ENV_CONFIG_FILE"
Artifacts::require_built "${s[root]}"
Env::require_config "$self"
Logger::info "sincronizando artefactos -> ${s[dest]}"
Artifacts::sync "${s[root]}" "${s[dest]}"
# El servidor autocarga <dest>/.env (no pisa variables del entorno);
# rsync --delete sólo afecta a dist/ y server/, así que sobrevive, pero
# se regenera en cada despliegue desde la config del repo.
prefix="$(Config::admin_prefix "${s[slug]}" "$config")"
printf 'LOCALESP_ADMIN_PREFIX=%s\n' "$prefix" > "${s[dest]}/.env"
Logger::info "instalando dependencias (prod)"
Deps::install "${s[root]}" "${s[dest]}"
SystemdUnit::write "${self}__unit"
Logger::info "configurando nginx para ${s[host]}"
NginxVhost::configure "${self}__vhost"
TlsCert::ensure "${self}__cert"
}
Env::teardown() {
local self="$1"
local -n s="$self"
SystemdUnit::remove "${self}__unit"
TlsCert::delete "${self}__cert"
NginxVhost::remove "${self}__vhost"
rm -rf "${s[dest]}"
}
Env::url() {
local self="$1"
local -n s="$self"
local proto
proto="$(TlsCert::protocol "${self}__cert")"
echo "$proto://${s[host]}"
}
Env::banner() {
local self="$1"
local -n s="$self"
echo "rama=${s[branch]} slug=${s[slug]} host=${s[host]} dest=${s[dest]} puerto=${s[port]}"
}
Env::identity() {
local self="$1"
local -n s="$self"
echo "${s[host]} (${s[dest]}, ${s[unit_name]})"
}
Env::summary() {
local self="$1"
local -n s="$self"
echo "rama=${s[branch]} unit=${s[unit_name]} puerto=${s[port]}"
}
+33
View File
@@ -0,0 +1,33 @@
#!/usr/bin/env bash
# teardown.sh — Elimina el entorno de una rama (al borrar la rama o a mano).
# Toda la lógica vive en lib/env.sh (modelo OOP). Éste es sólo el entrypoint.
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# shellcheck source=lib/env.sh
. "$SCRIPT_DIR/lib/env.sh"
usage() {
echo "usage: $0 <branch>" >&2
exit 2
}
main() {
local branch root
branch="${1:-}"
if [ -z "$branch" ]; then
usage
fi
root="$(cd "$SCRIPT_DIR/.." && pwd)"
Logger::set_tag teardown
Env::new env "$branch" "$root"
Logger::info "$(Env::identity env)"
Env::teardown env
Logger::info "entorno eliminado ✓"
}
main "$@"
+93 -26
View File
@@ -3,36 +3,103 @@ import { fileURLToPath } from "url";
import { dirname, join } from "path";
const __dirname = dirname(fileURLToPath(import.meta.url));
const db = new Database(join(__dirname, "..", "localesp.db"));
// Ruta de la BD sobreescribible para pruebas (admite ":memory:"); en
// producción se usa el archivo del repo.
const dbPath = process.env.LOCALESP_DB || join(__dirname, "../localesp.db");
const db = new Database(dbPath);
db.exec(`
CREATE TABLE IF NOT EXISTS businesses (
id TEXT PRIMARY KEY,
name TEXT NOT NULL,
category TEXT NOT NULL,
address TEXT NOT NULL,
description TEXT NOT NULL,
contact TEXT NOT NULL DEFAULT '',
lat REAL NOT NULL,
lng REAL NOT NULL,
status TEXT NOT NULL DEFAULT 'pending',
createdAt TEXT NOT NULL
)
CREATE TABLE IF NOT EXISTS locales (
id TEXT PRIMARY KEY,
nombre TEXT NOT NULL,
descripcion TEXT,
provincia TEXT,
subcategoria TEXT,
direccion TEXT,
enlaceGoogleMaps TEXT,
puntuacion INTEGER DEFAULT 0,
categoria TEXT,
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
lat REAL,
lng REAL
);
CREATE TABLE IF NOT EXISTS pendientes (
id TEXT PRIMARY KEY,
nombre TEXT NOT NULL,
descripcion TEXT,
provincia TEXT,
subcategoria TEXT,
direccion TEXT,
enlaceGoogleMaps TEXT,
puntuacion INTEGER DEFAULT 0,
categoria TEXT,
estado TEXT DEFAULT 'pendiente',
fechaPropuesta TEXT DEFAULT CURRENT_TIMESTAMP,
lat REAL,
lng REAL
);
CREATE TABLE IF NOT EXISTS config (
id TEXT PRIMARY KEY,
datos TEXT
);
CREATE TABLE IF NOT EXISTS reportes (
id TEXT PRIMARY KEY,
localId TEXT NOT NULL,
resenaId TEXT,
motivo TEXT,
comentario TEXT,
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
estado TEXT DEFAULT 'pendiente'
);
CREATE TABLE IF NOT EXISTS users (
id TEXT PRIMARY KEY,
email TEXT UNIQUE NOT NULL,
password TEXT NOT NULL,
created TEXT DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE IF NOT EXISTS resenas (
id TEXT PRIMARY KEY,
localId TEXT NOT NULL,
deviceId TEXT NOT NULL,
puntuacion INTEGER NOT NULL CHECK (puntuacion BETWEEN 1 AND 5),
comentario TEXT,
fecha TEXT DEFAULT CURRENT_TIMESTAMP,
fechaEdicion TEXT,
UNIQUE (localId, deviceId)
);
`);
const empty = db.prepare("SELECT COUNT(*) AS n FROM businesses").get().n === 0;
if (empty) {
const ins = db.prepare(`
INSERT INTO businesses
(id, name, category, address, description, contact, lat, lng, status, createdAt)
VALUES
(@id, @name, @category, @address, @description, @contact, @lat, @lng, @status, @createdAt)
`);
for (const b of [
{ id: "1", name: "Café del Mercado", category: "Cafetería", address: "Plaza Mayor 3, Madrid", description: "Café de especialidad y bollería artesana.", contact: "hola@cafedelmercado.example", lat: 40.4155, lng: -3.7074, status: "approved", createdAt: "2025-01-10T10:00:00Z" },
{ id: "2", name: "Librería El Faro", category: "Librería", address: "Calle Luna 12, Madrid", description: "Librería independiente con sección infantil.", contact: "", lat: 40.4221, lng: -3.7059, status: "approved", createdAt: "2025-01-12T10:00:00Z" },
{ id: "3", name: "Taller Bicicletas Rueda", category: "Servicios", address: "Calle Embajadores 45, Madrid", description: "Reparación y venta de segunda mano.", contact: "+34 600 000 000", lat: 40.4078, lng: -3.7053, status: "approved", createdAt: "2025-01-15T10:00:00Z" },
]) ins.run(b);
// Migración suave: si la base de datos ya existía con el esquema antiguo
// (sin provincia/subcategoria/direccion/enlaceGoogleMaps/puntuacion),
// añadimos las columnas que falten sin borrar nada, porque
// CREATE TABLE IF NOT EXISTS no modifica tablas ya creadas.
function ensureColumn(table, column, definition) {
const cols = db.prepare(`PRAGMA table_info(${table})`).all().map(c => c.name);
if (!cols.includes(column)) {
db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${definition}`);
}
}
for (const table of ["locales", "pendientes"]) {
ensureColumn(table, "provincia", "TEXT");
ensureColumn(table, "subcategoria", "TEXT");
ensureColumn(table, "direccion", "TEXT");
ensureColumn(table, "enlaceGoogleMaps", "TEXT");
ensureColumn(table, "puntuacion", "INTEGER DEFAULT 0");
}
// fechaConfirmacion: última vez que alguien confirmó que el local sigue activo.
// Al aprobarse por primera vez se inicializa igual a "fecha"; luego se actualiza
// con /api/locales/:id/confirmar cada vez que un usuario pulsa "Sigue aquí".
ensureColumn("locales", "fechaConfirmacion", "TEXT");
db.prepare("UPDATE locales SET fechaConfirmacion = fecha WHERE fechaConfirmacion IS NULL").run();
// Reseñas (issue #6): reportes puede señalar una reseña concreta (nullable;
// null = reporte del local en sí, como hasta ahora).
ensureColumn("reportes", "resenaId", "TEXT");
export default db;
+344 -27
View File
@@ -1,51 +1,368 @@
import express from "express";
import { randomUUID } from "crypto";
import { fileURLToPath } from "url";
import { fileURLToPath, pathToFileURL } from "url";
import { dirname, join } from "path";
import { readFileSync } from "fs";
import db from "./db.js";
import { randomUUID, createHash } from "crypto";
const __dirname = dirname(fileURLToPath(import.meta.url));
const app = express();
// Carga mínima de `.env` (repo raíz): KEY=valor, ignora comentarios y líneas
// vacías, admite comillas y `export`, y NO sobrescribe variables ya presentes
// en el entorno (las de pruebas/despliegue mandan sobre el fichero).
function cargarDotEnv(ruta) {
let contenido;
try {
contenido = readFileSync(ruta, "utf8");
} catch {
return; // sin .env: se usan solo las variables del entorno
}
for (const linea of contenido.split("\n")) {
const m = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)\s*$/.exec(linea);
if (!m) continue;
let valor = m[2].trim();
if ((valor.startsWith('"') && valor.endsWith('"')) || (valor.startsWith("'") && valor.endsWith("'"))) {
valor = valor.slice(1, -1);
}
if (!(m[1] in process.env)) process.env[m[1]] = valor;
}
}
cargarDotEnv(join(__dirname, "../.env"));
// Prefijo de las rutas de administración (ocultación por ruta no obvia): las
// rutas admin solo se sirven bajo este prefijo y las históricas /api/... dejan
// de existir (404). OBLIGATORIO y SIN valor por defecto: es la única variable
// y también la usa el frontend (Vite la expone vía envPrefix; el build falla si
// falta). Ver .env.example.
function normalizarPrefijo(valor) {
const limpio = (valor || "").trim().replace(/\/+$/, "");
if (!limpio || limpio === "") return null;
return limpio.startsWith("/") ? limpio : `/${limpio}`;
}
const ADMIN_PREFIX = normalizarPrefijo(process.env.LOCALESP_ADMIN_PREFIX);
if (!ADMIN_PREFIX || ADMIN_PREFIX === "/") {
console.error(
"[config] Falta LOCALESP_ADMIN_PREFIX (obligatorio, sin valor por defecto)." +
" Copia .env.example a .env y asigna el prefijo de administración," +
" p. ej. LOCALESP_ADMIN_PREFIX=/gestion-x7k2",
);
throw new Error("LOCALESP_ADMIN_PREFIX no configurado");
}
app.use(express.json());
app.use(express.static(join(__dirname, "../dist")));
app.get("/api/businesses", (_req, res) => {
res.json(db.prepare("SELECT * FROM businesses WHERE status = 'approved' ORDER BY createdAt DESC").all());
// Locales (público, solo lectura). Incluye el número de reseñas de cada
// local para que la tarjeta pueda plegar "Reseñas (N)" sin expandir.
app.get("/api/locales", (_req, res) => {
const locales = db.prepare(`
SELECT l.*, (SELECT COUNT(*) FROM resenas WHERE localId = l.id) AS totalResenas
FROM locales l ORDER BY fecha DESC
`).all();
res.json(locales);
});
app.post("/api/businesses", (req, res) => {
const { name, category, address, description, contact, lat, lng } = req.body;
const business = {
id: randomUUID(),
name, category, address, description,
contact: contact || "",
lat, lng,
status: "pending",
createdAt: new Date().toISOString(),
};
// Utilidades para detectar duplicados
function normaliza(s) {
return (s || "").toString().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").trim();
}
function distanciaMetros(lat1, lng1, lat2, lng2) {
const R = 6371000;
const toRad = (d) => (d * Math.PI) / 180;
const dLat = toRad(lat2 - lat1);
const dLng = toRad(lng2 - lng1);
const a = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLng / 2) ** 2;
return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
}
// Comprueba si ya existe un local con el mismo nombre (en la misma provincia o muy
// cerca geográficamente) entre los ya publicados y los pendientes de revisión.
app.post("/api/check-duplicado", (req, res) => {
const { nombre, provincia, lat, lng } = req.body;
const nombreN = normaliza(nombre);
if (!nombreN) return res.json({ duplicado: false, coincidencias: [] });
const candidatos = [
...db.prepare("SELECT id, nombre, provincia, direccion, categoria, lat, lng FROM locales").all().map((l) => ({ ...l, estado: "publicado" })),
...db.prepare("SELECT id, nombre, provincia, direccion, categoria, lat, lng FROM pendientes").all().map((l) => ({ ...l, estado: "pendiente" })),
];
const coincidencias = candidatos.filter((l) => {
if (normaliza(l.nombre) !== nombreN) return false;
const mismaProvincia = provincia && normaliza(l.provincia) === normaliza(provincia);
const cerca = lat && lng && l.lat && l.lng && distanciaMetros(lat, lng, l.lat, l.lng) < 200;
return mismaProvincia || cerca;
});
res.json({ duplicado: coincidencias.length > 0, coincidencias });
});
// Enviar propuesta
app.post("/api/propuestas", (req, res) => {
const { nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion, categoria, lat, lng } = req.body;
const id = randomUUID();
const fechaPropuesta = new Date().toISOString();
db.prepare(`
INSERT INTO businesses (id, name, category, address, description, contact, lat, lng, status, createdAt)
VALUES (@id, @name, @category, @address, @description, @contact, @lat, @lng, @status, @createdAt)
`).run(business);
res.status(201).json(business);
INSERT INTO pendientes (id, nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion, categoria, estado, fechaPropuesta, lat, lng)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'pendiente', ?, ?, ?)
`).run(id, nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion ?? 0, categoria, fechaPropuesta, lat, lng);
res.status(201).json({ id, nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion: puntuacion ?? 0, categoria, estado: "pendiente", fechaPropuesta, lat, lng });
});
app.get("/api/admin/pending", (_req, res) => {
res.json(db.prepare("SELECT * FROM businesses WHERE status = 'pending' ORDER BY createdAt ASC").all());
// Pendientes (admin, bajo prefijo configurable)
app.get(`${ADMIN_PREFIX}/pendientes`, (_req, res) => {
const pendientes = db.prepare("SELECT * FROM pendientes ORDER BY fechaPropuesta DESC").all();
res.json(pendientes);
});
app.patch("/api/admin/businesses/:id", (req, res) => {
const { status } = req.body;
if (!["approved", "rejected"].includes(status))
return res.status(400).json({ error: "status must be 'approved' or 'rejected'" });
const info = db.prepare("UPDATE businesses SET status = ? WHERE id = ?").run(status, req.params.id);
if (info.changes === 0) return res.status(404).json({ error: "not found" });
// Aprobar propuesta
app.post(`${ADMIN_PREFIX}/aprobar/:id`, (req, res) => {
const { id } = req.params;
const propuesta = db.prepare("SELECT * FROM pendientes WHERE id = ?").get(id);
if (!propuesta) return res.status(404).json({ error: "Propuesta no encontrada" });
const localeId = randomUUID();
const fecha = new Date().toISOString();
db.prepare(`
INSERT INTO locales (id, nombre, descripcion, provincia, subcategoria, direccion, enlaceGoogleMaps, puntuacion, categoria, fecha, lat, lng, fechaConfirmacion)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
`).run(localeId, propuesta.nombre, propuesta.descripcion, propuesta.provincia, propuesta.subcategoria, propuesta.direccion, propuesta.enlaceGoogleMaps, propuesta.puntuacion ?? 0, propuesta.categoria, fecha, propuesta.lat, propuesta.lng, fecha);
db.prepare("DELETE FROM pendientes WHERE id = ?").run(id);
res.json({ ok: true });
});
// Rechazar propuesta
app.post(`${ADMIN_PREFIX}/rechazar/:id`, (req, res) => {
const { id } = req.params;
db.prepare("DELETE FROM pendientes WHERE id = ?").run(id);
res.json({ ok: true });
});
// Eliminar local
app.delete(`${ADMIN_PREFIX}/locales/:id`, (req, res) => {
const { id } = req.params;
db.prepare("DELETE FROM locales WHERE id = ?").run(id);
db.prepare("DELETE FROM reportes WHERE localId = ?").run(id);
res.json({ ok: true });
});
// Reportes (admin, bajo prefijo configurable)
app.get(`${ADMIN_PREFIX}/reportes`, (_req, res) => {
const reportes = db.prepare(`
SELECT r.*, l.nombre AS localNombre, l.provincia AS localProvincia, l.direccion AS localDireccion
FROM reportes r LEFT JOIN locales l ON l.id = r.localId
WHERE r.estado = 'pendiente'
ORDER BY r.fecha DESC
`).all();
res.json(reportes);
});
// Descartar un reporte (el admin revisó y no hace falta actuar)
app.post(`${ADMIN_PREFIX}/reportes/:id/descartar`, (req, res) => {
const { id } = req.params;
db.prepare("UPDATE reportes SET estado = 'descartado' WHERE id = ?").run(id);
res.json({ ok: true });
});
// Reseñas (admin, bajo prefijo configurable): listado completo y borrado de
// moderación. La media del local se recalcula al borrar.
app.get(`${ADMIN_PREFIX}/resenas`, (_req, res) => {
const resenas = db.prepare(`
SELECT r.*, l.nombre AS localNombre, l.provincia AS localProvincia
FROM resenas r LEFT JOIN locales l ON l.id = r.localId
ORDER BY r.fecha DESC
`).all();
res.json(resenas);
});
app.delete(`${ADMIN_PREFIX}/resenas/:id`, (req, res) => {
const { id } = req.params;
const resena = db.prepare("SELECT * FROM resenas WHERE id = ?").get(id);
if (!resena) return res.status(404).json({ error: "Reseña no encontrada" });
db.prepare("DELETE FROM resenas WHERE id = ?").run(id);
recalcularMedia(resena.localId);
res.json({ ok: true });
});
// Confirmar que un local sigue activo (renueva fechaConfirmacion)
app.post("/api/locales/:id/confirmar", (req, res) => {
const { id } = req.params;
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
if (!local) return res.status(404).json({ error: "Local no encontrado" });
const ahora = new Date().toISOString();
db.prepare("UPDATE locales SET fechaConfirmacion = ? WHERE id = ?").run(ahora, id);
res.json({ ok: true, fechaConfirmacion: ahora });
});
// Reportar un local (cerrado / datos incorrectos / inapropiado / otro) o,
// con resenaId, una reseña concreta de ese local.
app.post("/api/locales/:id/reportar", (req, res) => {
const { id } = req.params;
const { motivo, comentario, resenaId } = req.body;
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
if (!local) return res.status(404).json({ error: "Local no encontrado" });
if (resenaId) {
const resena = db.prepare("SELECT id FROM resenas WHERE id = ? AND localId = ?").get(resenaId, id);
if (!resena) return res.status(404).json({ error: "Reseña no encontrada" });
}
const reporteId = randomUUID();
db.prepare(`
INSERT INTO reportes (id, localId, resenaId, motivo, comentario, fecha, estado)
VALUES (?, ?, ?, ?, ?, ?, 'pendiente')
`).run(reporteId, id, resenaId || null, motivo || "otro", comentario || "", new Date().toISOString());
res.status(201).json({ ok: true, id: reporteId });
});
// --- Reseñas anónimas por local (issue #6) ---
// Identidad v1: deviceId aleatorio del navegador (sin cuentas, estilo 4chan).
// Una reseña por (local, dispositivo) garantizada por UNIQUE; enviar de nuevo
// edita la propia. Publicación directa con filtro de palabras y rate-limit
// por IP como defensa anti-boicot; los reportes y el borrado admin cubren la
// moderación reactiva.
// Rate limit en memoria por IP (ventana 1h). Máximo configurable para pruebas
// (LOCALESP_RESENAS_RATELIMIT_MAX). El DDoS volumétrico se mitiga en el borde,
// no aquí.
const RESENAS_RATELIMIT_MAX = Number(process.env.LOCALESP_RESENAS_RATELIMIT_MAX) || 10;
const RESENAS_RATELIMIT_VENTANA_MS = 60 * 60 * 1000;
const resenasPorIP = new Map();
function limitarEscriturasResenas(req, res, siguiente) {
const ip = req.ip || req.socket?.remoteAddress || "desconocida";
const ahora = Date.now();
const entrada = resenasPorIP.get(ip);
if (entrada && ahora - entrada.inicio < RESENAS_RATELIMIT_VENTANA_MS) {
if (entrada.contador >= RESENAS_RATELIMIT_MAX) {
res.setHeader("Retry-After", Math.ceil((entrada.inicio + RESENAS_RATELIMIT_VENTANA_MS - ahora) / 1000));
return res.status(429).json({ error: "Demasiadas escrituras de reseñas desde esta conexión. Inténtalo de nuevo más tarde." });
}
entrada.contador += 1;
} else {
resenasPorIP.set(ip, { inicio: ahora, contador: 1 });
}
siguiente();
}
// Huella corta por local (estilo 4chan): 3 hex del sha256(deviceId:localId).
// Estable dentro del local, no reversible y no rastreable entre locales.
function huellaCorta(deviceId, localId) {
return "#" + createHash("sha256").update(`${deviceId}:${localId}`).digest("hex").slice(0, 3);
}
// Mantener locales.puntuacion como la media (ROUND) de las reseñas vigentes.
function recalcularMedia(localId) {
const fila = db.prepare("SELECT ROUND(AVG(puntuacion)) AS media FROM resenas WHERE localId = ?").get(localId);
const media = Number(fila?.media) || 0;
db.prepare("UPDATE locales SET puntuacion = ? WHERE id = ?").run(media, localId);
return media;
}
function contienePalabraProhibida(texto) {
const config = db.prepare("SELECT datos FROM config WHERE id = ?").get("filtro_palabras");
if (!config) return false;
const norm = (s) => (s || "").toString().toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "");
const t = norm(texto);
return JSON.parse(config.datos).some((p) => t.includes(norm(p)));
}
// Listar reseñas de un local (público). Con ?deviceId= se marca esPropia.
// Nunca se expone el deviceId completo: solo la huella corta.
app.get("/api/locales/:id/resenas", (req, res) => {
const { id } = req.params;
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
if (!local) return res.status(404).json({ error: "Local no encontrado" });
const { deviceId } = req.query;
const resenas = db.prepare("SELECT * FROM resenas WHERE localId = ? ORDER BY fecha DESC").all(id)
.map(({ deviceId: d, ...resto }) => ({
...resto,
huella: huellaCorta(d, id),
esPropia: deviceId ? d === deviceId : false,
}));
res.json({ resenas, total: resenas.length });
});
// Crear (201) o editar (200) la reseña del dispositivo en el local (upsert).
app.post("/api/locales/:id/resenas", limitarEscriturasResenas, (req, res) => {
const { id } = req.params;
const local = db.prepare("SELECT id FROM locales WHERE id = ?").get(id);
if (!local) return res.status(404).json({ error: "Local no encontrado" });
const { deviceId, puntuacion, comentario } = req.body || {};
if (typeof deviceId !== "string" || deviceId.length < 8 || deviceId.length > 64) {
return res.status(400).json({ error: "Falta o es inválido el identificador de dispositivo" });
}
const puntos = Number(puntuacion);
if (!Number.isInteger(puntos) || puntos < 1 || puntos > 5) {
return res.status(400).json({ error: "La puntuación debe ser un entero entre 1 y 5" });
}
const comentarioStr = (comentario ?? "").toString().trim();
if (comentarioStr.length > 500) {
return res.status(400).json({ error: "El comentario no puede superar los 500 caracteres" });
}
if (comentarioStr && contienePalabraProhibida(comentarioStr)) {
return res.status(400).json({ error: "El comentario contiene palabras no permitidas" });
}
const existente = db.prepare("SELECT id FROM resenas WHERE localId = ? AND deviceId = ?").get(id, deviceId);
const ahora = new Date().toISOString();
if (existente) {
db.prepare("UPDATE resenas SET puntuacion = ?, comentario = ?, fechaEdicion = ? WHERE id = ?")
.run(puntos, comentarioStr || null, ahora, existente.id);
} else {
db.prepare("INSERT INTO resenas (id, localId, deviceId, puntuacion, comentario, fecha) VALUES (?, ?, ?, ?, ?, ?)")
.run(randomUUID(), id, deviceId, puntos, comentarioStr || null, ahora);
}
const media = recalcularMedia(id);
res.status(existente ? 200 : 201).json({ ok: true, creada: !existente, media, total: db.prepare("SELECT COUNT(*) AS n FROM resenas WHERE localId = ?").get(id).n });
});
// Borrar la reseña propia del dispositivo en el local.
app.delete("/api/locales/:id/resenas", limitarEscriturasResenas, (req, res) => {
const { id } = req.params;
const { deviceId } = req.query;
if (typeof deviceId !== "string" || !deviceId) {
return res.status(400).json({ error: "Falta el identificador de dispositivo" });
}
const existente = db.prepare("SELECT id FROM resenas WHERE localId = ? AND deviceId = ?").get(id, deviceId);
if (!existente) return res.status(404).json({ error: "No hay reseña de este dispositivo en el local" });
db.prepare("DELETE FROM resenas WHERE id = ?").run(existente.id);
const media = recalcularMedia(id);
res.json({ ok: true, media, total: db.prepare("SELECT COUNT(*) AS n FROM resenas WHERE localId = ?").get(id).n });
});
// Config (palabras filtradas)
app.get("/api/config/filtro_palabras", (_req, res) => {
const config = db.prepare("SELECT datos FROM config WHERE id = ?").get("filtro_palabras");
if (config) {
res.json({ palabras: JSON.parse(config.datos) });
} else {
res.json({ palabras: [] });
}
});
app.post("/api/config/filtro_palabras", (req, res) => {
const { palabras } = req.body;
db.prepare("INSERT OR REPLACE INTO config (id, datos) VALUES (?, ?)").run("filtro_palabras", JSON.stringify(palabras));
res.json({ ok: true });
});
// SPA fallback
app.get(/^\/(?!api\/).*/, (_req, res) => {
res.sendFile(join(__dirname, "../dist/index.html"));
});
// Escucha solo cuando se ejecuta como script (`node server/index.js`); al ser
// importado (p. ej. por las pruebas con supertest) se exporta la app sin puerto.
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => console.log(`API listening on http://localhost:${PORT}`));
const esPuntoDeEntrada = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
if (esPuntoDeEntrada) {
app.listen(PORT, () => console.log(`Server listening on http://localhost:${PORT}`));
}
export default app;
+363
View File
@@ -0,0 +1,363 @@
// AdminPanel.jsx — raíz del prefijo admin configurado (LOCALESP_ADMIN_PREFIX)
// No aparece en ningún menú público. Acceso solo por URL directa prefijada.
import { useState, useEffect } from "react";
import {
escucharAuth, loginAdmin, registrarAdmin, cerrarSesion,
suscribirPendientes, aprobarPropuesta, rechazarPropuesta,
suscribirLocales, deleteLocal,
obtenerReportes, descartarReporte, borrarResenaAdmin,
obtenerPalabrasFiltradas, guardarPalabrasFiltradas,
} from "./firebase.js";
import { obtenerCategoria } from "./constants/categorias.js";
import { enlaceGoogleMapsDesdeLocal, enlaceWazeDesdeLocal } from "./utils/geo.js";
import StarRating from "./components/StarRating.jsx";
import Toast from "./components/Toast.jsx";
import useToast from "./hooks/useToast.js";
const CLAVE_TOAST_LOGIN = "localesp_mostrar_toast_login";
const S = {
page: { minHeight:"100vh", background:"#F2EDE8", fontFamily:"-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif" },
header: { background:"#1A1A1A", color:"white", padding:"14px 28px", display:"flex", alignItems:"center", justifyContent:"space-between", position:"sticky", top:0, zIndex:10 },
wrap: { maxWidth:920, margin:"0 auto", padding:"28px 20px 60px" },
card: { background:"white", borderRadius:12, border:"1px solid #E8E0D5", padding:"20px 24px", marginBottom:14 },
input: { width:"100%", boxSizing:"border-box", padding:"10px 13px", border:"1px solid #DDD", borderRadius:8, fontSize:14, fontFamily:"inherit", outline:"none" },
btn: (bg="#8B0000",fg="white") => ({ padding:"9px 20px", background:bg, color:fg, border:"none", borderRadius:8, cursor:"pointer", fontWeight:600, fontSize:14, fontFamily:"inherit" }),
tab: (a) => ({ padding:"11px 22px", border:"none", background:"none", cursor:"pointer", fontFamily:"inherit", fontSize:14, fontWeight:a?700:400, color:a?"#8B0000":"#888", borderBottom:a?"2px solid #8B0000":"2px solid transparent", marginBottom:-2 }),
badge: (c,bg) => ({ display:"inline-block", padding:"3px 10px", borderRadius:20, fontSize:11, fontWeight:600, background:bg, color:c }),
tag: { display:"inline-flex", alignItems:"center", gap:5, background:"#F0EBE5", borderRadius:20, padding:"4px 12px", fontSize:13 },
label: { fontSize:11, color:"#999", fontWeight:700, textTransform:"uppercase", letterSpacing:"0.5px", display:"block", marginBottom:5 },
};
// ── Pantalla de login/registro ────────────────────────────────────────────────
function PantallaAuth() {
const [modo, setModo] = useState("login");
const [email, setEmail] = useState("");
const [pass, setPass] = useState("");
const [pass2, setPass2] = useState("");
const [err, setErr] = useState("");
const [busy, setBusy] = useState(false);
const errMsg = code => ({ "auth/wrong-password":"Contraseña incorrecta.", "auth/user-not-found":"No existe ningún admin con ese email.", "auth/invalid-credential":"Email o contraseña incorrectos.", "auth/email-already-in-use":"Ese email ya está registrado.", "auth/weak-password":"Mínimo 6 caracteres.", "auth/invalid-email":"Email no válido.", "auth/too-many-requests":"Demasiados intentos. Espera un momento." }[code] || "Error inesperado.");
const submit = async () => {
setErr("");
if (!email || !pass) { setErr("Rellena todos los campos."); return; }
if (modo === "registro" && pass !== pass2) { setErr("Las contraseñas no coinciden."); return; }
setBusy(true);
try {
modo === "login" ? await loginAdmin(email, pass) : await registrarAdmin(email, pass);
try { sessionStorage.setItem(CLAVE_TOAST_LOGIN, modo === "login" ? "1" : "0"); } catch { /* sessionStorage no disponible */ }
}
catch(e) { setErr(errMsg(e.code)); }
setBusy(false);
};
return (
<div style={{ ...S.page, display:"flex", alignItems:"center", justifyContent:"center" }}>
<div style={{ width:"100%", maxWidth:400, padding:"0 20px" }}>
<div style={{ textAlign:"center", marginBottom:28 }}>
<div style={{ fontSize:52, marginBottom:8 }}>🔐</div>
<h1 style={{ margin:0, fontSize:22, color:"#1A1A1A" }}>Panel de Administración</h1>
<p style={{ margin:"6px 0 0", color:"#999", fontSize:13 }}>Locales Españoles · acceso restringido</p>
</div>
<div style={{ ...S.card, padding:"24px 28px" }}>
<div style={{ display:"flex", borderBottom:"1px solid #EEE", marginBottom:20 }}>
{[{id:"login",l:"Iniciar sesión"},{id:"registro",l:"Crear admin"}].map(t => (
<button key={t.id} onClick={() => { setModo(t.id); setErr(""); }}
style={{ flex:1, padding:"10px 0", border:"none", background:"none", cursor:"pointer", fontFamily:"inherit", fontSize:14, fontWeight:modo===t.id?700:400, color:modo===t.id?"#8B0000":"#888", borderBottom:modo===t.id?"2px solid #8B0000":"2px solid transparent", marginBottom:-1 }}>
{t.l}
</button>
))}
</div>
<div style={{ display:"flex", flexDirection:"column", gap:14 }}>
<div><label style={S.label}>Email</label><input style={S.input} type="email" placeholder="admin@ejemplo.com" value={email} onChange={e=>setEmail(e.target.value)} onKeyDown={e=>e.key==="Enter"&&submit()} /></div>
<div><label style={S.label}>Contraseña</label><input style={S.input} type="password" placeholder="Mínimo 6 caracteres" value={pass} onChange={e=>setPass(e.target.value)} onKeyDown={e=>e.key==="Enter"&&submit()} /></div>
{modo==="registro" && <div><label style={S.label}>Repetir contraseña</label><input style={S.input} type="password" placeholder="Repite la contraseña" value={pass2} onChange={e=>setPass2(e.target.value)} onKeyDown={e=>e.key==="Enter"&&submit()} /></div>}
{err && <p style={{ margin:0, color:"#C0392B", fontSize:13, background:"#FDEDEC", padding:"8px 12px", borderRadius:8 }}>{err}</p>}
<button onClick={submit} disabled={busy} style={{ ...S.btn(), opacity:busy?0.6:1, marginTop:4 }}>
{busy ? "..." : modo==="login" ? "Entrar" : "Crear cuenta de administrador"}
</button>
</div>
</div>
<p style={{ textAlign:"center", fontSize:12, color:"#CCC", marginTop:14 }}>Esta página no está indexada en el sitio público</p>
</div>
</div>
);
}
// ── Tarjeta propuesta pendiente ───────────────────────────────────────────────
function TarjetaPropuesta({ p, onAprobar, onRechazar, busy }) {
const cat = obtenerCategoria(p.categoria);
const fecha = new Date(p.fechaPropuesta).toLocaleDateString("es-ES", { day:"numeric", month:"short", hour:"2-digit", minute:"2-digit" });
const gmUrl = p.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(p);
const wazeUrl = enlaceWazeDesdeLocal(p);
return (
<div style={{ ...S.card, borderLeft:`4px solid ${cat.color}`, marginBottom:10 }}>
<div style={{ display:"flex", justifyContent:"space-between", alignItems:"flex-start", flexWrap:"wrap", gap:12 }}>
<div style={{ flex:1 }}>
<div style={{ display:"flex", alignItems:"center", gap:8, flexWrap:"wrap", marginBottom:6 }}>
<span style={{ fontWeight:700, fontSize:17 }}>{p.nombre}</span>
{p.categoria && <span style={S.badge(cat.textColor, cat.bgLight)}>{cat.emoji} {p.categoria}</span>}
{p.subcategoria && <span style={{ fontSize:12, color:"#888", background:"#F5F5F5", padding:"2px 8px", borderRadius:20 }}>{p.subcategoria}</span>}
</div>
<div style={{ display:"flex", flexWrap:"wrap", alignItems:"center", gap:16, fontSize:13, color:"#666" }}>
<span>📍 {p.provincia}</span>
{p.direccion && (gmUrl ? <a href={gmUrl} target="_blank" rel="noopener noreferrer" style={{ color:"#666", textDecoration:"underline" }}>🗺 {p.direccion}</a> : <span>🗺 {p.direccion}</span>)}
<StarRating value={p.puntuacion} readOnly size={14} />
<span style={{ color:"#AAA" }}>Enviado: {fecha}</span>
</div>
{p.descripcion && <p style={{ margin:"8px 0 0", fontSize:13, color:"#666", fontStyle:"italic", background:"#FAFAFA", padding:"8px 12px", borderRadius:8 }}>"{p.descripcion}"</p>}
<div style={{ display:"flex", gap:10 }}>
{gmUrl && <a href={gmUrl} target="_blank" rel="noopener noreferrer" style={{ display:"inline-block", marginTop:6, fontSize:12, color:"#1A73E8" }}>Ver en Google Maps ↗</a>}
{wazeUrl && <a href={wazeUrl} target="_blank" rel="noopener noreferrer" style={{ display:"inline-block", marginTop:6, fontSize:12, color:"#0A9FD9" }}>Ver en Waze ↗</a>}
</div>
</div>
<div style={{ display:"flex", gap:8, flexShrink:0 }}>
<button onClick={() => onAprobar(p)} disabled={busy} style={{ ...S.btn("#1E8449"), padding:"8px 16px", fontSize:13 }}>✓ Aprobar</button>
<button onClick={() => onRechazar(p.id)} disabled={busy} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>✕ Rechazar</button>
</div>
</div>
</div>
);
}
// ── Panel principal ───────────────────────────────────────────────────────────
function PanelAdmin({ email }) {
const [tab, setTab] = useState("pendientes");
const [pendientes, setPendientes] = useState([]);
const [publicados, setPublicados] = useState([]);
const [reportes, setReportes] = useState([]);
const [palabras, setPalabras] = useState([]);
const [nuevaP, setNuevaP] = useState("");
const [cargando, setCargando] = useState(true);
const [busy, setBusy] = useState(false);
const [guardando, setGuardando] = useState(false);
const [buscador, setBuscador] = useState("");
const { toast, mostrarToast } = useToast();
const cargarReportes = () => obtenerReportes().then(setReportes).catch(() => {});
useEffect(() => {
try {
const marca = sessionStorage.getItem(CLAVE_TOAST_LOGIN);
if (marca !== null) {
mostrarToast(marca === "1" ? `Sesión iniciada como ${email}` : "Cuenta de administrador creada", "exito");
sessionStorage.removeItem(CLAVE_TOAST_LOGIN);
}
} catch { /* sessionStorage no disponible */ }
}, []);
useEffect(() => {
setCargando(true);
let cancelado = false;
let limpiarPendientes, limpiarPublicados;
suscribirPendientes(l => { if (!cancelado) { setPendientes(l); setCargando(false); } }, () => !cancelado && setCargando(false))
.then(fn => { if (cancelado) fn?.(); else limpiarPendientes = fn; });
suscribirLocales(l => !cancelado && setPublicados(l), () => {})
.then(fn => { if (cancelado) fn?.(); else limpiarPublicados = fn; });
obtenerPalabrasFiltradas().then(p => !cancelado && setPalabras(p));
cargarReportes();
return () => { cancelado = true; limpiarPendientes?.(); limpiarPublicados?.(); };
}, []);
const aprobar = async (p) => { setBusy(true); try { await aprobarPropuesta(p); mostrarToast(`✅ "${p.nombre}" aprobado y publicado`, "exito"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } setBusy(false); };
const rechazar = async (id) => { if (!confirm("¿Rechazar y eliminar esta propuesta?")) return; try { await rechazarPropuesta(id); mostrarToast("Propuesta rechazada", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
const eliminar = async (id) => { if (!confirm("¿Eliminar este local publicado?")) return; try { await deleteLocal(id); cargarReportes(); mostrarToast("Local eliminado", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
const descartar = async (id) => { try { await descartarReporte(id); setReportes(r => r.filter(x => x.id !== id)); mostrarToast("Aviso descartado", "info"); } catch(e) { mostrarToast("Error: "+e.message, "error"); } };
// Moderación de reseñas (issue #6): al borrar la reseña reportada se
// descarta también el aviso (queda resuelto).
const borrarResenaReportada = async (resenaId, reporteId) => {
try {
await borrarResenaAdmin(resenaId);
await descartarReporte(reporteId);
setReportes(r => r.filter(x => x.id !== reporteId));
mostrarToast("Reseña eliminada", "exito");
} catch(e) { mostrarToast("Error: "+e.message, "error"); }
};
const addPalabra = () => {
const p = nuevaP.trim().toLowerCase();
if (!p || palabras.includes(p)) return;
setPalabras([...palabras, p]); setNuevaP("");
};
const guardarFiltro = async () => {
setGuardando(true);
try { await guardarPalabrasFiltradas(palabras); mostrarToast("💾 Filtro de palabras guardado", "exito"); }
catch(e) { mostrarToast("Error: "+e.message, "error"); }
setGuardando(false);
};
const pubFiltrados = publicados.filter(l =>
!buscador || l.nombre.toLowerCase().includes(buscador.toLowerCase()) || l.provincia?.toLowerCase().includes(buscador.toLowerCase())
);
const TABS = [
{ id:"pendientes", l:`Pendientes (${pendientes.length})` },
{ id:"publicados", l:`Publicados (${publicados.length})` },
{ id:"reportes", l:`Reportes${reportes.length ? ` (${reportes.length})` : ""}` },
{ id:"filtro", l:"Filtro de palabras" },
];
return (
<div style={S.page}>
<div style={S.header}>
<div style={{ display:"flex", alignItems:"center", gap:12 }}>
<span style={{ fontSize:24 }}>🛡️</span>
<div>
<p style={{ margin:0, fontWeight:700, fontSize:16 }}>Panel de Administración</p>
<p style={{ margin:0, fontSize:12, opacity:0.55 }}>Locales Españoles · {email}</p>
</div>
</div>
<button onClick={cerrarSesion} style={{ background:"rgba(255,255,255,0.1)", border:"1px solid rgba(255,255,255,0.2)", color:"white", padding:"7px 16px", borderRadius:8, cursor:"pointer", fontSize:13, fontFamily:"inherit" }}>
Cerrar sesión
</button>
</div>
<div style={S.wrap}>
{/* Tabs */}
<div style={{ display:"flex", borderBottom:"2px solid #E8E0D5", marginBottom:24 }}>
{TABS.map(t => <button key={t.id} onClick={() => setTab(t.id)} style={S.tab(tab===t.id)}>{t.l}</button>)}
</div>
{/* ── Pendientes ── */}
{tab === "pendientes" && (
cargando ? <p style={{ color:"#999", textAlign:"center", padding:"3rem" }}>Cargando propuestas...</p>
: pendientes.length === 0 ? (
<div style={{ textAlign:"center", padding:"4rem", color:"#AAA" }}>
<div style={{ fontSize:52, marginBottom:12 }}>🎉</div>
<p style={{ margin:0, fontSize:16, fontWeight:600, color:"#888" }}>Sin propuestas pendientes</p>
<p style={{ margin:"6px 0 0", fontSize:13 }}>Cuando un usuario proponga un local, aparecerá aquí para que lo apruebes o rechaces.</p>
</div>
) : (
<>
<p style={{ margin:"0 0 16px", fontSize:13, color:"#888" }}>
{pendientes.length} propuesta{pendientes.length!==1?"s":""} esperando revisión.
</p>
{pendientes.map(p => <TarjetaPropuesta key={p.id} p={p} onAprobar={aprobar} onRechazar={rechazar} busy={busy} />)}
</>
)
)}
{/* ── Publicados ── */}
{tab === "publicados" && (
<>
<div style={{ marginBottom:16 }}>
<input style={{ ...S.input, maxWidth:380 }} placeholder="🔍 Buscar por nombre o provincia..." value={buscador} onChange={e => setBuscador(e.target.value)} />
</div>
{pubFiltrados.length === 0
? <p style={{ color:"#AAA", textAlign:"center", padding:"2rem" }}>{publicados.length===0 ? "No hay locales publicados." : "Sin resultados."}</p>
: pubFiltrados.map(l => (
<div key={l.id} style={{ ...S.card, padding:"12px 18px", marginBottom:8 }}>
<div style={{ display:"flex", justifyContent:"space-between", alignItems:"center", gap:12 }}>
<div style={{ flex:1 }}>
<div style={{ display:"flex", alignItems:"center", gap:8, flexWrap:"wrap" }}>
<span style={{ fontWeight:600, fontSize:15 }}>{l.nombre}</span>
{l.categoria && <span style={S.badge(obtenerCategoria(l.categoria).textColor, obtenerCategoria(l.categoria).bgLight)}>{obtenerCategoria(l.categoria).emoji} {l.categoria}</span>}
<span style={{ fontSize:12, color:"#AAA" }}>📍 {l.provincia} · {new Date(l.fecha).toLocaleDateString("es-ES",{day:"numeric",month:"short",year:"numeric"})}</span>
</div>
{l.direccion && (() => {
const url = l.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(l);
return url
? <a href={url} target="_blank" rel="noopener noreferrer" style={{ margin:"3px 0 0", fontSize:13, color:"#888", textDecoration:"underline", display:"block" }}>{l.direccion}</a>
: <p style={{ margin:"3px 0 0", fontSize:13, color:"#888" }}>{l.direccion}</p>;
})()}
</div>
<button onClick={() => eliminar(l.id)} style={{ background:"none", border:"1px solid #FADADD", borderRadius:8, padding:"6px 14px", color:"#C0392B", cursor:"pointer", fontSize:12, fontWeight:600, flexShrink:0 }}>Eliminar</button>
</div>
</div>
))
}
</>
)}
{/* ── Reportes ── */}
{tab === "reportes" && (
reportes.length === 0 ? (
<div style={{ textAlign:"center", padding:"4rem", color:"#AAA" }}>
<div style={{ fontSize:52, marginBottom:12 }}>🚩</div>
<p style={{ margin:0, fontSize:16, fontWeight:600, color:"#888" }}>Sin reportes pendientes</p>
<p style={{ margin:"6px 0 0", fontSize:13 }}>Cuando alguien reporte un local (cerrado, datos incorrectos...), aparecerá aquí.</p>
</div>
) : (
<>
<p style={{ margin:"0 0 16px", fontSize:13, color:"#888" }}>{reportes.length} reporte{reportes.length!==1?"s":""} sin revisar.</p>
{reportes.map(r => (
<div key={r.id} style={{ ...S.card, borderLeft:"4px solid #C0392B", marginBottom:10 }}>
<div style={{ display:"flex", justifyContent:"space-between", alignItems:"flex-start", flexWrap:"wrap", gap:12 }}>
<div style={{ flex:1 }}>
<div style={{ display:"flex", alignItems:"center", gap:8, flexWrap:"wrap", marginBottom:6 }}>
<span style={{ fontWeight:700, fontSize:16 }}>{r.localNombre || "(local ya eliminado)"}</span>
<span style={S.badge("#C0392B", "#FDEDEC")}>{{ cerrado:"Ha cerrado", datos_incorrectos:"Datos incorrectos", inapropiado:"Contenido inapropiado", otro:"Otro motivo" }[r.motivo] || r.motivo}</span>
{r.resenaId && <span style={S.badge("#8B4513", "#FDF2E9")}>Reseña</span>}
</div>
<p style={{ margin:0, fontSize:13, color:"#666" }}>📍 {r.localProvincia} {r.localDireccion ? `· ${r.localDireccion}` : ""}</p>
{r.comentario && <p style={{ margin:"8px 0 0", fontSize:13, color:"#666", fontStyle:"italic", background:"#FAFAFA", padding:"8px 12px", borderRadius:8 }}>"{r.comentario}"</p>}
<p style={{ margin:"6px 0 0", fontSize:11, color:"#AAA" }}>Reportado: {new Date(r.fecha).toLocaleDateString("es-ES", { day:"numeric", month:"short", hour:"2-digit", minute:"2-digit" })}</p>
</div>
<div style={{ display:"flex", gap:8, flexShrink:0 }}>
{r.resenaId && <button onClick={() => borrarResenaReportada(r.resenaId, r.id)} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>🗑 Borrar reseña</button>}
{r.localId && !r.resenaId && <button onClick={() => eliminar(r.localId)} style={{ ...S.btn("#C0392B"), padding:"8px 16px", fontSize:13 }}>🗑 Eliminar local</button>}
<button onClick={() => descartar(r.id)} style={{ ...S.btn("#EEE","#666"), padding:"8px 16px", fontSize:13 }}>Descartar aviso</button>
</div>
</div>
</div>
))}
</>
)
)}
{/* ── Filtro de palabras ── */}
{tab === "filtro" && (
<div style={{ maxWidth:620 }}>
<div style={S.card}>
<p style={{ margin:"0 0 4px", fontWeight:700, fontSize:16 }}>Palabras prohibidas</p>
<p style={{ margin:"0 0 18px", fontSize:13, color:"#666", lineHeight:1.6 }}>
Las propuestas que contengan estas palabras en nombre, dirección o descripción serán bloqueadas automáticamente, sin llegar siquiera al panel de moderación. No distingue mayúsculas ni tildes.
</p>
<div style={{ display:"flex", gap:8, marginBottom:16 }}>
<input style={{ ...S.input, flex:1 }} placeholder="Añadir palabra o frase..." value={nuevaP}
onChange={e => setNuevaP(e.target.value)} onKeyDown={e => e.key==="Enter" && addPalabra()} />
<button onClick={addPalabra} style={S.btn()}>Añadir</button>
</div>
{palabras.length === 0
? <p style={{ color:"#BBB", fontSize:13, fontStyle:"italic" }}>No hay palabras filtradas todavía.</p>
: <div style={{ display:"flex", flexWrap:"wrap", gap:8, marginBottom:16 }}>
{palabras.map(p => (
<span key={p} style={S.tag}>
{p}
<button onClick={() => setPalabras(palabras.filter(x=>x!==p))} style={{ background:"none", border:"none", cursor:"pointer", color:"#AAA", padding:0, fontSize:15, lineHeight:1 }}>✕</button>
</span>
))}
</div>
}
<button onClick={guardarFiltro} disabled={guardando} style={{ ...S.btn(), opacity:guardando?0.6:1 }}>
{guardando ? "Guardando..." : "💾 Guardar filtro"}
</button>
</div>
<div style={{ ...S.card, background:"#FFFBF0", border:"1px solid #F5E6C8" }}>
<p style={{ margin:"0 0 8px", fontWeight:600, fontSize:14, color:"#784212" }}>ℹ️ Cómo funciona el flujo completo</p>
<ol style={{ margin:0, paddingLeft:20, fontSize:13, color:"#555", lineHeight:2 }}>
<li>El usuario rellena el formulario público y pulsa <em>"Enviar propuesta"</em>.</li>
<li>Antes de guardar, se comprueba el filtro de palabras. Si hay coincidencia → se rechaza al instante con un aviso.</li>
<li>Si pasa el filtro → se guarda en <code>/pendientes</code> en Firestore.</li>
<li>Aquí en el panel aparece la tarjeta. Tú pulsas <strong>Aprobar</strong> → pasa a <code>/locales</code> y se publica. O <strong>Rechazar</strong> → se elimina sin publicar.</li>
<li>Solo los locales en <code>/locales</code> son visibles en la web y la app móvil.</li>
</ol>
</div>
</div>
)}
</div>
<Toast toast={toast} />
</div>
);
}
// ── Raíz del panel ────────────────────────────────────────────────────────────
export default function AdminPanel() {
const [user, setUser] = useState(undefined);
useEffect(() => escucharAuth(u => setUser(u)), []);
if (user === undefined) return <div style={{ ...S.page, display:"flex", alignItems:"center", justifyContent:"center" }}><p style={{ color:"#999" }}>Cargando...</p></div>;
if (!user) return <PantallaAuth />;
return <PanelAdmin email={user.email} />;
}
+389 -60
View File
@@ -1,74 +1,403 @@
import { useEffect, useState } from "react";
import MapView from "./components/MapView.jsx";
import Sidebar from "./components/Sidebar.jsx";
import SubmitForm from "./components/SubmitForm.jsx";
import AdminPanel from "./components/AdminPanel.jsx";
import { getApproved, submit } from "./services/businessRepository.js";
import { useEffect, useRef, useState } from "react";
import { comprobarDuplicado, contienepalabrasProhibidas, enviarPropuesta, obtenerPalabrasFiltradas, suscribirLocales } from "./firebase.js";
import { CATEGORIAS, COLORES_MAPA, NOMBRES_CATEGORIAS, obtenerCategoria } from "./constants/categorias.js";
import { COORDS_PROVINCIAS, CENTRO_ESPANA } from "./constants/provincias.js";
import { distanciaKm as calcularDistanciaKm, enlaceGoogleMapsDesdeLocal, enlaceWazeDesdeLocal } from "./utils/geo.js";
import { ANCHO_CUERPO } from "./styles/shared.js";
import LocalCard from "./components/LocalCard.jsx";
import BannerMovil from "./components/BannerMovil.jsx";
import ModalPrivacidad from "./components/ModalPrivacidad.jsx";
import BotonFlotante from "./components/BotonFlotante.jsx";
import BotonProponerArriba from "./components/BotonProponerArriba.jsx";
import ModalPasarela from "./components/ModalPasarela.jsx";
import BarraFiltros from "./components/BarraFiltros.jsx";
import useFavoritos from "./hooks/useFavoritos.js";
import useUbicacion from "./hooks/useUbicacion.js";
const FORM_VACIO = {
nombre: "", provincia: "", categoria: "", subcategoria: "", descripcion: "",
direccion: "", enlaceGoogleMaps: "", lat: null, lng: null,
entradaUbicacion: "", proveedorUbicacion: "", // estado interno del paso de ubicación, no se envía
};
// ── App principal ─────────────────────────────────────────────────────────────
export default function App() {
const [businesses, setBusinesses] = useState([]);
const [selectedId, setSelectedId] = useState(null);
const [formStep, setFormStep] = useState(null); // null | 'picking' | 'editing'
const [pickedLocation, setPickedLocation] = useState(null);
const [adminOpen, setAdminOpen] = useState(false);
const [locales, setLocales] = useState([]);
const [vista, setVista] = useState("lista");
const [pasarelaAbierta, setPasarelaAbierta] = useState(false);
const [loading, setLoading] = useState(true);
const [saving, setSaving] = useState(false);
const [enviado, setEnviado] = useState(false); // confirmación de propuesta enviada
const [errorFiltro, setErrorFiltro] = useState(""); // palabra prohibida detectada
const [busqueda, setBusqueda] = useState("");
const [filtroCategoria, setFiltroCategoria] = useState("");
// Subcategoría: sin control en la barra (replanteada en la issue #22);
// queda "" y el criterio de localesFiltrados se mantiene intacto.
const [filtroSubcat] = useState("");
const [filtroProvincia, setFiltroProvincia] = useState("");
const [orden, setOrden] = useState("fecha");
const [palabrasProhibidas, setPalabrasProhibidas] = useState([]);
const [comprobandoDuplicado, setComprobandoDuplicado] = useState(false);
const [posibleDuplicado, setPosibleDuplicado] = useState(null); // { coincidencias, lat, lng }
const [soloFavoritos, setSoloFavoritos] = useState(false);
const [aceptaPrivacidad, setAceptaPrivacidad] = useState(false);
const [mostrarPrivacidad, setMostrarPrivacidad] = useState(false);
const [localDestacado, setLocalDestacado] = useState(null); // id del local abierto vía enlace compartido
const { favoritos, esFavorito } = useFavoritos();
const { ubicacion, buscando: buscandoUbicacion, error: errorUbicacion, pedirUbicacion, limpiarUbicacion } = useUbicacion();
const mapRef = useRef(null);
const mapInstanceRef = useRef(null);
const markersRef = useRef([]);
async function loadBusinesses() {
setBusinesses(await getApproved());
const [form, setForm] = useState(FORM_VACIO);
// Carga locales aprobados en tiempo real.
// suscribirLocales es async (hace fetch antes de devolver la función de
// limpieza), así que su valor de retorno inmediato es una Promise, no la
// función en sí: hay que esperarla antes de poder cancelar el intervalo.
useEffect(() => {
setLoading(true);
let cancelado = false;
let limpiar;
suscribirLocales(
(lista) => { if (!cancelado) { setLocales(lista); setLoading(false); } },
() => { if (!cancelado) { setLocales([]); setLoading(false); } },
).then((fn) => { if (cancelado) fn?.(); else limpiar = fn; });
return () => { cancelado = true; limpiar?.(); };
}, []);
// Carga filtro de palabras desde el backend
useEffect(() => {
obtenerPalabrasFiltradas().then((p) => setPalabrasProhibidas(p));
}, []);
// Enlace compartido (?local=ID): al cargar, resalta y desplaza hasta esa ficha
useEffect(() => {
const id = new URLSearchParams(window.location.search).get("local");
if (!id || loading || locales.length === 0) return;
setLocalDestacado(id);
const el = document.getElementById(`local-${id}`);
if (el) {
el.scrollIntoView({ behavior: "smooth", block: "center" });
const timer = setTimeout(() => setLocalDestacado(null), 3000);
return () => clearTimeout(timer);
}
}, [loading, locales]);
const resetForm = () => setForm(FORM_VACIO);
const abrirPasarela = () => {
setPasarelaAbierta(true);
setErrorFiltro("");
setPosibleDuplicado(null);
};
// Cerrar la pasarela descarta el borrador en curso
const cerrarPasarela = () => {
setPasarelaAbierta(false);
resetForm();
setAceptaPrivacidad(false);
setErrorFiltro("");
setPosibleDuplicado(null);
};
const guardarPropuesta = async (lat, lng) => {
setSaving(true);
try {
await enviarPropuesta({
nombre: form.nombre, provincia: form.provincia,
categoria: form.categoria, subcategoria: form.subcategoria,
// Opcional: vacía (o solo espacios) viaja como ausente → NULL en BD
descripcion: form.descripcion.trim() || undefined,
direccion: form.direccion, enlaceGoogleMaps: form.enlaceGoogleMaps,
lat, lng,
});
setEnviado(true);
resetForm();
setAceptaPrivacidad(false);
setPasarelaAbierta(false);
setPosibleDuplicado(null);
setTimeout(() => setEnviado(false), 5000);
} catch (e) {
console.error(e);
}
setSaving(false);
};
const enviarLocal = async () => {
setErrorFiltro("");
setPosibleDuplicado(null);
// Comprobar filtro de palabras
const textoCompleto = [form.nombre, form.direccion, form.descripcion].join(" ");
if (contienepalabrasProhibidas(textoCompleto, palabrasProhibidas)) {
setErrorFiltro("Tu propuesta contiene palabras no permitidas. Por favor, revisa el nombre, la dirección o la descripción.");
return;
}
let { lat, lng } = form;
if (!lat || !lng) {
const fallback = COORDS_PROVINCIAS[form.provincia] || CENTRO_ESPANA;
lat = fallback[0] + (Math.random() - 0.5) * 0.04;
lng = fallback[1] + (Math.random() - 0.5) * 0.04;
}
// Comprobar si ya existe un local igual (mismo nombre + provincia, o muy cerca)
setComprobandoDuplicado(true);
try {
const chequeo = await comprobarDuplicado({ nombre: form.nombre, provincia: form.provincia, lat, lng });
setComprobandoDuplicado(false);
if (chequeo?.duplicado) {
setPosibleDuplicado({ coincidencias: chequeo.coincidencias, lat, lng });
return;
}
} catch (e) {
console.error(e);
setComprobandoDuplicado(false);
// Si falla la comprobación, se permite continuar para no bloquear el envío
}
await guardarPropuesta(lat, lng);
};
const confirmarPeseADuplicado = () => {
if (!posibleDuplicado) return;
guardarPropuesta(posibleDuplicado.lat, posibleDuplicado.lng);
};
const localesFiltrados = locales
.filter((l) => {
const q = busqueda.toLowerCase();
return (!q || l.nombre.toLowerCase().includes(q) || l.provincia.toLowerCase().includes(q) || (l.categoria || "").toLowerCase().includes(q) || (l.subcategoria || "").toLowerCase().includes(q) || (l.direccion || "").toLowerCase().includes(q))
&& (!filtroCategoria || l.categoria === filtroCategoria)
&& (!filtroSubcat || l.subcategoria === filtroSubcat)
&& (!filtroProvincia || l.provincia === filtroProvincia)
&& (!soloFavoritos || esFavorito(l.id));
})
.sort((a, b) => {
if (orden === "distancia" && ubicacion) {
const da = a.lat && a.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, a.lat, a.lng) : Infinity;
const db = b.lat && b.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, b.lat, b.lng) : Infinity;
return da - db;
}
if (orden === "fecha") return new Date(b.fecha) - new Date(a.fecha);
if (orden === "puntuacion") return b.puntuacion - a.puntuacion;
return a.nombre.localeCompare(b.nombre);
});
// Mapa Leaflet. El contenedor se mantiene siempre montado (ver más abajo,
// solo se oculta con CSS) para que la instancia de Leaflet no se pierda al
// cambiar de pestaña. Si ya existe, solo recalculamos su tamaño: Leaflet no
// lo hace solo cuando el contenedor pasa de display:none a visible, y por
// eso antes hacía falta refrescar la página para que el mapa se viera bien.
useEffect(() => {
if (vista !== "mapa") return;
const timer = setTimeout(() => {
if (!mapRef.current) return;
if (mapInstanceRef.current) {
mapInstanceRef.current.invalidateSize();
return;
}
if (!window.L) {
const link = document.createElement("link");
link.rel = "stylesheet";
link.href = "https://unpkg.com/leaflet@1.9.4/dist/leaflet.css";
document.head.appendChild(link);
const script = document.createElement("script");
script.src = "https://unpkg.com/leaflet@1.9.4/dist/leaflet.js";
script.onload = () => initMap();
document.head.appendChild(script);
} else {
initMap();
}
}, 100);
return () => clearTimeout(timer);
}, [vista]);
useEffect(() => {
if (vista === "mapa" && mapInstanceRef.current && window.L) updateMarkers();
}, [locales, vista, filtroCategoria, filtroSubcat, filtroProvincia, busqueda, soloFavoritos, favoritos]);
function initMap() {
if (!mapRef.current || mapInstanceRef.current) return;
const L = window.L;
const map = L.map(mapRef.current, { zoomControl: true }).setView([40.416, -3.703], 6);
L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", { attribution: '© <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a>', maxZoom: 19 }).addTo(map);
mapInstanceRef.current = map;
updateMarkers(map);
}
useEffect(() => { loadBusinesses(); }, []);
const selected = businesses.find((b) => b.id === selectedId) || null;
function handlePickLocation(loc) {
setPickedLocation(loc);
if (formStep === "picking") setFormStep("editing");
}
async function handleSubmit(data) {
await submit(data);
setFormStep(null);
setPickedLocation(null);
alert("¡Gracias! Tu propuesta queda pendiente de revisión.");
}
function handleCancel() {
setFormStep(null);
setPickedLocation(null);
function updateMarkers(mapObj) {
const L = window.L;
const map = mapObj || mapInstanceRef.current;
if (!L || !map) return;
markersRef.current.forEach((m) => m.remove());
markersRef.current = [];
localesFiltrados.forEach((local) => {
if (!local.lat || !local.lng) return;
const cat = obtenerCategoria(local.categoria);
const color = COLORES_MAPA[local.categoria] || cat.color;
const puntuacion = Math.min(5, Math.max(0, Math.round(Number(local.puntuacion) || 0)));
const stars = "★".repeat(puntuacion) + "☆".repeat(5 - puntuacion);
const labelDir = local.direccion ? ` · ${local.direccion.split(",")[0]}` : "";
const marker = L.marker([local.lat, local.lng], {
icon: L.divIcon({ className: "", html: `<div style="background:${color};color:white;border-radius:8px 8px 8px 0;padding:5px 10px;font-size:12px;font-weight:600;white-space:nowrap;box-shadow:0 2px 8px rgba(0,0,0,0.3);border:2px solid white;max-width:220px;overflow:hidden;text-overflow:ellipsis;">${cat.emoji} ${local.nombre}${labelDir}</div>`, iconAnchor: [0, 32] }),
}).addTo(map);
const gmLink = local.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(local);
const wazeLink = enlaceWazeDesdeLocal(local);
const direccionHtml = local.direccion
? `<br><span style="font-size:12px;color:#444;margin-top:4px;display:block">📍 ${gmLink ? `<a href="${gmLink}" target="_blank" style="color:#444;text-decoration:underline">${local.direccion}</a>` : local.direccion}</span>`
: "";
const enlacesHtml = `${gmLink ? `<a href="${gmLink}" target="_blank" style="display:inline-block;margin-top:6px;margin-right:6px;font-size:12px;color:#1A73E8;font-weight:500;text-decoration:none;background:#E8F0FE;padding:3px 8px;border-radius:4px">Google Maps ↗</a>` : ""}${wazeLink ? `<a href="${wazeLink}" target="_blank" style="display:inline-block;margin-top:6px;font-size:12px;color:#0A9FD9;font-weight:500;text-decoration:none;background:#E6FAFF;padding:3px 8px;border-radius:4px">Waze ↗</a>` : ""}`;
marker.bindPopup(`<div style="font-family:sans-serif;min-width:200px;max-width:260px"><strong style="font-size:15px">${local.nombre}</strong><br><span style="color:#666;font-size:12px">${local.provincia}</span><br><span style="background:${cat.bgLight};color:${color};font-size:12px;padding:2px 8px;border-radius:4px;display:inline-block;margin:4px 0;font-weight:500">${cat.emoji} ${local.categoria}</span>${local.subcategoria ? `<span style="font-size:11px;color:#666;margin-left:4px">${local.subcategoria}</span>` : ""}${direccionHtml}<br>${enlacesHtml}<br><span style="color:#D4AF37;font-size:16px;display:block;margin-top:4px">${stars}</span>${local.descripcion ? `<em style="font-size:12px;color:#555">"${local.descripcion}"</em>` : ""}</div>`);
markersRef.current.push(marker);
});
}
return (
<div className="app">
<Sidebar
business={selected}
onContribute={() => setFormStep("picking")}
onClose={() => setSelectedId(null)}
picking={formStep === "picking"}
onCancelPicking={handleCancel}
onAdmin={() => setAdminOpen(true)}
<div style={{ maxWidth: ANCHO_CUERPO, margin: "0 auto", padding: "1.5rem 1rem", fontFamily: "var(--font-sans)" }}>
{/* Header */}
<div style={{ display: "flex", alignItems: "flex-start", justifyContent: "space-between", marginBottom: "1.5rem", gap: 12, flexWrap: "wrap" }}>
<div>
<h1 style={{ margin: 0, lineHeight: 0 }}>
<img
src="/logo-localesp.png"
srcSet="/logo-localesp.png 1x, /logo-localesp@2x.png 2x"
alt="LocalESP · Locales Españoles"
width={220}
height={62}
style={{ display: "block", width: "clamp(140px, 35vw, 200px)", height: "auto" }}
/>
</h1>
<p style={{ margin: "6px 0 0", fontSize: 13, color: "var(--color-text-secondary)" }}>Directorio colaborativo de negocios por toda España</p>
</div>
</div>
{/* Confirmación enviada */}
{enviado && (
<div role="status" style={{ background: "#EAFAF1", border: "1px solid #A9DFBF", borderRadius: "var(--border-radius-md)", padding: "12px 16px", marginBottom: "1rem", display: "flex", alignItems: "center", gap: 10 }}>
<span style={{ fontSize: 20 }} aria-hidden="true">✅</span>
<div>
<p style={{ margin: 0, fontWeight: 600, color: "#1E8449", fontSize: 14 }}>¡Propuesta enviada!</p>
<p style={{ margin: 0, fontSize: 13, color: "#1E8449" }}>El administrador revisará tu propuesta y la publicará si es correcta.</p>
</div>
</div>
)}
{/* Barra de filtros: sección única compartida por lista y mapa.
El estado vive aquí y se pasa por props; la derivación
localesFiltrados es compartida con el mapa. */}
<BarraFiltros
locales={locales} favoritos={favoritos}
busqueda={busqueda} setBusqueda={setBusqueda}
filtroCategoria={filtroCategoria} setFiltroCategoria={setFiltroCategoria}
filtroProvincia={filtroProvincia} setFiltroProvincia={setFiltroProvincia}
orden={orden} setOrden={setOrden}
soloFavoritos={soloFavoritos} setSoloFavoritos={setSoloFavoritos}
ubicacion={ubicacion} buscandoUbicacion={buscandoUbicacion} errorUbicacion={errorUbicacion}
pedirUbicacion={pedirUbicacion} limpiarUbicacion={limpiarUbicacion}
/>
<MapView
businesses={businesses}
selectedId={selectedId}
onSelect={setSelectedId}
pickingLocation={formStep === "picking"}
onPickLocation={handlePickLocation}
pickedLocation={pickedLocation}
/>
{formStep === "editing" && (
<SubmitForm
pickedLocation={pickedLocation}
onSubmit={handleSubmit}
onCancel={handleCancel}
onRepick={() => setFormStep("picking")}
/>
)}
{adminOpen && (
<AdminPanel
onClose={() => setAdminOpen(false)}
onApproved={loadBusinesses}
{/* Tabs */}
<div role="tablist" aria-label="Vista de locales" style={{ display: "flex", gap: 6, marginBottom: "1rem", borderBottom: "0.5px solid var(--color-border-tertiary)", paddingBottom: 8 }}>
{[{ id: "lista", label: "Lista", icon: "ti-list" }, { id: "mapa", label: "Mapa", icon: "ti-map-2" }].map((v) => (
<button key={v.id} role="tab" aria-selected={vista === v.id} onClick={() => setVista(v.id)}
style={{ background: vista === v.id ? "#8B0000" : "none", color: vista === v.id ? "white" : "var(--color-text-secondary)", border: `0.5px solid ${vista === v.id ? "#8B0000" : "var(--color-border-tertiary)"}`, borderRadius: "var(--border-radius-md)", padding: "6px 14px", fontSize: 13, fontWeight: 500, cursor: "pointer", display: "flex", alignItems: "center", gap: 5 }}>
<i className={`ti ${v.icon}`} aria-hidden="true"></i> {v.label}
</button>
))}
</div>
{vista === "lista" && (
<>
{loading ? (
<div style={{ textAlign: "center", padding: "3rem", color: "var(--color-text-tertiary)", fontSize: 14 }}>
<i className="ti ti-loader" style={{ fontSize: 24, display: "block", marginBottom: 8 }} aria-hidden="true"></i>
Cargando locales...
</div>
) : localesFiltrados.length === 0 ? (
<div style={{ textAlign: "center", padding: "3rem", color: "var(--color-text-tertiary)" }}>
<div style={{ fontSize: 40, marginBottom: 12 }} aria-hidden="true">🏘️</div>
<p style={{ margin: 0, fontWeight: 500 }}>
{locales.length === 0 ? "Todavía no hay locales publicados" : soloFavoritos ? "Aún no tienes favoritos guardados" : "No hay locales que coincidan"}
</p>
<p style={{ margin: "6px 0 0", fontSize: 13 }}>{soloFavoritos ? "Pulsa el corazón ♥ en un local para guardarlo aquí" : "Sé el primero en proponer uno — el administrador lo revisará y publicará"}</p>
</div>
) : (
<div style={{ display: "grid", gap: 10 }}>
{localesFiltrados.map((local) => (
<div key={local.id} style={localDestacado === local.id ? { outline: "2px solid #8B0000", borderRadius: "var(--border-radius-lg)" } : undefined}>
<LocalCard
local={local}
distanciaKm={ubicacion && local.lat && local.lng ? calcularDistanciaKm(ubicacion.lat, ubicacion.lng, local.lat, local.lng) : null}
/>
</div>
))}
{localesFiltrados.length < locales.length && (
<p style={{ textAlign: "center", fontSize: 12, color: "var(--color-text-tertiary)", margin: "4px 0" }}>
Mostrando {localesFiltrados.length} de {locales.length} locales
</p>
)}
</div>
)}
</>
)}
{/* El contenedor del mapa se mantiene siempre montado (solo se oculta con
CSS) para que Leaflet no pierda su instancia al cambiar de pestaña. */}
<div style={{ display: vista === "mapa" ? "block" : "none", borderRadius: "var(--border-radius-lg)", overflow: "hidden", border: "0.5px solid var(--color-border-tertiary)" }}>
<div style={{ padding: "8px 12px", background: "var(--color-background-secondary)", borderBottom: "0.5px solid var(--color-border-tertiary)", display: "flex", flexWrap: "wrap", gap: 10 }}>
{NOMBRES_CATEGORIAS.map((cat) => (
<span key={cat} style={{ fontSize: 11, display: "flex", alignItems: "center", gap: 4, color: "var(--color-text-secondary)" }}>
<span style={{ width: 10, height: 10, borderRadius: 2, background: COLORES_MAPA[cat], display: "inline-block", flexShrink: 0 }} aria-hidden="true"></span>
{CATEGORIAS[cat].emoji} {cat}
</span>
))}
</div>
{locales.length === 0 && <div style={{ textAlign: "center", padding: "1rem", background: "var(--color-background-secondary)", fontSize: 13, color: "var(--color-text-secondary)" }}>Todavía no hay locales publicados</div>}
{locales.length > 0 && localesFiltrados.length === 0 && <div style={{ textAlign: "center", padding: "1rem", background: "var(--color-background-secondary)", fontSize: 13, color: "var(--color-text-secondary)" }}>Ningún local coincide con el filtro seleccionado</div>}
<div ref={mapRef} style={{ height: 440, width: "100%" }} role="img" aria-label="Mapa de España con los locales publicados"></div>
<div style={{ padding: "8px 12px", background: "var(--color-background-secondary)", borderTop: "0.5px solid var(--color-border-tertiary)", display: "flex", gap: 12, alignItems: "center" }}>
<span style={{ fontSize: 12, color: "var(--color-text-secondary)" }}>
<i className="ti ti-map-pin" aria-hidden="true" style={{ marginRight: 4 }}></i>
{localesFiltrados.length} {localesFiltrados.length === 1 ? "local marcado" : "locales marcados"}
{localesFiltrados.length !== locales.length && ` de ${locales.length}`}
</span>
</div>
</div>
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", textAlign: "center", marginTop: "1.5rem" }}>
Los locales pasan por revisión antes de publicarse · ¿Tienes un negocio? Proponlo con el botón flotante ➕
{" · "}
<button type="button" onClick={() => setMostrarPrivacidad(true)} style={{ background: "none", border: "none", padding: 0, fontSize: 11, color: "var(--color-text-tertiary)", textDecoration: "underline", cursor: "pointer" }}>
Política de privacidad
</button>
</p>
{/* Botones de propuesta (ambos abren la misma pasarela) y modal */}
<BotonFlotante onClick={abrirPasarela} />
<BotonProponerArriba onClick={abrirPasarela} />
{pasarelaAbierta && (
<ModalPasarela
form={form}
setForm={setForm}
onCerrar={cerrarPasarela}
onEnviar={enviarLocal}
onConfirmarDuplicado={confirmarPeseADuplicado}
onDescartarDuplicado={() => setPosibleDuplicado(null)}
aceptaPrivacidad={aceptaPrivacidad}
setAceptaPrivacidad={setAceptaPrivacidad}
onAbrirPrivacidad={() => setMostrarPrivacidad(true)}
errorFiltro={errorFiltro}
posibleDuplicado={posibleDuplicado}
comprobandoDuplicado={comprobandoDuplicado}
saving={saving}
/>
)}
{mostrarPrivacidad && <ModalPrivacidad onCerrar={() => setMostrarPrivacidad(false)} />}
<BannerMovil />
</div>
);
}
+383
View File
@@ -0,0 +1,383 @@
import { useState, useEffect, useCallback } from "react";
import { suscribirLocales, enviarPropuesta, obtenerPalabrasFiltradas, contienepalabrasProhibidas } from "./firebase.js";
const CATEGORIAS = {
"Restauración": { emoji:"🍽️", color:"#8B0000", bg:"#FFF0F0", text:"#8B0000", subcategorias:["Tapas y raciones","Paella y arroces","Pintxos","Asador / Carne a la brasa","Mariscos y pescados","Bocadillos y montaditos","Menú del día","Cocina vasca","Cocina catalana","Cocina andaluza","Cocina gallega","Cocina madrileña","Cocina mediterránea","Pizzería","Hamburguesería","Comida rápida","Cocina internacional","Cafetería / Desayunos","Heladería","Pastelería"] },
"Pequeño comercio": { emoji:"🛍️", color:"#1A5276", bg:"#EBF5FB", text:"#1A5276", subcategorias:["Alimentación / Ultramarinos","Frutería","Carnicería","Pescadería","Panadería","Farmacia","Papelería / Librería","Floristería","Joyería / Relojería","Zapatería","Ropa y moda","Juguetería","Ferretería","Bazar / Todo a 100","Estanco","Quiosco","Óptica","Ortopedia","Tienda de mascotas","Electrodomésticos"] },
"Peluquería y estética": { emoji:"✂️", color:"#76448A", bg:"#F5EEF8", text:"#76448A", subcategorias:["Peluquería señora","Peluquería caballero","Peluquería unisex","Barbería","Centro de estética","Uñas / Manicura","Depilación","Masajes y spa","Tatuajes y piercings","Centro de bronceado","Micropigmentación"] },
"Servicios del hogar": { emoji:"🔧", color:"#1E8449", bg:"#EAFAF1", text:"#1E8449", subcategorias:["Cerrajería","Fontanería / Plomería","Electricidad","Reformas y construcción","Pintura","Carpintería","Cristalería","Climatización / Aire acondicionado","Mudanzas","Limpieza","Jardinería","Instalación solar","Alarmas y seguridad","Reparación electrodomésticos"] },
"Otros": { emoji:"📌", color:"#784212", bg:"#FDF2E9", text:"#784212", subcategorias:["Taller mecánico","Lavado de coches","Academia / Clases","Gestoría / Asesoría","Inmobiliaria","Agencia de viajes","Fotografía","Informática / Reparación móviles","Copistería / Imprenta","Veterinaria","Gimnasio / Fitness","Centro médico / Clínica","Fisioterapia","Psicología","Lavandería","Tintorería","Otro"] },
};
const CATS = Object.keys(CATEGORIAS);
const PROVINCIAS = ["Álava","Albacete","Alicante","Almería","Asturias","Ávila","Badajoz","Barcelona","Burgos","Cáceres","Cádiz","Cantabria","Castellón","Ciudad Real","Córdoba","Cuenca","Gerona","Granada","Guadalajara","Guipúzcoa","Huelva","Huesca","Islas Baleares","Jaén","La Coruña","La Rioja","Las Palmas","León","Lérida","Lugo","Madrid","Málaga","Murcia","Navarra","Orense","Palencia","Pontevedra","Salamanca","Santa Cruz de Tenerife","Segovia","Sevilla","Soria","Tarragona","Teruel","Toledo","Valencia","Valladolid","Vizcaya","Zamora","Zaragoza"];
const COORDS = {"Álava":[42.85,-2.67],"Albacete":[38.99,-1.86],"Alicante":[38.35,-0.48],"Almería":[36.83,-2.46],"Asturias":[43.36,-5.86],"Ávila":[40.66,-4.68],"Badajoz":[38.88,-6.97],"Barcelona":[41.39,2.17],"Burgos":[42.34,-3.70],"Cáceres":[39.48,-6.37],"Cádiz":[36.53,-6.29],"Cantabria":[43.46,-3.81],"Castellón":[39.99,-0.05],"Ciudad Real":[38.98,-3.93],"Córdoba":[37.89,-4.78],"Cuenca":[40.07,-2.14],"Gerona":[41.98,2.82],"Granada":[37.18,-3.60],"Guadalajara":[40.63,-3.16],"Guipúzcoa":[43.32,-1.98],"Huelva":[37.26,-6.94],"Huesca":[42.14,-0.41],"Islas Baleares":[39.57,2.65],"Jaén":[37.78,-3.78],"La Coruña":[43.36,-8.41],"La Rioja":[42.46,-2.44],"Las Palmas":[28.12,-15.44],"León":[42.60,-5.57],"Lérida":[41.62,0.62],"Lugo":[43.01,-7.56],"Madrid":[40.42,-3.70],"Málaga":[36.72,-4.42],"Murcia":[37.99,-1.13],"Navarra":[42.82,-1.64],"Orense":[42.34,-7.86],"Palencia":[42.01,-4.53],"Pontevedra":[42.43,-8.65],"Salamanca":[40.97,-5.66],"Santa Cruz de Tenerife":[28.46,-16.25],"Segovia":[40.94,-4.11],"Sevilla":[37.39,-5.98],"Soria":[41.76,-2.46],"Tarragona":[41.12,1.24],"Teruel":[40.34,-1.11],"Toledo":[39.86,-4.03],"Valencia":[39.47,-0.38],"Valladolid":[41.65,-4.72],"Vizcaya":[43.26,-2.94],"Zamora":[41.50,-5.74],"Zaragoza":[41.65,-0.89]};
async function geocodificar(dir) {
try {
const q = encodeURIComponent(dir + ", España");
const r = await fetch(`https://nominatim.openstreetmap.org/search?q=${q}&format=json&limit=1&countrycodes=es`, { headers:{"Accept-Language":"es","User-Agent":"LocalesMovil/1.0"} });
const d = await r.json();
if (d?.length) return { lat: parseFloat(d[0].lat), lng: parseFloat(d[0].lon) };
} catch {}
return null;
}
function parsearGoogleMaps(url) {
try {
let m = url.match(/@(-?\d+\.\d+),(-?\d+\.\d+)/);
if (m) return { lat: parseFloat(m[1]), lng: parseFloat(m[2]) };
m = url.match(/!3d(-?\d+\.\d+)!4d(-?\d+\.\d+)/);
if (m) return { lat: parseFloat(m[1]), lng: parseFloat(m[2]) };
} catch {}
return null;
}
// ─── Estilos base móvil ───────────────────────────────────────────────────────
const S = {
screen: { minHeight:"100dvh", display:"flex", flexDirection:"column", background:"#F8F5F0", fontFamily:"'Georgia', serif" },
header: { background:"#8B0000", color:"white", padding:"14px 16px 10px", position:"sticky", top:0, zIndex:10 },
headerTitle: { margin:0, fontSize:20, fontWeight:700, letterSpacing:"-0.3px" },
headerSub: { margin:"2px 0 0", fontSize:12, opacity:0.75 },
body: { flex:1, overflowY:"auto", padding:"12px 14px 80px" },
navBar: { position:"fixed", bottom:0, left:0, right:0, background:"white", borderTop:"1px solid #E5DDD5", display:"flex", zIndex:10, padding:"4px 0" },
navBtn: (active) => ({ flex:1, display:"flex", flexDirection:"column", alignItems:"center", gap:3, padding:"6px 0", background:"none", border:"none", cursor:"pointer", color: active ? "#8B0000" : "#999", fontSize:10, fontWeight: active ? 700 : 400 }),
navIcon: (active) => ({ fontSize:22, lineHeight:1, color: active ? "#8B0000" : "#999" }),
card: { background:"white", borderRadius:12, padding:"14px 16px", marginBottom:10, border:"1px solid #EEE8E0" },
badge: (cat) => { const c = CATEGORIAS[cat]; return { background: c?.bg||"#eee", color: c?.text||"#555", fontSize:11, padding:"3px 9px", borderRadius:20, fontWeight:500, display:"inline-block" }; },
input: { width:"100%", boxSizing:"border-box", padding:"11px 13px", borderRadius:10, border:"1px solid #DDD7CF", background:"white", fontSize:15, outline:"none", fontFamily:"inherit" },
label: { fontSize:12, color:"#888", display:"block", marginBottom:5, fontWeight:600, textTransform:"uppercase", letterSpacing:"0.4px" },
btn: (primary) => ({ width:"100%", padding:"13px", borderRadius:10, border:"none", cursor:"pointer", fontSize:15, fontWeight:700, background: primary ? "#8B0000" : "#F0EBE5", color: primary ? "white" : "#666", fontFamily:"inherit" }),
stars: (n) => "★".repeat(n)+"☆".repeat(5-n),
};
// ─── Pantalla: Lista ──────────────────────────────────────────────────────────
function PantallaLista({ locales, onDelete, onBuscar, busqueda, filtroCat, setFiltroCat }) {
const filtrados = locales.filter(l => {
const q = busqueda.toLowerCase();
return (!q || l.nombre.toLowerCase().includes(q) || (l.direccion||"").toLowerCase().includes(q) || l.provincia.toLowerCase().includes(q))
&& (!filtroCat || l.categoria === filtroCat);
});
return (
<>
<div style={{ marginBottom:12 }}>
<input style={S.input} placeholder="🔍 Buscar nombre, ciudad..." value={busqueda} onChange={e => onBuscar(e.target.value)} />
</div>
{/* Chips categoría */}
<div style={{ display:"flex", gap:6, overflowX:"auto", paddingBottom:8, marginBottom:10, scrollbarWidth:"none" }}>
<button onClick={() => setFiltroCat("")} style={{ ...S.badge("Restauración"), background: !filtroCat?"#8B0000":"#EEE8E0", color: !filtroCat?"white":"#777", flexShrink:0, cursor:"pointer", border:"none", fontFamily:"inherit" }}>Todos</button>
{CATS.map(c => (
<button key={c} onClick={() => setFiltroCat(filtroCat===c?"":c)}
style={{ ...S.badge(c), flexShrink:0, cursor:"pointer", border: filtroCat===c?"1.5px solid "+CATEGORIAS[c].color:"1px solid transparent", fontFamily:"inherit" }}>
{CATEGORIAS[c].emoji} {c}
</button>
))}
</div>
{filtrados.length === 0 ? (
<div style={{ textAlign:"center", padding:"3rem 1rem", color:"#AAA" }}>
<div style={{ fontSize:48, marginBottom:12 }}>🏘️</div>
<p style={{ margin:0, fontSize:15, color:"#888" }}>{locales.length===0 ? "¡Sé el primero en añadir un local!" : "Sin resultados"}</p>
</div>
) : filtrados.map(local => (
<div key={local.id} style={S.card}>
<div style={{ display:"flex", justifyContent:"space-between", alignItems:"flex-start", marginBottom:8 }}>
<div style={{ flex:1 }}>
<p style={{ margin:0, fontWeight:700, fontSize:16, color:"#1A1A1A" }}>{local.nombre}</p>
<p style={{ margin:"2px 0 0", fontSize:13, color:"#888" }}>📍 {local.provincia}</p>
</div>
<button onClick={() => onDelete(local.id)} style={{ background:"none", border:"none", color:"#CCC", fontSize:18, cursor:"pointer", padding:"0 0 0 8px" }}>✕</button>
</div>
<div style={{ display:"flex", flexWrap:"wrap", gap:5, marginBottom:8 }}>
<span style={S.badge(local.categoria)}>{CATEGORIAS[local.categoria]?.emoji} {local.categoria}</span>
{local.subcategoria && <span style={{ fontSize:11, color:"#888", padding:"3px 8px", background:"#F5F5F5", borderRadius:20 }}>{local.subcategoria}</span>}
</div>
{local.direccion && <p style={{ margin:"0 0 6px", fontSize:13, color:"#666" }}>{local.direccion}</p>}
<div style={{ display:"flex", justifyContent:"space-between", alignItems:"center" }}>
<span style={{ color:"#D4AF37", fontSize:18, letterSpacing:1 }}>{S.stars(local.puntuacion)}</span>
{(local.direccion || local.enlaceGoogleMaps) && (
<a href={local.enlaceGoogleMaps || `https://www.google.com/maps/search/${encodeURIComponent(local.nombre+" "+local.direccion)}`}
target="_blank" rel="noopener noreferrer"
style={{ fontSize:12, color:"#1A73E8", textDecoration:"none", background:"#E8F0FE", padding:"4px 10px", borderRadius:8, fontWeight:600 }}>
Maps ↗
</a>
)}
</div>
{local.descripcion && <p style={{ margin:"8px 0 0", fontSize:13, color:"#666", fontStyle:"italic" }}>"{local.descripcion}"</p>}
</div>
))}
</>
);
}
// ─── Pantalla: Añadir ─────────────────────────────────────────────────────────
function PantallaAnadir({ onGuardar }) {
const [form, setForm] = useState({ nombre:"", provincia:"", categoria:"", subcategoria:"", direccion:"", enlaceGoogleMaps:"", puntuacion:0, descripcion:"" });
const [modoUbic, setModoUbic] = useState("direccion");
const [geocodif, setGeocodif] = useState(null);
const [guardando, setGuardando] = useState(false);
const [ok, setOk] = useState(false);
const valido = form.nombre && form.provincia && form.categoria && form.puntuacion > 0 && (form.direccion || form.enlaceGoogleMaps);
const guardar = async () => {
if (!valido) return;
setGuardando(true);
let lat, lng;
if (modoUbic === "direccion" && form.direccion) {
const geo = await geocodificar(form.direccion);
if (geo) { lat = geo.lat; lng = geo.lng; }
} else if (form.enlaceGoogleMaps) {
const c = parsearGoogleMaps(form.enlaceGoogleMaps);
if (c) { lat = c.lat; lng = c.lng; }
}
if (!lat) {
const fb = COORDS[form.provincia] || [40.4,-3.7];
lat = fb[0] + (Math.random()-0.5)*0.04;
lng = fb[1] + (Math.random()-0.5)*0.04;
}
await onGuardar({ ...form, lat, lng, id: Date.now().toString(), fecha: new Date().toISOString() });
setOk(true);
setGuardando(false);
setTimeout(() => {
setOk(false);
setForm({ nombre:"", provincia:"", categoria:"", subcategoria:"", direccion:"", enlaceGoogleMaps:"", puntuacion:0, descripcion:"" });
setGeocodif(null);
}, 1500);
};
if (ok) return (
<div style={{ display:"flex", flexDirection:"column", alignItems:"center", justifyContent:"center", minHeight:"60vh", gap:16 }}>
<div style={{ fontSize:64 }}>✅</div>
<p style={{ fontSize:18, fontWeight:700, color:"#1E8449", margin:0 }}>¡Local añadido!</p>
<p style={{ fontSize:14, color:"#888", margin:0 }}>Sincronizando con la web...</p>
</div>
);
return (
<div style={{ paddingBottom:20 }}>
<div style={{ marginBottom:16 }}>
<label style={S.label}>Nombre del local *</label>
<input style={S.input} placeholder="Bar El Olivo, Clínica San José..." value={form.nombre} onChange={e => setForm(f=>({...f,nombre:e.target.value}))} />
</div>
<div style={{ marginBottom:16 }}>
<label style={S.label}>Provincia *</label>
<select style={S.input} value={form.provincia} onChange={e => setForm(f=>({...f,provincia:e.target.value}))}>
<option value="">Selecciona...</option>
{PROVINCIAS.map(p => <option key={p} value={p}>{p}</option>)}
</select>
</div>
<div style={{ marginBottom:16 }}>
<label style={S.label}>Categoría *</label>
<select style={S.input} value={form.categoria} onChange={e => setForm(f=>({...f,categoria:e.target.value,subcategoria:""}))}>
<option value="">Selecciona...</option>
{CATS.map(c => <option key={c} value={c}>{CATEGORIAS[c].emoji} {c}</option>)}
</select>
</div>
{form.categoria && (
<div style={{ marginBottom:16 }}>
<label style={S.label}>Tipo específico</label>
<select style={S.input} value={form.subcategoria} onChange={e => setForm(f=>({...f,subcategoria:e.target.value}))}>
<option value="">Selecciona...</option>
{CATEGORIAS[form.categoria].subcategorias.map(s => <option key={s} value={s}>{s}</option>)}
</select>
</div>
)}
{/* Ubicación */}
<div style={{ marginBottom:16 }}>
<label style={S.label}>Ubicación *</label>
<div style={{ display:"flex", border:"1px solid #DDD7CF", borderRadius:10, overflow:"hidden", marginBottom:8 }}>
{[{id:"direccion",label:"📍 Dirección"},{id:"enlace",label:"🔗 Google Maps"}].map(opt => (
<button key={opt.id} onClick={() => { setModoUbic(opt.id); setForm(f=>({...f,direccion:"",enlaceGoogleMaps:""})); setGeocodif(null); }}
style={{ flex:1, padding:"10px 6px", border:"none", background: modoUbic===opt.id?"#F0EBE5":"white", fontSize:13, cursor:"pointer", fontWeight: modoUbic===opt.id?700:400, color: modoUbic===opt.id?"#8B0000":"#666", fontFamily:"inherit" }}>
{opt.label}
</button>
))}
</div>
{modoUbic === "direccion" ? (
<input style={S.input} placeholder="Calle Mayor 5, Madrid..." value={form.direccion}
onChange={e => { setForm(f=>({...f,direccion:e.target.value})); setGeocodif(null); }} />
) : (
<input style={S.input} placeholder="Pega el enlace de Google Maps..." value={form.enlaceGoogleMaps}
onChange={e => {
const val = e.target.value;
setForm(f=>({...f,enlaceGoogleMaps:val}));
const c = parsearGoogleMaps(val);
setGeocodif(c ? "✅ Coordenadas detectadas" : val ? "⚠️ No se detectaron coordenadas" : null);
}} />
)}
{geocodif && <p style={{ fontSize:12, color:geocodif.startsWith("✅")?"#1E8449":"#784212", margin:"6px 0 0" }}>{geocodif}</p>}
</div>
{/* Puntuación */}
<div style={{ marginBottom:16 }}>
<label style={S.label}>Puntuación *</label>
<div style={{ display:"flex", gap:8 }}>
{[1,2,3,4,5].map(n => (
<button key={n} onClick={() => setForm(f=>({...f,puntuacion:n}))}
style={{ fontSize:32, background:"none", border:"none", cursor:"pointer", color: n<=form.puntuacion?"#D4AF37":"#DDD", padding:0 }}>★</button>
))}
</div>
</div>
<div style={{ marginBottom:24 }}>
<label style={S.label}>Descripción (opcional)</label>
<textarea style={{ ...S.input, minHeight:80, resize:"vertical" }} placeholder="Horarios, especialidades, qué lo hace especial..."
value={form.descripcion} onChange={e => setForm(f=>({...f,descripcion:e.target.value}))} />
</div>
<button onClick={guardar} disabled={!valido||guardando} style={{ ...S.btn(true), opacity: valido?1:0.4 }}>
{guardando ? "Enviando..." : "📨 Enviar propuesta"}
</button>
</div>
);
}
// ─── Pantalla: Estadísticas ───────────────────────────────────────────────────
function PantallaStats({ locales }) {
const media = locales.length ? (locales.reduce((s,l)=>s+l.puntuacion,0)/locales.length).toFixed(1) : "—";
const provincias = [...new Set(locales.map(l=>l.provincia))].length;
const porCat = CATS.map(c => ({ cat:c, n: locales.filter(l=>l.categoria===c).length })).filter(x=>x.n>0).sort((a,b)=>b.n-a.n);
const top5 = [...locales].sort((a,b)=>b.puntuacion-a.puntuacion).slice(0,5);
return (
<>
<div style={{ display:"grid", gridTemplateColumns:"1fr 1fr", gap:10, marginBottom:14 }}>
{[{v:locales.length,l:"Locales"},{v:provincias,l:"Provincias"},{v:media,l:"Media ★"},{v:porCat.length,l:"Categorías"}].map(s=>(
<div key={s.l} style={{ background:"white", borderRadius:12, padding:"14px 16px", border:"1px solid #EEE8E0", textAlign:"center" }}>
<p style={{ margin:0, fontSize:11, color:"#AAA", textTransform:"uppercase", letterSpacing:"0.5px", fontWeight:600 }}>{s.l}</p>
<p style={{ margin:"6px 0 0", fontSize:28, fontWeight:700, color:"#1A1A1A" }}>{s.v}</p>
</div>
))}
</div>
{porCat.length > 0 && (
<div style={S.card}>
<p style={{ margin:"0 0 12px", fontWeight:700, fontSize:14, color:"#555", textTransform:"uppercase", letterSpacing:"0.4px" }}>Por categoría</p>
{porCat.map(({cat,n}) => {
const pct = Math.round((n/locales.length)*100);
return (
<div key={cat} style={{ marginBottom:10 }}>
<div style={{ display:"flex", justifyContent:"space-between", marginBottom:4 }}>
<span style={{ fontSize:14 }}>{CATEGORIAS[cat].emoji} {cat}</span>
<span style={{ fontSize:13, fontWeight:700, color:CATEGORIAS[cat].color }}>{n}</span>
</div>
<div style={{ background:"#F0EBE5", borderRadius:4, height:6, overflow:"hidden" }}>
<div style={{ height:"100%", background:CATEGORIAS[cat].color, width:pct+"%", borderRadius:4 }} />
</div>
</div>
);
})}
</div>
)}
{top5.length > 0 && (
<div style={S.card}>
<p style={{ margin:"0 0 12px", fontWeight:700, fontSize:14, color:"#555", textTransform:"uppercase", letterSpacing:"0.4px" }}>Top valorados</p>
{top5.map((l,i) => (
<div key={l.id} style={{ display:"flex", alignItems:"center", gap:10, marginBottom:10 }}>
<span style={{ fontSize:18, fontWeight:700, color:"#D4AF37", minWidth:24 }}>#{i+1}</span>
<div style={{ flex:1 }}>
<p style={{ margin:0, fontSize:14, fontWeight:600 }}>{l.nombre}</p>
<p style={{ margin:0, fontSize:12, color:"#888" }}>{l.provincia}</p>
</div>
<span style={{ color:"#D4AF37", fontSize:14 }}>{"★".repeat(l.puntuacion)}</span>
</div>
))}
</div>
)}
<p style={{ textAlign:"center", fontSize:12, color:"#BBB", marginTop:16 }}>
Datos sincronizados con la versión web
</p>
</>
);
}
// ─── App principal ────────────────────────────────────────────────────────────
export default function AppMovil() {
const [tab, setTab] = useState("lista");
const [locales, setLocales] = useState([]);
const [loading, setLoading] = useState(true);
const [busqueda, setBusqueda] = useState("");
const [filtroCat, setFiltroCat] = useState("");
const [palabrasProhibidas, setPalabrasProhibidas] = useState([]);
const cargar = useCallback(() => {}, []); // Firestore ya escucha en tiempo real
useEffect(() => {
setLoading(true);
const unsub = suscribirLocales(
(lista) => { setLocales(lista); setLoading(false); },
() => { setLocales([]); setLoading(false); }
);
return () => unsub();
}, []);
useEffect(() => { obtenerPalabrasFiltradas().then(p => setPalabrasProhibidas(p)); }, []);
const addLocal = async (local) => {
// Comprobar filtro de palabras
const texto = [local.nombre, local.descripcion||"", local.direccion||""].join(" ");
if (contienepalabrasProhibidas(texto, palabrasProhibidas)) {
alert("Tu propuesta contiene palabras no permitidas. Por favor, revísala.");
return;
}
try { await enviarPropuesta(local); } catch(e) { console.error(e); }
};
const delLocal = null; // Solo el admin puede eliminar locales
const TABS = [
{ id:"lista", icon:"🗂️", label:"Lista" },
{ id:"anadir", icon:"➕", label:"Añadir" },
{ id:"stats", icon:"📊", label:"Stats" },
];
return (
<div style={S.screen}>
{/* Header */}
<div style={S.header}>
<div style={{ display:"flex", alignItems:"center", gap:10 }}>
<span style={{ fontSize:26 }}>🇪🇸</span>
<div>
<h1 style={S.headerTitle}>Locales Españoles</h1>
<p style={S.headerSub}>{loading ? "Cargando..." : `${locales.length} ${locales.length===1?"local":"locales"} · sincronizado`}</p>
</div>
<button onClick={cargar} style={{ marginLeft:"auto", background:"rgba(255,255,255,0.2)", border:"none", borderRadius:8, padding:"6px 10px", color:"white", cursor:"pointer", fontSize:18 }}>↻</button>
</div>
</div>
{/* Contenido */}
<div style={S.body}>
{loading ? (
<div style={{ textAlign:"center", padding:"4rem 1rem", color:"#AAA" }}>
<p style={{ fontSize:32, margin:"0 0 12px" }}>⏳</p>
<p style={{ margin:0, fontSize:15 }}>Sincronizando con la web...</p>
</div>
) : tab === "lista" ? (
<PantallaLista locales={locales} onDelete={null} onBuscar={setBusqueda} busqueda={busqueda} filtroCat={filtroCat} setFiltroCat={setFiltroCat} />
) : tab === "anadir" ? (
<PantallaAnadir onGuardar={async (local) => { await addLocal(local); setTab("lista"); }} />
) : (
<PantallaStats locales={locales} />
)}
</div>
{/* Nav bar inferior */}
<nav style={S.navBar}>
{TABS.map(t => (
<button key={t.id} onClick={() => setTab(t.id)} style={S.navBtn(tab===t.id)}>
<span style={S.navIcon(tab===t.id)}>{t.icon}</span>
{t.label}
</button>
))}
</nav>
</div>
);
}
+234
View File
@@ -0,0 +1,234 @@
// Local SQLite API instead of Firebase
const API_URL = "/api";
// Prefijo de las rutas de administración: la MISMA variable que usa el
// servidor (LOCALESP_ADMIN_PREFIX), expuesta al frontend por Vite mediante
// `envPrefix` (dev/build la recogen de .env o del entorno; el build falla si
// falta). El fallback "/api" solo aplica fuera de un build real (p. ej. tests).
const rawAdmin = String(import.meta.env.LOCALESP_ADMIN_PREFIX || "").trim().replace(/\/+$/, "");
const ADMIN_URL = rawAdmin ? (rawAdmin.startsWith("/") ? rawAdmin : `/${rawAdmin}`) : "/api";
export async function suscribirLocales(onData, onError) {
try {
const response = await fetch(`${API_URL}/locales`);
const data = await response.json();
onData(data);
// Simulate real-time by polling every 5 seconds
const interval = setInterval(async () => {
try {
const res = await fetch(`${API_URL}/locales`);
const newData = await res.json();
onData(newData);
} catch (err) {
console.error(err);
}
}, 5000);
return () => clearInterval(interval);
} catch (err) {
onError(err);
}
}
export async function suscribirPendientes(onData, onError) {
try {
const response = await fetch(`${ADMIN_URL}/pendientes`);
const data = await response.json();
onData(data);
// Simulate real-time by polling every 5 seconds
const interval = setInterval(async () => {
try {
const res = await fetch(`${ADMIN_URL}/pendientes`);
const newData = await res.json();
onData(newData);
} catch (err) {
console.error(err);
}
}, 5000);
return () => clearInterval(interval);
} catch (err) {
onError(err);
}
}
export async function enviarPropuesta(local) {
const { id: _x, ...datos } = local;
const response = await fetch(`${API_URL}/propuestas`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(datos),
});
return response.json();
}
export async function comprobarDuplicado({ nombre, provincia, lat, lng }) {
const response = await fetch(`${API_URL}/check-duplicado`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ nombre, provincia, lat, lng }),
});
return response.json();
}
export async function aprobarPropuesta(p) {
const response = await fetch(`${ADMIN_URL}/aprobar/${p.id}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
});
return response.json();
}
export async function rechazarPropuesta(id) {
const response = await fetch(`${ADMIN_URL}/rechazar/${id}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
});
return response.json();
}
export async function deleteLocal(id) {
const response = await fetch(`${ADMIN_URL}/locales/${id}`, {
method: "DELETE",
});
return response.json();
}
export async function confirmarLocal(id) {
const response = await fetch(`${API_URL}/locales/${id}/confirmar`, { method: "POST" });
return response.json();
}
export async function reportarLocal(id, motivo, comentario, resenaId) {
const response = await fetch(`${API_URL}/locales/${id}/reportar`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ motivo, comentario, resenaId }),
});
return response.json();
}
// --- Reseñas anónimas por local (issue #6) ---
// Identidad v1: deviceId del navegador. Con ?deviceId= el servidor marca
// esPropia en cada reseña (para precargar el formulario) sin exponer el
// deviceId completo (solo la huella corta por local).
export async function listarResenas(localId, deviceId) {
const q = deviceId ? `?deviceId=${encodeURIComponent(deviceId)}` : "";
const response = await fetch(`${API_URL}/locales/${localId}/resenas${q}`);
return response.json();
}
// Crear o editar (upsert) la reseña del dispositivo en el local.
export async function enviarResena(localId, { deviceId, puntuacion, comentario }) {
const response = await fetch(`${API_URL}/locales/${localId}/resenas`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ deviceId, puntuacion, comentario }),
});
const datos = await response.json().catch(() => ({}));
if (!response.ok) throw new Error(datos.error || "No se pudo guardar la reseña");
return datos;
}
// Borrar la reseña propia del dispositivo en el local.
export async function borrarResena(localId, deviceId) {
const response = await fetch(`${API_URL}/locales/${localId}/resenas?deviceId=${encodeURIComponent(deviceId)}`, {
method: "DELETE",
});
const datos = await response.json().catch(() => ({}));
if (!response.ok) throw new Error(datos.error || "No se pudo borrar la reseña");
return datos;
}
// Moderación: listado completo y borrado de cualquier reseña (admin).
export async function obtenerResenas() {
const response = await fetch(`${ADMIN_URL}/resenas`);
return response.json();
}
export async function borrarResenaAdmin(id) {
const response = await fetch(`${ADMIN_URL}/resenas/${id}`, { method: "DELETE" });
return response.json();
}
export async function obtenerReportes() {
const response = await fetch(`${ADMIN_URL}/reportes`);
return response.json();
}
export async function descartarReporte(id) {
const response = await fetch(`${ADMIN_URL}/reportes/${id}/descartar`, { method: "POST" });
return response.json();
}
export async function obtenerPalabrasFiltradas() {
try {
const response = await fetch(`${API_URL}/config/filtro_palabras`);
const data = await response.json();
return data.palabras || [];
} catch {
return [];
}
}
export async function guardarPalabrasFiltradas(palabras) {
const response = await fetch(`${API_URL}/config/filtro_palabras`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ palabras }),
});
return response.json();
}
export function contienepalabrasProhibidas(texto, lista) {
if (!lista?.length) return false;
const norm = s => s.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "");
const t = norm(texto);
return lista.some(p => t.includes(norm(p)));
}
// Auth helpers (local implementation)
let currentUser = null;
export function escucharAuth(cb) {
// Simple localStorage-based auth
// Robusto ante valores corruptos/legados: si el JSON no parsea, se limpia y
// se trata como sesión cerrada (antes esto rompía /admin en blanco).
let user = null;
try {
const raw = localStorage.getItem("user");
user = raw ? JSON.parse(raw) : null;
} catch {
try { localStorage.removeItem("user"); } catch { /* almacenamiento no disponible */ }
user = null;
}
currentUser = user;
cb(currentUser);
// Listen for storage changes
const handleStorageChange = () => {
const user = localStorage.getItem("user");
currentUser = user ? JSON.parse(user) : null;
cb(currentUser);
};
window.addEventListener("storage", handleStorageChange);
return () => window.removeEventListener("storage", handleStorageChange);
}
export async function loginAdmin(email, password) {
// Simple email/password check (in production use proper auth)
if (email && password) {
const user = { email, uid: email };
localStorage.setItem("user", JSON.stringify(user));
currentUser = user;
return user;
}
throw new Error("Invalid email or password");
}
export async function registrarAdmin(email, password) {
return loginAdmin(email, password);
}
export async function cerrarSesion() {
localStorage.removeItem("user");
currentUser = null;
}
-55
View File
@@ -1,55 +0,0 @@
import { useEffect, useState } from "react";
import { getPending, setStatus } from "../services/businessRepository.js";
export default function AdminPanel({ onClose, onApproved }) {
const [pending, setPending] = useState([]);
const [loading, setLoading] = useState(true);
async function load() {
setLoading(true);
setPending(await getPending());
setLoading(false);
}
useEffect(() => { load(); }, []);
async function handle(id, status) {
await setStatus(id, status);
await load();
onApproved();
}
return (
<div className="modal-backdrop" onClick={onClose}>
<div className="modal admin-panel" onClick={(e) => e.stopPropagation()}>
<div className="admin-header">
<h2>Propuestas pendientes</h2>
<button className="close" onClick={onClose} aria-label="Cerrar">×</button>
</div>
{loading && <p className="admin-empty">Cargando…</p>}
{!loading && pending.length === 0 && (
<p className="admin-empty">No hay propuestas pendientes.</p>
)}
{!loading && pending.map((b) => (
<div key={b.id} className="admin-item">
<div className="admin-item-info">
<strong>{b.name}</strong>
<span className="badge">{b.category}</span>
<p>{b.address}</p>
<p className="admin-desc">{b.description}</p>
{b.contact && <p className="admin-contact">{b.contact}</p>}
<p className="admin-coords">{b.lat.toFixed(4)}, {b.lng.toFixed(4)}</p>
</div>
<div className="admin-actions">
<button className="approve" onClick={() => handle(b.id, "approved")}>Aprobar</button>
<button className="reject" onClick={() => handle(b.id, "rejected")}>Rechazar</button>
</div>
</div>
))}
</div>
</div>
);
}
+103
View File
@@ -0,0 +1,103 @@
import { useEffect, useRef, useState } from "react";
import { buscarLugares } from "../utils/geo.js";
import { PROVINCIAS } from "../constants/provincias.js";
import { inputStyle } from "../styles/shared.js";
const normaliza = (s) => (s || "").toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").trim();
function emparejarProvincia(texto) {
const t = normaliza(texto);
if (!t) return "";
return PROVINCIAS.find((p) => normaliza(p) === t || t.includes(normaliza(p))) || "";
}
// Campo "Nombre del local" con autocompletar: al escribir, busca lugares (OpenStreetMap)
// y permite seleccionar uno para rellenar automáticamente nombre, dirección, provincia y coordenadas.
export default function AutocompletarLocal({ form, setForm }) {
const [sugerencias, setSugerencias] = useState([]);
const [abierto, setAbierto] = useState(false);
const [buscando, setBuscando] = useState(false);
const debounceRef = useRef(null);
const cajaRef = useRef(null);
useEffect(() => {
function alClicFuera(e) {
if (cajaRef.current && !cajaRef.current.contains(e.target)) setAbierto(false);
}
document.addEventListener("mousedown", alClicFuera);
return () => document.removeEventListener("mousedown", alClicFuera);
}, []);
const handleChange = (val) => {
setForm((f) => ({ ...f, nombre: val }));
setAbierto(true);
clearTimeout(debounceRef.current);
if (val.trim().length < 3) { setSugerencias([]); return; }
debounceRef.current = setTimeout(async () => {
setBuscando(true);
try {
setSugerencias(await buscarLugares(val));
} catch {
setSugerencias([]);
}
setBuscando(false);
}, 450);
};
const seleccionar = (lugar) => {
setForm((f) => ({
...f,
nombre: lugar.nombre,
direccion: lugar.direccion,
enlaceGoogleMaps: "",
lat: lugar.lat,
lng: lugar.lng,
provincia: emparejarProvincia(lugar.provincia) || f.provincia,
}));
setSugerencias([]);
setAbierto(false);
};
return (
<div ref={cajaRef} style={{ position: "relative" }}>
<label htmlFor="campo-nombre" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>Nombre del local *</label>
<input
id="campo-nombre"
style={inputStyle}
autoComplete="off"
placeholder="Bar El Olivo, Clínica San José..."
value={form.nombre}
onChange={(e) => handleChange(e.target.value)}
onFocus={() => sugerencias.length && setAbierto(true)}
role="combobox"
aria-expanded={abierto && sugerencias.length > 0}
aria-autocomplete="list"
/>
{buscando && (
<i className="ti ti-loader" aria-hidden="true" style={{ position: "absolute", right: 10, top: 32, fontSize: 14, color: "var(--color-text-tertiary)" }}></i>
)}
{abierto && sugerencias.length > 0 && (
<div role="listbox" style={{
position: "absolute", zIndex: 20, top: "100%", left: 0, right: 0, marginTop: 4,
background: "var(--color-background-primary)", border: "0.5px solid var(--color-border-secondary)",
borderRadius: "var(--border-radius-md)", boxShadow: "0 6px 18px rgba(0,0,0,0.15)",
maxHeight: 240, overflowY: "auto",
}}>
{sugerencias.map((s) => (
<button key={s.id} type="button" role="option" onClick={() => seleccionar(s)}
style={{
display: "block", width: "100%", textAlign: "left", background: "none", border: "none",
borderBottom: "0.5px solid var(--color-border-tertiary)", padding: "8px 10px", cursor: "pointer",
}}>
<div style={{ fontSize: 13, fontWeight: 500, color: "var(--color-text-primary)" }}>{s.nombre}</div>
<div style={{ fontSize: 11, color: "var(--color-text-secondary)", marginTop: 2 }}>{s.direccion}</div>
</button>
))}
</div>
)}
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "4px 0 0" }}>
Escribe el nombre y elige una opción para rellenar dirección y ubicación automáticamente.
</p>
</div>
);
}
+125
View File
@@ -0,0 +1,125 @@
import { useEffect, useState } from "react";
import usePwaInstall from "../hooks/usePwaInstall.js";
import useEsMovil from "../hooks/useEsMovil.js";
import { ANCHO_CUERPO } from "../styles/shared.js";
const CLAVE_VISITAS = "localesp_visitas";
const CLAVE_CERRADO = "localesp_banner_cerrado_hasta";
const VISITAS_MINIMAS = 2;
const DIAS_OCULTO_TRAS_CERRAR = 14;
function registrarVisitaYContar() {
try {
const actual = parseInt(localStorage.getItem(CLAVE_VISITAS) || "0", 10) + 1;
localStorage.setItem(CLAVE_VISITAS, String(actual));
return actual;
} catch {
return VISITAS_MINIMAS; // si localStorage falla, no bloqueamos el banner
}
}
function estaCerradoRecientemente() {
try {
const hasta = parseInt(localStorage.getItem(CLAVE_CERRADO) || "0", 10);
return Date.now() < hasta;
} catch {
return false;
}
}
// Aviso flotante para instalar/abrir la PWA. Usa el service worker +
// manifest.webmanifest ya registrados en main.jsx/index.html: si el
// navegador soporta la instalación nativa (evento beforeinstallprompt),
// el botón la dispara directamente. Si la app ya se está ejecutando en
// modo standalone (o el navegador confirma que está instalada), el aviso
// se oculta porque ya no aporta nada mostrarlo.
//
// Colocación: abajo a la IZQUIERDA en PC y móvil, alineada con el borde
// izquierdo del cuerpo central (columna de ANCHO_CUERPO px), flanqueando el
// contenido junto al FAB de "proponer local" (abajo a la derecha): en
// pantallas anchas acompaña a la columna en vez de pegarse al borde de la
// ventana; en estrechas queda a 16px. Respeta la barra inferior de la PWA
// (env(safe-area-inset-bottom)) y en PC se muestra algo más grande.
//
// Para no ser intrusivo, solo se muestra a partir de la 2ª visita del
// usuario (contador en localStorage) y, si se cierra con ✕, no vuelve a
// aparecer durante 14 días.
export default function BannerMovil() {
const [cerrado, setCerrado] = useState(estaCerradoRecientemente);
const [visitasSuficientes, setVisitasSuficientes] = useState(false);
const { isInstalled, canPromptInstall, promptInstall, isIos } = usePwaInstall();
const [instalando, setInstalando] = useState(false);
const [resultado, setResultado] = useState(null); // "accepted" | "dismissed" | null
const esMovil = useEsMovil();
useEffect(() => {
setVisitasSuficientes(registrarVisitaYContar() >= VISITAS_MINIMAS);
}, []);
if (cerrado || isInstalled || !visitasSuficientes) return null;
const handleCerrar = () => {
try {
localStorage.setItem(CLAVE_CERRADO, String(Date.now() + DIAS_OCULTO_TRAS_CERRAR * 24 * 60 * 60 * 1000));
} catch { /* localStorage no disponible: se cierra solo para esta sesión */ }
setCerrado(true);
};
const handleInstalar = async () => {
setInstalando(true);
const outcome = await promptInstall();
setResultado(outcome);
setInstalando(false);
};
const tarjeta = (onCerrarTarjeta, estiloExtra = {}) => (
<div style={{ position: "relative", background: "white", border: "1px solid #E5DDD5", borderRadius: 14, padding: "14px 18px", boxShadow: "0 6px 24px rgba(0,0,0,0.10)", width: 280, boxSizing: "border-box", fontFamily: "var(--font-sans)", ...estiloExtra }}>
<button onClick={onCerrarTarjeta} aria-label="Cerrar aviso de instalación"
style={{ position: "absolute", top: 8, right: 10, background: "none", border: "none", cursor: "pointer", color: "#CCC", fontSize: 16, padding: 0 }}>✕</button>
<div style={{ display: "flex", alignItems: "center", gap: 10, marginBottom: 10 }}>
<img src="/icon-192.png" alt="" width={30} height={30} style={{ borderRadius: 7, flexShrink: 0 }} />
<div>
<p style={{ margin: 0, fontWeight: 700, fontSize: 14 }}>App para móvil</p>
<p style={{ margin: 0, fontSize: 12, color: "#888" }}>Sincronizada en tiempo real</p>
</div>
</div>
{canPromptInstall && (
<button onClick={handleInstalar} disabled={instalando}
style={{ display: "block", width: "100%", textAlign: "center", padding: "9px 0", background: "#8B0000", color: "white", border: "none", borderRadius: 8, fontSize: 13, fontWeight: 700, cursor: instalando ? "default" : "pointer", opacity: instalando ? 0.7 : 1 }}>
{instalando ? "Abriendo instalación..." : "📲 Instalar app"}
</button>
)}
{!canPromptInstall && isIos && (
<p style={{ margin: 0, fontSize: 12, color: "var(--color-text-secondary, #666)", lineHeight: 1.5 }}>
Pulsa <i className="ti ti-share-2" aria-hidden="true"></i> <strong>Compartir</strong> y luego <strong>"Añadir a pantalla de inicio"</strong> para instalarla.
</p>
)}
{!canPromptInstall && !isIos && (
<p style={{ margin: 0, fontSize: 12, color: "var(--color-text-secondary, #666)", lineHeight: 1.5 }}>
Instálala desde el menú de tu navegador ("Instalar app" o "Añadir a pantalla de inicio").
</p>
)}
{resultado === "dismissed" && (
<p style={{ margin: "8px 0 0", fontSize: 11, color: "#888" }}>Puedes instalarla más tarde cuando quieras.</p>
)}
</div>
);
// ── Aviso abajo a la izquierda (PC y móvil), alineado con el borde del cuerpo ──
return (
<div style={{
position: "fixed",
left: `max(16px, calc((100vw - ${ANCHO_CUERPO}px) / 2 + 16px))`,
bottom: 0,
zIndex: 999,
paddingBottom: "calc(16px + env(safe-area-inset-bottom))",
}}>
{tarjeta(handleCerrar, { width: esMovil ? 280 : 320 })}
</div>
);
}
+146
View File
@@ -0,0 +1,146 @@
import { CATEGORIAS, NOMBRES_CATEGORIAS } from "../constants/categorias.js";
import { PROVINCIAS_POR_COMUNIDAD } from "../constants/provincias.js";
import { inputStyle } from "../styles/shared.js";
// UI de filtrado del directorio. El estado vive en App.jsx (la derivación de
// localesFiltrados la comparten lista y mapa); este componente solo pinta y
// dispara los setters recibidos por props.
//
// Diseño (openspec unificar-filtros-iu): una única sección con tres filas —
// búsqueda + provincia compacta, chips de categorías y acciones rápidas con
// el orden segmentado y el «✕ Limpiar» global. Sin control de subcategoría
// (los subtipos se replantean en la issue #22) y sin desplegable de orden.
// Visible en las vistas de lista y mapa (mismos criterios en ambas).
const OPCIONES_ORDEN = [
{ valor: "fecha", etiqueta: "🕒 Reciente" },
{ valor: "puntuacion", etiqueta: "★ Mejor" },
{ valor: "nombre", etiqueta: "A-Z" },
];
const OPCION_ORDEN_DISTANCIA = { valor: "distancia", etiqueta: "📍 Más cerca" };
const estiloChip = {
borderRadius: 20,
padding: "5px 12px",
fontSize: 12,
cursor: "pointer",
display: "flex",
alignItems: "center",
gap: 5,
transition: "all 0.15s",
};
export default function BarraFiltros({
locales,
favoritos,
busqueda, setBusqueda,
filtroCategoria, setFiltroCategoria,
filtroProvincia, setFiltroProvincia,
orden, setOrden,
soloFavoritos, setSoloFavoritos,
ubicacion, buscandoUbicacion, errorUbicacion, pedirUbicacion, limpiarUbicacion,
}) {
const conteosCat = NOMBRES_CATEGORIAS.reduce((acc, c) => { acc[c] = locales.filter((l) => l.categoria === c).length; return acc; }, {});
const opcionesOrden = ubicacion ? [...OPCIONES_ORDEN, OPCION_ORDEN_DISTANCIA] : OPCIONES_ORDEN;
const hayFiltros = busqueda || filtroCategoria || filtroProvincia || soloFavoritos || orden !== "fecha" || ubicacion;
const limpiarTodo = () => {
setBusqueda("");
setFiltroCategoria("");
setFiltroProvincia("");
setSoloFavoritos(false);
setOrden("fecha");
if (ubicacion) limpiarUbicacion();
};
return (
<section
aria-label="Filtros de locales"
className="barra-filtros"
style={{
background: "var(--color-background-primary)",
border: "0.5px solid var(--color-border-tertiary)",
borderRadius: "var(--border-radius-lg)",
padding: "0.75rem",
marginBottom: "1.25rem",
display: "grid",
gap: "0.6rem",
}}
>
{/* Búsqueda + provincia compacta */}
<div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
<input
style={{ ...inputStyle, flex: 1, minWidth: 140 }}
placeholder="🔍 Buscar por nombre, dirección o provincia..."
value={busqueda}
onChange={(e) => setBusqueda(e.target.value)}
aria-label="Buscar por nombre, dirección o provincia"
/>
<select style={{ ...inputStyle, width: "auto", flexShrink: 0 }} value={filtroProvincia} onChange={(e) => setFiltroProvincia(e.target.value)} aria-label="Filtrar por provincia">
<option value="">📍 Todas las provincias</option>
{Object.entries(PROVINCIAS_POR_COMUNIDAD).map(([comunidad, provincias]) => (
<optgroup key={comunidad} label={comunidad}>
{provincias.map((p) => <option key={p} value={p}>{p}</option>)}
</optgroup>
))}
</select>
</div>
{/* Chips categorías */}
<div style={{ display: "flex", flexWrap: "wrap", gap: 6 }}>
{NOMBRES_CATEGORIAS.map((cat) => {
const c = CATEGORIAS[cat];
const activo = filtroCategoria === cat;
return (
<button key={cat} onClick={() => setFiltroCategoria(activo ? "" : cat)}
style={{ ...estiloChip, background: activo ? c.bgLight : "var(--color-background-secondary)", color: activo ? c.textColor : "var(--color-text-secondary)", border: `0.5px solid ${activo ? c.textColor : "var(--color-border-tertiary)"}`, fontWeight: activo ? 500 : 400 }}
aria-pressed={activo}>
{c.emoji} {cat}
{conteosCat[cat] > 0 && <span style={{ background: activo ? c.textColor : "var(--color-border-secondary)", color: activo ? "white" : "var(--color-text-secondary)", borderRadius: 10, padding: "0 6px", fontSize: 11 }}>{conteosCat[cat]}</span>}
</button>
);
})}
</div>
{/* Acciones rápidas + orden + limpiar */}
<div style={{ display: "flex", alignItems: "center", gap: 10, flexWrap: "wrap" }}>
{!ubicacion ? (
<button onClick={pedirUbicacion} disabled={buscandoUbicacion}
style={{ ...estiloChip, background: "none", border: "0.5px solid var(--color-border-secondary)", color: "var(--color-text-secondary)" }}>
<i className="ti ti-current-location" aria-hidden="true"></i> {buscandoUbicacion ? "Localizando..." : "Cerca de mí"}
</button>
) : (
<button onClick={() => { limpiarUbicacion(); if (orden === "distancia") setOrden("fecha"); }}
style={{ ...estiloChip, background: "#EAFAF1", border: "0.5px solid #A9DFBF", color: "#1E8449" }}>
<i className="ti ti-map-pin-check" aria-hidden="true"></i> Ubicación activada ✕
</button>
)}
{errorUbicacion && <span style={{ fontSize: 12, color: "#922B21" }}>{errorUbicacion}</span>}
<button onClick={() => setSoloFavoritos((v) => !v)} aria-pressed={soloFavoritos}
style={{ ...estiloChip, background: soloFavoritos ? "#FDEDEC" : "none", border: `0.5px solid ${soloFavoritos ? "#8B0000" : "var(--color-border-secondary)"}`, color: soloFavoritos ? "#8B0000" : "var(--color-text-secondary)" }}>
<i className={soloFavoritos ? "ti ti-heart-filled" : "ti ti-heart"} aria-hidden="true"></i> Favoritos {favoritos.length > 0 && `(${favoritos.length})`}
</button>
{/* Orden segmentado (sin desplegable) */}
<div role="group" aria-label="Ordenar locales" style={{ display: "flex", overflow: "hidden", borderRadius: "var(--border-radius-md)", border: "0.5px solid var(--color-border-tertiary)", marginLeft: "auto" }}>
{opcionesOrden.map((o) => {
const activo = orden === o.valor;
return (
<button key={o.valor} onClick={() => setOrden(o.valor)} aria-pressed={activo}
style={{ border: "none", padding: "5px 10px", fontSize: 12, cursor: "pointer", background: activo ? "#8B0000" : "var(--color-background-secondary)", color: activo ? "white" : "var(--color-text-secondary)", fontWeight: activo ? 500 : 400, display: "flex", alignItems: "center" }}>
{o.etiqueta}
</button>
);
})}
</div>
{/* Siempre presente (deshabilitado sin filtros): así reserva su hueco
y no desplaza a los controles vecinos al activarse un filtro. */}
<button onClick={limpiarTodo} disabled={!hayFiltros}
aria-label="Limpiar todos los filtros"
style={{ ...estiloChip, background: "none", border: "0.5px solid var(--color-border-secondary)", color: "var(--color-text-tertiary)", cursor: hayFiltros ? "pointer" : "default", opacity: hayFiltros ? 1 : 0.4 }}>
✕ Limpiar
</button>
</div>
</section>
);
}
+67
View File
@@ -0,0 +1,67 @@
import { useState } from "react";
import useEsMovil from "../hooks/useEsMovil.js";
import { ANCHO_CUERPO } from "../styles/shared.js";
const TEXTO_TOOLTIP = "Añade un nuevo local al directorio";
// Botón de acción flotante (FAB) para proponer un local: fijo abajo a la
// derecha, visible en PC y móvil, alineado con el borde derecho del cuerpo
// central (columna de ANCHO_CUERPO px) para que acompañe al contenido en
// pantallas anchas. En PC es más grande (64px) que en móvil (54px). Respeta
// la barra de la PWA con env(safe-area-inset-bottom). Muestra un tooltip
// propio al hacer hover o recibir foco (posicionado a la izquierda) y expone
// aria-label para accesibilidad sin ratón.
export default function BotonFlotante({ onClick }) {
const [tooltipVisible, setTooltipVisible] = useState(false);
const esMovil = useEsMovil();
const tamano = esMovil ? 54 : 64; // más grande en PC
return (
<div
style={{
position: "fixed",
// Abajo a la derecha, alineado con el borde derecho del cuerpo central:
// en pantallas anchas flanquea la columna de contenido; en estrechas, 16px.
right: `max(16px, calc((100vw - ${ANCHO_CUERPO}px) / 2 + 16px))`,
bottom: 0,
zIndex: 900,
paddingBottom: "env(safe-area-inset-bottom)",
}}
>
<div style={{ position: "relative", marginBottom: 16 }}>
<button
type="button"
onClick={onClick}
aria-label={TEXTO_TOOLTIP}
onMouseEnter={() => setTooltipVisible(true)}
onMouseLeave={() => setTooltipVisible(false)}
onFocus={() => setTooltipVisible(true)}
onBlur={() => setTooltipVisible(false)}
style={{
display: "flex", alignItems: "center", justifyContent: "center",
width: tamano, height: tamano, borderRadius: "50%",
background: "#8B0000", color: "white", border: "none",
boxShadow: esMovil ? "0 4px 14px rgba(139,0,0,0.4)" : "0 6px 20px rgba(139,0,0,0.45)",
fontSize: esMovil ? 24 : 28, cursor: "pointer",
}}
>
<i className="ti ti-plus" aria-hidden="true"></i>
</button>
{tooltipVisible && (
<span
role="tooltip"
style={{
position: "absolute", right: "calc(100% + 10px)", top: "50%", transform: "translateY(-50%)",
background: "var(--color-text-primary)", color: "var(--color-background-primary)",
padding: "6px 10px", borderRadius: "var(--border-radius-md)",
fontSize: 12, fontWeight: 500, whiteSpace: "nowrap", pointerEvents: "none",
boxShadow: "0 4px 12px rgba(0,0,0,0.25)",
}}
>
{TEXTO_TOOLTIP}
</span>
)}
</div>
</div>
);
}
+33
View File
@@ -0,0 +1,33 @@
import useEsMovil from "../hooks/useEsMovil.js";
import { ANCHO_CUERPO } from "../styles/shared.js";
// Botón "Proponer local" arriba a la derecha (solo PC): hace exactamente lo
// mismo que el FAB inferior — abre la pasarela de propuesta — pero da un
// punto de acceso visible en la zona superior, alineado con el borde derecho
// del cuerpo central (columna de ANCHO_CUERPO px) para acompañar al contenido
// en pantallas anchas. En móvil no se renderiza (ahí basta el FAB inferior).
export default function BotonProponerArriba({ onClick }) {
const esMovil = useEsMovil();
if (esMovil) return null;
return (
<button
type="button"
onClick={onClick}
aria-label="Añade un nuevo local al directorio"
style={{
position: "fixed",
top: 20,
right: `max(16px, calc((100vw - ${ANCHO_CUERPO}px) / 2 + 16px))`,
zIndex: 900,
display: "flex", alignItems: "center", gap: 8,
background: "#8B0000", color: "white", border: "none", borderRadius: 999,
padding: "11px 22px", fontSize: 15, fontWeight: 600,
cursor: "pointer", fontFamily: "var(--font-sans)",
boxShadow: "0 4px 14px rgba(139,0,0,0.35)",
}}
>
<i className="ti ti-plus" aria-hidden="true"></i> Proponer local
</button>
);
}
+19
View File
@@ -0,0 +1,19 @@
import { obtenerCategoria } from "../constants/categorias.js";
export default function CategoriaBadge({ categoria, subcategoria }) {
if (!categoria) return null;
const cat = obtenerCategoria(categoria);
return (
<div style={{ display: "flex", flexWrap: "wrap", gap: 5 }}>
<span style={{ background: cat.bgLight, color: cat.textColor, fontSize: 12, padding: "3px 10px", borderRadius: "var(--border-radius-md)", fontWeight: 500 }}>
{cat.emoji} {categoria}
</span>
{subcategoria && (
<span style={{ background: "var(--color-background-secondary)", color: "var(--color-text-secondary)", fontSize: 12, padding: "3px 10px", borderRadius: "var(--border-radius-md)" }}>
{subcategoria}
</span>
)}
</div>
);
}
+89
View File
@@ -0,0 +1,89 @@
import { useEffect, useRef } from "react";
import StarRating, { TAMANO_ESTRELLAS } from "./StarRating.jsx";
const MAX_COMENTARIO = 500;
// Formulario de reseña (anónima), controlado desde `useResenas` y montado por
// LocalCard DEBAJO de la barra de acciones: aparece solo al pulsar "Comentar".
// Estrellas y textarea reflejan el estado del hook, así que publicar deja el
// formulario en modo "Actualizar" sin lógica extra.
export default function FormularioResena({
puntuacion, setPuntuacion,
comentario, setComentario,
tienePropia, enviando, error,
onEnviar, onCerrar,
}) {
const contenedorRef = useRef(null);
// Al abrirse, el foco va a la primera estrella (como antes al expandir).
useEffect(() => {
contenedorRef.current?.querySelector("button")?.focus();
}, []);
const puedePublicar = puntuacion >= 1 && !enviando;
return (
<div
ref={contenedorRef}
style={{
borderTop: "0.5px solid var(--color-border-tertiary)", paddingTop: 8,
display: "flex", flexDirection: "column", gap: 8,
}}
>
<p style={{ margin: 0, fontSize: 12, fontWeight: 500 }}>
{tienePropia ? "Tu reseña (anónima) — edítala o bórrala desde su tarjeta" : "Deja tu reseña (anónima)"}
</p>
{/* Las estrellas usan lineHeight 0 (caja de línea de altura 0: el glifo
desborda y se solapa con el título). El wrapper con lineHeight normal
aporta el soporte de línea que falta. */}
<div style={{ lineHeight: "22px" }}>
<StarRating value={puntuacion} onChange={setPuntuacion} size={TAMANO_ESTRELLAS} />
</div>
<textarea
value={comentario}
onChange={(e) => setComentario(e.target.value)}
maxLength={MAX_COMENTARIO}
rows={2}
placeholder="Comentario opcional (máx. 500 caracteres)…"
aria-label="Comentario de la reseña"
style={{
fontSize: 12, padding: "5px 8px", borderRadius: "var(--border-radius-md)",
border: "0.5px solid var(--color-border-secondary)",
background: "var(--color-background-primary)", color: "var(--color-text-primary)",
resize: "vertical", fontFamily: "inherit",
}}
/>
{error && (
<p role="alert" style={{ margin: 0, fontSize: 12, color: "#922B21" }}>
<i className="ti ti-alert-triangle" aria-hidden="true"></i> {error}
</p>
)}
<div style={{ display: "flex", gap: 6, alignItems: "center" }}>
<button
type="button"
className="btn-primario"
onClick={onEnviar}
disabled={!puedePublicar}
style={{
fontSize: 12, border: "none", borderRadius: "var(--border-radius-md)",
padding: "5px 12px", cursor: puedePublicar ? "pointer" : "not-allowed", fontWeight: 500,
}}
>
{enviando ? "Guardando…" : tienePropia ? "Actualizar" : "Publicar"}
</button>
<button
type="button"
className="btn-hover"
onClick={onCerrar}
style={{
fontSize: 12, border: "0.5px solid var(--color-border-secondary)",
borderRadius: "var(--border-radius-md)", padding: "5px 12px", cursor: "pointer",
color: "var(--color-text-secondary)",
}}
>
Cerrar
</button>
</div>
</div>
);
}
+227
View File
@@ -0,0 +1,227 @@
import { useState } from "react";
import CategoriaBadge from "./CategoriaBadge.jsx";
import ResenasLocal from "./ResenasLocal.jsx";
import FormularioResena from "./FormularioResena.jsx";
import ReportarLocal from "./ReportarLocal.jsx";
import StarRating, { TAMANO_ESTRELLAS } from "./StarRating.jsx";
import Toast from "./Toast.jsx";
import useFavoritos from "../hooks/useFavoritos.js";
import useResenas from "../hooks/useResenas.js";
import useToast from "../hooks/useToast.js";
import { confirmarLocal } from "../firebase.js";
import { enlaceGoogleMapsDesdeLocal, enlaceWazeDesdeLocal, formatearDistancia } from "../utils/geo.js";
const MESES_PARA_CADUCAR = 6;
function formatearFecha(fecha) {
if (!fecha) return null;
const date = new Date(fecha);
if (Number.isNaN(date.getTime())) return null;
return date.toLocaleDateString("es-ES", { day: "numeric", month: "long", year: "numeric" });
}
function mesesDesde(fecha) {
if (!fecha) return null;
const date = new Date(fecha);
if (Number.isNaN(date.getTime())) return null;
return (Date.now() - date.getTime()) / (1000 * 60 * 60 * 24 * 30);
}
const botonBarra = (activo) => ({
flex: 1, display: "flex", flexDirection: "column", alignItems: "center", gap: 2,
border: "none", padding: "6px 2px 4px", cursor: "pointer",
borderRadius: "var(--border-radius-md)",
fontSize: 11, fontWeight: 500, lineHeight: 1.2,
color: activo ? "#8B0000" : "var(--color-text-secondary)",
});
// Tarjeta de local (rediseño de usabilidad): cabecera con nombre, provincia y
// las estrellas de la media arriba a la derecha a la altura del título;
// categoría, dirección y enlaces; la DESCRIPCIÓN del local en bloque propio
// ENCIMA de la sección de reseñas; fecha en pequeñito y, como pie, la barra
// inferior de acciones a ancho completo: Comentar · Reportar · Marcar ·
// Compartir. El formulario de reseña se monta DEBAJO de la barra cuando el
// usuario pulsa «Comentar» (que queda en estado activo).
export default function LocalCard({ local, distanciaKm }) {
const { esFavorito, alternarFavorito } = useFavoritos();
const { toast, mostrarToast } = useToast();
const [confirmando, setConfirmando] = useState(false);
const [confirmado, setConfirmado] = useState(false);
const [fechaConfirmacion, setFechaConfirmacion] = useState(local.fechaConfirmacion || local.fecha);
const [reportando, setReportando] = useState(false);
const [comentando, setComentando] = useState(false);
const {
resenas, cargando, total, media, reportada,
tienePropia, puntuacion, setPuntuacion, comentario, setComentario,
enviando, error, enviar, borrarPropia, reportar,
} = useResenas(local.id, { totalInicial: local.totalResenas || 0, mediaInicial: local.puntuacion || 0 });
const gmUrl = local.enlaceGoogleMaps || enlaceGoogleMapsDesdeLocal(local);
const wazeUrl = enlaceWazeDesdeLocal(local);
const fechaFormateada = formatearFecha(local.fecha);
const meses = mesesDesde(fechaConfirmacion);
const sinConfirmarReciente = meses != null && meses >= MESES_PARA_CADUCAR;
const favorito = esFavorito(local.id);
const handleConfirmar = async () => {
setConfirmando(true);
try {
const res = await confirmarLocal(local.id);
setFechaConfirmacion(res?.fechaConfirmacion || new Date().toISOString());
setConfirmado(true);
} catch (e) {
console.error(e);
}
setConfirmando(false);
};
const handleAlternarFavorito = () => {
const nuevoEstado = !favorito;
alternarFavorito(local.id);
mostrarToast(nuevoEstado ? "❤️ Añadido a favoritos" : "Quitado de favoritos", nuevoEstado ? "exito" : "info");
};
const compartir = async () => {
const url = `${window.location.origin}${window.location.pathname}?local=${local.id}`;
const texto = `${local.nombre}${local.provincia ? ` · ${local.provincia}` : ""}`;
if (navigator.share) {
try { await navigator.share({ title: local.nombre, text: texto, url }); } catch { /* usuario canceló */ }
return;
}
try {
await navigator.clipboard.writeText(url);
window.open(`https://wa.me/?text=${encodeURIComponent(`${texto} ${url}`)}`, "_blank", "noopener,noreferrer");
} catch {
window.open(`https://wa.me/?text=${encodeURIComponent(`${texto} ${url}`)}`, "_blank", "noopener,noreferrer");
}
};
return (
<div
id={`local-${local.id}`}
style={{ background: "var(--color-background-primary)", border: "0.5px solid var(--color-border-tertiary)", borderRadius: "var(--border-radius-lg)", padding: "1rem 1.25rem", display: "flex", flexDirection: "column", gap: 8, transition: "border-color 0.2s" }}
onMouseEnter={(e) => { e.currentTarget.style.borderColor = "var(--color-border-secondary)"; }}
onMouseLeave={(e) => { e.currentTarget.style.borderColor = "var(--color-border-tertiary)"; }}
>
{/* Cabecera: nombre, provincia y las estrellas de la media arriba a la
derecha, a la altura del título */}
<div style={{ display: "flex", alignItems: "flex-start", justifyContent: "space-between", gap: 12 }}>
<div style={{ minWidth: 0 }}>
<p style={{ fontWeight: 500, fontSize: 16, margin: 0 }}>{local.nombre}</p>
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: "2px 0 0" }}>
{local.provincia}
{distanciaKm != null && <span style={{ color: "var(--color-text-tertiary)" }}> · {formatearDistancia(distanciaKm)}</span>}
</p>
</div>
<div style={{ flexShrink: 0, paddingTop: 2, lineHeight: 0 }}>
<StarRating value={media} readOnly size={TAMANO_ESTRELLAS} />
</div>
</div>
<CategoriaBadge categoria={local.categoria} subcategoria={local.subcategoria} />
{local.direccion && (
<div style={{ display: "flex", alignItems: "flex-start", gap: 6 }}>
<i className="ti ti-map-pin" aria-hidden="true" style={{ fontSize: 14, color: "var(--color-text-tertiary)", marginTop: 1, flexShrink: 0 }}></i>
{gmUrl ? (
<a href={gmUrl} target="_blank" rel="noopener noreferrer" title="Abrir dirección en Google Maps"
style={{ fontSize: 13, color: "var(--color-text-secondary)", textDecoration: "underline", textDecorationStyle: "dotted", textUnderlineOffset: 2 }}>
{local.direccion}
</a>
) : (
<span style={{ fontSize: 13, color: "var(--color-text-secondary)" }}>{local.direccion}</span>
)}
</div>
)}
{(gmUrl || wazeUrl) && (
<div style={{ display: "flex", gap: 8, flexWrap: "wrap" }}>
{gmUrl && (
<a href={gmUrl} target="_blank" rel="noopener noreferrer"
style={{ display: "inline-flex", alignItems: "center", gap: 5, fontSize: 12, color: "#1A73E8", textDecoration: "none", width: "fit-content", background: "#E8F0FE", padding: "4px 10px", borderRadius: "var(--border-radius-md)", fontWeight: 500 }}>
<i className="ti ti-brand-google-maps" aria-hidden="true" style={{ fontSize: 14 }}></i>
Google Maps
</a>
)}
{wazeUrl && (
<a href={wazeUrl} target="_blank" rel="noopener noreferrer"
style={{ display: "inline-flex", alignItems: "center", gap: 5, fontSize: 12, color: "#33CCFF", textDecoration: "none", width: "fit-content", background: "#E6FAFF", padding: "4px 10px", borderRadius: "var(--border-radius-md)", fontWeight: 500 }}>
<i className="ti ti-brand-waze" aria-hidden="true" style={{ fontSize: 14 }}></i>
Waze
</a>
)}
</div>
)}
{/* Descripción del local: bloque propio, ENCIMA de las reseñas */}
{local.descripcion && (
<p style={{ fontSize: 13, color: "var(--color-text-secondary)", margin: 0, fontStyle: "italic" }}>"{local.descripcion}"</p>
)}
{/* Reseñas: vista previa + expansión animada solo del resto de reseñas
(la media va en la cabecera; el formulario, bajo la barra) */}
<ResenasLocal
resenas={resenas}
cargando={cargando}
total={total}
reportada={reportada}
onReportar={reportar}
onBorrar={borrarPropia}
/>
{sinConfirmarReciente && !confirmado && (
<div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 8, flexWrap: "wrap", background: "#FDF2E9", border: "1px solid #F5CBA7", borderRadius: "var(--border-radius-md)", padding: "6px 10px" }}>
<span style={{ fontSize: 12, color: "#784212", display: "flex", alignItems: "center", gap: 5 }}>
<i className="ti ti-clock-exclamation" aria-hidden="true"></i> Sin confirmar recientemente
</span>
<button type="button" className="btn-verde" onClick={handleConfirmar} disabled={confirmando}
style={{ fontSize: 12, border: "none", borderRadius: "var(--border-radius-md)", padding: "4px 10px", cursor: "pointer", fontWeight: 500 }}>
{confirmando ? "..." : "Sigue aquí ✅"}
</button>
</div>
)}
{confirmado && (
<p style={{ fontSize: 12, color: "#1E8449", margin: 0 }}>✅ Gracias por confirmar que sigue activo.</p>
)}
{/* Formulario de reporte (se abre desde la barra inferior) */}
{reportando && (
<ReportarLocal localId={local.id} inicialAbierto onCerrar={() => setReportando(false)} />
)}
{/* Fecha, en pequeñito, justo encima de la barra */}
{fechaFormateada && (
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: 0 }}>Publicado {fechaFormateada}</p>
)}
{/* Barra inferior de acciones: cubre todo el pie de la tarjeta */}
<div style={{ display: "flex", gap: 2, marginTop: 2, paddingTop: 6, borderTop: "0.5px solid var(--color-border-tertiary)", flexWrap: "wrap" }}>
<button type="button" onClick={() => setComentando((v) => !v)} aria-pressed={comentando}
className={`btn-hover${comentando ? " activo" : ""}`} style={botonBarra(comentando)}>
<i className="ti ti-message-dots" aria-hidden="true" style={{ fontSize: 18 }}></i> Comentar
</button>
<button type="button" className="btn-hover" onClick={() => setReportando(true)} style={botonBarra(false)}>
<i className="ti ti-flag" aria-hidden="true" style={{ fontSize: 18 }}></i> Reportar
</button>
<button type="button" className={`btn-hover${favorito ? " activo" : ""}`} onClick={handleAlternarFavorito} aria-pressed={favorito} style={botonBarra(favorito)}>
<i className={`ti ${favorito ? "ti-heart-filled" : "ti-heart"}`} aria-hidden="true" style={{ fontSize: 18 }}></i> {favorito ? "Marcado" : "Marcar"}
</button>
<button type="button" className="btn-hover" onClick={compartir} style={botonBarra(false)}>
<i className="ti ti-share-2" aria-hidden="true" style={{ fontSize: 18 }}></i> Compartir
</button>
</div>
{/* Formulario de reseña: DEBAJO de la barra y solo con «Comentar» */}
{comentando && (
<FormularioResena
puntuacion={puntuacion} setPuntuacion={setPuntuacion}
comentario={comentario} setComentario={setComentario}
tienePropia={tienePropia} enviando={enviando} error={error}
onEnviar={enviar} onCerrar={() => setComentando(false)}
/>
)}
<Toast toast={toast} />
</div>
);
}
-68
View File
@@ -1,68 +0,0 @@
import { MapContainer, TileLayer, Marker, useMapEvents } from "react-leaflet";
import L from "leaflet";
// Configuración del icono por defecto. Leaflet no encuentra sus iconos cuando
// se empaqueta con Vite; los referenciamos desde el CDN para no copiar
// archivos a public/.
const icon = new L.Icon({
iconUrl: "https://unpkg.com/leaflet@1.9.4/dist/images/marker-icon.png",
iconRetinaUrl: "https://unpkg.com/leaflet@1.9.4/dist/images/marker-icon-2x.png",
shadowUrl: "https://unpkg.com/leaflet@1.9.4/dist/images/marker-shadow.png",
iconSize: [25, 41],
iconAnchor: [12, 41],
});
const DEFAULT_CENTER = [40.4168, -3.7038];
const DEFAULT_ZOOM = 13;
function LocationPicker({ onPick }) {
useMapEvents({
click(e) {
onPick({ lat: e.latlng.lat, lng: e.latlng.lng });
},
});
return null;
}
export default function MapView({
businesses,
selectedId,
onSelect,
pickingLocation,
onPickLocation,
pickedLocation,
}) {
return (
<div className="map">
<MapContainer
center={DEFAULT_CENTER}
zoom={DEFAULT_ZOOM}
style={{ height: "100%", width: "100%" }}
>
<TileLayer
attribution='&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a>'
url="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"
/>
{businesses.map((b) => (
<Marker
key={b.id}
position={[b.lat, b.lng]}
icon={icon}
eventHandlers={{ click: () => onSelect(b.id) }}
opacity={selectedId && selectedId !== b.id ? 0.6 : 1}
/>
))}
{pickingLocation && <LocationPicker onPick={onPickLocation} />}
{pickedLocation && (
<Marker
position={[pickedLocation.lat, pickedLocation.lng]}
icon={icon}
/>
)}
</MapContainer>
{pickingLocation && (
<div className="map-hint">Haz clic en el mapa para fijar la ubicación</div>
)}
</div>
);
}
+169
View File
@@ -0,0 +1,169 @@
import { useEffect, useRef, useState } from "react";
import useEsMovil from "../hooks/useEsMovil.js";
import PasoUbicacion from "./PasoUbicacion.jsx";
import PasoDatosLocal from "./PasoDatosLocal.jsx";
import PasoCategoria from "./PasoCategoria.jsx";
import PasoSubcategoria from "./PasoSubcategoria.jsx";
import PasoDescripcion from "./PasoDescripcion.jsx";
import PasoResumen from "./PasoResumen.jsx";
// Definición declarativa de las pantallas de la pasarela: orden, título y
// validez de cada paso (habilita o deshabilita "Siguiente"). El paso final
// gestiona su propio botón de envío en PasoResumen.
const PASOS = [
{ id: "ubicacion", titulo: "Ubicación", Componente: PasoUbicacion, puedeContinuar: (f) => f.lat != null && f.lng != null },
{ id: "datos", titulo: "Datos del local", Componente: PasoDatosLocal, puedeContinuar: (f) => (f.nombre || "").trim().length >= 2 && !!f.provincia },
{ id: "categoria", titulo: "Categoría", Componente: PasoCategoria, puedeContinuar: (f) => !!f.categoria },
{ id: "subcategoria", titulo: "Tipo específico", Componente: PasoSubcategoria, puedeContinuar: () => true },
{ id: "descripcion", titulo: "Descripción", Componente: PasoDescripcion, puedeContinuar: () => true },
{ id: "resumen", titulo: "Revisión y envío", Componente: PasoResumen, puedeContinuar: () => true },
];
// Modal de la pasarela para proponer un local: una pantalla por campo con
// navegación atrás/siguiente e indicador de progreso. Sigue el patrón de
// ModalPrivacidad (overlay + role="dialog" + cierre por fondo/✕/Escape) y
// añade contención del foco de teclado. Responsive: en móvil el panel ocupa
// todo el ancho y casi todo el alto; en escritorio queda centrado (~480px).
export default function ModalPasarela({
form, setForm,
onCerrar, onEnviar, onConfirmarDuplicado, onDescartarDuplicado,
aceptaPrivacidad, setAceptaPrivacidad, onAbrirPrivacidad,
errorFiltro, posibleDuplicado, comprobandoDuplicado, saving,
}) {
const [paso, setPaso] = useState(0);
const esMovil = useEsMovil();
const panelRef = useRef(null);
const cuerpoRef = useRef(null);
const pasoActual = PASOS[paso];
const esUltimo = paso === PASOS.length - 1;
const puedeContinuar = pasoActual.puedeContinuar(form);
const enviando = comprobandoDuplicado || saving;
// Foco inicial en el primer control de la pantalla activa (no del panel
// completo: el ✕ de la cabecera precede al cuerpo en el DOM). La
// contención de Tab evita que el foco se escape del modal.
useEffect(() => {
const cuerpo = cuerpoRef.current;
if (!cuerpo) return;
const primerControl = cuerpo.querySelector("input, select, textarea, button:not([disabled])");
primerControl?.focus();
}, [paso]);
const alTeclear = (e) => {
if (e.key === "Escape") {
e.stopPropagation();
onCerrar();
return;
}
if (e.key !== "Tab") return;
const focos = panelRef.current?.querySelectorAll(
'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])',
);
if (!focos?.length) return;
const primero = focos[0];
const ultimo = focos[focos.length - 1];
if (e.shiftKey && document.activeElement === primero) {
e.preventDefault();
ultimo.focus();
} else if (!e.shiftKey && document.activeElement === ultimo) {
e.preventDefault();
primero.focus();
}
};
const { Componente } = pasoActual;
return (
<div
role="dialog"
aria-modal="true"
aria-label={`Proponer local: ${pasoActual.titulo}`}
style={{
position: "fixed", inset: 0, background: "rgba(0,0,0,0.45)", zIndex: 1000,
display: "flex", alignItems: "center", justifyContent: "center",
padding: esMovil ? 8 : 16,
}}
onClick={(e) => { if (e.target === e.currentTarget) onCerrar(); }}
onKeyDown={alTeclear}
>
<div
ref={panelRef}
onClick={(e) => e.stopPropagation()}
style={{
background: "var(--color-background-primary)",
borderRadius: "var(--border-radius-lg)",
width: "100%",
maxWidth: esMovil ? "none" : 480,
height: esMovil ? "92dvh" : undefined,
maxHeight: "92vh",
display: "flex", flexDirection: "column",
overflow: "hidden",
fontFamily: "var(--font-sans)",
}}
>
{/* Cabecera: título, progreso y cierre */}
<div style={{ display: "flex", alignItems: "center", justifyContent: "space-between", gap: 10, padding: "14px 16px 10px", borderBottom: "0.5px solid var(--color-border-tertiary)" }}>
<div>
<p style={{ margin: 0, fontWeight: 600, fontSize: 16 }}>Proponer un local</p>
<p style={{ margin: "2px 0 0", fontSize: 12, color: "var(--color-text-secondary)" }}>
{pasoActual.titulo} · Paso {paso + 1} de {PASOS.length}
</p>
</div>
<div style={{ display: "flex", alignItems: "center", gap: 12 }}>
<div style={{ display: "flex", gap: 4 }} aria-hidden="true">
{PASOS.map((p, i) => (
<span key={p.id} style={{ width: 16, height: 4, borderRadius: 2, background: i <= paso ? "#8B0000" : "var(--color-border-tertiary)", transition: "background 0.15s" }} />
))}
</div>
<button onClick={onCerrar} aria-label="Cerrar" disabled={enviando} style={{ background: "none", border: "none", cursor: enviando ? "not-allowed" : "pointer", fontSize: 18, color: "var(--color-text-tertiary)" }}>✕</button>
</div>
</div>
{/* Cuerpo: la pantalla activa (con scroll si no cabe) */}
<div ref={cuerpoRef} style={{ flex: 1, minHeight: 0, overflowY: "auto", padding: "14px 16px" }}>
<Componente
form={form}
setForm={setForm}
{...(pasoActual.id === "resumen" ? {
aceptaPrivacidad, setAceptaPrivacidad, onAbrirPrivacidad,
onEnviar, onConfirmarDuplicado, onDescartarDuplicado,
errorFiltro, posibleDuplicado, comprobandoDuplicado, saving,
} : {})}
/>
</div>
{/* Pie: navegación atrás/siguiente */}
<div style={{ display: "flex", justifyContent: "space-between", gap: 8, padding: "12px 16px", borderTop: "0.5px solid var(--color-border-tertiary)" }}>
<button
onClick={paso === 0 ? onCerrar : () => setPaso((p) => p - 1)}
disabled={enviando}
style={{
background: "none", border: "0.5px solid var(--color-border-secondary)",
borderRadius: "var(--border-radius-md)", padding: "8px 16px",
fontSize: 14, cursor: enviando ? "not-allowed" : "pointer",
color: "var(--color-text-secondary)",
}}
>
{paso === 0 ? "Cancelar" : "← Atrás"}
</button>
{!esUltimo && (
<button
onClick={() => setPaso((p) => p + 1)}
disabled={!puedeContinuar}
style={{
background: puedeContinuar ? "#8B0000" : "var(--color-background-secondary)",
color: puedeContinuar ? "white" : "var(--color-text-tertiary)",
border: "none", borderRadius: "var(--border-radius-md)",
padding: "8px 20px", fontSize: 14, fontWeight: 500,
cursor: puedeContinuar ? "pointer" : "not-allowed",
}}
>
Siguiente
</button>
)}
</div>
</div>
</div>
);
}
+31
View File
@@ -0,0 +1,31 @@
// Modal con la política de privacidad. Contenido genérico orientativo: como se
// guardan datos de negocios (algunos de terceros, no del propio usuario) conviene
// que un profesional lo revise antes de publicar la app.
export default function ModalPrivacidad({ onCerrar }) {
return (
<div
role="dialog" aria-modal="true" aria-label="Política de privacidad"
style={{ position: "fixed", inset: 0, background: "rgba(0,0,0,0.45)", zIndex: 1000, display: "flex", alignItems: "center", justifyContent: "center", padding: 16 }}
onClick={onCerrar}
>
<div
onClick={(e) => e.stopPropagation()}
style={{ background: "var(--color-background-primary)", borderRadius: "var(--border-radius-lg)", maxWidth: 560, width: "100%", maxHeight: "85vh", overflowY: "auto", padding: "1.5rem", fontFamily: "var(--font-sans)" }}
>
<div style={{ display: "flex", justifyContent: "space-between", alignItems: "flex-start", marginBottom: 12 }}>
<p style={{ margin: 0, fontWeight: 600, fontSize: 17 }}>Privacidad y condiciones</p>
<button onClick={onCerrar} aria-label="Cerrar" style={{ background: "none", border: "none", cursor: "pointer", fontSize: 18, color: "var(--color-text-tertiary)" }}>✕</button>
</div>
<div style={{ fontSize: 13, lineHeight: 1.6, color: "var(--color-text-secondary)", display: "flex", flexDirection: "column", gap: 10 }}>
<p><strong>Qué datos guardamos.</strong> Cuando propones un local guardamos el nombre del negocio, su dirección o enlace de Google Maps, categoría, una descripción opcional y una puntuación. Estos datos suelen referirse a un negocio (a menudo de terceros), no a datos personales tuyos.</p>
<p><strong>Revisión previa.</strong> Toda propuesta pasa por un administrador antes de publicarse, y puede ser rechazada si incumple las normas (contenido inapropiado, información falsa, etc.).</p>
<p><strong>Ubicación.</strong> Si usas "cerca de mí", tu posición se usa solo en tu dispositivo para calcular distancias; no se envía a nuestro servidor ni se guarda.</p>
<p><strong>Datos públicos de negocios.</strong> Los datos de los negocios listados (nombre, dirección) son públicos y equivalentes a los que aparecen en Google Maps u otros directorios similares. Cualquiera puede solicitar la corrección o eliminación de una ficha usando el botón "Reportar" en cada local.</p>
<p><strong>Favoritos.</strong> Tu lista de favoritos se guarda únicamente en tu propio dispositivo (localStorage), no en nuestros servidores.</p>
<p style={{ fontSize: 12, color: "var(--color-text-tertiary)" }}>Este texto es orientativo y no sustituye asesoría legal. Antes de publicar la app conviene adaptarlo con un profesional, especialmente en lo referente a datos de terceros (dueños de negocios) y RGPD.</p>
</div>
</div>
</div>
);
}
+25
View File
@@ -0,0 +1,25 @@
import { inputStyle } from "../styles/shared.js";
import { CATEGORIAS, NOMBRES_CATEGORIAS } from "../constants/categorias.js";
// Paso 4 de la pasarela: categoría principal del negocio.
export default function PasoCategoria({ form, setForm }) {
return (
<div>
<label htmlFor="paso-categoria" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
Categoría <span style={{ color: "#8B0000" }}>*</span>
</label>
<select
id="paso-categoria"
style={inputStyle}
value={form.categoria}
onChange={(e) => setForm((f) => ({ ...f, categoria: e.target.value, subcategoria: "" }))}
>
<option value="">Selecciona categoría...</option>
{NOMBRES_CATEGORIAS.map((c) => <option key={c} value={c}>{CATEGORIAS[c].emoji} {c}</option>)}
</select>
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
Elige el grupo general al que pertenece el negocio.
</p>
</div>
);
}
+77
View File
@@ -0,0 +1,77 @@
import { inputStyle } from "../styles/shared.js";
import { PROVINCIAS_POR_COMUNIDAD } from "../constants/provincias.js";
const etiqueta = { fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 };
// Paso 2 de la pasarela: los datos inferidos desde la ubicación (nombre,
// provincia y dirección), pre-rellenados y editables en una misma pantalla.
// Si la inferencia falló o no casó con el listado, llegan vacíos y se
// rellenan a mano, sin bloquear la pasarela.
export default function PasoDatosLocal({ form, setForm }) {
const algunoInferido = !!(form.nombre || form.provincia || form.direccion);
return (
<div style={{ display: "flex", flexDirection: "column", gap: 12 }}>
{algunoInferido && (
<div role="status" style={{
display: "flex", alignItems: "flex-start", gap: 6,
background: "#EAFAF1", color: "#1E8449",
padding: "6px 10px", borderRadius: "var(--border-radius-md)", fontSize: 12,
}}>
<i className="ti ti-sparkles" aria-hidden="true" style={{ fontSize: 14, flexShrink: 0, marginTop: 1 }}></i>
<span style={{ lineHeight: 1.4 }}>
Rellenados automáticamente desde la ubicación: compruébalos y corrige lo que haga falta.
</span>
</div>
)}
<div>
<label htmlFor="paso-nombre" style={etiqueta}>
Nombre del local <span style={{ color: "#8B0000" }}>*</span>
</label>
<input
id="paso-nombre"
style={inputStyle}
autoComplete="off"
placeholder="Bar El Olivo, Clínica San José..."
value={form.nombre}
onChange={(e) => setForm((f) => ({ ...f, nombre: e.target.value }))}
/>
</div>
<div>
<label htmlFor="paso-provincia" style={etiqueta}>
Provincia <span style={{ color: "#8B0000" }}>*</span>
</label>
<select
id="paso-provincia"
style={inputStyle}
value={form.provincia}
onChange={(e) => setForm((f) => ({ ...f, provincia: e.target.value }))}
>
<option value="">Selecciona provincia...</option>
{Object.entries(PROVINCIAS_POR_COMUNIDAD).map(([comunidad, provincias]) => (
<optgroup key={comunidad} label={comunidad}>
{provincias.map((p) => <option key={p} value={p}>{p}</option>)}
</optgroup>
))}
</select>
</div>
<div>
<label htmlFor="paso-direccion" style={etiqueta}>Dirección</label>
<input
id="paso-direccion"
style={inputStyle}
autoComplete="off"
placeholder="Calle, número, ciudad"
value={form.direccion}
onChange={(e) => setForm((f) => ({ ...f, direccion: e.target.value }))}
aria-describedby="paso-direccion-ayuda"
/>
<p id="paso-direccion-ayuda" style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "4px 0 0" }}>
Opcional: se rellena automáticamente desde la ubicación; corrígela si hace falta.
</p>
</div>
</div>
);
}
+26
View File
@@ -0,0 +1,26 @@
import { inputStyle } from "../styles/shared.js";
// Paso 5 de la pasarela: descripción corta del local, opcional. Se puede
// continuar sin escribir nada. El texto (recortado de espacios) viaja en la
// propuesta: el admin lo ve al revisarla y la ficha pública al aprobarse.
export default function PasoDescripcion({ form, setForm }) {
return (
<div>
<label htmlFor="paso-descripcion" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
Descripción
</label>
<textarea
id="paso-descripcion"
style={{ ...inputStyle, resize: "vertical", minHeight: 72, fontFamily: "inherit", lineHeight: 1.5 }}
maxLength={200}
rows={3}
value={form.descripcion}
onChange={(e) => setForm((f) => ({ ...f, descripcion: e.target.value }))}
placeholder="Qué se vende, el ambiente, algún detalle que te gustaría contar…"
/>
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
Paso opcional: puedes continuar sin escribir descripción. Máximo 200 caracteres.
</p>
</div>
);
}
+125
View File
@@ -0,0 +1,125 @@
import { CATEGORIAS } from "../constants/categorias.js";
import { ETIQUETAS_PROVEEDOR } from "../utils/ubicacion/index.js";
const fila = { display: "flex", justifyContent: "space-between", alignItems: "flex-start", gap: 10, padding: "6px 0", borderBottom: "0.5px solid var(--color-border-tertiary)", fontSize: 13 };
const clave = { color: "var(--color-text-secondary)", flexShrink: 0 };
const valor = { textAlign: "right", fontWeight: 500, wordBreak: "break-word" };
// Paso 6 (final) de la pasarela: resumen legible de todo lo introducido,
// aceptación obligatoria de la política de privacidad y envío de la
// propuesta. Los avisos de palabra prohibida y de posible duplicado se
// muestran dentro del propio modal.
export default function PasoResumen({
form, aceptaPrivacidad, setAceptaPrivacidad, onAbrirPrivacidad,
onEnviar, onConfirmarDuplicado, onDescartarDuplicado,
errorFiltro, posibleDuplicado, comprobandoDuplicado, saving,
}) {
const categoria = form.categoria ? CATEGORIAS[form.categoria] : null;
const enviando = comprobandoDuplicado || saving;
const etiquetaProveedor = form.proveedorUbicacion ? ETIQUETAS_PROVEEDOR[form.proveedorUbicacion] || form.proveedorUbicacion : "";
return (
<div>
<p style={{ margin: "0 0 8px", fontSize: 13, color: "var(--color-text-secondary)" }}>
Comprueba los datos antes de enviar. El administrador revisará la propuesta antes de publicarla.
</p>
<div style={{ background: "var(--color-background-secondary)", borderRadius: "var(--border-radius-md)", padding: "4px 12px", marginBottom: 12 }}>
<div style={fila}>
<span style={clave}>📍 Ubicación</span>
<span style={valor}>
{etiquetaProveedor && <>{etiquetaProveedor}<br /></>}
{form.lat != null && form.lng != null && <span style={{ fontWeight: 400 }}>{form.lat.toFixed(4)}, {form.lng.toFixed(4)}</span>}
{form.direccion && <span style={{ fontWeight: 400, display: "block" }}>{form.direccion}</span>}
</span>
</div>
<div style={fila}>
<span style={clave}>🏷️ Nombre</span>
<span style={valor}>{form.nombre}</span>
</div>
<div style={fila}>
<span style={clave}>🗺️ Provincia</span>
<span style={valor}>{form.provincia}</span>
</div>
<div style={fila}>
<span style={clave}>📂 Categoría</span>
<span style={valor}>{categoria ? `${categoria.emoji} ${form.categoria}` : ""}</span>
</div>
<div style={fila}>
<span style={clave}>🔖 Tipo específico</span>
<span style={{ ...valor, fontWeight: form.subcategoria ? 500 : 400, color: form.subcategoria ? "inherit" : "var(--color-text-tertiary)" }}>
{form.subcategoria || "—"}
</span>
</div>
<div style={{ ...fila, borderBottom: "none" }}>
<span style={clave}>💬 Descripción</span>
<span style={{ ...valor, fontWeight: form.descripcion ? 500 : 400, color: form.descripcion ? "inherit" : "var(--color-text-tertiary)", whiteSpace: "pre-line" }}>
{form.descripcion || "—"}
</span>
</div>
</div>
<label style={{ display: "flex", alignItems: "flex-start", gap: 8, marginBottom: 12, fontSize: 12, color: "var(--color-text-secondary)", cursor: "pointer" }}>
<input
type="checkbox"
checked={aceptaPrivacidad}
onChange={(e) => setAceptaPrivacidad(e.target.checked)}
style={{ marginTop: 2 }}
/>
<span>
He leído y acepto la{" "}
<button
type="button"
onClick={(e) => { e.preventDefault(); onAbrirPrivacidad(); }}
style={{ background: "none", border: "none", padding: 0, color: "#8B0000", textDecoration: "underline", cursor: "pointer", fontSize: 12 }}
>
política de privacidad
</button>
{" "}sobre cómo se usan estos datos. <span style={{ color: "#8B0000" }}>*</span>
</span>
</label>
{/* Aviso de palabra prohibida */}
{errorFiltro && (
<div role="alert" style={{ marginBottom: 12, background: "#FDEDEC", border: "1px solid #F5B7B1", borderRadius: "var(--border-radius-md)", padding: "10px 14px", fontSize: 13, color: "#922B21", display: "flex", alignItems: "center", gap: 8 }}>
<i className="ti ti-ban" aria-hidden="true"></i> {errorFiltro}
</div>
)}
{/* Aviso de posible duplicado */}
{posibleDuplicado && (
<div role="alert" style={{ marginBottom: 12, background: "#FDF2E9", border: "1px solid #F5CBA7", borderRadius: "var(--border-radius-md)", padding: "10px 14px", fontSize: 13, color: "#784212" }}>
<div style={{ display: "flex", alignItems: "center", gap: 8, fontWeight: 500 }}>
<i className="ti ti-alert-triangle" aria-hidden="true"></i> Ya existe un local parecido
</div>
<ul style={{ margin: "6px 0", paddingLeft: 20 }}>
{posibleDuplicado.coincidencias.map((c) => (
<li key={c.id}>{c.nombre} · {c.provincia}{c.direccion ? ` · ${c.direccion}` : ""} ({c.estado === "pendiente" ? "pendiente de revisión" : "ya publicado"})</li>
))}
</ul>
<div style={{ display: "flex", gap: 8, marginTop: 4 }}>
<button onClick={onConfirmarDuplicado} disabled={saving}
style={{ background: "#8B0000", color: "white", border: "none", borderRadius: "var(--border-radius-md)", padding: "6px 14px", fontSize: 12, fontWeight: 500, cursor: "pointer" }}>
{saving ? "Enviando..." : "Enviar de todos modos"}
</button>
<button onClick={onDescartarDuplicado} style={{ background: "none", border: "0.5px solid var(--color-border-secondary)", borderRadius: "var(--border-radius-md)", padding: "6px 14px", fontSize: 12, cursor: "pointer", color: "var(--color-text-secondary)" }}>Revisar datos</button>
</div>
</div>
)}
<button
onClick={onEnviar}
disabled={!aceptaPrivacidad || enviando}
style={{
background: aceptaPrivacidad ? "#8B0000" : "var(--color-background-secondary)",
color: aceptaPrivacidad ? "white" : "var(--color-text-tertiary)",
border: "none", borderRadius: "var(--border-radius-md)",
padding: "10px 20px", fontSize: 14, fontWeight: 500, width: "100%",
cursor: aceptaPrivacidad && !enviando ? "pointer" : "not-allowed",
}}
>
{comprobandoDuplicado ? "Comprobando..." : saving ? "Enviando..." : "📨 Enviar propuesta"}
</button>
</div>
);
}
+29
View File
@@ -0,0 +1,29 @@
import { inputStyle } from "../styles/shared.js";
import { CATEGORIAS } from "../constants/categorias.js";
// Paso 5 de la pasarela: tipo específico (subcategoría), opcional. Solo está
// accesible tras elegir categoría (el paso anterior lo exige), y se puede
// continuar sin seleccionar ninguna.
export default function PasoSubcategoria({ form, setForm }) {
const subcategorias = form.categoria ? CATEGORIAS[form.categoria]?.subcategorias || [] : [];
return (
<div>
<label htmlFor="paso-subcategoria" style={{ fontSize: 12, color: "var(--color-text-secondary)", display: "block", marginBottom: 4 }}>
Tipo específico
</label>
<select
id="paso-subcategoria"
style={{ ...inputStyle, opacity: form.categoria ? 1 : 0.5 }}
value={form.subcategoria}
onChange={(e) => setForm((f) => ({ ...f, subcategoria: e.target.value }))}
disabled={!form.categoria}
>
<option value="">Sin tipo específico</option>
{subcategorias.map((s) => <option key={s} value={s}>{s}</option>)}
</select>
<p style={{ fontSize: 11, color: "var(--color-text-tertiary)", margin: "6px 0 0" }}>
Paso opcional: puedes continuar sin elegir un tipo específico.
</p>
</div>
);
}

Some files were not shown because too many files have changed in this diff Show More