# API Anime Tracker

API de synchronisation pour l'extension Chrome Anime Tracker, permettant de synchroniser l'historique des animés sur plusieurs appareils.

## Fonctionnalités

- ✅ Authentification JWT (inscription, connexion)
- ✅ Synchronisation des animés entre appareils
- ✅ CRUD complet pour les animés
- ✅ Endpoint de synchronisation en masse
- ✅ Base de données PostgreSQL (service externe)

## Configuration

### Variables d'environnement

Créez un fichier `.env` à partir de `env.example` :

```bash
cp env.example .env
```

Éditez `.env` et configurez :

- `SECRET_KEY`: Clé secrète pour JWT (minimum 32 caractères, générer une clé aléatoire)
- `DATABASE_URL`: URL de connexion PostgreSQL (format: `postgresql://user:password@host:port/database`)

### Exemple de configuration

```env
SECRET_KEY=votre-cle-secrete-tres-longue-et-aleatoire-minimum-32-caracteres
DATABASE_URL=postgresql://username:password@postgres.holo795.fr:5432/anime_tracker
```

## Installation avec Docker

### 1. Lancer avec Docker Compose

```bash
docker-compose up -d
```

L'API sera accessible sur `https://anime-tracker.holo795.fr` (ou le port configuré)

### 2. Vérifier le statut

```bash
docker-compose ps
docker-compose logs -f api
```

## Développement local (sans Docker)

```bash
# Créer un environnement virtuel
python -m venv venv
source venv/bin/activate  # Sur Windows: venv\Scripts\activate

# Installer les dépendances
pip install -r requirements.txt

# Lancer l'API
uvicorn main:app --reload --host 0.0.0.0 --port 8000
```

## Documentation API

Une fois l'API lancée, accédez à :
- **Swagger UI**: https://anime-tracker.holo795.fr/docs
- **ReDoc**: https://anime-tracker.holo795.fr/redoc

## Endpoints principaux

### Authentification

- `POST /api/auth/register` - Inscription
  ```json
  {
    "username": "mon_username",
    "email": "email@example.com",
    "password": "motdepasse123"
  }
  ```

- `POST /api/auth/login` - Connexion
  ```json
  {
    "email_or_username": "email@example.com",
    "password": "motdepasse123"
  }
  ```

- `GET /api/auth/me` - Informations utilisateur (nécessite authentification)

### Animés

- `GET /api/animes` - Liste des animés (nécessite authentification)
- `POST /api/animes` - Créer/mettre à jour un animé (nécessite authentification)
- `PUT /api/animes/{anime_id}` - Mettre à jour un animé (nécessite authentification)
- `DELETE /api/animes/{anime_id}` - Supprimer un animé (nécessite authentification)
- `POST /api/animes/sync` - Synchroniser plusieurs animés (nécessite authentification)

### Santé

- `GET /api/health` - Vérification de l'état

## Production

### Déploiement

1. Configurez les variables d'environnement sur votre serveur
2. Assurez-vous que PostgreSQL est accessible depuis le conteneur Docker
3. Utilisez un reverse proxy (nginx) avec HTTPS
4. Configurez les certificats SSL

### Sécurité

- ✅ Utilisez une `SECRET_KEY` forte et unique
- ✅ Utilisez HTTPS en production
- ✅ Configurez CORS pour limiter les origines autorisées
- ✅ Utilisez un mot de passe fort pour PostgreSQL
- ✅ Limitez les connexions réseau à PostgreSQL

### Exemple de configuration nginx

```nginx
server {
    listen 443 ssl;
    server_name anime-tracker.holo795.fr;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

## Base de données

### Création de la base de données PostgreSQL

```sql
CREATE DATABASE anime_tracker;
CREATE USER anime_user WITH PASSWORD 'votre_mot_de_passe';
GRANT ALL PRIVILEGES ON DATABASE anime_tracker TO anime_user;
```

Les tables seront créées automatiquement au premier démarrage de l'API.

### Migration

Si vous devez migrer depuis SQLite vers PostgreSQL :

1. Exportez les données depuis SQLite
2. Importez-les dans PostgreSQL
3. Mettez à jour `DATABASE_URL` dans `.env`