Repository navigation
1 Architecture
Oussama Elhadji edited this page Oct 25, 2026
·
1 revision
L7OT is designed as an offline-first, client-rendered Progressive Web App (PWA) with sub-second interaction speed, zero server latency, and complete multi-lingual support.
flowchart TD
User([User in Fish Market / Kitchen]) --> UI[L7OT React UI]
UI --> FishModule[Fish Encyclopedia & Multi-Search]
UI --> RecipeModule[Authentic Recipe Catalog]
UI --> ChefModule[Chef L7ot Charmoula Engine]
UI --> MarketModule[5-Sense Freshness & Port Guide]
UI --> SpeechModule[Darija Audio Speech Synthesizer]
ChefModule --> CalcEngine[Charmoula Matrix Engine]
CalcEngine --> DynamicFormula[Grams / Spoons / Temp / Marinade]
FishModule --> StaticDB[(Local Encrypted Dataset)]
RecipeModule --> StaticDB
MarketModule --> StaticDB
UI --> PWA[Service Worker Cache / Offline Storage]
-
State & i18n Layer:
-
STRINGSdictionary providing immediate, zero-flash locale transitions between Moroccan Arabic (Darija), French, and English. - RTL directionality switching dynamically based on active locale.
-
-
The "Chef L7ot" Calculation Algorithm (
src/lib/charmoula.ts):- Computes exact spice ratios as a function of:
- Meat density & fat profile (Oily pelagic vs delicate white fish vs cephalopod vs crustacean).
- Cooking thermodynamics (Clay tagine braising vs 200°C convection oven vs screaming hot fry oil vs charcoal embers).
- Scalable serving multiplier (1 to 12 persons).
- Computes exact spice ratios as a function of:
-
Media & Fallback Pipeline:
- High-definition live photography curated from Wikimedia Commons and Unsplash.
- Automatic fallback SVG rendering ensures no broken image icons ever show if network connectivity drops.
-
Speech Synthesis:
-
speakDarija()utilizeswindow.speechSynthesistargeting native Arabic voices (ar-MAor Arabic variants) with phonetic Latin fallbacks for international travelers.
-
L7OT (الحوت) — The Definitive Moroccan Fish & Marine Encyclopedia
Curated & Architected by Oussama EL HADJI • Distributed under the MIT License
-
📖 Encyclopedia & Biology
-
🍽️ Culinary & Port Culture
-
📊 Economics, Treaties & Maritime Law
-
💻 Engineering & Architecture