Project brief
프로젝트 내용
[프로젝트 개요]
- 한국어 강사용 웹 서비스를 운영하고 있으며, 이미 운영 중인 서비스를 점검해 주실 업체를 찾고 있습니다. 새로 개발하는 일이 아니라 검수 작업입니다.
- 점검에서 문제가 나오면 수정은 제가 직접 하고, 업체에서는 문제마다 어떻게 고치면 되는지 알려 주신 뒤 고친 결과를 다시 확인해 주시면 됩니다. 기능 추가나 수정 개발은 범위에 포함하지 않습니다.
[클라이언트 소개]
- 한국어 강사용 웹 서비스를 운영하는 1인 사업자입니다. 강사가 이용권을 결제해 쓰는 유료 서비스이며, 학생(성인 외국인)은 계정 없이 휴대폰으로 입장합니다.
- 프로젝트 의사결정 구조: 대표 1인이 요구사항 확정부터 계약·최종 승인까지 직접 합니다.
- 개발 지식: 개발자가 아닙니다. 서비스는 처음부터 AI 코딩 도구(Claude Code)로 만들어 배포했고, 수정도 같은 방식으로 직접 합니다.
[프로젝트 배경 및 목표]
- 지금 상황: 서비스는 이미 배포되어 운영 중이며, 이번 검수는 지자체 지원사업으로 진행합니다. 지원사업 정산 일정 때문에 대금 지급일과 1차 결과보고서 제출일이 정해져 있습니다.
- 끝나면 이렇게 되기를 바랍니다: 유료 서비스로서 기본이 갖춰져 있는지(보안, 결제, 데이터 보호, 백업과 복구, 실제 수업이 잘 돌아가는지) 확인하고, 나온 문제를 제가 직접 고친 뒤 재검수까지 마치는 것입니다.
- 다만 이런 점이 우려됩니다: 비개발자 혼자 수정해야 하므로, 점검 결과를 설명받아도 충분히 이해하지 못하거나 받은 권고를 어디까지 그대로 적용해도 되는지 판단하기 어려울 수 있습니다.
[필수 과업 범위와 결과물]
1. 수행 범위
- 테스트·QA: 운영 중인 서비스의 환경·DB·복구, 보안, 부하, 실제 기기·결제 점검
- 수정 방향 제시: 문제마다 어떻게 고치면 좋을지 의견을 주시고, 구조를 크게 바꿔야 하는 문제는 어떤 방향으로 갈지까지 정해 주시면 됩니다. 수정은 제가 AI 코딩 도구로 직접 합니다.
- 재검수: 수정 후 1회
- 문서화: 인수 문서 작성과 원격 실습 1회
- SW 개발: 포함하지 않습니다.
2. 상세 점검 요구 사항
- 항목별 상세 내용은 첨부한 견적요청서(6쪽)에 있습니다.
2-1. 점검 대상 서비스
- 강사 화면: 자료 만들기, 교실 게임 수업, 숙제, 리포트, 이용권 결제
- 학생 화면: 계정 없이 PIN 또는 QR로 휴대폰에서 입장 (성인 외국인)
- 운영자 화면: 관리자 화면 (추가 인증)
2-2. 환경·DB·복구 점검
- 시험용 서버 점검: 운영과 분리된 Supabase·Vercel 시험 환경 점검 및 운영 서버와의 차이 정리
- DB 변경 적용 절차 점검: 빈 DB에 새로 구축 1회, 기존 버전에서 변경 1회
- 백업 복원: 별도 환경에 실제 복원 1회
- 되돌리기 점검: 이전 버전으로 되돌리기 (목표: 4시간 안 재개, 데이터 손실 최대 24시간)
2-3. 보안 점검
- 권한별 직접 호출: 비로그인·학생·강사·관리자 권한으로 RLS, RPC, API, Storage 직접 호출 확인
- 점검 시나리오: 다른 강사 자료 접근, 권한 상승, 유료 기능과 AI 사용량 제한 우회, 점수 조작, 결제 금액 조작, 다른 사람 주문 환불 등
2-4. 부하·기기·결제 점검
- 부하 시험: 대표 게임 1개, 반당 30명 기준 1반·3반·5반 단계별 증가 후 5반(150명) 30분 유지
- 부하 시험 선택 견적: 10반 이상 또는 60분 이상은 별도 선택 견적
- 실제 기기 점검: 안드로이드 Chrome, 아이폰 Safari, PC 각 1대
- 결제 시험: 승인·실패·중복·취소 점검 (나이스페이 시험 환경)
- 실제 결제 확인: 나이스페이 정식 승인 뒤 제가 직접 결제, 업체에서 결과 확인
2-5. 운영 준비·인수·재검수
- 운영 준비 점검: 운영 전반 준비 상태 점검
- 인수 문서: 기술 문서로 작성. 단 운영자가 화면에서 직접 하는 작업(백업 복원, 이전 버전으로 되돌리기, 계정 복구, 장애 시 첫 조치)은 비개발자도 이해할 수 있는 수준으로 작성
- 운영자 실습: 원격 1회 (복구, 되돌리기, 검사 다시 돌리기)
- 재검수: 수정 후 1회
3. 결과물
- 1차 결과보고서: 지자체 제출용, 제출 시점까지 진행한 작업 기준
- 최종 점검 결과보고서: 문제별 원인과 수정 방향 포함
- 재검수 결과
- 인수 문서
[기술 스택]
- Frontend·Backend: Next.js 16 (TypeScript)
- DB·인증·저장소: Supabase (PostgreSQL, RLS, RPC, Auth, Storage)
- 배포: Vercel
- 외부 연동: Google Gemini API, 나이스페이 단건 결제
[클라이언트 준비 사항]
- 준비된 것: 운영 중인 서비스, 운영과 분리된 시험용 서버(Supabase·Vercel), 나이스페이 시험 환경, 견적요청서(6쪽)
- 준비 중인 것: 나이스페이 정식 승인
[오픈 시점과 예산]
- 목표 시점: 1차 결과보고서는 11월 13일이면 좋고, 늦어도 11월 18일까지 필요합니다(지자체 제출용, 그때까지 하신 작업 기준). 대금 지급(11월 14일)과 1차 결과보고서(11월 18일)는 지원사업 정산 일정 때문에 바꾸기 어렵습니다.
- 진행 일정: 10월 27일 견적 회신, 10월 30일 계약(목표), 11월 2일 시작(보안, 결제, 복구부터), 11월 14일까지 대금 지급 완료
- 나머지 작업: 시작 후 4~6주 안에 마무리하면 됩니다. 짧은 기간에 전부 끝내야 하는 일은 아니며, 자세한 일정은 미팅에서 조율합니다.
- 예산: 1,000만원
- 첨부한 요청서의 항목을 모두 포함해 견적을 주시고, 예산 안에서 어려운 항목이 있다면 빼지 마시고 어느 항목인지, 어떻게 줄이면 가능한지, 원래대로 하면 얼마인지 따로 적어 주세요.
[제안 포함 필수 사항]
- 지원 내용은 아래 기준으로 검토합니다.
1. 점검 방법과 사용할 도구, 그 선택 이유를 제안에 포함해 주세요. 저는 개발자가 아니므로 비개발자가 이해할 수 있는 수준으로 적어 주시면 도움이 됩니다.
2. 파트너님께서 판단하시기에 어떤 부분이 완료되어야 이번 검수가 성공적으로 마무리되었다고 보시는지 제안에 포함해 주세요. 전문가로서 이번 검수의 결과물에 대한 의견 부탁드립니다.
3. 문제별 수정 권고를 어떤 형태로 주실지(원인과 방향 수준인지, AI 코딩 도구에 입력할 수 있는 지시 수준인지)와, 제가 고친 결과를 어떻게 확인해 주실지 제안에 포함해 주세요. 비개발자인 제가 권고를 직접 적용해야 하므로 이 부분을 특히 중요하게 보고 있습니다.
4. 착수부터 1차 결과보고서(11월 18일)까지의 작업 순서와 주차별 일정을 제안에 포함해 주세요.
[견적 시 함께 부탁드립니다]
- 항목별 금액과 부가세 포함 총액 (지자체 지원사업에 낼 산출 견적서 형식)
- 보안 담당과 DB·성능 담당을 실제로 배정할 수 있는지 (일부 협력사와 함께하셔도 되고, 계약은 한 곳과 합니다)
- 비슷한 작업 경험 (웹 보안 점검, 부하 시험, 복구 점검)
- 계약 때 필요한 서류: 계약서, 사업자등록증, 통장 사본, 청구서 (계좌이체로 지급하면 전자세금계산서도 필요)