models.py 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136
  1. """Typed domain models used by deterministic tools and agent orchestration."""
  2. from __future__ import annotations
  3. from dataclasses import asdict, dataclass, field
  4. from datetime import date
  5. from typing import Any, Literal
  6. TransactionKind = Literal["income", "expense"]
  7. @dataclass(slots=True)
  8. class Transaction:
  9. transaction_id: str
  10. occurred_at: str
  11. merchant: str
  12. amount: float
  13. kind: TransactionKind
  14. category: str = "Uncategorized"
  15. note: str = ""
  16. source: str = "csv"
  17. category_confidence: float = 0.0
  18. @property
  19. def date(self) -> date:
  20. return date.fromisoformat(self.occurred_at[:10])
  21. @property
  22. def hour(self) -> int:
  23. if "T" not in self.occurred_at:
  24. return 12
  25. return int(self.occurred_at.split("T", 1)[1][:2])
  26. def to_dict(self) -> dict[str, Any]:
  27. return asdict(self)
  28. @dataclass(slots=True)
  29. class Anomaly:
  30. transaction_id: str
  31. merchant: str
  32. category: str
  33. amount: float
  34. occurred_at: str
  35. method: str
  36. score: float
  37. reason: str
  38. def to_dict(self) -> dict[str, Any]:
  39. return asdict(self)
  40. @dataclass(slots=True)
  41. class Goal:
  42. goal_id: str
  43. title: str
  44. goal_type: Literal["savings", "travel", "category_limit"]
  45. target_amount: float
  46. current_amount: float
  47. deadline: str
  48. category: str | None = None
  49. monthly_limit: float | None = None
  50. active: bool = True
  51. def to_dict(self) -> dict[str, Any]:
  52. return asdict(self)
  53. @dataclass(slots=True)
  54. class Quest:
  55. quest_id: str
  56. title: str
  57. description: str
  58. quest_type: str
  59. target: float
  60. progress: float
  61. unit: str
  62. exp_reward: int
  63. status: Literal["active", "completed"] = "active"
  64. evidence: str = ""
  65. def to_dict(self) -> dict[str, Any]:
  66. return asdict(self)
  67. @dataclass(slots=True)
  68. class Achievement:
  69. key: str
  70. title: str
  71. description: str
  72. unlocked: bool
  73. def to_dict(self) -> dict[str, Any]:
  74. return asdict(self)
  75. @dataclass(slots=True)
  76. class AnalysisReport:
  77. user_id: str
  78. month: str
  79. transactions: list[Transaction]
  80. summary: dict[str, Any]
  81. category_breakdown: dict[str, float]
  82. trends: dict[str, dict[str, float]]
  83. patterns: dict[str, Any]
  84. anomalies: list[Anomaly]
  85. subscriptions: list[dict[str, Any]]
  86. persona: dict[str, Any]
  87. budget: dict[str, Any]
  88. goals: list[dict[str, Any]]
  89. quests: list[Quest]
  90. achievements: list[Achievement]
  91. gamification: dict[str, Any]
  92. reflection: dict[str, Any]
  93. agent_trace: list[dict[str, Any]] = field(default_factory=list)
  94. def to_dict(self) -> dict[str, Any]:
  95. return {
  96. "user_id": self.user_id,
  97. "month": self.month,
  98. "transactions": [item.to_dict() for item in self.transactions],
  99. "summary": self.summary,
  100. "category_breakdown": self.category_breakdown,
  101. "trends": self.trends,
  102. "patterns": self.patterns,
  103. "anomalies": [item.to_dict() for item in self.anomalies],
  104. "subscriptions": self.subscriptions,
  105. "persona": self.persona,
  106. "budget": self.budget,
  107. "goals": self.goals,
  108. "quests": [item.to_dict() for item in self.quests],
  109. "achievements": [item.to_dict() for item in self.achievements],
  110. "gamification": self.gamification,
  111. "reflection": self.reflection,
  112. "agent_trace": self.agent_trace,
  113. }