Files
aurum/backend/app/schemas/crypto.py
ZProger c3309b9d60 feat: click a coin row to view its trade history; edit transactions
Matches CoinMarketCap's flow: clicking anywhere on a coin's row in the
holdings table opens its transaction history (previously only a dedicated
icon button did). The table's own History icon is gone since the row now
does that job; the remaining "+"/delete icons get stopPropagation so they
don't also trigger the row click.

Adds the missing piece: transactions could be viewed and deleted but not
edited. New PATCH /crypto/transactions/{id} (partial update, never calls
CoinGecko, same oversell guard as creating a sell) backs a pencil button on
each history row that opens CryptoTransactionModal pre-filled — the same
dialog used for "+", now doing double duty as create/edit.

86/86 backend tests passing (4 new). Verified live against the real API:
create, edit quantity/note, 404 on unknown id, cleanup — real user data
untouched throughout.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01855PiW5Wd8n4aRW4n9kByY
2026-08-30 05:06:20 +03:00

122 lines
4.2 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 CryptoTransactionUpdate(BaseModel):
type: CryptoTransactionType | None = None
quantity: Decimal | None = Field(default=None, gt=0, max_digits=38, decimal_places=18)
price_per_unit: Decimal | None = Field(default=None, gt=0, max_digits=38, decimal_places=18)
date: date_ | None = None
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]