Bienvenue chez USTS

Surfez la meilleure vague du developpement

Ce guide te permettra de demarrer rapidement et efficacement. Tu y trouveras tous les outils, conventions et bonnes pratiques utilises chez USTS.

Objectif : Etre operationnel et autonome le plus vite possible.

01 Outils & Acces

Les outils essentiels pour travailler au quotidien. Demande tes acces des le premier jour.

GitLab

Gestion du code source, CI/CD, merge requests

gitlab.usts.ai

Coolify

Deploiement et hebergement des applications

coolify.michelle.usts.ai

Vaultwarden

Gestionnaire de mots de passe securise

vaultwarden.bonny.usts.fr

n8n

Automatisations et workflows

n8n.usts.ai

Monday

Planning, taches et suivi de projet

usts.monday.com

Tuto Deploiement

Guide complet GitLab vers Coolify

docs.google.com

02 IDE & MCP Context7

Utilise un IDE avec support MCP pour booster ta productivite avec l'IA.

Windsurf

IDE IA-first base sur VS Code

windsurf.com

Cursor

IDE IA avec support Claude integre

cursor.com

Claude Code

Agent CLI pour le terminal

docs.anthropic.com

MCP Context7 - Obligatoire

Context7 permet d'avoir une documentation a jour directement dans ton IDE. Configure-le des le premier jour.

Voir sur GitHub
Configuration MCP - mcp.json 
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}
Astuce : Utilise Context7 pour obtenir la documentation a jour de n'importe quelle librairie directement dans ton IDE. Plus besoin de chercher sur Google !

03 Stack Technique

Notre stack principale pour tous les projets.

Frontend

Angular + TypeScript

  • Framework structure et robuste
  • TypeScript obligatoire pour le typage
  • Standalone components privilegies
  • RxJS pour la reactivite
Backend

Symfony + API Platform

  • API REST/GraphQL automatique
  • Documentation OpenAPI generee
  • Securite integree (JWT, OAuth)
  • A utiliser le plus souvent possible
Regle : Symfony API Platform est le choix par defaut pour toute nouvelle API. Justifie tout autre choix technique.

04 Methodologie

Approche de developpement par feature pour un code organise et maintenable.

Feature-Based Development

Chaque fonctionnalite est developpee de maniere isolee avec tout ce dont elle a besoin.

Structure type d'une feature 
src/
  features/
    user-management/
      components/
      services/
      models/
      user-management.module.ts
    billing/
      components/
      services/
      models/
      billing.module.ts

Avantages

  • + Code isole et testable
  • + Facilite le travail en equipe
  • + Refactoring simplifie
  • + Lazy loading naturel

05 Docker

Docker est obligatoire pour tous les projets. Pas d'exception.

Pourquoi Docker ?

  • Environnement identique pour tous
  • Deploiement simplifie sur Coolify
  • Pas de "ca marche sur ma machine"
  • Isolation des dependances
docker-compose.yml - Exemple 
version: '3.8'

services:
  frontend:
    build: ./frontend
    ports:
      - "4200:4200"
    volumes:
      - ./frontend:/app
      - /app/node_modules

  api:
    build: ./api
    ports:
      - "8000:8000"
    volumes:
      - ./api:/var/www/html
    depends_on:
      - database

  database:
    image: postgres:15
    environment:
      POSTGRES_DB: app
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:
Commandes essentielles : docker compose up -d pour demarrer, docker compose logs -f pour les logs, docker compose down pour arreter.

06 Architecture & README

Un projet bien structure avec une documentation claire.

Structure projet type

Arborescence recommandee 
project-name/
  README.md              # Documentation principale
  docker-compose.yml     # Configuration Docker
  .env.example           # Variables d'environnement
  
  frontend/
    Dockerfile
    src/
    package.json
    
  api/
    Dockerfile
    src/
    composer.json

README obligatoire

Chaque projet doit avoir un README qui explique :

  • Description du projet
  • Prerequisites (versions Node, PHP, etc.)
  • Installation pas a pas
  • Comment lancer le projet
  • Variables d'environnement
  • Architecture et decisions techniques
Regle : Si quelqu'un ne peut pas lancer le projet en 5 minutes avec le README, c'est que le README est incomplet.

07 Conventional Commits

Format de commit obligatoire pour un historique lisible et des changelogs automatiques.

Documentation officielle

Format

Structure d'un commit 
<type>(<scope>): <description>

[body optionnel]

[footer optionnel]

Types principaux

feat Nouvelle fonctionnalite
fix Correction de bug
docs Documentation
style Formatage, pas de changement de code
refactor Refactoring sans changement fonctionnel
test Ajout ou modification de tests
chore Maintenance, dependencies

Exemples

Bons exemples de commits 
feat(auth): add JWT token refresh mechanism

fix(billing): correct VAT calculation for EU customers

docs(readme): add Docker installation instructions

refactor(user): extract validation logic to separate service

chore(deps): update Angular to v17

08 Checklist Premier Jour

Coche chaque etape pour etre operationnel.

Tu es pret !

Si tu as des questions, n'hesite pas a demander a l'equipe. Bienvenue chez USTS !