Skip to content

Commit History and Changelog

Bosaj edited this page Oct 24, 2026 · 11 revisions

📜 Project Commit History & Release Notes

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.


🚀 Release Milestones

[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).
  • 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 in public/audio/fish/ar/, public/audio/fish/fr/, and public/audio/fish/en/.
    • Dynamic multilingual pronunciation audio matching active UI browsing language.
  • 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 localStorage persistence.
  • 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) and Recipe JSON-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.

[v1.9.0] — Mode Pêcheur en Mer, Full Offline PWA Caching & High-Seas Marine Navigator (2026-10-24)

  • Full Offline PWA Service Worker Caching ("Mode Pêcheur en Mer"):
    • Enhanced vite-plugin-pwa Workbox engine to precache 112 assets totaling 18.09 MB (maximumFileSizeToCacheInBytes: 15MB), including all 44 high-res Moroccan fish specimens in public/images/fish/, webfonts, and biological regulatory tables.
    • Guarantees 100% offline functionality when sailing offshore with zero cellular signal (0G / No 4G/5G).
  • 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.

[v1.8.0] — Interactive 3,500 km Moroccan Coastal GIS Map & Port Species Hotspots (2026-10-24)

  • 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.
  • Live Vercel Production Sync:

[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 with Amiri serif headings and Readex Pro / IBM Plex Sans Arabic body.
    • French (font-french): Haute couture French Riviera editorial styling with Playfair Display serif headings and Plus Jakarta Sans body.
    • English (font-english): Imperial Roman inscriptional capitals with Cinzel serif headings and Plus Jakarta Sans naval telemetry body.
    • Injected Google Fonts CDN fallback directly in index.html alongside @fontsource packages.
  • 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:

  • 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-sans with tight optical kerning (tracking-[-0.012em]).
    • Modern Arabic clean typography via @fontsource-variable/readex-pro alongside classical Amiri Naskh.
    • Automatic document.documentElement.lang and dir dynamic synchronization in App.tsx.
  • 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.

[v1.5.0] — Seasonal Catch Calendar, Coastal Radar & Audio Synthesizer (2026-10-24)

  • 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 in CREDITS.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.
  • 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 درهم/كلغ ▼).

[v1.3.0] — Moroccan Maritime Law, Spearfishing Compliance & Catch Size Engine (2026-10-18)

  • 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.

[v1.2.0] — Continuous Dual-Track Ticker, Scrollbar-Free Navigation & CI Hardening (2026-10-18)

  • Dual-Track Infinite Marquee Ticker:
    • Replaced the previous single-strip animation with twin identical tracks (Track A and Track B) side-by-side inside a dir="ltr" container.
    • Applied translate3d(0, 0, 0) to translate3d(-50%, 0, 0) with a 45s linear loop and will-change: transform.
    • As Track A moves left, Track B continuously 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.
  • 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.ts via vi.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).
  • BiDi / RTL Refinements:
    • Fixed Arabic right-to-left directional chevrons in FishModal.
    • Defaulted and auto-detected central inland users to Casablanca / Mohammedia port.

[v1.1.0] — Worldwide Free Marine APIs, GPS Geolocation & Oriental Dialects (2026-10-18)

  • 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, and SECURITY.md.

[v1.0.0] — The Definitive Moroccan Fish Encyclopedia (2026-10-18)

  • 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.

🗂️ Complete Git Commit Log

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

🔍 Historical Bug Fixes & Architectural Decisions

1. The Marquee Void (RTL Empty Space)

  • 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" and translate3d(-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.

2. CI Network Timeouts

  • The Problem: Tests in marineApis.test.ts originally 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.

3. BiDi Currency Directionality

  • The Problem: Arabic number rendering flipped expressions like 14 درهم/كلغ into درهم/كلغ 14 or 14 kg/DH because of mixed LTR numbers inside RTL strings.
  • The Fix: Created <PriceBadge /> with isolated <bdi> and explicit RTL flow to guarantee correct cultural typography.

4. CodeQL Incomplete Multi-Character Sanitization (CWE-116)

  • The Problem: CodeQL security scanning flagged scripts/download-images.mjs with rule js/incomplete-multi-character-sanitization due 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.

5. Subpath Asset Resolution on GitHub Pages

  • 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 from https://bosaj.github.io/.
  • The Fix: Implemented assetHelper.ts with getAssetUrl() and standardized relative path resolution (./images/...), ensuring assets resolve properly whether deployed at domain root (Netlify, Docker) or subpath (GitHub Pages).

Clone this wiki locally