-------------------------------------------------------------------------------- Document ID : DAB-DASH-SPEC-V9-4-001 Title : Daralbeida Intelligence Hub — v9.4 Delta Specification Version : 9.4 Status : DRAFT Date Created : 2026-05-01 Prepared by : PYB / Daralbeida Style : BPGP Department : OPS Classification: Internal Related Docs : DAB-DASH-SPEC-V9-3-001; bi.html (v9.4); : api/newsdata_proxy.php (unchanged from v9.3) Builds on : DAB-DASH-SPEC-V9-3-001 -------------------------------------------------------------------------------- OUTLINE -------------------------------------------------------------------------------- 1. Purpose and Scope 2. Changes in v9.4 3. New Tab — Competitor Markets 4. Card Inventory 5. Source Quality Rationale 6. Strategic Value by Country 7. Files Shipped with This Specification 8. Deployment 9. Known Limitations 10. Change Log 11. Acronyms 12. Glossary 13. Document Control ================================================================================ 1. PURPOSE AND SCOPE ================================================================================ This document is the delta specification for v9.4 of the Daralbeida Intelligence Hub. It adds one new tab (Competitor Markets) covering the six Mediterranean olive oil producing countries that compete with Morocco for US import share, plus a cross-cutting climate watch focused on harvest-impact weather. No changes are made to the v9.3 architecture, fallback logic, NewsData.io integration, or PHP proxy. The existing six tabs (Awards, Water, Production, Market, Retail, Compliance) are unchanged. ================================================================================ 2. CHANGES IN V9.4 ================================================================================ One new tab added: Competitor Markets. Eleven new cards. No other changes. ================================================================================ 3. NEW TAB — COMPETITOR MARKETS ================================================================================ Tab ID: competitor Title: Competitor Markets Card count: 11 Sort: Reverse chronological across all cards (existing logic) ================================================================================ 4. CARD INVENTORY ================================================================================ Country/Lane Card Query Basis --------------------------------------------------------------- Spain Mercacei (ES) Pub name + ES/EN keywords Spain Olimerca (ES) Pub name + ES/EN keywords Spain Spain Agro Press ES-language harvest/export Italy Olio Officina (IT) Pub name + IT keywords Italy Teatro Naturale Pub name + IT keywords Italy Italy Agro Press IT-language harvest/export Tunisia Tunisia Sector ONAGRI/ONH + FR/EN Greece Greece Sector PDO + Kalamata + Koroneiki Portugal Portugal Sector PT-language Alentejo/azeite Turkey Turkey Sector Zeytinyagi + export terms Cross-cutting Med Climate Watch Drought/heatwave + harvest ================================================================================ 5. SOURCE QUALITY RATIONALE ================================================================================ 5.1 Spanish Trade Press -------------------------------------------------------------------------------- Mercacei and Olimerca are the two reference Spanish-language olive oil trade magazines. Both are cited as primary sources by Olive Oil Times, Certified Origins monthly reports, and the wider EU trade. Neither has a confirmed public RSS feed usable from a browser. v9.4 uses Google News publication-name search (indexes both originals and third-party citations). 5.2 Italian Trade Press -------------------------------------------------------------------------------- Olio Officina (olioofficina.it) and Teatro Naturale (teatronaturale.it) are the two reference Italian-language olive oil trade publications. Same name- search pattern as Spanish. 5.3 Tunisia, Greece, Portugal, Turkey -------------------------------------------------------------------------------- No single dominant English-language olive oil trade publication per country. Handled via Google News queries with country-specific terminology: Tunisia: ONAGRI (National Observatory on Agriculture), ONH (Office National de l'Huile) Greece: PDO Kalamata, Koroneiki varietal Portugal: azeite, Alentejo region, colheita (harvest) Turkey: zeytinyagi (olive oil in Turkish), export terms 5.4 Mediterranean Climate Watch -------------------------------------------------------------------------------- Mediterranean drought and heatwave coverage where the article ties weather to olive harvest impact. Harvest-impact analysis surfaces through trade press; this card ensures weather-driven supply disruptions are flagged early. ================================================================================ 6. STRATEGIC VALUE BY COUNTRY ================================================================================ Country Strategic Value for Daralbeida --------------------------------------------------------------- Spain No. 1 global producer (~40% world supply). Sets EU and global reference price. Main MAFTA-vs-EU-15%- tariff comparator for investor materials. Italy Premium EVOO brand standard. Made-in-Italy blending often uses Spanish/Tunisian bulk — Italian bulk price signals indicate downstream pressure on premium pricing. Tunisia Closest North African peer. Faces a 28% US tariff (vs. Daralbeida 0% under MAFTA). Direct landed-cost benchmark. Greece Single-varietal premium positioning (Koroneiki, PDO Kalamata) — closest stylistic match to Daralbeida's single-estate narrative. Portugal Modern-intensive Alentejo growth story. Rising competitor in mid-premium tier. EU production data: approximately 177,000 tons (2024/25). Turkey Volatile player: government export suspensions create supply gaps competitors fill. Worth monitoring for opportunistic supply windows. ================================================================================ 7. FILES SHIPPED WITH THIS SPECIFICATION ================================================================================ File Description --------------------------------------------------------------- bi.html v9.4 dashboard (drop-in replacement for v9.3 bi.html) DAB-DASH-SPEC-V9-4-001.TXT This document No new PHP, CSS, or other files. api/newsdata_proxy.php from v9.3 is unchanged and still required. ================================================================================ 8. DEPLOYMENT ================================================================================ Step 1 Drop new bi.html into public_html/devt/ (overwrites v9.3 bi.html). Step 2 No changes needed to api/newsdata_proxy.php. Step 3 Open devt/bi.html; verify the Competitor Markets tab appears as the 7th tab in the navigation row. Step 4 Click the tab. Confirm cards load with mostly [PRIMARY] tags. Spanish/Italian trade press cards may show [FALLBACK] depending on Google News indexing freshness; this is normal. Step 5 Promote to public_html/ once verified. ================================================================================ 9. KNOWN LIMITATIONS ================================================================================ 1. Google News indexing of Spanish/Italian trade pubs is not real-time — articles may surface 2-24 hours after publication on the original site. 2. Bing News fallback for non-English-language queries is patchier than for English. Expect more [QUIET] states on Italian/Portuguese cards during low-news periods. 3. If a card consistently returns [QUIET] over 1-2 weeks, revise the query in collections[].feeds — that is a signal the search terms are not matching current news vocabulary. ================================================================================ 10. CHANGE LOG ================================================================================ v9.4.0 Added Competitor Markets tab with 11 cards covering Spain (3), Italy (3), Tunisia, Greece, Portugal, Turkey, and Mediterranean Climate Watch. ================================================================================ 11. ACRONYMS ================================================================================ API Application Programming Interface BI Business Intelligence (also: bi.html — the dashboard file) DEVT Development environment (public_html/devt/) ES Spanish language code FR French language code IT Italian language code JS JavaScript MAFTA Morocco-America Free Trade Agreement ONAGRI Observatoire National de l'Agriculture (Tunisia) ONH Office National de l'Huile (Tunisia) OPS Operations and Logistics (department code) PDO Protected Designation of Origin PHP PHP Hypertext Preprocessor PT Portuguese language code PYB Internal reference code for the Daralbeida founder RSS Really Simple Syndication ================================================================================ 12. GLOSSARY ================================================================================ Azeite Portuguese word for olive oil. Used as a search term for Portuguese- language olive oil trade news in the Competitor Markets tab. Colheita Portuguese word for harvest. Used as a search term for Portuguese- language harvest reporting in the Competitor Markets tab. Competitor Markets Tab The new 7th tab in the Daralbeida Intelligence Hub dashboard. Covers Spain, Italy, Tunisia, Greece, Portugal, Turkey, and a Mediterranean Climate Watch cross-cutting card. Added in v9.4. Daralbeida Intelligence Hub The Daralbeida internal market intelligence dashboard (bi.html). Aggregates live news feeds across olive oil production, trade, regulation, and competitive intelligence. Hosted on daralbeida.com. Koroneiki The dominant Greek olive cultivar. Produces single-varietal premium EVOOs that are the closest stylistic comparator to Daralbeida's single-estate positioning. Monitored as a competitive signal. Mercacei One of the two reference Spanish-language olive oil trade magazines. Sets Spanish and EU reference pricing. Monitored via Google News publication-name search. Olimerca The second reference Spanish-language olive oil trade magazine. Monitored alongside Mercacei via Google News. Zeytinyagi Turkish word for olive oil. Primary search term for Turkish-language olive oil trade news in the Competitor Markets tab. -------------------------------------------------------------------------------- DOCUMENT CONTROL (FOOTER) -------------------------------------------------------------------------------- Document ID : DAB-DASH-SPEC-V9-4-001 Version : 9.4 Status : DRAFT Style : BPGP Department : OPS Last Modified : 2026-05-01 Review Cycle : Upon promotion from devt to production; upon addition of new competitor country lanes Retention : 2 years from date of creation Owner : PYB / Daralbeida Distribution : Internal only — webmaster/sysadmin receives this document for implementation COMPLIANCE : This is a delta specification. It must be read in conjunction with DAB-DASH-SPEC-V9-3-001. Do not implement v9.4 without a fully functional v9.3 deployment as the base. Relative path convention from v9.3 applies unchanged. Revision History: Version Date Author Summary of Changes -------------------------------------------------- 9.4.0 2026-05-01 PYB Initial v9.4 delta spec; Competitor Markets tab added -------------------------------------------------------------------------------- END OF DOCUMENT — DAB-DASH-SPEC-V9-4-001 --------------------------------------------------------------------------------