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>
This commit is contained in:
2026-07-16 18:06:17 +09:00
co-authored by Claude Sonnet 5
commit cee589bb3e
80 changed files with 4695 additions and 0 deletions
+254
View File
@@ -0,0 +1,254 @@
import calendar
from datetime import date, timedelta
from sqlalchemy import func, select
from sqlalchemy.orm import Session
from app.models.habit import Habit, HabitStatus, HabitType
from app.models.habit_log import HabitLog
from app.schemas.habit_log import HabitStats, MonthlySummaryDay, TodayItem, WeeklyMatrixRow
from app.services import habit_service, push_service
# 체크 시 축하 푸시/배지를 트리거하는 연속 달성일 마일스톤.
MILESTONE_STREAKS = {7, 30, 66, 100, 200, 365}
def _to_today_item(db: Session, habit: Habit, checked: bool) -> TodayItem:
stats = get_habit_stats(db, habit)
return TodayItem(
habit_id=habit.id,
name=habit.name,
habit_type=habit.habit_type.value,
condition_text=habit.condition_text,
reminder_time=habit.reminder_time.strftime("%H:%M") if habit.reminder_time else None,
checked=checked,
completion_rate=stats.completion_rate,
current_streak=stats.current_streak,
scheduled_days=stats.scheduled_days,
)
def get_today_items(db: Session, user_id: int, target_date: date) -> tuple[list[TodayItem], list[TodayItem]]:
"""오늘 요일에 예정된 active 습관을 형성/중단으로 나누어 체크 여부와 함께 반환한다."""
weekday = target_date.weekday()
active_habits = habit_service.list_habits(db, user_id, status=HabitStatus.ACTIVE)
scheduled = [h for h in active_habits if h.is_scheduled_on(weekday)]
checked_ids: set[int] = set()
habit_ids = [h.id for h in scheduled]
if habit_ids:
checked_ids = set(
db.scalars(
select(HabitLog.habit_id).where(
HabitLog.log_date == target_date, HabitLog.habit_id.in_(habit_ids)
)
)
)
build_items = [_to_today_item(db, h, h.id in checked_ids) for h in scheduled if h.habit_type == HabitType.BUILD]
quit_items = [_to_today_item(db, h, h.id in checked_ids) for h in scheduled if h.habit_type == HabitType.QUIT]
return build_items, quit_items
def toggle_check(db: Session, habit_id: int, log_date: date) -> bool:
"""체크 상태를 반전시키고 토글 후의 체크 여부를 반환한다.
호출측에서 이미 habit_service.get_habit(db, habit_id, user_id)로 소유권을 검증한 뒤에만 불러야 한다.
"""
existing = db.scalar(select(HabitLog).where(HabitLog.habit_id == habit_id, HabitLog.log_date == log_date))
if existing:
db.delete(existing)
db.commit()
return False
db.add(HabitLog(habit_id=habit_id, log_date=log_date))
db.commit()
return True
def toggle_check_and_celebrate(db: Session, habit: Habit, log_date: date) -> tuple[bool, int | None]:
"""체크를 토글하고, 새로 체크되어 스트릭이 마일스톤에 도달했으면 축하 푸시를 보낸다.
반환값: (checked, milestone_streak). milestone_streak은 이번 토글로 막 달성한 마일스톤 값이면 그 값,
체크 해제거나 마일스톤이 아니면 None.
"""
checked = toggle_check(db, habit.id, log_date)
if not checked:
return checked, None
streak = get_habit_stats(db, habit).current_streak
if streak not in MILESTONE_STREAKS:
return checked, None
if habit.user_id is not None:
push_service.send_to_user(
db, habit.user_id, title=f"🔥 {habit.name}", body=f"{streak}일 연속 달성했어요!", url="/today"
)
return checked, streak
def list_logs(
db: Session, user_id: int, habit_id: int | None = None, start: date | None = None, end: date | None = None
) -> list[HabitLog]:
stmt = select(HabitLog).join(Habit, HabitLog.habit_id == Habit.id).where(Habit.user_id == user_id)
if habit_id is not None:
stmt = stmt.where(HabitLog.habit_id == habit_id)
if start is not None:
stmt = stmt.where(HabitLog.log_date >= start)
if end is not None:
stmt = stmt.where(HabitLog.log_date <= end)
stmt = stmt.order_by(HabitLog.log_date)
return list(db.scalars(stmt))
def _checked_counts_by_date(db: Session, habit_ids: list[int], start: date, end: date) -> dict[date, int]:
if not habit_ids:
return {}
rows = db.execute(
select(HabitLog.log_date, func.count(HabitLog.id))
.where(HabitLog.habit_id.in_(habit_ids), HabitLog.log_date.between(start, end))
.group_by(HabitLog.log_date)
).all()
return {row[0]: row[1] for row in rows}
def get_monthly_summary(db: Session, user_id: int, year: int, month: int) -> list[MonthlySummaryDay]:
"""해당 월의 날짜별 예정 습관 수 / 체크된 습관 수를 집계한다 (현재 active 습관 기준)."""
days_in_month = calendar.monthrange(year, month)[1]
first_day = date(year, month, 1)
last_day = date(year, month, days_in_month)
active_habits = habit_service.list_habits(db, user_id, status=HabitStatus.ACTIVE)
checked_counts = _checked_counts_by_date(db, [h.id for h in active_habits], first_day, last_day)
summaries = []
for day_num in range(1, days_in_month + 1):
d = date(year, month, day_num)
# 습관이 생성되기 전 날짜는 "예정되었지만 안 함"으로 잘못 잡히지 않도록 제외한다.
scheduled = sum(1 for h in active_habits if h.created_at.date() <= d and h.is_scheduled_on(d.weekday()))
summaries.append(
MonthlySummaryDay(log_date=d, scheduled_count=scheduled, checked_count=checked_counts.get(d, 0))
)
return summaries
def summarize_completion_rate(summaries: list[MonthlySummaryDay], up_to: date) -> float:
"""월별 요약에서 up_to(보통 오늘)까지 지난 날짜만 모아 전체 완료율(%)을 계산한다.
아직 지나지 않은 미래 날짜는 scheduled_count는 있어도 checked_count가 항상 0이라
포함시키면 완료율이 부당하게 낮아지므로 제외한다.
"""
past = [s for s in summaries if s.log_date <= up_to]
total_scheduled = sum(s.scheduled_count for s in past)
total_checked = sum(s.checked_count for s in past)
return round(total_checked / total_scheduled * 100, 1) if total_scheduled else 0.0
def get_period_completion_rate(db: Session, user_id: int, start: date, end: date) -> tuple[float, int, int]:
"""[start, end] 구간(양끝 포함)의 예정/체크 수를 집계해 완료율(%)과 함께 반환한다.
get_monthly_summary와 같은 규칙(현재 active 습관 기준, 습관 생성일 이전 제외)을 임의 기간에
적용한 버전 — 주간 요약 알림처럼 달력 월 경계에 안 맞는 기간을 집계할 때 쓴다.
"""
active_habits = habit_service.list_habits(db, user_id, status=HabitStatus.ACTIVE)
checked_counts = _checked_counts_by_date(db, [h.id for h in active_habits], start, end)
total_scheduled = 0
total_checked = 0
d = start
while d <= end:
total_scheduled += sum(
1 for h in active_habits if h.created_at.date() <= d and h.is_scheduled_on(d.weekday())
)
total_checked += checked_counts.get(d, 0)
d += timedelta(days=1)
rate = round(total_checked / total_scheduled * 100, 1) if total_scheduled else 0.0
return rate, total_scheduled, total_checked
def get_habit_stats(db: Session, habit: Habit) -> HabitStats:
"""습관 생성일부터 오늘까지의 완료율과, 오늘(또는 어제)부터 거슬러 올라간 연속 달성일을 계산한다.
요일 스케줄은 현재 습관의 weekdays_mask를 과거에도 그대로 적용한 것으로 간주한다
(과거 요일 변경 이력은 추적하지 않음 — 월별/주별 집계와 같은 단순화).
"""
today = date.today()
start = habit.created_at.date()
checked_dates = set(db.scalars(select(HabitLog.log_date).where(HabitLog.habit_id == habit.id)))
scheduled_days = 0
checked_days = 0
d = start
while d <= today:
if habit.is_scheduled_on(d.weekday()):
scheduled_days += 1
if d in checked_dates:
checked_days += 1
d += timedelta(days=1)
completion_rate = round(checked_days / scheduled_days * 100, 1) if scheduled_days else 0.0
streak = 0
d = today
while d >= start:
if habit.is_scheduled_on(d.weekday()):
if d in checked_dates:
streak += 1
elif d != today:
break
# d가 오늘이고 아직 체크 전이면: 하루가 아직 안 끝났으니 스트릭을 끊지 않고 계속 거슬러 올라간다.
d -= timedelta(days=1)
return HabitStats(
completion_rate=completion_rate,
current_streak=streak,
scheduled_days=scheduled_days,
checked_days=checked_days,
)
def get_weekly_matrix(db: Session, user_id: int, week_start: date) -> list[WeeklyMatrixRow]:
"""week_start(호출측에서 정한 주 시작일, 현재 /history는 일요일을 사용)부터 7일간,
active 습관별 요일 체크 매트릭스를 반환한다. 이 함수 자체는 week_start가 어떤 요일이든 상관없다."""
week_days = [week_start + timedelta(days=i) for i in range(7)]
active_habits = habit_service.list_habits(db, user_id, status=HabitStatus.ACTIVE)
habit_ids = [h.id for h in active_habits]
checked_pairs: set[tuple[int, date]] = set()
if habit_ids:
rows = db.execute(
select(HabitLog.habit_id, HabitLog.log_date).where(
HabitLog.habit_id.in_(habit_ids), HabitLog.log_date.between(week_days[0], week_days[-1])
)
).all()
checked_pairs = {(r[0], r[1]) for r in rows}
today = date.today()
result = []
for h in active_habits:
checks: dict[str, bool | None] = {}
scheduled_past = 0
checked_past = 0
for d in week_days:
# 습관이 생성되기 전 날짜는 요일이 맞아도 "예정 없음"으로 취급한다.
if d < h.created_at.date() or not h.is_scheduled_on(d.weekday()):
checks[d.isoformat()] = None
continue
is_checked = (h.id, d) in checked_pairs
checks[d.isoformat()] = is_checked
if d <= today:
scheduled_past += 1
if is_checked:
checked_past += 1
completion_rate = round(checked_past / scheduled_past * 100, 1) if scheduled_past else 0.0
result.append(
WeeklyMatrixRow(
habit_id=h.id,
name=h.name,
habit_type=h.habit_type.value,
checks=checks,
completion_rate=completion_rate,
)
)
return result