Tracker de vie auto-hébergé : suivi poids/calories/sport avec planning de pesées, sevrage tabac (vape) avec modèle de coût DIY et économies, et finances personnelles avec import de relevés bancaires. Architecture : FastAPI + SQLAlchemy 2.0 + PostgreSQL 16, React 18 + TS + Vite + Tailwind + ECharts, déploiement Docker Compose. Modules auto-découverts des deux côtés (pkgutil / import.meta.glob) et framework de connecteurs à deux voies (importeurs de fichiers + ingestion JSON) pour brancher de nouvelles sources sans toucher au noyau. Validé : 292 tests pytest, tsc + vite build, contrat API/web vérifié contre le schéma OpenAPI, et déploiement Docker réel sur PostgreSQL 16 (28 tables, SPA servie par nginx, wizard de premier démarrage). Documentation : README.md, docs/GUIDE.md, CONVENTIONS.md, et les documents de conception et de recherche dans docs/. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
26 lines
675 B
Python
26 lines
675 B
Python
from abc import ABC, abstractmethod
|
|
from dataclasses import dataclass
|
|
from typing import Any, ClassVar
|
|
|
|
from sqlalchemy.orm import Session
|
|
|
|
from app.core.importing.base import UpsertOutcome
|
|
|
|
|
|
@dataclass
|
|
class IngestRecord:
|
|
type: str # ex: "steps", "weight", "workout"
|
|
data: dict[str, Any]
|
|
external_id: str | None = None
|
|
source: str = "ingest" # sender-declared source (ex: "android_bridge")
|
|
|
|
|
|
class BaseIngestHandler(ABC):
|
|
domain: ClassVar[str] # "health"
|
|
record_types: ClassVar[tuple[str, ...]] # accepted `type` values
|
|
|
|
@abstractmethod
|
|
def apply(
|
|
self, db: Session, user_id: int, record: IngestRecord
|
|
) -> UpsertOutcome: ...
|