AGENT PM 포트폴리오 · 서울고 1-1 학급사이트

흩어진 학급 정보(일정·급식·질문)를 한 곳에 모은 PM 프로젝트

서울고 1학년 1반 학생·학부모용 학급 정보 사이트를 기획부터 운영까지 맡았습니다. 메뉴마다 "왜 만들었는지"를 문제와 해결로 정리했습니다.

역할기획, PM, 운영(1인). 개발은 Claude Code와 협업
기간2026-07-12 착수, 운영 중
도구Next.js, Supabase, Vercel, GitHub Issues, NEIS 오픈 API, Playwright

핵심 숫자

17 / 17기획·관리 산출물 완료완료보고서
9일MVP 완성 (계획 5주)착수보고서·완료보고서
103건이슈 등록·종료 (114건 중)GitHub Issues
17회주간보고서01.관리문서
389건+총 커밋git log
88건테스트 케이스 정의완료보고서

문제 정의

서울고 1학년 1반은 학생·학부모가 확인해야 할 정보가 흩어져 있었습니다. 수행평가·과제 일정은 담임이 따로 공지해야 했고, 학사일정과 급식 정보는 NEIS에 따로 있었습니다. 질문은 로그인 없이 편하게 남기게 하되, 학급 구성원이 아닌 사람이나 사칭은 막아야 하는 조건도 있었습니다. 5주 커리큘럼 안에서 일정표·Q&A·급식안내·관리자도구·홈 대시보드 5대 기능을 갖춘 사이트를 1인(AI 협업)으로 기획부터 배포까지 완성하는 것이 과제였습니다.

화면별 기획 의도

메인·시간표·딸깍Q·개인 스케줄러 화면의 이름과 일정 내용은 모두 예시용 가짜 값입니다. 스케줄러는 캡처 직후 테스트 계정과 입력한 데이터를 전부 삭제했습니다. 실제 개인정보는 들어 있지 않습니다.

PM으로서 한 일

문서와 게이트로 일을 통제

착수보고서부터 완료보고서까지 17단계 산출물을 의존관계(Document Chaining)로 정의하고, 전제조건을 확인한 뒤 생성
완료보고서(#17) 이후 운영 단계의 요청·버그도 GitHub Issues로 계속 추적해 이력이 끊기지 않게 함

이슈 기반 변경 관리

사용 중 들어온 요청·버그는 작업 전 이슈부터 만들고, 커밋에 closes로 연결해 자동으로 닫음
관리자 홈 메인 링크 누락처럼 작은 사용성 공백도 이슈로 남겨 추적(#115)

주간 보고와 운영 습관

요청일 기준 7일 창으로 주간보고서 17회 작성, 완료 항목·이슈 현황·차주 계획을 고정 형식으로 기록
무관한 기존 타입 에러로 배포가 막힌 경험 이후, 배포 전 타입체크(tsc --noEmit)를 습관화

범위와 판단 변경

인증 방식을 착수 시 정의(이름+비밀번호)에서 명단대조+PIN으로 변경 — 사칭 방지가 편의성보다 중요하다고 판단
급식 아이콘 카드는 2칸 레이아웃을 유지하기로 하고, 칸을 늘리는 대신 조합 규칙(COMBO_PAIRS)으로 해결

의사결정 사례

01

화면을 늘리지 않고, 규칙으로 일반화해서 해결

급식 카드는 반찬/밥 2칸뿐인데, 전용 아이콘이 있는 메뉴 두 개가 같은 날 겹치면 하나만 보였습니다. 3번째 칸을 추가할지 사용자에게 직접 물었고, 카드 레이아웃은 그대로 두고 밥 칸을 두 번째 메뉴로 대신 채우는 쪽을 선택했습니다. 이후 비슷한 조합이 생길 때마다 목록(COMBO_PAIRS)에 한 줄만 추가하면 되는 구조로 일반화했습니다.

02

증상만 보고 원인을 단정하지 않기

메뉴에 없는 잡곡밥 아이콘이 뜬다는 제보를 받았습니다. 코드만 보고는 원인을 찾지 못했고, 실제 그날 NEIS 메뉴 데이터를 다시 받아 대조한 끝에 "옥수수크림스프"의 "수수"가 잡곡밥 정규식의 "수수"와 겹쳐 오매칭된 것을 찾았습니다. 추측으로 고치지 않고 실제 데이터로 재현한 뒤 고쳤습니다.

03

착수 시 정의와 다르게, 인증 방식을 바꾸기

무로그인(이름+4자리 비밀번호) 게시판으로 시작했지만, 이름은 같은 반 학생 누구나 아는 공개 정보라 그것만으로는 사칭을 막을 수 없다는 걸 확인했습니다. 학급 명단 대조와 개인 PIN을 추가하는 쪽으로 바꿨고, 당초 설계보다 가입 절차가 늘어나는 비용을 감수했습니다(완료보고서).

04

RLS(행 수준 보안) 점검을 습관으로 만들기

Supabase는 공개 키(anon key)만으로도 RLS(행 수준 보안)가 없으면, 서버가 PIN을 아무리 철저히 검증해도 테이블에 직접 접근할 수 있다는 걸 확인하고 정기 점검 절차를 만들었습니다. 존재하지 않는 가짜 row id로 쓰기 테스트를 하면 막혀도 안 막혀도 똑같은 응답이 와 오판하기 쉽다는 것도 실수를 통해 배워 점검 절차에 반영했습니다.

회고

잘한 점문제가 생길 때마다 이슈로 남기고 원인을 기록해, 같은 실수가 반복되지 않게 함
아쉬운 점자동화 테스트를 8일차에야 도입해 초기 검증을 대부분 수동에 의존함(완료보고서)
배운 점증상만 보고 원인을 단정하지 않고 실제 데이터로 재현한 뒤 고치는 습관이, 추측으로 고쳤다가 다시 고치는 시간을 줄여 줌