Créer un projet de portfolio avec Bun au Maroc : idées et étapes concrètes

Choisir un projet adapté à son niveau

Pour choisir un projet concret Bun, commencez par les compétences que vous souhaitez montrer, et non par la liste des fonctionnalités possibles. Un recruteur peut vouloir voir que vous savez structurer un petit programme, traiter des entrées, gérer les erreurs et vérifier le résultat. Un client, lui, cherchera surtout à comprendre le problème traité, ce que l’outil lui permet de faire et ce qui reste à prévoir.

Un projet de niveau débutant peut être une application en ligne de commande qui lit un fichier JSON, ajoute une tâche et affiche les tâches en attente. À un niveau intermédiaire, vous pouvez en faire une petite API avec des routes pour créer, consulter et modifier des demandes. Un projet plus avancé peut ajouter une interface web, une base de données, une authentification de démonstration ou un processus de compilation. N’ajoutez ces éléments que si vous pouvez les expliquer et les tester.

Gardez un périmètre réduit : une fonction principale, quelques cas d’usage bien définis et une démonstration reproductible. Il vaut mieux présenter un outil simple et achevé qu’une grande application dont des parties essentielles ne fonctionnent pas. Définissez dès le départ ce qui ne sera pas traité, par exemple les notifications réelles, les paiements ou la gestion d’utilisateurs à grande échelle.

• Choisissez une tâche représentative d’un métier ou d’un besoin d’organisation.
• Fixez un résultat observable : une demande créée, une liste filtrée ou un rapport généré.
• Prévoyez un périmètre que vous pouvez terminer et documenter.
• Indiquez clairement si le projet est un prototype, une démonstration ou un outil prêt à être déployé.

Partir d’un besoin concret

Un exercice pratique Bun peut s’inspirer d’une situation quotidienne : suivre des demandes de maintenance, organiser les tâches d’une petite équipe, inventorier du matériel ou enregistrer des réservations de salle. Choisissez un contexte que vous comprenez, puis décrivez le problème sans supposer que la personne qui lit votre portfolio connaît votre métier.

Par exemple, une petite équipe reçoit des demandes internes par différents canaux et perd de vue leur statut. Votre application de démonstration permettra d’ajouter une demande, de préciser sa catégorie et sa priorité, puis de consulter son état. Le projet montre une logique de traitement utile sans prétendre remplacer un système de production.

Avant de coder, écrivez les besoins en langage simple. Exemple : « Une personne peut enregistrer une demande avec un titre et une catégorie. L’équipe peut afficher toutes les demandes et les filtrer par statut. Une demande sans titre est refusée avec un message compréhensible. » Ces phrases deviendront vos critères de test.

• Qui rencontre le problème ?
• Quelle action l’application doit-elle rendre plus simple ?
• Quelles informations sont indispensables, et lesquelles sont facultatives ?
• Comment reconnaître que le projet fonctionne ?
• Quelles fonctions sont explicitement hors périmètre ?

Brief de projet : suivi de demandes internes

Objectif : créer une petite application de démonstration qui permet d’enregistrer et de consulter des demandes internes. Le projet doit montrer la prise en main de Bun, l’organisation du code, la validation des données et les tests. La première version peut fonctionner en ligne de commande ou exposer une API locale ; choisissez une seule interface pour éviter d’élargir inutilement le travail.

Livrables : le code source, un fichier de données d’exemple entièrement fictives, des tests automatisés, un guide de démarrage, une courte description des choix techniques et des captures d’écran ou une démonstration enregistrée. Si vous ajoutez une API, fournissez aussi quelques exemples de requêtes et de réponses. Si vous réalisez une interface, montrez au moins l’état vide, une demande enregistrée et un cas d’erreur.

• Fonctions minimales : ajouter une demande, lister les demandes et filtrer par statut.
• Champs possibles : identifiant généré, titre, catégorie, statut et date fictive.
• Règles : refuser un titre vide, accepter uniquement les statuts prévus et afficher un message en cas de saisie invalide.
• Hors périmètre conseillé : connexion à une messagerie, notifications réelles, données personnelles et déploiement sur un système d’entreprise.

Préparer les données, fichiers et ressources

Avant de créer le projet, choisissez comment stocker les données. Pour une première version, un tableau en mémoire ou un fichier JSON local peut suffire. Cette option rend la démonstration facile à lancer, mais ne constitue pas nécessairement une solution adaptée à un service réel utilisé par plusieurs personnes. Expliquez cette limite dans votre documentation.

Avec Bun, vous pouvez initialiser un projet JavaScript ou TypeScript, installer les dépendances nécessaires et utiliser les outils intégrés de l’environnement. Consultez la documentation officielle pour vérifier la syntaxe et les commandes correspondant à la version que vous installez. Évitez de multiplier les bibliothèques : chaque dépendance doit répondre à un besoin identifié.

Préparez un jeu de données inventé : « Demande de test — salle A », « Vérification du matériel de démonstration ». Ne copiez pas de noms, de numéros de téléphone, d’adresses électroniques, d’identifiants internes, de captures d’écran issues d’un outil professionnel ou de documents appartenant à un client. Vérifiez également les droits d’utilisation des images, polices, jeux de données et extraits de code.

• Créez un dépôt propre et un fichier de dépendances cohérent.
• Ajoutez un fichier d’exemple sans données personnelles ni secrets.
• Ne placez pas de mots de passe, clés d’API ou fichiers de configuration sensibles dans le dépôt.
• Si une configuration locale est nécessaire, fournissez un exemple sans valeur secrète et expliquez comment créer le fichier réel.
• Notez la version de Bun utilisée pour rendre l’installation plus reproductible.

Réaliser le projet par étapes

Travaillez par petites étapes terminées. Après chacune, relancez l’application et les tests. Cette approche aide à repérer rapidement une erreur et rend votre progression plus facile à raconter en entretien. Elle montre aussi que vous savez réduire un problème en tâches vérifiables.

• 1. Initialiser le projet : créez le dépôt, choisissez JavaScript ou TypeScript et vérifiez que Bun lance un fichier minimal.
• 2. Définir les données : décrivez les champs d’une demande et les statuts permis. Choisissez comment générer un identifiant et où stocker les exemples.
• 3. Construire la fonction principale : ajoutez d’abord une demande et affichez-la. Testez ce parcours avant d’ajouter les filtres.
• 4. Valider les entrées : refusez les champs obligatoires manquants et les valeurs inconnues ; rendez les messages d’erreur utiles.
• 5. Ajouter les fonctions restantes : liste, filtre ou mise à jour du statut, selon le périmètre retenu.
• 6. Écrire les tests : utilisez l’outil de test disponible dans Bun pour vérifier les résultats attendus et les cas invalides.
• 7. Préparer l’exécution : fournissez des scripts simples pour lancer les tests et l’application, puis vérifiez qu’un nouvel utilisateur peut suivre vos instructions.
• 8. Finaliser la présentation : rédigez le guide de démarrage, prenez des captures sans données confidentielles et notez les limites connues.

Tester, corriger et documenter

Les tests doivent vérifier les comportements importants, pas seulement confirmer que le programme démarre. Pour chaque fonction, prévoyez au moins un cas normal et un cas où l’entrée est incorrecte. Si les données sont enregistrées dans un fichier, vérifiez également ce qui se passe quand le fichier manque, est vide ou contient un format invalide.

Documentez le projet pour une personne qui le découvre sans votre aide. Présentez le besoin, les fonctionnalités, la manière de lancer l’application et les commandes de test. Expliquez en quelques lignes pourquoi vous avez choisi un stockage local ou une API, et quelles améliorations seraient nécessaires avant une utilisation réelle. Une documentation honnête est plus utile qu’une promesse de fonctionnalités qui n’existent pas.

• L’application démarre en suivant les instructions du dépôt.
• Une demande valide peut être créée et retrouvée.
• Les filtres affichent les bons résultats, y compris quand aucune demande ne correspond.
• Les champs manquants ou invalides produisent un retour compréhensible.
• Les tests couvrent les parcours principaux et plusieurs erreurs prévisibles.
• Les dépendances et scripts sont identifiés ; aucun secret n’est commité.
• Le dépôt ne contient pas de données réelles ni de fichiers protégés.
• Les limites, choix techniques et éventuels problèmes non résolus sont mentionnés.

Présenter son travail dans un portfolio

Présentez d’abord le problème et le résultat, puis les détails techniques. Une page de projet efficace peut tenir en quelques parties : contexte, objectif, fonctions réalisées, outils employés, démarche de test, captures ou démonstration, puis limites et pistes d’amélioration. Donnez accès au code si vous êtes autorisé à le partager et si le dépôt ne contient ni secrets ni contenus protégés.

Les captures doivent montrer des écrans représentatifs et utiliser uniquement les données inventées du projet. Une courte démonstration peut présenter le lancement, la création d’une demande, un filtre et une erreur de saisie. Ajoutez des sous-titres ou une description textuelle pour que les étapes restent compréhensibles sans le son.

Indiquez précisément votre contribution si le travail a été réalisé en groupe. Ne présentez pas un prototype comme un service en production, ni une fonctionnalité envisagée comme une fonctionnalité déjà disponible. Si le code vient d’un exercice guidé, précisez ce que vous avez adapté ou ajouté. Cette transparence aide le lecteur à évaluer vos compétences réelles.

• Une capture de l’écran principal avec des données fictives.
• Une démonstration courte du parcours central et d’un cas d’erreur.
• Un lien vers le dépôt, si sa publication est autorisée et sûre.
• Un résumé des choix techniques et de ce que vous avez appris.
• Une liste claire des limites actuelles et des prochaines étapes.

Formations et programmes au Maroc

Compétences clés

Questions fréquentes

Sources

1. FormaGroup — Technologie Bun formagroup.ma
2. Documentation officielle Bun bun.sh
3. JobInTech jobintech.academy
4. Formation intra-entreprise — OFPPT ofppt.ma