System Overview
CanaryConditions is built on a highly optimized WordPress foundation, utilizing a custom plugin architecture to handle complex data aggregation, processing, and visualization. Unlike standard WordPress sites, we treat the CMS primarily as an application framework and content delivery engine.
Core Engine
Custom-built canary-conditions-core plugin handling all business logic, custom post types, and REST API endpoints.
Data Pipeline
Orchestrated ingestion from OpenWeatherMap, AEMET, and regional sensors with intelligent failure handling.
Performance
Vanilla JavaScript frontend with Leaflet.js for mapping, ensuring sub-second load times and smooth interactivity.
Intelligent Data Management
One of our biggest engineering challenges was handling high-frequency weather data for 50+ locations without exceeding API rate limits or slowing down the database. We implemented a location-based caching strategy that revolutionized our data efficiency.
Optimized from 800 to ~120 calls/day by decoupling spots from monitoring stations.
Reduced daily row insertions from 16,000 to 4,800 through combined forecast storage.
Real-time cron jobs ensure data is never more than 15 minutes old.
The "Combined Fetch" Pattern
We developed a proprietary fetch_and_cache_combined() method in our Forecast Manager. Instead of making separate API calls for current conditions and 5-day forecasts, we retrieve a single comprehensive dataset. This data is then parsed to populate both the real-time status tables and the long-term forecast cache simultaneously, ensuring perfect synchronization between what users see now and what they expect later.
Algorithmic Intelligence
Raw data is useless without context. Our scoring engines translate complex meteorological metrics into actionable advice.
📸 Photography Score Algorithm
Calculates a 0-10 score based on:
- Calima Penalty: Exponential decay based on PM10 levels.
- Cloud Cover: Bell-curve scoring (some clouds are better than none).
- Golden Hour: Boosts score during sunrise/sunset windows.
- Precipitation: Heavy penalties for rain probability > 20%.
⛰️ Hiking Safety Rating
Determines Safe/Caution/Unsafe status based on:
- Wind Speed: Thresholds at 30km/h (Caution) and 50km/h (Unsafe).
- Thermal Stress: Combined heat/humidity index analysis.
- Air Quality: PM10 levels > 100µg/m³ trigger safety warnings.
- Visibility: Low visibility (< 2km) automatically flags trails as Unsafe.
The Stack
- Backend: PHP 8.1, WordPress 6.4+
- Database: MySQL 8.0 (Custom tables for time-series data)
- Frontend: HTML5, CSS3 (CSS Variables), Vanilla ES6 JavaScript
- Mapping: Leaflet.js v1.9.4, OpenStreetMap
- APIs: OpenWeatherMap One Call 3.0, SunCalc.js
- Infrastructure: WP-CLI for background processing and maintenance