home_stock/backend/README.md

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

# Avec uv (recommandé)
uv sync

# Ou avec pip
pip install -e .

Lancement

# 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

# Lancer les tests
uv run pytest

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

Migrations

# 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