Files
lifetrack/apps/api/app/core/mixins.py
T
MeeJayandClaude Opus 5 93f0689c1e Initial import: LifeTrack v1 (santé, vape, finances)
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>
2026-08-14 10:48:57 +02:00

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)