✨ [feat][backend] Add Event.cleared_at

Author: tomy0000000

backend/alembic/versions/0039_add_event_cleared_at.py

@@ -0,0 +1,31 @@
+"""add event cleared_at
+
+Revision ID: 0039
+Revises: 0038
+Create Date: 2026-07-19 03:48:43.469123
+
+"""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = "0039"
+down_revision = "0038"
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column(
+        "event", sa.Column("cleared_at", sa.DateTime(timezone=True), nullable=True)
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column("event", "cleared_at")
+    # ### end Alembic commands ###

backend/kayman/schemas/event.py

@@ -25,6 +25,7 @@ class EventBase(SQLModel):
     timestamp: datetime
     timezone: TimeZoneName
     description: str | None = None
+    cleared_at: datetime | None = None
 
 
 class Event(EventBase, table=True):
@@ -34,6 +35,9 @@ class Event(EventBase, table=True):
         sa_column=Column(DateTime(timezone=True), nullable=False)
     )
     timezone: TimeZoneName = Field(sa_column=Column(SATimezone(), nullable=False))
+    cleared_at: datetime | None = Field(
+        default=None, sa_column=Column(DateTime(timezone=True), nullable=True)
+    )
     # Auto calculated for Expense or Income
     # Manually logged for Transfer or Exchange
     transactions: list["Transaction"] = Relationship(back_populates="event")
@@ -53,3 +57,4 @@ class EventUpdate(SQLModel):
     timestamp: datetime | None = None
     timezone: TimeZoneName | None = None
     description: str | None = None
+    cleared_at: datetime | None = None

backend/kayman/tests/crud/test_event.py

@@ -171,12 +171,14 @@ def test_read_events_for_update(session: Session):
         # Datetime fields use commit=False: SQLite drops tzinfo on the
         # post-commit refresh, so keep the in-memory tz-aware value to compare.
         ("timestamp", lambda: datetime(2026, 6, 1, tzinfo=UTC), False),
+        ("cleared_at", lambda: datetime(2026, 6, 1, tzinfo=UTC), False),
     ],
     ids=[
         "type",
         "timezone",
         "description",
         "timestamp",
+        "cleared_at",
     ],
 )
 def test_update_event_field(session: Session, field, make_value, commit):
@@ -185,12 +187,14 @@ def test_update_event_field(session: Session, field, make_value, commit):
         timestamp=datetime(2025, 1, 1, 12, 0),
         timezone="UTC",
         description="original description",
+        cleared_at=datetime(2025, 1, 1, 12, 0),
     )
     originals = {
         "type": event.type,
         "timestamp": event.timestamp,
         "timezone": event.timezone,
         "description": event.description,
+        "cleared_at": event.cleared_at,
     }
     new_value = make_value()
 

backend/kayman/tests/factories/event.py

@@ -15,6 +15,7 @@ class Meta:
     timestamp = factory.Faker("date_time")
     timezone = "UTC"
     type = factory.Faker("random_element", elements=list(EventType))
+    cleared_at = factory.Faker("date_time")
 
     @classmethod
     def build_details(cls, type=EventType.Expense, entry_num=1, transaction_num=1):