# Je vais prendre en charge ton **premier projet** de programmation en **C++**, **Java** ou **Python** — installation, structure propre, **tests unitaires** et **README** complet

Tu veux réussir ton **premier projet** sans te perdre dans l’installation ni l’organisation du code ? **Je m’occupe de tout** : configuration de l’environnement (**C++/CMake**, **Java/Gradle ou Maven**, **Python/venv**), création d’une **arborescence professionnelle**, mise en place de **tests unitaires** (**assertions/GoogleTest**, **JUnit**, **pytest**) et rédaction d’un **README** détaillé (build, exécution, tests, prochaines étapes). Résultat : un **projet exécutable**, propre, documenté — prêt à apprendre, itérer et présenter.

> Tous les échanges se font sur **ComeUp Direct** pour un suivi clair et sécurisé.

---

## Résultat attendu (bénéfices & KPI)

* **Exécution garantie** : le projet **build** et **tourne** du premier coup (runner/script fourni).
* **Structure standard** : dossiers clairs, dépendances gérées, conventions lisibles.
* **Tests unitaires** : vérif de base pour évoluer sans casser.
* **README pédagogique** : commandes, explications, pistes d’évolution (algorithmie, structures de données).
* **Autonomie** : socle réutilisable pour tes futurs projets **C++**, **Java** ou **Python**.

---

## Périmètre de la **version de base** (Essentiel)

* **Type d’app** : **CLI** (ligne de commande), sans interface graphique.
* **Cas d’usage** : **1 seul** cas simple au choix : *Calculatrice CLI*, *Analyseur de texte*, *Gestion TODO fichier*, *Convertisseur d’unités*, *Mini-parser CSV* ou **autre projet simple**.
* **Complexité** : logique simple, **jusqu’à 3 fonctions ou 2 classes** principales, **sans algorithmes avancés**.
* **I/O** : entrées clavier ou **1 fichier** (≤ **2 Mo**), sortie console/CSV.
* **Dépendances** : standard du langage, **sans framework lourd**.
* **Tests** : **tests basiques** (chemin “ça marche/ça casse”) : assertions/GoogleTest (C++), **JUnit** (Java), **pytest** (Python).
* **Livrables** : structure standard + code du cas d’usage + **README** + **journal des changements**.
* **Retouche incluse** : **1** retouche **mineure** (texte, message d’erreur, nommage, petit ajustement **sans** changer la structure ni le cas d’usage).

> **Hors base** : GUI/desktop/mobile, **base de données** (SQLite/PostgreSQL…), **réseau/API**, multi-threading, cryptographie, scraping, IA/ML, architecture hexagonale, tests E2E, déploiement cloud. Possible via **options personnalisée**.

---

## Ce que je fais concrètement (selon le langage)

* **C++** : g++/clang + **CMake** (ou VS Code tasks), `src/`, `include/`, exécutable de démo, assertions/GoogleTest possibles.
* **Java** : **JDK** + **Gradle/Maven**, `src/main`, `src/test`, **JUnit**, tâche **run** prête.
* **Python** : **venv**, `requirements.txt`, `package/`, `tests/`, **pytest**, script `run.py`.

---

## Processus & délai

Étape Ce que je fais Sortie livrée
-------------------- --------------------------------------------------- ----------------------------------
1. Brief (15–20 min) Objectif, langage, OS/IDE, **choix du cas d’usage** Mini-plan + critères d’acceptation
2. Setup & structure Environnement + arborescence + dépendances Projet qui **build**
3. Implémentation Cas d’usage **défini** + tests basiques Exécution + **tests OK**
4. Documentation **README** complet + conseils d’évolution Archive ou dépôt **Git**
5. Retouche **1** retouche mineure (voir limites) Finition propre

**Délai de livraison** : **72 h**.

---

## Critères d’acceptation

* Le projet **compile/s’exécute** sur ton OS (Windows/macOS/Linux) avec les **commandes du README**.
* Les **tests basiques passent**.
* Le **cas d’usage validé** en brief est **fonctionnel** tel que décrit.
* La **structure** et le **README** respectent les bonnes pratiques annoncées.

---

## Packs & tarifs (clairs, comparatifs)

Pack Pour qui Contenu exact Délai Prix
------------------------ ---------------------- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ----- ------------
**Essentiel (Standard)** Démarrer sans douleur **Tout le périmètre de base** ci-dessus (CLI, 1 cas simple, ≤3 fonctions/2 classes, 1 fichier ≤2 Mo, dépendances standard, tests basiques, README, journal, **2 retouche mineure**) 72 h **58,86 $US HT**
**Starters (Apprenant)** Apprendre en confiance **Standard** **+** couche de **tests unitaires** étoffés (pytest/JUnit/assertions), **mini-refactor** (lisibilité) et **commentaires pédagogiques** dans le code 72 h **94,18 $US HT**
**Avancé (Boost)** Aller plus loin **Starters** **+ 1 module additionnel limité** (au choix ci-dessous) **+ session visio 30 min sur ComeUp Direct** (revue exécution/tests/roadmap) 72 h **153,03 $US HT**

### “Module additionnel limité” (Boost) — choisis **1** parmi :

* **Persistance légère** : lecture/écriture dans **1 fichier JSON ou CSV** (sans DB serveur).
* **Options CLI** : `--input`, `--limit`, `--sort` (≤ **5** options).

**Limites du module** : pas de réseau/API, pas de multithreading, pas de DB relationnelle, pas de GUI ; taille d’entrée cumulée ≤ **5 Mo** ; 2 modifications **sans** refonte de l’architecture.

---

## Options à la carte

* **Packaging exécutable/installer** (selon OS) — **+58,86 $US**
*Livrable* : binaire/installer **1 OS** ; *exclu* : signature code & stores.
* **Jeu de tests élargi** — **+47,09 $US**
*Livrable* : **+5 à +8** cas de tests ; *exclu* : tests E2E/UI.
* **Refactor & commentaires détaillés** — **+47,09 $US**
*Portée* : renommages, découpage léger ; *exclu* : changement de cas d’usage.
* **Session d’accompagnement 30 min sur Comeup Direct** (hors Boost) — **+35,32 $US**
*Portée* : prise en main, Q/R ; *exclu* : dev en direct.

> Tout besoin **hors limites** (API, GUI, DB, multi-thread, algos avancés…) fait l’objet d’une **offres personnalisée** avant travaux.

---

## Exemples de cas d’usage

* **Analyseur de texte** : compte mots/phrases, fréquences, export CSV.
* **Calculatrice CLI** : opérations + validation d’entrées.
* **Gestionnaire TODO** : CRUD fichier (texte/JSON) + tests.
* **Convertisseur d’unités** : config externe + tests de cohérence.
* **Mini-parser CSV** : lecture, filtrage, tri, résumé.

Chaque exemple illustre des **patterns réutilisables** pour l’algorithmie et les structures de données (tableaux, listes, maps, fichiers).

**NB :** Des services personnalisées sont disponibles à la demande pour mieux appréhender vos besoins.

---

## Ce que tu reçois

* **Projet exécutable** (build & run OK).
* **Arborescence pro** (C++ : `src/`, `include/` ; Java : `src/main`, `src/test` ; Python : `package/`, `tests/`).
* **Tests unitaires** (pytest/JUnit/assertions/GoogleTest).
* **README** : installation, build, exécution, tests, arborescence, pistes d’évolution.
* **Journal des changements** (ce qui a été configuré, pourquoi, comment rejouer).

---

## Politique de changements & retouches

* **Après brief validé** : toute **nouvelle fonctionnalité** ou **changement de cas d’usage** ⇒ **option personnalisée**.
* **Retouche incluse** (2x) = texte, message d’erreur, nommage, petit ajustement **sans** toucher à la structure ni au cas d’usage.
* **Hors-périmètre** : je t’alerte immédiatement et on choisit : **ajustement de délai en plein commande**, **option**, **remboursement partiel** si nécessaire.

---

## Éthique & conformité (important si tu es étudiant·e)

Je t’aide à **apprendre** et à mettre en place une **base pédagogique**. Je ne “rends pas un devoir à ta place”. On peut livrer un **squelette conforme** que tu compléteras : tu gardes la **main**, tu **progresses** et tu restes dans les règles.

---

## FAQ

* **Windows / macOS / Linux ?**
Oui. Je fournis les **commandes adaptées** (scripts, targets CMake, tâche Gradle/Maven) et je valide une **exécution OK**.

* **Quel IDE ?**
**VS Code** par défaut (fichiers de config inclus). **IntelliJ**, **CLion** ou **Visual Studio** possibles sur demande.

* **Le code m’appartient-il ?**
Oui. Tu obtiens la **propriété** de tout le code livré (hors dépendances open-source listées).

* **Et si ça ne compile pas chez moi ?**
Je t’accompagne jusqu’à un **run OK** dans ton environnement. En cas d’imprévu bloquant (ex. contrainte machine/OS), on ajuste proprement via ComeUp.

---

## Mots-clés (SEO interne ComeUp)

**C++**, **Java**, **Python**, **premier projet**, **débutant**, **setup**, **CMake**, **Gradle**, **Maven**, **venv**, **tests unitaires**, **JUnit**, **pytest**, **algorithmie**, **structures de données**, **VS Code**, **IntelliJ**, **CLion**, **Visual Studio**.

---

## Visuels conseillés

1. **Arborescence** du projet (capture IDE).
2. **Terminal** : build + tests qui passent.
3. **Exécution** du cas d’usage (CLI).
4. **Extrait README** (commandes, structure).

---

### “Garantie sans surprise”

> Si une contrainte imprévue apparaît (machine/OS, accès), je te préviens immédiatement et on choisit l’option la plus saine : **ajustement de délai**, **option** dédiée ou **remboursement partiel**. Priorité : livrer **propre** et te rendre **autonome**.

---

## Appel à l’action

**Dis-moi en une phrase ce que doit faire ton projet**, **choisis ton langage** (**C++ / Java / Python**) et ton **système** (Windows/macOS/Linux). Je t’envoie un **mini-plan** avec les **critères d’acceptation** et je lance : sous **72 h**, tu reçois un **projet exécutable, structuré, testé et documenté**, dans un périmètre **clair** et **respecté**.