I

INES

Modules principaux

Accueil RepèretorY TorBox TubbyBeta BibliHome INES-Market Réseaux Studio Ateliers Codex Workflows

Accès rapide

Extensions Marketplaces

Modules secondaires

Paramètres Notifications

Command Palette

Search for a command to run...

API

1

WAO

Localisation...

wao

Multi

0 ID

Standards WAO

Normes, conventions et standards techniques du projet INES

CodeSTD-001

Conventions de nommage

Variables et fonctions : camelCase (ex: getUserById)
Composants React : PascalCase (ex: UserCard)
Fichiers de pages : kebab-case (ex: user-profile)
Constantes globales : SCREAMING_SNAKE_CASE
Tables PostgreSQL : snake_case (ex: user_sessions)

ArchitectureSTD-002

Séparation des responsabilités

Modèles : logique métier et accès aux données uniquement
Contrôleurs : orchestration des services, pas de SQL direct
Vues/Pages : affichage et interaction, 0 logique métier
Services : réutilisables, indépendants du framework
Hooks React : état local et effets, pas de fetch direct dans les composants

CSSSTD-003

Styles et design

0 styles inline — toujours des classes Tailwind
Variables CSS via --token pour la cohérence des couleurs
Responsive first : mobile → tablette → desktop
Utiliser shadcn/ui pour tous les composants UI de base
Dark mode natif via la classe `dark` sur le body

APISTD-004

Design des endpoints REST

Versioning : /api/v1/resource
Noms de ressources au pluriel : /users, /workflows
HTTP verbs sémantiques : GET/POST/PUT/PATCH/DELETE
Réponses JSON avec champs : data, error, meta
Codes HTTP standards : 200/201/400/401/403/404/500

GitSTD-005

Convention de commits

Format : type(scope): description courte
Types : feat / fix / refactor / docs / chore / test
Scope : module concerné (auth, workflows, codex...)
Description en minuscules, impératif, sans point final
PR = 1 feature ou 1 fix, pas de mix

SécuritéSTD-006

Bonnes pratiques sécurité

Jamais de secrets en dur — variables d'environnement obligatoires
Validation des entrées côté backend systématiquement (Pydantic)
Tokens JWT avec expiration courte + refresh tokens
Rate limiting sur toutes les routes publiques
CORS restreint aux origines autorisées

6 standards · Ces règles s'appliquent à l'ensemble du projet INES