칸반 보드

담당자별 백로그입니다. 티켓 1건 = 파일 1개(jekyll/_backlogs/)이므로 네 사람이 동시에 자기 티켓을 고쳐도 병합 충돌이 나지 않습니다. 주차별 목표는 8주 마일스톤, 일자별 기록은 개발 로그, 아직 정하지 못한 것은 미결 항목에 있습니다.

티켓 추가하는 법

jekyll/_backlogs/ 에 파일을 하나 만듭니다. 다른 사람 파일은 건드리지 않습니다.

---
title: "카카오 로그인 API 연동"
assignee: "류준"          # 정성윤 | 류준 | 장민석 | 조서희
role: "ai"                # infra | ai | app  (배지 색 — ai: 류준·장민석, app: 조서희)
status: "in-progress"     # todo | in-progress | done | cancelled
sprint: 1
priority: 5               # 같은 칸 안에서의 정렬 순서
date: 2026-08-25
paths:                    # (선택) 이 티켓 소관 파일 — 붙여두면 상태 갱신을 잊었을 때 경고해 줍니다
  - "apps/dashboard/*"
depends_on:               # (선택) 앞 단계 티켓. 일부러 나눈 단계는 중복 경고에서 빠집니다
  - "w2-baseline"
requirement:              # (선택) 이 티켓이 만드는 기능 ID — 카드에 기능 이름 배지로 붙습니다
  - "B-2"
---

무엇을 / 왜 / 완료 조건을 적습니다.

파일명은 w{주차}-{영문-슬러그}.md 로 짓습니다(예: w1-eval-ci.md). 한글 파일명은 URL이 깨집니다. 상태를 바꿀 때는 자기 티켓의 status 한 줄만 고칩니다.

requirement 는 기획서의 기능 ID를 그대로 씁니다 — 새 접두어를 만들지 않습니다. 같은 ID를 코드 파일 상단에도 # Requirement: B-2 로 답니다. 두 곳이 같은 ID라 백로그에서 코드까지 추적이 이어집니다.

보드에는 ID 가 아니라 기능 이름(「실시간 자막」·「문서 검색」·「추천 카드」…)으로 뜹니다. 프론트엔드가 카드만 보고 어느 화면을 짜야 하는지 바로 알 수 있게 하기 위해서입니다 — A-1·SEC-1 같은 코드는 화면을 만드는 쪽에서 읽히지 않습니다. ID→이름 대응은 kanban.markdown 안의 case 블록에 있고, 같은 이름으로 겹치면 배지 하나로 합칩니다(D-1+D-2 → 「통화 후 요약」). 정확한 ID 는 배지에 마우스를 올리면 보입니다.

배포·저장소 정리처럼 기능 ID 대상이 아닌 티켓은 비워 둡니다.

세션을 끝낼 때 python3 scripts/check_session_end.py 를 돌리면 상태가 실제와 어긋난 티켓과 중복 티켓을 알려줍니다. 진행 기록을 빠뜨리면 Stop 훅이 세션을 끝내지 못하게 막습니다.

← 개발목차로 돌아가기