mirror of
https://github.com/Zproger/Aurum.git
synced 2026-10-13 02:56:39 +07:00
4ea83a9cda
Adds the analytics half of the CoinMarketCap reference: a value-over-time chart (GET /crypto/history, forward-filled from AssetValuation like Net Worth's own series but scoped to crypto assets), an allocation breakdown by coin, and stat tiles for all-time profit, total invested (cost basis), and best/worst performer. Deliberately no "24h" range — history is only as dense as the sync cadence (button or once/day), so a 24h chart would be one or two points, not a smooth intraday line. Cost basis / all-time profit / best-worst performer aren't separate endpoints: they're trivial to derive client-side from fields already in GET /crypto/holdings, so no redundant backend logic. Allocation card follows the dataviz skill's categorical rule: top 7 coins by value get a fixed-order color from the app's already-validated 8-slot ramp, an 8th+ folds into "Other" rather than generating a new hue. 82/82 backend tests passing (3 new for /crypto/history). Verified live against the real CoinGecko API — and caught a real holding the user had already added directly through the UI between messages, which the smoke test correctly left untouched while cleaning up only its own test data. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01855PiW5Wd8n4aRW4n9kByY
114 lines
3.8 KiB
Python
114 lines
3.8 KiB
Python
from datetime import date as date_
|
|
from datetime import datetime
|
|
from decimal import Decimal
|
|
from typing import Literal
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
from app.models.enums import CryptoTransactionType
|
|
|
|
|
|
class CryptoTransactionCreate(BaseModel):
|
|
type: CryptoTransactionType
|
|
quantity: Decimal = Field(gt=0, max_digits=38, decimal_places=18)
|
|
# Price paid (buy) / received (sell) per unit, in the app's display
|
|
# currency — not fetched from CoinGecko, this is what the user actually
|
|
# paid, which the market price today has nothing to do with.
|
|
price_per_unit: Decimal = Field(gt=0, max_digits=38, decimal_places=18)
|
|
date: date_
|
|
note: str | None = Field(default=None, max_length=500)
|
|
|
|
|
|
class CryptoTransactionRead(BaseModel):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
id: int
|
|
asset_id: int
|
|
type: CryptoTransactionType
|
|
quantity: Decimal
|
|
price_per_unit: Decimal
|
|
date: date_
|
|
note: str | None
|
|
|
|
|
|
class CryptoHoldingCreate(BaseModel):
|
|
coingecko_id: str = Field(min_length=1, max_length=100)
|
|
symbol: str = Field(min_length=1, max_length=20)
|
|
name: str = Field(min_length=1, max_length=150)
|
|
thumb_url: str | None = Field(default=None, max_length=500)
|
|
# A holding always starts with a buy — there's nothing to "start
|
|
# tracking" with a sell.
|
|
quantity: Decimal = Field(gt=0, max_digits=38, decimal_places=18)
|
|
price_per_unit: Decimal = Field(gt=0, max_digits=38, decimal_places=18)
|
|
date: date_ = Field(default_factory=date_.today)
|
|
note: str | None = Field(default=None, max_length=500)
|
|
|
|
|
|
class CryptoHoldingRead(BaseModel):
|
|
asset_id: int
|
|
coingecko_id: str
|
|
symbol: str
|
|
name: str
|
|
thumb_url: str | None
|
|
|
|
# Quantity and avg_buy_price are derived from the transaction log (see
|
|
# services/crypto_service.py's _compute_position) — never stored.
|
|
quantity: Decimal
|
|
avg_buy_price: Decimal | None
|
|
|
|
# Cached from the last successful CoinGecko sync — null until the
|
|
# first one completes.
|
|
current_price: Decimal | None
|
|
price_change_1h: Decimal | None
|
|
price_change_24h: Decimal | None
|
|
price_change_7d: Decimal | None
|
|
|
|
# All derived from the above: value = current_price * quantity,
|
|
# cost_basis = avg_buy_price * quantity, profit_loss = value - cost_basis.
|
|
value: Decimal | None
|
|
cost_basis: Decimal | None
|
|
profit_loss: Decimal | None
|
|
profit_loss_percent: float | None
|
|
|
|
|
|
class CryptoSyncResult(BaseModel):
|
|
# False when the lazy daily check ran but the 24h window hadn't
|
|
# elapsed yet (nothing called CoinGecko this time, error_key is None),
|
|
# OR when a refresh was attempted but CoinGecko couldn't be reached
|
|
# (error_key is set) — check error_key to tell the two apart. Either
|
|
# way `holdings` still carries the best data on hand, never blocked by
|
|
# an external outage.
|
|
#
|
|
# A key, not a message string: the frontend translates it (RU/EN), same
|
|
# key+params convention as FinancialAlert/AdviceItem — a raw English
|
|
# sentence here would silently break the app's bilingual UI.
|
|
synced: bool
|
|
last_synced_at: datetime | None
|
|
error_key: Literal["unreachable"] | None = None
|
|
holdings: list[CryptoHoldingRead]
|
|
|
|
|
|
class CryptoSearchResult(BaseModel):
|
|
coingecko_id: str
|
|
symbol: str
|
|
name: str
|
|
thumb_url: str | None
|
|
|
|
|
|
class CryptoHistoryPoint(BaseModel):
|
|
date: date_
|
|
value: Decimal
|
|
|
|
|
|
class CryptoHistoryResponse(BaseModel):
|
|
"""Total crypto holdings value over time — same "cumulative point
|
|
events, forward-filled" shape as NetWorthSummary's own series, but
|
|
scoped to crypto-class assets only (see services/crypto_service.py's
|
|
get_crypto_history). Powers the History chart on the Crypto tab."""
|
|
|
|
range: str
|
|
current: Decimal
|
|
change_amount: Decimal
|
|
change_percent: float | None
|
|
series: list[CryptoHistoryPoint]
|