Initial commit: habit tracker PWA with Google OAuth, push notifications

FastAPI + SQLAlchemy/Alembic + MariaDB backend with Jinja2/htmx/Alpine
server-rendered frontend. Multi-user via Google OAuth, daily habit
tracking, monthly/weekly history views, Web Push reminders via
APScheduler, and PWA support (manifest, service worker, offline caching).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/models/__init__.py

@@ -0,0 +1,16 @@
+from app.models.habit import Habit, HabitStatus, HabitType
+from app.models.habit_log import HabitLog
+from app.models.notification_log import HabitNotificationLog, SummaryNotificationLog
+from app.models.push_subscription import PushSubscription
+from app.models.user import User
+
+__all__ = [
+    "Habit",
+    "HabitStatus",
+    "HabitType",
+    "HabitLog",
+    "HabitNotificationLog",
+    "SummaryNotificationLog",
+    "PushSubscription",
+    "User",
+]

app/models/habit.py

@@ -0,0 +1,48 @@
+import enum
+from datetime import datetime, time
+
+from sqlalchemy import Enum, ForeignKey, Integer, SmallInteger, String, Time
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+from sqlalchemy.sql import func
+
+from app.database import Base
+
+ALL_WEEKDAYS_MASK = 0b1111111  # 월~일 전부 (bit0=월 ... bit6=일)
+
+
+class HabitType(str, enum.Enum):
+    BUILD = "build"  # 만들고 싶은 습관
+    QUIT = "quit"  # 멈추고 싶은 습관
+
+
+class HabitStatus(str, enum.Enum):
+    ACTIVE = "active"
+    COMPLETED = "completed"
+
+
+class Habit(Base):
+    __tablename__ = "habit"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    user_id: Mapped[int | None] = mapped_column(
+        ForeignKey("user.id", ondelete="CASCADE"), nullable=True
+    )
+    name: Mapped[str] = mapped_column(String(200), nullable=False)
+    habit_type: Mapped[HabitType] = mapped_column(Enum(HabitType, native_enum=False, length=20), nullable=False)
+    status: Mapped[HabitStatus] = mapped_column(
+        Enum(HabitStatus, native_enum=False, length=20), nullable=False, default=HabitStatus.ACTIVE
+    )
+    weekdays_mask: Mapped[int] = mapped_column(SmallInteger, nullable=False, default=ALL_WEEKDAYS_MASK)
+    condition_text: Mapped[str | None] = mapped_column(String(300), nullable=True)
+    reminder_time: Mapped[time | None] = mapped_column(Time, nullable=True)
+    sort_order: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    created_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)
+    completed_at: Mapped[datetime | None] = mapped_column(nullable=True)
+
+    logs: Mapped[list["HabitLog"]] = relationship(
+        back_populates="habit", cascade="all, delete-orphan", passive_deletes=True
+    )
+
+    def is_scheduled_on(self, weekday: int) -> bool:
+        """weekday: Python date.weekday() 기준 (월=0 ... 일=6)"""
+        return bool(self.weekdays_mask & (1 << weekday))

app/models/habit_log.py

@@ -0,0 +1,19 @@
+from datetime import date, datetime
+
+from sqlalchemy import Date, ForeignKey, Integer, UniqueConstraint
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+from sqlalchemy.sql import func
+
+from app.database import Base
+
+
+class HabitLog(Base):
+    __tablename__ = "habit_log"
+    __table_args__ = (UniqueConstraint("habit_id", "log_date", name="uq_habit_log_habit_date"),)
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    habit_id: Mapped[int] = mapped_column(ForeignKey("habit.id", ondelete="CASCADE"), nullable=False)
+    log_date: Mapped[date] = mapped_column(Date, nullable=False)
+    checked_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)
+
+    habit: Mapped["Habit"] = relationship(back_populates="logs")

app/models/notification_log.py

@@ -0,0 +1,33 @@
+from datetime import date, datetime
+
+from sqlalchemy import Date, ForeignKey, Integer, String, UniqueConstraint
+from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy.sql import func
+
+from app.database import Base
+
+
+class HabitNotificationLog(Base):
+    __tablename__ = "habit_notification_log"
+    __table_args__ = (UniqueConstraint("habit_id", "notify_date", name="uq_notification_habit_date"),)
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    habit_id: Mapped[int] = mapped_column(ForeignKey("habit.id", ondelete="CASCADE"), nullable=False)
+    notify_date: Mapped[date] = mapped_column(Date, nullable=False)
+    sent_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)
+
+
+class SummaryNotificationLog(Base):
+    """주간/월간 요약 알림 중복 발송 방지용 클레임 테이블 (habit_notification_log와 동일한 패턴).
+
+    period_type은 "weekly"/"monthly", period_start는 그 기간의 시작일(주간=월요일, 월간=1일)이다.
+    """
+
+    __tablename__ = "summary_notification_log"
+    __table_args__ = (UniqueConstraint("user_id", "period_type", "period_start", name="uq_summary_user_period"),)
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    user_id: Mapped[int] = mapped_column(ForeignKey("user.id", ondelete="CASCADE"), nullable=False)
+    period_type: Mapped[str] = mapped_column(String(20), nullable=False)
+    period_start: Mapped[date] = mapped_column(Date, nullable=False)
+    sent_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)

app/models/push_subscription.py

@@ -0,0 +1,21 @@
+from datetime import datetime
+
+from sqlalchemy import ForeignKey, Integer, String
+from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy.sql import func
+
+from app.database import Base
+
+
+class PushSubscription(Base):
+    __tablename__ = "push_subscription"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    user_id: Mapped[int | None] = mapped_column(
+        ForeignKey("user.id", ondelete="CASCADE"), nullable=True
+    )
+    endpoint: Mapped[str] = mapped_column(String(512), nullable=False, unique=True)
+    p256dh_key: Mapped[str] = mapped_column(String(255), nullable=False)
+    auth_key: Mapped[str] = mapped_column(String(255), nullable=False)
+    user_agent: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    created_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)

app/models/user.py

@@ -0,0 +1,18 @@
+from datetime import datetime
+
+from sqlalchemy import Integer, String
+from sqlalchemy.orm import Mapped, mapped_column
+from sqlalchemy.sql import func
+
+from app.database import Base
+
+
+class User(Base):
+    __tablename__ = "user"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True)
+    google_sub: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
+    email: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
+    name: Mapped[str | None] = mapped_column(String(255), nullable=True)
+    picture_url: Mapped[str | None] = mapped_column(String(512), nullable=True)
+    created_at: Mapped[datetime] = mapped_column(server_default=func.now(), nullable=False)