À propos - Calendar API

« À chaque nouveau projet impliquant des données financières ou opérationnelles marocaines, on recodait la même chose : un tableau de dates fériées hardcodé, une logique fragile pour savoir si demain est ouvrable, et une maintenance silencieuse chaque année. »Think Green!

⚡

Le problème récurrent

Pipelines ETL qui tournent les jours fériés. Orchestrateurs qui ignorent l'Aid. Séries chronologiques avec des trous inexpliqués. Calculs de next business day réimplémentés à chaque projet, avec des sources de données différentes selon les équipes.

🧩

L'idée fondatrice

Centraliser une bonne fois pour toutes le calendrier économique marocain — fêtes nationales, religieuses et exceptionnelles — dans un service unique, fiable, versionné, et consommable par n'importe quel stack technique via une API REST standard ou un SDK Python minimaliste.

Ce qui rend le problème plus difficile qu'il n'y paraît

Le Maroc dispose d'un calendrier hybride : des jours fériés nationaux à dates fixes, des jours fériés religieux dont la date dépend de l'observation astronomique de la lune, et des jours exceptionnels annoncés à court terme. Cette nature dynamique rend toute liste statique fondamentalement obsolète.

Calendar API expose un statut explicite — Estimated avant la confirmation lunaire, Official ensuite — et documente un pattern de polling pour que vos pipelines soient aussi réactifs que le journal officiel.

Les partis pris techniques

Le SDK pycalendar-api est construit sur des dataclasses standard — pas de Pydantic, pas de dépendances lourdes. Le client HTTP repose sur httpxyz, configurable via .toml pour les environnements proxy d'entreprise. Les modèles de réponse sont entièrement typés et convertis automatiquement depuis le JSON.

Le concept de CalSpan — bornes ouvrables enchaînables par mois, trimestre, semestre ou année — est né d'un besoin très concret en reporting OPCVM : générer des intervalles [start, end] qui s'enchaînent sans trou ni chevauchement, utilisables directement dans une clause SQL BETWEEN.

Le concepteur

Marouane FAKIR.

Fondateur · Unravel Designs · Casablanca

Ingénieur de formation (EMI — École Mohammadia d'Ingénieurs), spécialisé en Modélisation et Informatique Scientifique. Neuf ans passés dans la gestion des OPCVM — Middle Office, Risk Manager, Responsable BI — à la croisée de la finance quantitative, de la donnée et du logiciel. Cette expérience a forgé une profonde compréhension alliant à la fois le besoin métier réglementé et les contraintes d'ingénierie qui permettent d'y répondre de façon durable.

Fin 2023, il fonde Unravel Designs avec une conviction : concevoir des logiciels qui durent, qui s'adaptent aux contraintes de marchés réglementés, et qui ne sacrifient pas la rigueur technique à la vitesse de livraison. Calendar API est le premier produit public issu de cette aventure.

Stack & compétences

Python 15+ ansData EngineeringModélisation financièrePolarsSQLAlchemyLitestarPostgreSQLDuckDBAirflowDagsterPGQueuerMinIO / RustFSHTMXmsgspecasyncioNumpy / Scipy

Parcours

Diplôme · EMI

Ingénieur en Modélisation et Informatique Scientifique — École Mohammadia d'Ingénieurs, Rabat.

9 ans · Gestion OPCVM

Middle Office → Risk Manager → Responsable BI dans plusieurs sociétés de gestion. Expertise en marchés des capitaux, reporting OPCVM et réglementaire et data quality sur séries chronologiques financières.

2023 · Unravel Designs

Création d'Unravel Designs (RC : 605945) — cabinet spécialisé en modélisation et conception de logiciels modernes pour marchés réglementés.

2026 · Calendar API

Lancement de Calendar API — premier service public d'Unravel Designs. SDK Python open-source, documentation interactive, infrastructure redondante.

Vous avez un projet data ?

Modélisation, data platform, ETL, migration vers un stack moderne — Marouane est disponible en freelance pour des missions exigeantes.

Discutons →

Pourquoi CalendarAPI. existe