Quel projet Deno réaliser pour présenter son portfolio au Maroc ?

Choisir un projet adapté à son niveau

Le meilleur projet portfolio Deno n’est pas nécessairement le plus vaste. Il doit vous permettre de terminer une première version, de l’expliquer et d’en montrer le fonctionnement. Si vous débutez, privilégiez une seule fonction métier, quelques types de données et un nombre limité de routes. Vous pourrez ensuite ajouter des améliorations clairement séparées.

Un exemple adapté à un projet Deno débutant est un service de suivi de demandes internes : une personne crée une demande, consulte son état et peut le modifier. Les données peuvent représenter des demandes fictives de matériel, de réservation ou de maintenance. Ce cas permet d’exercer les bases de TypeScript ou JavaScript, la réception de requêtes HTTP, la validation et les réponses d’une API.

Avant de choisir, vérifiez quatre critères : le problème se formule en une phrase ; les données nécessaires sont disponibles sans autorisation particulière ; la première version peut rester petite ; et le résultat peut être démontré sans exposer d’informations privées. Un exercice pratique Deno n’a pas besoin d’un grand nombre d’écrans ou d’une intégration à des services payants pour être convaincant.

Ajustez l’ambition au niveau visé. Pour une première réalisation, une API en mémoire peut suffire, à condition d’indiquer que les données sont perdues au redémarrage. Pour un projet plus avancé, vous pouvez ajouter une persistance, une interface minimale ou une authentification simulée. N’ajoutez pas ces éléments simplement pour allonger la liste de technologies : choisissez-les parce qu’ils servent le besoin.

• Débutant : créer, consulter et modifier des demandes avec des données fictives.
• Niveau intermédiaire : ajouter une persistance, des filtres ou une pagination, puis tester les erreurs.
• Projet plus avancé : définir des rôles, renforcer la validation et décrire les décisions de sécurité.

Partir d’un besoin concret

Un projet concret Deno gagne en clarté lorsqu’il part d’une situation que le lecteur reconnaît. Imaginez une petite équipe qui reçoit des demandes par messages et perd le fil des réponses. Votre service transforme ce flux en fiches consultables avec un titre, une catégorie, une priorité et un état. Le portfolio doit montrer le problème et la réponse proposée, pas prétendre que l’outil est déjà déployé dans une entreprise.

Rédigez le brief avant de coder. Il aide à garder le périmètre réaliste et sert ensuite de fil conducteur à la documentation.

• Objectif : créer une petite API permettant d’enregistrer des demandes fictives et d’en suivre l’état.
• Utilisateurs visés : une équipe qui veut consulter et mettre à jour une liste de demandes.
• Fonctions de la première version : créer une demande, afficher les demandes, consulter une demande par identifiant et changer son état.
• Données : identifiant, titre, catégorie, date de création et état. N’ajoutez pas de noms ou de coordonnées réels.
• Livrables : code source, instructions de lancement, tests automatisés, exemples de requêtes et réponses, description des choix et limites, et courte démonstration.
• Hors périmètre initial : connexion à un outil professionnel, données d’un employeur, paiement, comptes réels et promesse de disponibilité en production.

Préparer les données, fichiers ou ressources

Avant de démarrer, préparez un dépôt de code, la version de Deno utilisée pour le projet, une liste de routes attendues et quelques exemples fictifs. Précisez dans le fichier de présentation comment installer ou lancer l’application et comment exécuter les tests. Un lecteur doit pouvoir comprendre les prérequis sans vous contacter.

Évitez de copier des fichiers, des bases de données, des captures d’écran ou des extraits de code provenant d’un employeur ou d’un client, sauf autorisation explicite. Les informations personnelles, les clés d’accès, les mots de passe, les adresses internes et les noms de clients ne doivent pas apparaître dans le dépôt, les journaux, les captures ni les exemples. Pour illustrer le projet, fabriquez des données synthétiques. Si vous partez de données réellement publiques, contrôlez leurs conditions de réutilisation et indiquez leur origine.

Faites également attention aux secrets de configuration : ne les écrivez pas directement dans le code et ne les versez pas dans l’historique du dépôt. Pour une démonstration locale qui n’utilise aucun service externe, dites-le clairement. Cela évite de laisser croire qu’une connexion ou une protection existe alors qu’elle n’a pas été réalisée.

Un ensemble de préparation simple peut comprendre un fichier de description du projet, le code de l’API, des tests, des exemples de requêtes et un fichier listant les variables de configuration attendues sans y mettre de valeurs secrètes.

• Créer trois à cinq demandes fictives pour illustrer plusieurs états.
• Noter les routes et les réponses attendues avant l’implémentation.
• Choisir un nom de projet et vérifier que les captures ne contiennent aucune information personnelle.
• Indiquer les versions et commandes utiles dans la documentation, puis les essayer sur un environnement propre.

Réaliser le projet par étapes

Procédez par petites étapes terminées et vérifiables. Deno fournit un environnement d’exécution pour JavaScript et TypeScript avec des outils intégrés ; pour ce projet, concentrez-vous d’abord sur le comportement du service plutôt que sur l’ajout de dépendances. Gardez le code lisible et séparez, si cela simplifie la compréhension, la validation des données, la logique métier et les réponses HTTP.

• 1. Définir le périmètre : rédiger les fonctions incluses, celles qui ne le sont pas et le format minimal d’une demande.
• 2. Créer le squelette : préparer les fichiers, choisir le langage du projet et écrire les instructions de démarrage.
• 3. Démarrer le serveur : mettre en place un point d’entrée HTTP avec Deno et vérifier qu’une requête simple reçoit une réponse.
• 4. Ajouter les routes une par une : commencer par la consultation de la liste, puis la création, la consultation par identifiant et la mise à jour d’état.
• 5. Valider les entrées : refuser les champs manquants ou les valeurs d’état inconnues et renvoyer une erreur compréhensible.
• 6. Ajouter les tests : couvrir un parcours normal, une demande inexistante et des entrées incorrectes.
• 7. Préparer la démonstration : fournir quelques données fictives, une suite de requêtes reproductibles et un exemple du résultat attendu.
• 8. Relire et documenter : retirer les traces de débogage inutiles, expliquer les décisions et noter ce qui reste à faire.

Tester, corriger et documenter

Les tests montrent que le projet ne se limite pas à une capture d’écran. Commencez par contrôler les fonctions attendues, puis essayez les cas d’erreur. Même dans une application volontairement petite, la cohérence des réponses et la clarté des messages comptent : un recruteur ou un client doit comprendre ce qui se passe lorsque la requête n’est pas valide.

Documentez les choix au moment où vous les faites. Expliquez pourquoi la première version garde les données en mémoire, pourquoi telle validation est nécessaire et ce que vous changeriez pour un usage réel. Distinguez les fonctions effectivement réalisées des pistes d’évolution. Ne présentez pas un contrôle simulé comme une authentification réelle, ni une démonstration locale comme un service déployé.

• Checklist de tests et de contrôle qualité :
• Le serveur démarre en suivant les instructions du dépôt.
• Chaque route annoncée répond selon le comportement décrit.
• La création refuse les champs obligatoires manquants et les formats invalides.
• La consultation d’un identifiant inconnu renvoie une réponse d’erreur compréhensible.
• Une mise à jour accepte les états autorisés et refuse les autres.
• Les tests passent après une nouvelle exécution, sans dépendre d’un état laissé par un essai précédent.
• Les exemples de requêtes et de réponses correspondent au comportement actuel du code.
• Le dépôt, les journaux et les captures ne contiennent ni secret ni donnée personnelle.
• Les limites de la solution sont visibles : persistance, sécurité, capacité et déploiement ne sont pas revendiqués s’ils n’ont pas été traités.

Présenter son travail dans un portfolio

Une présentation efficace permet de comprendre rapidement le besoin, d’essayer le projet et d’évaluer votre contribution. Commencez par une courte description : le problème choisi, les utilisateurs visés, les fonctions réalisées et les technologies utilisées. Ajoutez une capture de la démonstration ou un schéma simple des échanges entre client et API. Vérifiez que les images ne révèlent aucun nom, courriel, identifiant ou contenu confidentiel.

Donnez ensuite les instructions pour lancer le projet et effectuer les tests. Une démonstration courte peut suivre un scénario unique : créer une demande fictive, afficher la liste, changer son état puis montrer la réponse à une entrée invalide. Si le projet n’est pas hébergé, dites-le sans détour et expliquez comment le lancer localement.

Pour le portfolio Deno, la qualité de l’explication est aussi importante que le nombre de fonctions. Indiquez ce que vous avez personnellement conçu, les difficultés rencontrées, les décisions prises et les prochaines améliorations possibles. Un projet modeste, terminé et compréhensible donne davantage de matière à discuter qu’une longue liste de fonctions inachevées.

• À montrer : le brief, un schéma ou une capture, les routes principales, les tests et les instructions de lancement.
• À expliquer : votre rôle, les choix de conception, les erreurs que vous avez corrigées et les limites actuelles.
• À ne pas publier : secrets, données d’entreprise, contenus protégés ou captures prises dans un environnement professionnel sans autorisation.

Le parcours, étape par étape

1. 1Choisir un cas d’usage délimité — Formulez le problème en une phrase et sélectionnez une seule fonction principale, comme le suivi de demandes fictives.
2. 2Écrire le brief et réunir des ressources sûres — Définissez utilisateurs, données, livrables et limites. Préparez des exemples synthétiques et écartez les fichiers confidentiels.
3. 3Construire une première API fonctionnelle — Démarrez un serveur Deno, puis ajoutez les routes nécessaires une par une et validez les données reçues.
4. 4Tester le parcours et les erreurs — Vérifiez le lancement, les réponses normales, les identifiants inconnus, les champs invalides et la reproductibilité des tests.
5. 5Rendre le projet compréhensible — Documentez les commandes, les choix techniques, les limites et les étapes d’une démonstration reproductible.
6. 6Présenter le travail honnêtement — Montrez votre contribution et les livrables disponibles. Distinguez les fonctions réalisées des améliorations envisagées.

Formations et programmes au Maroc

Compétences clés

Questions fréquentes

Sources

1. Formation Deno — FormaGroup formagroup.ma
2. JobInTech jobintech.academy
3. Formation intra-entreprise — OFPPT ofppt.ma