Guide d'Onboarding

Ce guide aide un nouveau développeur à devenir opérationnel sur le projet StageConnect.

Avant de Commencer

Lectures Obligatoires

Lire dans l'ordre avant de commencer à coder :

1. intro.md — Vue d'ensemble du projet
2. architecture/overview.md — Schéma global
3. architecture/decisions.md — Pourquoi ces choix techniques
4. security/auth-flow.md — Comprendre l'authentification

Accès à Demander

Contacter le lead technique pour obtenir :

Accès	Utilisation
GitHub	Accès aux repositories
Vercel	Dashboard des frontends
Dokploy	Dashboard du backend
Supabase	Base de données, authentification
Passbolt	Gestion des secrets (en cours de migration)

Jour 1 — Comprendre (Matin)

Matin : Architecture

• Lire intro.md
• Lire architecture/overview.md
• Lire architecture/decisions.md
• Comprendre la séparation : 3 frontends → backend → DB/cache

Après-midi : Environnement

• Demander les accès nécessaires
• Cloner les 4 repositories :
  • backend
  • career-stageconnect (Career)
  • discover-stageconnect (Discover)
  • admin-stageconnect (Admin)
• Suivre backend/setup.md jusqu'au bout
• Lancer au moins un frontend en local

Lancer le Projet en Local

Backend

# 1. Cloner et installer
git clone https://github.com/stageconnect/backend.git
cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 2. Variables d'environnement
cp .env.example .env
# Éditer .env avec les valeurs fournies

# 3. Lancer
uvicorn app.main:app --reload --port 8000

Frontends

# Career
cd career-stageconnect
npm install
npm run dev

# Discover
cd discover-stageconnect
npm install
npm run dev

# Admin
cd admin-stageconnect
npm install
npm run dev

Vérifier que tout fonctionne

• Backend : http://localhost:8000/docs
• Career (career-stageconnect) : http://localhost:3000
• Admin (admin-stageconnect) : http://localhost:3001
• Discover (discover-stageconnect) : http://localhost:3002

Première Semaine

Lectures Complémentaires

• guides/contributing.md — Comment contribuer
• guides/git-workflow.md — Conventions Git
• security/auth-flow.md — Authentification (important)
• devops/ci-cd.md — Déploiement et CI/CD

Premières Tâches

1. Faire une première PR simple

   • Corriger une typo dans la doc
   • Améliorer un commentaire
   • Objectif : comprendre le workflow de contribution

2. Observer une PR en review

   • Regarder comment les autres font des PRs
   • Comprendre les standards de code

3. Lancer tous les services en local

   • Backend + les 3 frontends
   • Tester le flow login

Ressources

Documentation

Fichier	Description
intro.md	Vue d'ensemble
backend/setup.md	Lancer le backend
devops/deploy.md	Déploiement
devops/monitoring.md	Monitoring

Commandes Utiles

# Backend
cd backend
uvicorn app.main:app --reload --port 8000

# Tests backend
pytest -v

# Frontend
npm run dev    # Mode développement
npm run build  # Build production
npm run lint   # Linting

Questions Fréquentes

Je suis bloqué, qui demander ?

• Questions techniques : voir l'équipe
• Problème d'accès : demander au lead technique

Où trouver les endpoints API ?

• Swagger : http://localhost:8000/docs (backend local)
• ou production : https://api.stageconnect.app/docs

Comment tester l'auth ?

Voir security/auth-flow.md

Checklist de Fin de Première Semaine

• J'ai lu les docs obligatoires
• Le backend fonctionne en local
• Au moins un frontend fonctionne en local
• J'ai fait ma première PR
• Je comprends le workflow Git (branche → PR → merge)