Repository navigation
Commit History and Changelog
Bosaj edited this page Oct 24, 2026
·
11 revisions
This page documents the complete chronological development trajectory of L7OT (الحوت) from the initial commit to the latest release, detailing all architectural decisions, taxonomy expansions, marine API integrations, and UX refinements.
[v2.1.1] — Universal Mobile Viewport Optimization, Zero Horizontal Overflow & Prominent Language Switcher (2026-10-24)
-
Mobile Viewport & Overflow Elimination:
- Replaced ambient blur elements with pure CSS hardware-accelerated radial gradients, eliminating the 47px horizontal layout expansion in RTL browsers.
- Added overflow-x: clip on html, body, and #root.
- Universal protection on all select elements (max-width: 100% !important; text-overflow: ellipsis; overflow: hidden;).
- Converted port and footer action buttons to clean, symmetrical mobile grids.
-
Service Worker Update Configuration:
- Enabled skipWaiting, clientsClaim, and cleanupOutdatedCaches in vite-plugin-pwa.
-
Production Integration:
- Configured official repository homepage to https://l7ot.vercel.app and registered active Vercel Production deployment in GitHub Deployments.
[v2.1.0] — Real Interactive Geographic Coastal GIS Map (Leaflet) & Tactical Nautical Layer (2026-10-24)
-
Real Interactive Moroccan Coastal GIS Map (MoroccanLeafletMap.tsx):
- Integrated Leaflet with true geographic coordinates covering all 3,500 km of Moroccan coastline (Saïdia to Lagouira).
- Multi-layer tile engine: Esri Oceans (bathymetric depths), Esri World Imagery (high-res satellite), and National Geographic Physical Terrain.
- Moroccan Nautical Lighthouses network with historic flashing periods and WGS84 coordinates.
- Real-time oceanographic popups showing live swell height (m), wind speed (knots), and surface sea temperature (°C) for all 17 Moroccan commercial ports and Marine Protected Areas (AMPs).
[v2.0.0] — 44 Species Catalog, Studio Neural Audio (Darija, FR, EN), Bourse Citoyenne, Social Share Cards & Edge Vision AI (2026-10-24)
-
Full 44-Species Moroccan Halieutic Catalog Alignment:
- Complete biological data, dialectal names (Chamal, Oriental/Tarifit, Centre, Sud/Amazigh), Dahir 1973 statutory sizes, and ONP wholesale spot pricing for all 44 species (
merou-brun,lotte-baudroie,turbot,marbre,sar-tambour,liche-amie,rascasse-rouge,ombrine,homard-europeen,dorade-grise,cernier,grande-vive).
- Complete biological data, dialectal names (Chamal, Oriental/Tarifit, Centre, Sud/Amazigh), Dahir 1973 statutory sizes, and ONP wholesale spot pricing for all 44 species (
-
High-Fidelity Studio Neural Voice Pack (132 Recordings across Darija, French & English):
- Native Moroccan Arabic (
ar-MA-JamalNeural), French (fr-FR-VivienneMultilingualNeural), and English (en-US-ChristopherNeural) studio MP3 files inpublic/audio/fish/ar/,public/audio/fish/fr/, andpublic/audio/fish/en/. - Dynamic multilingual pronunciation audio matching active UI browsing language.
- Native Moroccan Arabic (
-
Bourse Citoyenne (Crowdsourced Souk & Port Price Reporter) (
CommunityPriceReporter.tsx):- Live crowdsourced marketplace tracking observed retail prices per kg across 17 coastal Moroccan markets (Marché Central Casablanca, Souk El Had Agadir, Port de Safi, Bab El Marsa Tanger, etc.).
- Automated ONP wholesale markup barometer detecting fair margins vs. speculative overpricing.
- Citizen confirmation and upvoting counter with
localStoragepersistence.
-
Dynamic Social Specimen Share Cards (
SpecimenShareCardModal.tsx) & Schema.org Rich SEO:- High-res 1200x630 HTML5 Canvas generator rendering Moroccan maritime crest, fish specimen artwork, spot prices, and Dahir 1973 minimum size.
- 1-click WhatsApp share button with pre-formatted bilingual Moroccan text and direct link.
- Dynamic Schema.org
Product(SeafoodProduct) andRecipeJSON-LD injection for Google Search rich cards.
-
Edge Vision AI Scanner Enhancement (
FishScanner.tsx):- Real-time animated bounding box, laser sweep, corneal clarity eye reticle, gill coloration contour arc, and Dahir 1973 length calibrator over live camera video feed.
- Biometric sensory HUD controls with interactive toggle.
-
Full Offline PWA Service Worker Caching ("Mode Pêcheur en Mer"):
- Enhanced
vite-plugin-pwaWorkbox engine to precache 112 assets totaling 18.09 MB (maximumFileSizeToCacheInBytes: 15MB), including all 44 high-res Moroccan fish specimens inpublic/images/fish/, webfonts, and biological regulatory tables. - Guarantees 100% offline functionality when sailing offshore with zero cellular signal (0G / No 4G/5G).
- Enhanced
-
High-Seas Marine Navigator & Gyro Compass (
MarineGpsNavigator.tsx):- Built an offshore nautical bridge dashboard featuring a rotating SVG gyro compass dial with magnetic needle pointing toward refuge ports.
- Real-time GPS telemetry: Latitude / Longitude in Nautical DMS (
DD°MM'SS" N/W) and Decimal Degrees, Speed Over Ground (SOG) in Knots, and GPS precision accuracy ($\pm x$ meters). - Haversine Proximity Engine computing nautical distance (
NM), azimuth bearing ($0-359^\circ$ ), and sailing travel duration at 8 knots across all 17 Moroccan ONP ports.
-
Moroccan Sovereign Maritime Zone Classifier:
- Categorizes vessel distance according to Dahir 1-73-211 and UNCLOS: Territorial Waters (0–12 NM), Contiguous Zone (12–24 NM), Moroccan Exclusive Economic Zone (ZEE 200 NM), and International High Seas (> 200 NM).
-
Marine Protected Areas (AMPs) Sanctuary Proximity Alarm:
- Real-time safety status monitoring near 5 marine reserves (Al Hoceima National Park, Marchica Lagoon, Sidi Boughaba, Souss-Massa, and Dakhla Bay) with cautionary biological rest warnings per Dahir 1973.
-
VHF Channel 16 & MRCC Emergency Mayday Generator:
- Pre-formatted international distress broadcast message (Canal 16 VHF - 156.800 MHz) with 1-click clipboard copy and direct contact numbers for MRCC Rabat (+212 537 62 58 77), Gendarmerie Maritime (177), and Protection Civile (150).
-
Persistent Offshore Status Banner (
OffshoreFishermanBanner.tsx):- Live online/offline listener with manual high-seas simulation toggle, sonar ping animation, and quick launcher button.
-
Interactive 3,500 km Moroccan Coastal GIS Map (
MoroccanCoastalRadar.tsx):- Added as first-class Navigation Tab (
02 · خريطة السواحل والموانئ / Carte GIS) with full mobile and desktop support. - 17 Commercial & Artisanal Ports (ONP): Tanger Med, Nador Beni Ensar, Al Hoceima, Saïdia, Larache, Mehdia, Casablanca, Oualidia, Safi, Essaouira, Agadir, Sidi Ifni, Tan-Tan, Laâyoune, Boujdour, Dakhla, and Lagouira.
- Multi-Layer GIS Architecture: Switch between All Layers, 17 Ports/Criées, 5 Marine Protected Areas (Parc National d'Al Hoceima, Lagune de Marchica, Parc National de Souss-Massa, Baie d'Oued Ed-Dahab), and 3 Pelagic Fishery Corridors.
- Direct Catalog Filtering: 1-click action button (Filtrer les poissons de ce port dans l'Atlas) dynamically filtering species by port of landing.
- Added as first-class Navigation Tab (
-
Live Vercel Production Sync:
- Updated and promoted live at https://l7ot.vercel.app.
[v1.7.0] — Dynamic Language Typography, Coastal Tide & Lunar Clock, Specimen Passport & Vercel Production (2026-10-24)
-
Tri-Lingual Dynamic Typographic Architecture:
- Resolved font family switching bug: Changing language between Arabic, French, and English now visibly, instantly, and reliably shifts both heading and body typography.
-
Arabic (
font-arabic): Classical calligraphic dignity withAmiriserif headings andReadex Pro/IBM Plex Sans Arabicbody. -
French (
font-french): Haute couture French Riviera editorial styling withPlayfair Displayserif headings andPlus Jakarta Sansbody. -
English (
font-english): Imperial Roman inscriptional capitals withCinzelserif headings andPlus Jakarta Sansnaval telemetry body. - Injected Google Fonts CDN fallback directly in
index.htmlalongside@fontsourcepackages.
-
Moroccan Coastal Tide & Lunar Clock (
MoroccanTideAndLunarClock.tsx):- Astronomical lunar phase calculation engine (real-time illumination %, synodic cycle day, Spring/Neap tides Vives-Eaux / Mortes-Eaux indicator).
- Semi-diurnal tide predictions (high tide, low tide, tidal coefficients, water height in meters) for 6 major Moroccan ports: Tanger Med, Casablanca, Safi, Essaouira, Agadir, and Dakhla.
- Dedicated artisanal & surfcasting fishery recommendations for each lunar and tidal phase.
-
Printable Specimen Passport & Fiche Technique (
FishSpecimenPassportModal.tsx):- 1-click printable technical passport adhering to Dahir 1973 minimum commercial catch size, nutritional breakdown, regional ports, and culinary methods.
- Native
window.print()styling and instant formatted Markdown clipboard export.
-
Live Vercel Production Deployment:
- Deployed live at https://l7ot.vercel.app and https://l7ot-atlas.vercel.app.
- Automated Vercel CLI deployment via team scope
bosajs-projectswith zero-downtime edge caching.
-
Royal & Premium Latin Typography Architecture:
- Inscriptional Latin display typography (
Cinzel&Playfair Display) delivering imperial, regal majesty for English and French translations. - Modern geometric UI body typography via
@fontsource-variable/plus-jakarta-sanswith tight optical kerning (tracking-[-0.012em]). - Modern Arabic clean typography via
@fontsource-variable/readex-proalongside classicalAmiriNaskh. - Automatic
document.documentElement.langanddirdynamic synchronization inApp.tsx.
- Inscriptional Latin display typography (
-
Interactive 5-Sense Freshness Diagnostic Lab (
MarketGuide.tsx):- 5-point interactive sensory inspection (Eyes, Gills, Skin, Flesh, Aroma) with real-time scoring and certification (Grade A+ Criée Royale, Frais Standard, Passé).
-
Moroccan Fleet Landing Schedule & Port Market Clock:
- Exact landing hours for Pêche Artisanale (06:00-09:00), Coastal Trawlers (11:00-14:30), and Pelagic Sardine Seiners (20:30-02:00).
-
Localized Primary Titles in Specimen Cards:
- Prominent English/French species titles on specimen cards and detail modals when browsing in LTR mode.
-
Touch-Action Mobile Scroll Lock:
- Enforced
touchAction = 'none'across all modal dialogs to eliminate iOS Safari touch background bounce.
- Enforced
-
12 New Commercial Species (44 Total):
- Integrated Mérou brun, Baudroie (Lotte), Turbot, Marbré, Sar tambour, Liche amie, Rascasse rouge, Ombrine côtière, Homard bleu, Dorade grise, Cernier commun, and Grande vive.
- Sourced 12 high-resolution, curated Wikimedia Commons photos stored in
public/images/fish/with licensing attribution inCREDITS.json. - Multi-regional dialect terminology cataloged across Chamal, Oriental (Rif), Centre, and Sud/Souss.
-
Multi-Language Video Filleting & Preparation Selector:
- Added instant language switcher (
🇲🇦 الدارجة,🇫🇷 Français,🇬🇧 English) within the modal video player. - Embedded dynamic, species-tailored YouTube search queries preventing generic video loops.
- Added instant language switcher (
-
Zero-Scrollbar Modal Navigation UX:
- Replaced horizontal overflow navigation with a responsive wrapping pill cluster (
scrollbar-none). - Enforced background page scroll locking during modal active states.
- Refined Arabic live ticker typography with natural right-to-left currency and trend orientation (
55 درهم/كلغ ▼).
- Replaced horizontal overflow navigation with a responsive wrapping pill cluster (
-
Moroccan Maritime Law Module (
MaritimeLawGuide):- Ingested legal provisions from Dahir 1973 and Arrêté ministériel n° 1154-88 (minimum commercial catch sizes for pelagics, demersals, cephalopods, crustaceans).
- Interactive dual-color visual fish size ruler showing prohibited sub-legal zone vs legal commercial zone.
- Official biological resting calendars (Repos biologique) for Dusky Grouper (Mérou) and Common Octopus (Poulpe).
-
Apnea Spearfishing (Chasse sous-marine) Code:
- 6 golden rules under DPM authority: apnea-only requirement, daytime hunting only, mandatory surface marker buoy with Alpha flag, non-commercial catch limit, and mandatory administrative licensing.
-
Dual-Track Infinite Marquee Ticker:
- Replaced the previous single-strip animation with twin identical tracks (
Track AandTrack B) side-by-side inside adir="ltr"container. - Applied
translate3d(0, 0, 0)totranslate3d(-50%, 0, 0)with a 45s linear loop andwill-change: transform. - As
Track Amoves left,Track Bcontinuously feeds in from the right edge, guaranteeing zero empty space on screens up to 4K resolutions. - Added instant hover pause (
group-hover:[animation-play-state:paused]). - Expanded wholesale port coverage to 12 Moroccan ports: Nador/Beni Ansar (Oriental), Tangier Med, Al Hoceima, Larache, Casablanca, Oualidia, Safi, Essaouira, Agadir, Tan-Tan/Sidi Ifni, Laâyoune, and Dakhla.
- Replaced the previous single-strip animation with twin identical tracks (
-
Scrollbar-Free Navigation UX:
- Eliminated all horizontal scrollbars and manual dragging across the main navigation masthead.
- Wrapped navigation items into a responsive pill cluster (
flex flex-wrap gap-1.5) with distinct Lucide iconography (Fish,Camera,UtensilsCrossed,ChefHat,ShoppingBag,Globe2,Waves).
-
Deterministic Offline Test Mocking:
- Mocked all external third-party API calls in
src/services/marineApis.test.tsviavi.spyOn(globalThis, 'fetch'). - Reduced test suite duration from >4s to 7ms, completely eliminating network timeouts in GitHub Actions cloud runners.
- Full coverage of both successful telemetry parsing and resilient offline fallback states (26/26 passing tests).
- Mocked all external third-party API calls in
-
BiDi / RTL Refinements:
- Fixed Arabic right-to-left directional chevrons in
FishModal. - Defaulted and auto-detected central inland users to Casablanca / Mohammedia port.
- Fixed Arabic right-to-left directional chevrons in
- Oriental Moroccan Regional Dialects: Cataloged authentic Oriental and Rifian fish names (Nador, Saïdia, Marchica lagoon) across all 32 marine species (e.g., Titchoukt, Pagel, Kamber, Lubina, Choco, Akharouy).
- GPS Coastal Port Geolocation Engine: Haversine formula calculates distance to nearest Moroccan port hub and auto-adjusts regional naming and pricing.
-
Worldwide Free Marine & Fisheries APIs Integration:
- Open-Meteo Marine API (live wave height, swell direction, period, and safety indices).
- WoRMS REST API (AphiaID and global taxonomic validation).
- OBIS API (UNESCO-IOC marine occurrences).
- FishBase / SeaLifeBase API (trophic levels and ecological vulnerability).
- Open Food Facts API (Moroccan packaged seafood, Nutri-Score, Eco-Score).
-
Governance & Workflows: Added GitHub Actions CI, CodeQL Security Scan, Release Automation, Issue Templates,
CONTRIBUTING.md,CONTRIBUTORS.md, andSECURITY.md.
- 32 Species Catalog: Authentic high-definition photography, binomial nomenclature, nutritional composition per 100g/1kg, and market pricing.
- 16 Coastal Recipes: Traditional Moroccan tagines with embedded filleting video guides (Le Kessal).
- Chef L7ot Charmoula Calculator: Dynamic spice formulation engine based on species, weight, and cooking style.
- Fisheries Treaties: Comprehensive economic analysis of Morocco's international agreements (EU, Russia, Japan, UK).
- Mobile AI Camera Scanner: Browser-based camera scanner for instant fish identification.
The following table provides the full linear history of all commits pushed to the repository:
| # | Commit | Date | Author | Summary & Changes |
|---|---|---|---|---|
| 24 | 7f31ffe |
2026-10-24 | Oussama EL HADJI | feat(v1.5.0): add Seasonal Catch Calendar, relative asset paths, 100% species cleaning videos, Vercel config & v1.5.0 release |
| 23 | 7aafb5f |
2026-10-24 | Oussama EL HADJI | fix(deploy): enable workflow-driven GitHub Pages & configure relative base path |
| 22 | 6603bbf |
2026-10-24 | Oussama EL HADJI | feat(coastal-radar, audio, deploy): add Moroccan Coastal Radar, Web Audio haptics, Docker containerization & Netlify deployment |
| 21 | f1bfd4c |
2026-10-19 | Oussama EL HADJI | chore: add .github/CODEOWNERS assigning global ownership to @Bosaj |
| 20 | 92a11cf |
2026-10-18 | Oussama EL HADJI | feat(taxonomy, legal, ux): add 12 Moroccan marine species (44 total), Maritime Law Guide & fix modal UX |
| 19 | c4f3dfa |
2026-10-18 | Oussama EL HADJI | fix(ui): correct Arabic exports number format (+31 مليار درهم) and add open-source issue/email reporting footer |
| 18 | a80b6a9 |
2026-10-18 | Oussama EL HADJI | docs(changelog): record CodeQL CWE-116 fix and updated commit log |
| 17 | 6e2d3c1 |
2026-10-18 | Oussama EL HADJI | fix(security): resolve CodeQL CWE-116 incomplete multi-character sanitization in download-images.mjs |
| 16 | 74e074a |
2026-10-18 | Oussama EL HADJI | docs: update README and CHANGELOG with v1.2.0 release, dual-track ticker, and complete commit history |
| 15 | 4c9669f |
2026-10-18 | Oussama EL HADJI | test(marineApis): mock network calls to prevent CI timeouts and ensure deterministic tests |
| 14 | aea4b82 |
2026-10-18 | Oussama EL HADJI | fix(header): eliminate ticker gap with dual-track infinite marquee and 12 Moroccan ports |
| 13 | 218d863 |
2026-10-18 | Oussama EL HADJI | fix(ux): add smooth auto-scrolling ticker with pause on hover and eliminate horizontal scrollbars in navigation |
| 12 | 254235c |
2026-10-18 | Oussama EL HADJI | fix(ux): normalize regional styling, fix RTL/LTR modal arrows, enable Casablanca auto-detection & integrate marine APIs into core features |
| 11 | f09a88f |
2026-10-18 | Oussama EL HADJI | docs: add GitHub Actions CI/CodeQL/release workflows, issue templates, CHANGELOG, and governance files |
| 10 | 8753bca |
2026-10-18 | Oussama EL HADJI | feat: add Oriental Moroccan regional dialect naming, port geolocation detection, and worldwide free marine APIs integration |
| 9 | 107d0fa |
2026-10-18 | Oussama EL HADJI | fix: resolve RTL/LTR currency inversion, layout overflows, untranslated footer, and add live marine weather and free marine APIs directory |
| 8 | b61e334 |
2026-10-18 | Oussama EL HADJI | feat: complete premium Moroccan seafood portal overhaul |
| 7 | 8e602f8 |
2026-10-18 | Oussama EL HADJI | feat: editorial Moroccan Maritime Atlas redesign, 22 fish species with local photos, native Arabic MP3 audio, and 10 fisheries treaties |
| 6 | a33dd71 |
2026-10-18 | Oussama EL HADJI | fix: store authentic fish & recipe photos locally, embed YouTube cleaning tutorials, and unify typography |
| 5 | 195c97e |
2026-10-18 | Oussama EL HADJI | docs: expand README with comprehensive guide to regional taxonomy, price trends, live nutrition calculator, cleaning tutorials, and treaties |
| 4 | 183bc44 |
2026-10-18 | Oussama EL HADJI | feat: real biological photos, regional Moroccan names, global/local price trends, live nutrition calculator, and traditional cleaning tutorials |
| 3 | 552aa99 |
2026-10-18 | Oussama EL HADJI | feat: add regional Moroccan fish names, global vs local pricing, international fisheries treaties, market tracker, and live 100g/1kg nutritional calculator |
| 2 | 5a6f390 |
2026-10-18 | Oussama EL HADJI | feat: initial release of L7OT - Moroccan fish encyclopedia, live images, market freshness guide, and recipes web app |
| 1 | initial |
2026-10-18 | Oussama EL HADJI | Initial commit: project scaffolding, Vite, React 19, TypeScript, and TailwindCSS configuration |
-
The Problem: In Arabic mode (
dir="rtl"), the single ticker track aligned to the container's right boundary. When the keyframe shifted the content left (translateX(-33%)), it moved away from the right edge, exposing an empty black space between the ONP badge and the items. -
The Fix: Configured a dual-track container with
dir="ltr"andtranslate3d(-50%, 0, 0)containing 12 wholesale ports duplicated side-by-side. Track B seamlessly enters from the right as Track A exits on the left.
-
The Problem: Tests in
marineApis.test.tsoriginally performed live HTTP requests to GBIF and Open Food Facts. In GitHub Actions runners, network throttling exceeded Vitest's 5000ms timeout. -
The Fix: Replaced live calls with mock responses via
vi.spyOn(globalThis, 'fetch'), verifying both successful payload transformation and graceful error recovery in 7ms.
-
The Problem: Arabic number rendering flipped expressions like
14 درهم/كلغintoدرهم/كلغ 14or14 kg/DHbecause of mixed LTR numbers inside RTL strings. -
The Fix: Created
<PriceBadge />with isolated<bdi>and explicit RTL flow to guarantee correct cultural typography.
-
The Problem: CodeQL security scanning flagged
scripts/download-images.mjswith rulejs/incomplete-multi-character-sanitizationdue to single-pass.replace(/<[^>]+>/g, '')on untrusted Wikimedia metadata. -
The Fix: Implemented
sanitizeHtml()with an iterative loop stripping nested tags until fixed-point equality, followed by single-character markup neutralizer.replace(/[<>]/g, ''), permanently resolving security alert #1.
-
The Problem: Images specified with absolute root paths (e.g.
/favicon.svg,/images/fish/sardine.jpg) resulted in broken image icons on GitHub Pages because the repository was hosted under a subpath (https://bosaj.github.io/l7ot/), causing browsers to request non-existent assets fromhttps://bosaj.github.io/. -
The Fix: Implemented
assetHelper.tswithgetAssetUrl()and standardized relative path resolution (./images/...), ensuring assets resolve properly whether deployed at domain root (Netlify, Docker) or subpath (GitHub Pages).
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