Add BeanFlows MVP: coffee analytics dashboard, API, and web app

- Fix pipeline granularity: add market_year to cleaned/serving SQL models
- Add DuckDB data access layer with async query functions (analytics.py)
- Build Chart.js dashboard: supply/demand, STU ratio, top producers, YoY table
- Add country comparison page with multi-select picker
- Replace items CRUD with read-only commodity API (list, metrics, countries, CSV)
- Configure BeanFlows plan tiers (Free/Starter/Pro) with feature gating
- Rewrite public pages for coffee market intelligence positioning
- Remove boilerplate items schema, update health check for DuckDB
- Add test suite: 139 tests passing (dashboard, API, billing)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

transform/sqlmesh_materia/models/cleaned/cln_psdalldata__commodity_pivoted.sql

@@ -13,6 +13,7 @@ SELECT
   max(commodity_name) as commodity_name,
   country_code,
   max(country_name) as country_name,
+  market_year,
   ingest_date,
   COALESCE(SUM(CASE WHEN attribute_name = 'Production' THEN value END), 0) AS Production,
   COALESCE(SUM(CASE WHEN attribute_name = 'Imports' THEN value END), 0) AS Imports,
@@ -48,8 +49,10 @@ WHERE attribute_name IN (
 GROUP BY
   commodity_code,
   country_code,
+  market_year,
   ingest_date
 ORDER BY
   commodity_code,
   country_code,
+  market_year,
   ingest_date

transform/sqlmesh_materia/models/serving/obt_commodity_metrics.sql

@@ -14,6 +14,7 @@ WITH country_metrics AS (
     commodity_name,
     country_code,
     country_name,
+    market_year,
     ingest_date,
     Production,
     Imports,
@@ -27,7 +28,7 @@ WITH country_metrics AS (
     -- Handle division by zero for Stock-to-Use Ratio
     (Ending_Stocks / NULLIF(Total_Distribution, 0)) * 100 AS Stock_to_Use_Ratio_pct,
     -- Calculate Production YoY percentage change using a window function
-    (Production - LAG(Production, 1, 0) OVER (PARTITION BY commodity_code, country_code ORDER BY ingest_date)) / NULLIF(LAG(Production, 1, 0) OVER (PARTITION BY commodity_code, country_code ORDER BY ingest_date), 0) * 100 AS Production_YoY_pct
+    (Production - LAG(Production, 1, 0) OVER (PARTITION BY commodity_code, country_code ORDER BY market_year, ingest_date)) / NULLIF(LAG(Production, 1, 0) OVER (PARTITION BY commodity_code, country_code ORDER BY market_year, ingest_date), 0) * 100 AS Production_YoY_pct
   FROM cleaned.psdalldata__commodity_pivoted
 ),
 global_aggregates AS (
@@ -36,6 +37,7 @@ global_aggregates AS (
     commodity_name,
     NULL::TEXT AS country_code, -- Use NULL for global aggregates
     'Global' AS country_name,
+    market_year,
     ingest_date,
     SUM(Production) AS Production,
     SUM(Imports) AS Imports,
@@ -46,6 +48,7 @@ global_aggregates AS (
   GROUP BY
     commodity_code,
     commodity_name,
+    market_year,
     ingest_date
 ),
 -- CTE to calculate derived metrics for global aggregates
@@ -55,6 +58,7 @@ global_metrics AS (
     commodity_name,
     country_code,
     country_name,
+    market_year,
     ingest_date,
     Production,
     Imports,
@@ -65,7 +69,7 @@ global_metrics AS (
     (Exports - Imports) AS Trade_Balance,
     (Production + Imports - Exports) - Total_Distribution AS Supply_Demand_Balance,
     (Ending_Stocks / NULLIF(Total_Distribution, 0)) * 100 AS Stock_to_Use_Ratio_pct,
-    (Production - LAG(Production, 1, 0) OVER (PARTITION BY commodity_code ORDER BY ingest_date)) / NULLIF(LAG(Production, 1, 0) OVER (PARTITION BY commodity_code ORDER BY ingest_date), 0) * 100 AS Production_YoY_pct
+    (Production - LAG(Production, 1, 0) OVER (PARTITION BY commodity_code ORDER BY market_year, ingest_date)) / NULLIF(LAG(Production, 1, 0) OVER (PARTITION BY commodity_code ORDER BY market_year, ingest_date), 0) * 100 AS Production_YoY_pct
   FROM global_aggregates
 )
 -- Combine country-level and global-level data into a single output
@@ -74,6 +78,7 @@ SELECT
   commodity_name,
   country_code,
   country_name,
+  market_year,
   ingest_date,
   Production,
   Imports,
@@ -97,4 +102,5 @@ FROM (
 ORDER BY
   commodity_name,
   country_name,
+  market_year,
   ingest_date;