Développeur Backend API - Banque - Freelance

Contexte

Le projet est né d'un besoin de gouvernance et d'audit réglementaire sur les APIs et les serveurs MCP, afin de maîtriser leur référencement, les responsabilités, le cycle de vie et l’utilisation.
L'objectif est de construire un registre d’actifs numériques servant de source de référence à but de découvrabilité, de compréhension des rôles, d’identification des acteurs, des usages et des interconnexions.
Un portail développeur viendra en complément du registre, afin de permettre son administration et son utilisation au quotidien : recherche et découverte d'actifs, consultation des informations et des relations. Accès aux contacts ainsi qu'à différents outils et ressources destinés aux développeurs.
Le projet est pensé dès sa conception comme un produit open source, générique et extensible, sans dépendance à un environnement d'entreprise particulier, afin de pouvoir être adopté, adapté et enrichi dans d'autres contextes.
La mission s'inscrit dans un contexte bancaire et sécurisé : les choix techniques doivent intégrer naturellement les exigences de sécurité, notamment sur l'usage des images et dépendances, la gestion des secrets, la journalisation et l'exposition des informations sensibles.

Objectifs de la prestation

La prestation vise à concevoir et développer le socle backend du registre : modèle de domaine, APIs d'administration et de consultation, mécanismes d'authentification et d'autorisation, gestion du cycle de vie des ressources, exposition OpenAPI et fondations techniques permettant une adoption open source.
La prestation s'inscrit dans une démarche API First : les contrats d'API, leurs usages et leur documentation sont pensés comme des éléments structurants du produit, avant et pendant l'implémentation.

Missions

• Participer à la clarification du besoin fonctionnel et métier autour du référencement, des responsabilités, du cycle de vie et des relations entre actifs numériques.
• Concevoir les fonctionnalités dans une démarche API First, en travaillant les contrats, les usages, les erreurs, la documentation et la stabilité des interfaces dès les phases de conception.
• Concevoir le modèle de domaine et le modèle de données du registre en tenant compte des APIs, serveurs MCP, responsable, contacts, tags, statuts, usages et relations.
• Contribuer aux échanges de conception avec le profil frontend afin de garantir une bonne expérience développeur et une cohérence produit.
• Structurer l'architecture backend selon des principes de clean architecture ou d'architecture hexagonale.
• Mettre en place les mécanismes d'authentification, d'autorisation et de contrôle d'accès adaptés au produit.
• Documenter les choix structurants, les conventions de contribution et les modalités d'exploitation du backend.
• Développer les APIs backend avec NestJS et TypeScript, en appliquant des pratiques de conception d'API robustes, documentées et évolutives.
• Produire et maintenir les contrats OpenAPI associés aux endpoints exposés.
• Mettre en place les tests unitaires, tests d'intégration et pratiques de qualité nécessaires à un projet open source maintenable.

Expertises spécifiques attendues

• NestJS et TypeScript.
• Démarche API First : design de contrats, documentation, cohérence des ressources, versioning et expérience consommateur d'API.
• API Design et conception d'APIs REST documentées et maintenables.
• OpenAPI : conception, génération, validation ou publication de contrats.
• Data Modeling et Domain Modeling.
• Authentication / Authorization, idéalement dans des contextes OIDC / OAuth2 ou équivalents.
• Tests backend : unitaires, intégration, éventuellement contract testing.
• Architecture backend : clean architecture, architecture hexagonale, séparation domaine / application / infrastructure.
• Culture open source : packaging, documentation, qualité de contribution, généricité et extensibilité.

Compétences transverses attendues

• Être capable de challenger une décision, une idée ou une approche technique de manière constructive.
• Être à l'aise avec la philosophie open source : lisibilité, documentation, généricité, extensibilité et contribution communautaire.
• Utiliser l'IA comme outil de travail tout en restant capable d'expliquer, contrôler et assumer ce qui est produit.
• Faire preuve de curiosité, apprendre vite et raisonner à partir du besoin pour construire une solution pertinente.
• Avoir envie de construire un produit depuis zéro, avec une attention particulière à la maintenabilité et à la réutilisabilité hors contexte d'entreprise spécifique.
• Penser la solution comme un produit open source générique et réutilisable, tout en vérifiant sa compatibilité avec les contraintes d'industrialisation de l'environnement bancaire afin d'éviter des blocages tardifs.
• Anglais professionnel fortement recommandé, notamment pour échanger avec les équipes de production au Portugal lorsque cela est nécessaire.

Livrables attendus

• Code source backend maintenable, testé et documenté.
• Contrats OpenAPI et documentation d'utilisation des APIs.
• Modèle de domaine et modèle de données documentés.
• Tests automatisés et éléments d'intégration continue associés.
• Documentation technique, guide de contribution et éléments facilitant l'installation locale.
• Recommandations d'architecture et justification des principaux choix techniques.