# 📁 Structure du Projet - Mes Budgets Participatifs

## 🗂️ **Organisation des dossiers**

```
mes-budgets-participatifs/
├── 📚 docs/                    # Documentation complète
│   ├── README.md              # Index de la documentation
│   ├── SETUP.md               # Guide de configuration
│   ├── MIGRATION-GUIDE.md     # Migration vers la sécurité
│   ├── SECURITY-SUMMARY.md    # Résumé de la sécurisation
│   └── SETTINGS.md            # Configuration avancée
│
├── 🗄️ database/               # Scripts de base de données
│   └── supabase-schema.sql           # Schéma complet avec sécurité
│
├── 🛠️ scripts/                # Outils et scripts
│   └── test-security.js       # Tests de sécurité
│
├── 📱 src/                    # Code source de l'application
│   ├── app/                   # Pages Next.js (App Router)
│   ├── components/            # Composants React
│   ├── lib/                   # Services et utilitaires
│   └── types/                 # Types TypeScript
│
├── 🎨 public/                 # Assets statiques
├── 📦 node_modules/           # Dépendances (généré)
├── ⚙️ Configuration files     # Fichiers de configuration
└── 📖 README.md               # Documentation principale
```

## 📋 **Fichiers principaux**

### **Configuration**
- `package.json` - Dépendances et scripts
- `tsconfig.json` - Configuration TypeScript
- `next.config.ts` - Configuration Next.js
- `env.example` - Exemple de variables d'environnement

### **Documentation**
- `README.md` - Documentation principale
- `docs/README.md` - Index de la documentation
- `PROJECT-STRUCTURE.md` - Ce fichier

### **Base de données**
- `database/supabase-schema.sql` - Schéma complet avec sécurité

### **Outils**
- `scripts/test-security.js` - Tests de sécurité

## 🔧 **Scripts disponibles**

```bash
# Développement
npm run dev

# Build de production
npm run build

# Tests de sécurité
npm run test:security

# Linting
npm run lint
npm run lint:fix
```

## 📚 **Documentation par type**

### **🚀 Démarrage rapide**
- `docs/SETUP.md` - Installation et configuration

### **🔒 Sécurité**
- `docs/SECURITY-SUMMARY.md` - Vue d'ensemble de la sécurité
- `docs/SETTINGS.md` - Configuration SMTP et paramètres

### **🗄️ Base de données**
- `database/supabase-schema.sql` - Schéma complet avec RLS

## 🎯 **Points d'entrée**

### **Pour les développeurs :**
1. `README.md` - Vue d'ensemble
2. `docs/SETUP.md` - Configuration
3. `src/` - Code source

### **Pour les administrateurs :**
1. `docs/SECURITY-SUMMARY.md` - Sécurité
2. `docs/SETTINGS.md` - Configuration

### **Pour les déploiements :**
1. `database/supabase-schema.sql` - Base de données
2. `scripts/test-security.js` - Vérification
3. `env.example` - Variables d'environnement

## 🔄 **Workflow de développement**

1. **Configuration** → `docs/SETUP.md`
2. **Développement** → `src/`
3. **Tests** → `scripts/test-security.js`
4. **Documentation** → `docs/`
5. **Déploiement** → `database/` + configuration

---

**Dernière mise à jour :** Réorganisation complète de la structure ✅