# HomeStock Backend

Backend API pour la gestion d'inventaire domestique.

## Stack technique

- **FastAPI** : Framework web moderne et performant
- **SQLAlchemy 2.0+** : ORM avec support asynchrone
- **SQLite** : Base de données embarquée
- **Alembic** : Migrations de base de données
- **Pydantic** : Validation des données
- **Loguru** : Logging avancé

## Installation

```bash
# Avec uv (recommandé)
uv sync

# Ou avec pip
pip install -e .
```

## Lancement

```bash
# Mode développement (avec hot-reload)
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

# Ou via le Makefile depuis la racine
make dev-backend
```

## Tests

```bash
# Lancer les tests
uv run pytest

# Avec couverture
uv run pytest --cov=app --cov-report=html
```

## Migrations

```bash
# Créer une nouvelle migration
uv run alembic revision --autogenerate -m "Description"

# Appliquer les migrations
uv run alembic upgrade head

# Rollback
uv run alembic downgrade -1
```

## Structure

```
backend/
├── app/
│   ├── core/          # Configuration, database, logging
│   ├── models/        # Modèles SQLAlchemy
│   ├── schemas/       # Schémas Pydantic
│   ├── routers/       # Endpoints API
│   ├── services/      # Logique métier
│   ├── repositories/  # Accès données
│   └── utils/         # Utilitaires
├── alembic/           # Migrations
└── tests/             # Tests
```