CLAUDE.md

# Nom du projet

## Stack
    # Versions, frameworks, outils clés

## Architecture
    # Structure des dossiers, patterns

## Conventions
    # Nommage, styles, règles de code

## Ce que Claude doit faire
    # Obligations, workflows

## Ce que Claude ne doit PAS faire
    # Interdictions, limitations

# E-Commerce Platform — Frontend

## Stack
    # Next.js 14, React 18, TypeScript, Tailwind

## Architecture
    # /app, /components, /features, /lib, /types

## Conventions
    # - TOUJOURS type (pas interface)
    # - Imports @/ (racine), pas relatifs
    # - data-testid kebab-case sur élts interactifs
    # - Nommage : PascalCase composants, camelCase tout le reste

## Ce que Claude doit faire
    # - Créer features complètes (composants + tests + types)
    # - Refactorer vers patterns standards du projet
    # - Ecrire du code testable et documenté

## Ce que Claude ne doit PAS faire
    # - Modifier index.ts/tsx (structure immuable)
    # - Créer de nouvelles dépendances sans accord
    # - Changer les conventions existantes

# Backend API — Django

## Stack
    # Django 4.2, DRF, PostgreSQL, Celery

## Conventions
    # - PEP8 strict + Black formatter
    # - Type hints obligatoires (mypy)
    # - Services pour logique métier, pas Models

## Ce que Claude doit faire
    # - Créer endpoints avec serializers + tests
    # - Respecter patterns DAL (Data Access Layer)

## Ce que Claude ne doit PAS faire
    # - Requêtes SQL brutes (ORM obligatoire)
    # - Migrations sans analyse de données existantes