Skip to content

feat: #1 planner 모델 작성 - #2

Merged
h2ew0n merged 3 commits into
devfrom
feature/#1-planner-models
Jul 29, 2026
Merged

feat: #1 planner 모델 작성#2
h2ew0n merged 3 commits into
devfrom
feature/#1-planner-models

Conversation

@wngjs8114

@wngjs8114 wngjs8114 commented Jul 27, 2026

Copy link
Copy Markdown
Collaborator

관련 이슈

Closes #1

작업 내용

planner 앱의 핵심 모델 작성 및 마이그레이션 확인

  • DailyPlan: 날짜별 학습 계획 (시험, 날짜, 가용시간, 계획시간, 상태)
  • DailyPlanItem: 계획 내 개별 작업 항목 (계획 생성 당시 planned_minutes를 별도 저장 → 이후 StudyTask 예상시간이 바뀌어도 과거 계획 기록 불변)
  • ProgressLog: 진행 결과 기록 (완료/일부완료/못함, 실제 진행시간·진행량)
  • RecoveryPlan: 복구안 (분량 유지형 / 핵심 집중형)
  • RecoveryPlanItem: 복구안 내 개별 작업 변경 내역 (원래 날짜, 변경 날짜, 액션 타입, 사유)

참고 사항

  • plannerexams.Exam, exams.StudyTask를 FK로 참조하는 구조라, 로컬에서는 exams/models.py를 임시로 채워서 makemigrations/migrate가 정상 동작하는지 검증했습니다.
  • 이번 PR에는 planner/models.pyplanner/migrations/0001_initial.py만 포함되어 있으며, exams/accounts/core/choices.py는 담당자(장희원) 확정 후 별도 PR로 올라갈 예정입니다.
  • core.choicesDailyPlanStatus, ProgressStatus, RecoveryType, RecoveryPlanStatus, RecoveryActionType은 로컬 테스트 시 사용한 Enum이며, 실제 core/choices.py에는 아직 반영되지 않았습니다. 병합 전 공통 Enum 정의 관련 팀 합의가 필요합니다.

테스트

  • python manage.py makemigrations 정상 동작 확인
  • python manage.py migrate 정상 동작 확인 (exams 임시 모델 기준)
  • exams 모델 확정 후 실제 FK 연결 재검증 필요
  • study_task FK: CASCADE → PROTECT 변경 (과거 계획/복구 기록 보존)
  • ProgressLog.daily_plan_item: ForeignKey → OneToOneField (하루 1회 결과 입력 정책)
  • completed_amountcompletion_percent(0~100)로 단위 명확화
  • RecoveryPlan.recovery_group_id(UUID) 추가 — 같은 계산 시점에 생성된 분량유지형/핵심집중형을 그룹으로 묶어 비교 가능
  • exams.Exam, exams.StudyTask → 문자열 참조('exams.Exam')로 변경, 직접 import 제거
  • planner/admin.py 5개 모델 등록
  • 중복 import 제거

Shell 검증 완료

  • ProtectedError 정상 발생 (StudyTask 삭제 시 PROTECT 작동 확인)
  • item.progress_log OneToOne 역참조 정상
  • 동일 recovery_group_id로 생성한 두 RecoveryPlan 정상 필터링 (count=2)

보류 중 (미해결)

  • exams 모델/공통 choices가 아직 dev에 없어 여전히 병합 불가 상태 — BE2(exams) PR 대기 중, 해당 PR 머지 후 rebase 예정
  • 상태 이중화(DailyPlanItem.status vs ProgressLog.progress_status) 동기화는 서비스 레이어(planner/services/) 구현 시 반영 예정. ProgressLog를 상태의 기준(source of truth)으로 삼고, 갱신 시 트랜잭션으로 함께 처리하는 방향으로 진행하겠습니다.

exams 쪽 진행 상황 공유되면 바로 rebase하겠습니다.

업데이트 (ExamPeriod 구조 반영)

ExamPeriod가 전체 시험기간, Exam이 개별 과목으로 분리됨에 따라
DailyPlan과 RecoveryPlan의 참조 대상을 ExamPeriod로 변경했습니다.

최종 migration은 exams 모델 병합 후 다시 생성할 예정입니다.

리뷰 요청

@h2ew0n — planner가 참조하는 exams.Exam / exams.StudyTask 필드 구조가 이 방향으로 맞는지 확인 부탁드립니다.

- study_task FK를 CASCADE에서 PROTECT로 변경 (과거 계획 기록 보존)
- ProgressLog를 OneToOneField로 변경 (하루 한 번 결과 입력 정책)
- completed_amount를 completion_percent(0~100)로 명확화
- RecoveryPlan에 recovery_group_id(UUID) 추가 (분량유지형/핵심집중형 비교 그룹)
- exams.Exam, exams.StudyTask 참조를 문자열 참조로 변경
- planner/admin.py 등록
- shell 테스트로 PROTECT, OneToOne, group_id 정상 동작 검증
@wngjs8114
wngjs8114 marked this pull request as draft July 27, 2026 09:54
@wngjs8114

Copy link
Copy Markdown
Collaborator Author

BE2(exams) 모델이 dev에 병합돼서, planner를 최신 ExamPeriod 구조 기준으로 rebase하고 migration을 재생성했습니다.

참고: makemigrations 실행 시 exams 쪽에서 id 필드 alter 마이그레이션(0003)이 자동으로 같이 생성되는데, 이건 planner와 무관한 exams 자체 이슈로 보여서 별도로 장희원에게 공유하겠습니다.

@wngjs8114
wngjs8114 marked this pull request as ready for review July 29, 2026 07:21
@h2ew0n
h2ew0n merged commit f98a136 into dev Jul 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

planner 모델 설계 (DailyPlan, DailyPlanItem, ProgressLog, RecoveryPlan, RecoveryPlanItem)

2 participants