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>
32 lines
1.2 KiB
Python
32 lines
1.2 KiB
Python
from datetime import datetime
|
|
|
|
from sqlalchemy import JSON, DateTime, String, func
|
|
from sqlalchemy.dialects import postgresql
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
# Portable JSON type (see CONVENTIONS C8): plain JSON on SQLite (tests),
|
|
# JSONB on PostgreSQL (production). Use this alias for every JSON column.
|
|
JSONB_V = JSON().with_variant(postgresql.JSONB(), "postgresql")
|
|
|
|
|
|
class TimestampMixin:
|
|
created_at: Mapped[datetime] = mapped_column(
|
|
DateTime(timezone=True), server_default=func.now()
|
|
)
|
|
updated_at: Mapped[datetime] = mapped_column(
|
|
DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
|
|
)
|
|
|
|
|
|
class SourceMixin:
|
|
"""Provenance + dedupe columns for every imported/ingested row.
|
|
|
|
source: "manual" | importer id ("foodvisor_csv") | ingest source ("android_bridge")
|
|
external_id: stable id from the source system, if any
|
|
content_hash: sha256 of canonical payload, used when no external_id exists
|
|
"""
|
|
|
|
source: Mapped[str] = mapped_column(String(50), default="manual")
|
|
external_id: Mapped[str | None] = mapped_column(String(255), default=None)
|
|
content_hash: Mapped[str | None] = mapped_column(String(64), default=None)
|