csv/docs/README.md

CSV - Documentation détaillée

Architecture

graph TD
    subgraph "Frontend (React/Vite)"
        App[App.jsx]
        Router[React Router]
        Pages[Pages]
        Auth[AuthContext]
    end

    subgraph "Backend (Express ESM)"
        Server[index.js]
        Routes[Routes API]
        Multer[Multer Uploads]
    end

    subgraph "Base de données"
        MariaDB[(MariaDB<br/>csv)]
    end

    App --> Router
    Router --> Pages
    Pages --> Auth
    Pages -->|API calls| Server
    Server --> Routes
    Server --> Multer
    Routes --> MariaDB

Modèle de données

erDiagram
    USERS ||--o{ ARTICLES : "écrit"
    USERS ||--o{ EVENTS : "crée"
    USERS ||--o{ LISTINGS : "publie"
    USERS ||--o{ HELP_REQUESTS : "demande"
    USERS ||--o{ BUSINESSES : "possède"
    CATEGORIES ||--o{ LISTINGS : "classe"
    CATEGORIES ||--o{ EVENTS : "classe"

    USERS {
        int id PK
        string name
        string email UK
        string password
        string phone
        string address
        enum role user|admin
        string avatar
    }

    ARTICLES {
        int id PK
        string title
        text content
        string image
        int author_id FK
        boolean published
    }

    EVENTS {
        int id PK
        string title
        text description
        date date
        time time
        string location
        string image
        string category
        int author_id FK
    }

    LISTINGS {
        int id PK
        string title
        text description
        float price
        string image
        string category
        int author_id FK
    }

    HELP_REQUESTS {
        int id PK
        string title
        text description
        string urgency
        int author_id FK
    }

    BUSINESSES {
        int id PK
        string name
        string description
        string address
        string phone
        string email
        string website
        string category
        int owner_id FK
    }

    CATEGORIES {
        int id PK
        string name
        enum type listing|event
    }

API Routes

Méthode	Route	Description
POST	/api/auth/register	Inscription
POST	/api/auth/login	Connexion
GET	/api/auth/me	Profil
GET	/api/articles	Liste articles
POST	/api/articles	Créer article
GET	/api/events	Liste événements
POST	/api/events	Créer événement
GET	/api/listings	Liste annonces
POST	/api/listings	Créer annonce
GET	/api/help-requests	Liste demandes d'aide
POST	/api/help-requests	Créer demande
GET	/api/businesses	Liste entreprises
POST	/api/businesses	Créer entreprise
GET	/api/categories	Liste catégories

Fonctionnalités

Articles

• CRUD avec images (upload Multer)
• Système de publication (brouillon/publié)
• Auteur lié

Événements

• Date, heure, lieu
• Catégories (musique, sport, culture, etc.)
• Images

Petites Annonces (Listings)

• Prix, catégorie
• Images uploadées
• Recherche par catégorie

Demandes d'Aide

• Niveau d'urgence
• Mise en relation entre utilisateurs

Annuaire Entreprises

• Informations contact
• Site web, téléphone
• Catégories métier

Administration

• Panel admin pour gérer les contenus
• Modération des articles/annonces
• Gestion des utilisateurs

Développement

# Backend
cd backend
npm install
node src/index.js      # Express sur :3002

# Frontend
cd frontend
npm install
npm run dev            # Vite sur :5173

Auto-migration BDD

Le backend crée automatiquement les tables au démarrage via CREATE TABLE IF NOT EXISTS. Pas de migration nécessaire.