✨ [feat][backend] Add Account.created_at

Author: tomy0000000

backend/alembic/versions/0041_add_account_created_at.py

@@ -0,0 +1,36 @@
+"""add account created_at
+
+Revision ID: 0041
+Revises: 0040
+Create Date: 2026-07-19 17:56:10.091969
+
+"""
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = '0041'
+down_revision = '0040'
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "account",
+        sa.Column(
+            "created_at",
+            sa.DateTime(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column('account', 'created_at')
+    # ### end Alembic commands ###

backend/kayman/schemas/account.py

@@ -1,8 +1,9 @@
+from datetime import UTC, datetime
 from decimal import Decimal
 from typing import TYPE_CHECKING
 
 from pydantic_extra_types.timezone_name import TimeZoneName
-from sqlmodel import Column, Field, Relationship, SQLModel
+from sqlmodel import Column, DateTime, Field, Relationship, SQLModel
 
 from kayman.schemas._custom_types import SATimezone
 
@@ -24,6 +25,10 @@ class Account(AccountBase, table=True):
     # we don't accept initial value on create, and will always use 0 as default
     balance: Decimal = Field(default=0)
     timezone: TimeZoneName = Field(sa_column=Column(SATimezone(), nullable=False))
+    created_at: datetime = Field(
+        default_factory=lambda: datetime.now(UTC),
+        sa_column=Column(DateTime(timezone=True), nullable=False),
+    )
     currency: "Currency" = Relationship(back_populates="accounts")
     statements: list["Statement"] = Relationship(back_populates="account")
     transactions: list["Transaction"] = Relationship(back_populates="account")
@@ -37,6 +42,7 @@ class AccountRead(AccountBase):
     id: int
     balance: Decimal
     timezone: TimeZoneName
+    created_at: datetime
 
 
 class AccountUpdate(SQLModel):

backend/kayman/tests/crud/test_account.py

@@ -37,8 +37,10 @@ def assert_account_matches(
     # - a server-assigned id for new accounts
     if isinstance(expected, Account):
         assert actual.id == expected.id
+        assert actual.created_at == expected.created_at
     else:
         assert actual.id is not None
+        assert actual.created_at is not None
 
     # balance should be
     # - 0 for new accounts

backend/kayman/tests/factories/account.py

@@ -1,3 +1,5 @@
+from datetime import UTC, datetime
+
 import factory
 from factory.alchemy import SQLAlchemyModelFactory
 
@@ -15,3 +17,4 @@ class Meta:
     currency_code = factory.SelfAttribute("currency.code")
     balance = factory.Faker("pydecimal", left_digits=5, right_digits=2)
     timezone = "UTC"
+    created_at = factory.LazyFunction(lambda: datetime.now(UTC))