✨ Feat: 과제 public.assignment 이중 저장 (Spring 조회 노출)

[naooung]

배경

과제가 chapter_studio.assignment에만 저장돼 public.assignment가 비어 있어 Spring/프론트에서 과제가 조회되지 않았다. 슬라이드/퀴즈/노트는 이미 두 스키마에 이중 저장되고 있어 동일 패턴으로 과제도 맞췄다.

변경

• persistence_sql.py: public_assignment_sql(), public_delete_assignment_sql() 추가
• public_persistence.py: _insert_public_assignment() 추가, persist_public_content 시퀀스(슬라이드→퀴즈→노트→과제)에 연결, 삭제 섹션에 chapter_id 선삭제 추가
• 테스트: test_public_assignment_persistence.py 신규 (컬럼 매핑, steps 빈 경우 total_questions=1 보정, title 폴백)

컬럼 매핑 (chapter_studio source → public.assignment target)

public.assignment	값
id	new_id("asg") (Spring chk_asg_id 정규식과 동일 형식)
user_id (NOT NULL)	context.user_id (course owner / 학습자)
course_id	context.tutoring_id
chapter_id	context.lesson_id
status (NOT NULL)	"active" (Spring AssignmentStatus 초기값)
title	assignment_meta.title (없으면 prompt 첫 줄)
description	assignment_seed (과제 프롬프트)
total_questions (NOT NULL)	len(steps) (steps 비면 1)
questions	_json(steps)
created_at / updated_at	NOW() (SQL)

source 값은 chapter_studio.assignment를 쓰는 _insert_assignment와 같은 헬퍼(state_text/state_record/record_default_str_list/record_default_text/first_line)로 읽어 두 스키마 내용이 어긋나지 않게 했다.

안전성

• Spring은 assignment를 읽기만 하므로 쓰기 충돌이 없다.
• persist_chapter_state 7/7 단계의 같은 트랜잭션 안에서 실행한다 (새 트랜잭션을 열지 않는다).
• chapter_id 선삭제(slide와 동일한 idempotent delete 패턴) → 재생성 멱등. ON CONFLICT (id)는 PK 충돌 안전망으로 유지.
• public.assignment에 chapter_id UNIQUE 제약이 없어(PK는 id) ON CONFLICT (id)만으로는 재생성 시 중복이 생길 수 있으나, delete-first가 이를 막는다.

검증

• uv run python -m compileall app/modules/ChapterStudio_V1 통과
• pytest -k "public or persist or assignment" → 21 passed (신규 3 포함), 0 failed

🤖 Generated with Claude Code