Castellón Comercio · Front
Encuentra, filtra y sigue en un mapa los comercios adheridos a los bonos de Castelló de la Plana.
Dos ediciones en una sola web: la 2025 (demo) y la 2026 (renovada).
🌐 Web pública · Capturas · Ecosistema · Arranque rápido · Documentación · ⚙️ API
[!NOTE]
Iniciativa independiente y sin ánimo de lucro. No guarda relación con el Ayuntamiento de Castelló de la Plana ni con CONFECOMERÇ. Los datos proceden de la web oficial del programa y se ofrecen solo con fines informativos.
✨ ¿Qué es?
La web oficial del programa ofrece un listado paginado sin buscador cómodo, sin mapa y sin histórico. Este proyecto lo convierte en una experiencia útil:
- 🔎 Buscador por nombre, dirección o sector (tolera acentos).
- 🗂️ Lista agrupada por sector o 🗺️ mapa con clústeres, con contador de establecimientos.
- ⭐ Favoritos guardados en tu navegador y 🔗 filtros compartibles por URL.
- 🔔 Novedades: altas y bajas del listado a lo largo del tiempo.
- 🌍 Castellano y valencià, responsive y con accesibilidad en mente (
prefers-reduced-motion, ARIA, teclado).
🧭 Ecosistema
Este repositorio es solo el front. Los datos los produce el API, que vigila la web oficial y avisa de los cambios.
flowchart LR
W["🌐 Web oficial<br/>bonoscastellodelaplana.es"] -- "scrapeo cada 5 min" --> A["⚙️ API<br/>Node · Express"]
A <--> R[("🧠 Redis")]
A -- "email si hay<br/>comercios nuevos" --> M["✉️ SMTP / Resend"]
A -- "REST /api/comercios" --> F["🖥️ Front<br/>Angular (este repo)"]
F --> U(["👤 Ciudadanía"])
style F fill:#1E4D2B,color:#FBFAF0,stroke:#123524
style A fill:#F9CBA0,stroke:#C25E00
📸 Capturas
Todas las capturas usan datos ficticios (comercios, fotos, teléfonos y fechas inventados); no se muestran datos reales del programa. Se regeneran con tools/readme-screenshots.cjs.
Portada
Edición 2026
En el móvil
Edición 2025 (demo)
🗓️ Ediciones
| Ruta | Edición | Datos |
|---|
/ | Portada (por qué existe, fuentes oficiales, entrada a la 2026; la 2025 demo desde el pie) | — |
/2026 · /2026/comercios · /2026/novedades | 2026 — vistas renovadas | API real (configurable) |
/2025 · /2025/history | 2025 — vistas originales | Siempre demo (public/mockup/) |
Cómo se fuerza el modo demo en 2025 y cómo está montado el diseño 2026: docs/EDITIONS.md.
🚀 Arranque rápido
Requisitos: Node.js 22.22.3+, 24.15+ o 26+ (lo exige Angular 22) y npm.
git clone https://github.com/ElMaxter99/castellon-comercio-notificator-front.git
cd castellon-comercio-notificator-front
npm install
npm start # http://localhost:4200 contra el API en http://localhost:12001
npm start -- --live=false # sin API: datos mock de public/mockup (solo afecta a 2026)
npm test # Karma + Jasmine (el CI lo ejecuta en cada PR)
npm run build -- --configuration=production
🔌 Apuntar a tu propio API
La URL se fija al compilar, sin tocar código:
# variable de entorno (también en Vercel: Project Settings → Environment Variables)
API_BASE_URL=https://mi-api.onrender.com npm run build -- --configuration=production
# o con flag
npm start -- --api-url=http://localhost:3000
Prioridad: --api-url › API_BASE_URL › valor por defecto del entorno. Detalles en docs/ENVIRONMENTS-AND-MOCK.md. Para montar tu propio backend gratis: guía de hosting del API.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
