[Phase 1] Task 1: Create core/models.py — Domain dataclasses #5

New Issue

shoko · 2026-04-02T18:28:39+02:00

shoko commented

2026-04-02 18:28:39 +02:00

Task 1: Create core/models.py

Labels: phase-1, core
Dependency: None — can start immediately

Goal

Define all domain dataclasses for the JIGAIDO bounty tracker.

Files to create

core/__init__.py
core/models.py

Domain dataclasses to implement

from dataclasses import dataclass
from typing import Optional

@dataclass
class Bounty:
    """Base bounty with common fields."""
    id: int
    text: Optional[str]
    link: Optional[str]
    due_date_ts: Optional[int]
    created_at: int

@dataclass
class GroupBounty(Bounty):
    """Bounty created in a group context."""
    created_by_user_id: int

@dataclass
class PersonalBounty(Bounty):
    """Bounty created in DM/personal context."""
    pass

@dataclass
class TrackedBounty:
    """A bounty that a user is tracking."""
    bounty_id: int
    created_at: int

@dataclass
class GroupData:
    """All data for a group."""
    group_id: int
    bounties: list[GroupBounty]
    next_id: int

@dataclass
class TrackingData:
    """User tracking data within a group."""
    user_id: int
    tracked: list[TrackedBounty]

@dataclass
class UserData:
    """All personal bounties for a user (DM mode)."""
    user_id: int
    bounties: list[PersonalBounty]
    next_id: int

Acceptance Criteria

All dataclasses defined with proper types
Optional fields properly typed with Optional[T]
Can be instantiated and compared
Unit tests in tests/test_models.py pass

## Task 1: Create core/models.py **Labels:** phase-1, core **Dependency:** None — can start immediately ### Goal Define all domain dataclasses for the JIGAIDO bounty tracker. ### Files to create - `core/__init__.py` - `core/models.py` ### Domain dataclasses to implement ```python from dataclasses import dataclass from typing import Optional @dataclass class Bounty: """Base bounty with common fields.""" id: int text: Optional[str] link: Optional[str] due_date_ts: Optional[int] created_at: int @dataclass class GroupBounty(Bounty): """Bounty created in a group context.""" created_by_user_id: int @dataclass class PersonalBounty(Bounty): """Bounty created in DM/personal context.""" pass @dataclass class TrackedBounty: """A bounty that a user is tracking.""" bounty_id: int created_at: int @dataclass class GroupData: """All data for a group.""" group_id: int bounties: list[GroupBounty] next_id: int @dataclass class TrackingData: """User tracking data within a group.""" user_id: int tracked: list[TrackedBounty] @dataclass class UserData: """All personal bounties for a user (DM mode).""" user_id: int bounties: list[PersonalBounty] next_id: int ``` ### Acceptance Criteria - [ ] All dataclasses defined with proper types - [ ] Optional fields properly typed with `Optional[T]` - [ ] Can be instantiated and compared - [ ] Unit tests in `tests/test_models.py` pass

shoko referenced this issue

2026-04-02 18:29:04 +02:00

[Phase 1] Task 2: Create core/ports.py — Storage interfaces #6

shoko referenced this issue

2026-04-02 18:29:54 +02:00

[Phase 1] Task 4: Create core/services.py — Business logic #8

shoko referenced this issue

2026-04-02 18:30:40 +02:00

[Phase 1] Task 5: Create adapters/storage/json_file.py — JSON file adapter #9

shoko referenced this issue

2026-04-02 18:32:56 +02:00

[Phase 1] Architecture Extraction — Full Hexagonal Architecture Refactor #17