Feature/daily-close

[zzimin25]

종류

• ✨ 기능 (feat)
• 🐛 버그 수정 (fix)
• 🎨 디자인 / UI
• 📝 문서 (docs)
• 🔧 설정 / 잡무 (chore)

무엇을 / 왜

하루 단위로 수입·지출 기록을 확인하고 마감할 수 있는 Daily Close 기능을 구현
마감 시 당일 기록 여부를 확인하고, 하루 1회만 마감할 수 있도록 처리했으며 연속 마감일(streak_days)이 갱신되도록 구현
또한 하루 마감 화면에서 오늘의 수입·지출과 현재 잔액을 확인할 수 있도록 연결하고 피그마를 기준으로 UI를 구현

관련 이슈

Closes #32

변경 사항

ledger/services.py

• get_today_record_summary() 추가
  • 오늘 날짜 기준 EarnRecord, SpendRecord 조회
  • 오늘의 수입/지출 합계 및 기록 존재 여부 반환
• close_today() 추가
  • 동일 날짜 중복 마감 방지
  • 기록이 없는 경우 빈 마감 방지 처리
  • 마감 시 DailyClose 생성
  • 전날 마감 여부에 따라 streak_days 갱신

ledger/views.py

• 하루 마감 페이지를 처리하는 View 추가
• get_today_record_summary()를 이용해 오늘의 수입/지출 데이터를 템플릿에 전달
• get_current_balance()를 연결해 현재 잔액을 템플릿에 전달
• POST 요청 시 close_today()를 호출하도록 연결
• 마감 여부 및 에러 메시지를 템플릿에 전달하도록 처리

budget/services.py

• get_week_range() 및 get_current_balance() 공용 잔액 함수 선반영
• 주간 예산 + 해당 주 수입 - 해당 주 지출을 기준으로 현재 잔액 계산

⚠️ 해당 코드는 지아 PR에서 구현된 공용 잔액 함수를 기준으로 가져온 코드입니다.
지아님 PR이 아직 develop에 머지되지 않아 하루 마감 기능과의 연결 및 테스트를 위해 우선 반영했습니다.
추후 해당 PR 머지 후 중복되는 부분은 정리할 예정입니다.

ledger/templates/ledger/daily_close.html

• 하루 마감 페이지 신규 생성
• 오늘의 지출 / 오늘의 수입 / 현재 잔액 출력
• streak_days 출력
• 마감 전 하루 마감하기, 마감 후 마감완료! 상태 분기
• 지출 기록이 없을 경우 오늘은 안 봤어요 문구 자동 표시 / 기록이 전혀 없으면 마감 버튼 비활성화
• 마감 요청을 위한 POST form 및 CSRF 처리

ledger/static/ledger/css/daily_close.css

• 하루 마감 페이지 전용 CSS 신규 생성
• 피그마 기준 수입/지출/잔액 카드 및 체크 아이콘 스타일 적용
• streak 안내 영역 및 마감 버튼 스타일 적용
• 마감 전/완료 화면에 필요한 레이아웃 구현

테스트 방법

1. 하루 마감 페이지 접속

서버 실행 후 아래 주소로 접속

http://localhost:8000/ledger/daily-close/

---

2. 기록이 없는 상태 확인

오늘 날짜의 수입/지출 기록이 없는 상태에서 페이지를 확인

확인 사항

• 오늘의 지출 → 오늘은 안 봤어요
• 오늘의 수입 → 0분
• 잔액이 정상적으로 표시되는지 확인
• 하루 마감하기 버튼이 회색으로 비활성화되는지 확인
• 연속 마감 일수가 정상적으로 표시되는지 확인

---

3. 수입 기록 추가 후 확인

터미널에서 Django shell을 실행

docker-compose exec web python manage.py shell

shell에서 테스트용 수입 기록을 추가

from django.contrib.auth import get_user_model
from django.utils import timezone
from budget.models import Activity
from ledger.models import EarnRecord

User = get_user_model()
user = User.objects.get(username="테스트할_유저명")

activity = Activity.objects.create(
    users=user,
    activity_type="독서",
    rate=0.5,
)

now = timezone.now()

EarnRecord.objects.create(
    users=user,
    activity=activity,
    earn_min=30,
    verify_method="test",
    photo_url="",
    earn_date=timezone.localdate(),
    earn_start=now,
    earn_end=now,
)

기록 생성 후 하루 마감 페이지를 새로고침

확인 사항

• 오늘의 수입에 활동명 + 30.00분 형식으로 표시되는지 확인
• 잔액이 수입 기록만큼 증가하는지 확인
• 하루 마감하기 버튼이 주황색으로 활성화되는지 확인

---

4. 지출 기록 추가 후 확인

같은 Django shell에서 테스트용 지출 기록을 추가

from ledger.models import SpendRecord

SpendRecord.objects.create(
    users=user,
    spend_date=timezone.localdate(),
    category="숏폼",
    duration_min=10,
    spend_start=now,
    spend_end=now,
)

기록 생성 후 페이지를 새로고침

확인 사항

• 오늘의 지출에 숏폼 10분이 표시되는지 확인
• 잔액이 지출 기록만큼 감소하는지 확인
• 수입 / 지출 / 잔액 값이 정상적으로 반영되는지 확인

---

5. 하루 마감 완료 상태 확인

활성화된 하루 마감하기 버튼을 클릭

확인 사항

• 하루 마감이 정상적으로 처리되는지 확인
• 버튼이 마감완료!로 변경되는지 확인
• 연속 마감 일수가 정상적으로 반영되는지 확인
• 새로고침 후에도 마감 완료 상태가 유지되는지 확인

스크린샷

체크리스트

• 로컬에서 실행해봤고 안 깨진다 (docker-compose up)
• 커밋 컨벤션(feat:, fix:, docs: ...)을 지켰다
• .env 등 시크릿은 커밋에 포함되지 않았다
• 리뷰어 2명 이상 지정했다