TContext
교사의 교육관, 수업 방식, 학급 맥락과 현실적 제약을 반구조화 인터뷰로 정리해 여러 생성형 AI에서 재사용할 수 있는 Markdown 컨텍스트 문서로 만드는 개인정보 보호 중심 웹앱입니다.
TContext는 교사를 점수화하거나 MBTI처럼 유형화하지 않습니다. AI가 만든 모든 문장과 분석 태그는 교사가 직접 검토·수정·삭제·확정합니다.
주요 기능
- 로그인 없는 약 20분 교사 인터뷰
- 유치원·초등·중학교·고등학교 및 8개 역할별 질문 분기, 중고등학교 담당 교과 선택
- 고정 핵심 질문과 최대 4개의 제한된 AI 후속 질문
- 직접 진술, AI 추론, 확인 필요 근거 구분
- 7개 모듈의 Zod 검증 구조화 프로필
- 교사가 모든 문장과 controlled tag를 검토하는 편집 화면
- 연수용으로 입력 단계는 차단 없이 규칙 기반 개인정보 경고만 표시하고(교사가 고치거나 그대로 계속), 최종 OpenAI 개인정보 검토와 경고 확인 후 로컬 내보내기를 제공
- 수업별 작업 YAML과 실행 지침을 포함한 범용 Markdown 다운로드·복사·인쇄
- 저장 없이 전체 기능 사용
- 별도 동의가 있을 때만 최종 결과를 Supabase에 선택 저장
- 제출 ID와 일회성 삭제 코드를 이용한 비로그인 삭제
- 일일 정리 간격을 포함한 최대 365일 실제 보유기간과 보호된 Vercel Cron 삭제
서비스 흐름
- 개인정보 입력 주의사항 확인
- 학교급과 역할 선택, 중고등학교는 담당 교과 선택
- 한 화면에 한 질문씩 답변
- 필요한 경우에만 AI 후속 질문
- 구조화 프로필 초안 생성
- 근거 상태별 문장과 AI 작성 제목·요약·원칙·지침 수정·삭제·확인
- 분석 태그 확인
- 개인정보 최종 검토(수정 또는 명시적 경고 확인)
- Markdown 다운로드·복사·인쇄
- 개인정보 검토가
clear인 경우에만 원하는 최종 결과 기여
- 저장 영수증과 삭제 코드 보관
원본 답변은 React 메모리에만 남으며 Web Storage, 쿠키, IndexedDB에 기록하지 않습니다. sessionStorage에는 학교급·역할·중고등학교 담당 교과·현재 질문 위치 같은 비민감 진행 메타데이터만 남습니다. 새로고침하거나 탭을 닫으면 답변을 복구할 수 없습니다.
로컬 프로파일 보관과 버전 기록
교사가 로컬 저장을 켠 경우에만 확정본과 편집 초안을 이 브라우저의 IndexedDB에 최대 10개 보관합니다. /profiles에서 다시 열기·수정·삭제·JSON 백업 가져오기를 할 수 있고, 저장 동의 없이도 Markdown·JSON 다운로드와 JSON을 메모리에만 열기가 가능합니다. 서버에 보내는 선택적 기여와는 별개입니다. 공용 기기에서는 보관에 주의하고, 브라우저 데이터 정리로 사라질 수 있으므로 JSON 백업을 권장합니다.
내용을 바꾸어 확정하면 이전 확정본을 프로파일마다 최대 5개 보관합니다. 전체본 Markdown 내용이 같으면 새 버전을 만들지 않습니다. 버전 기록에서 바뀐 영역과 현재 문서를 비교하고 이전 버전을 복원하거나 삭제할 수 있습니다. 복원하면 그 버전의 원래 확정일을 유지하고, 지금 확정본은 이력에 남습니다. 편집 중인 초안이 있으면 먼저 확정하거나 버려야 복원할 수 있습니다.
연결된 확정본과 현재 문서 내용이 같을 때 Markdown 복사·다운로드와 skill ZIP 다운로드가 성공하면 대상별 최근 내보내기 기록을 최대 10건 보관합니다. 기록은 대상·형식·내보낸 날짜·확정일만 담으며 내보낸 내용, 모듈 선택, 외부 계정 정보는 저장하지 않습니다. 문서를 바꾸면 이전 버전을 내보낸 곳과 교체 방법을 안내하지만, 외부 서비스에 실제로 등록했는지는 알 수 없습니다.
기존 v1 기록은 읽을 때 v2로 변환하고 다음 쓰기에서 저장합니다. JSON 백업 형식은 유지하며 선택한 현재 확정본 또는 초안 하나만 담습니다. 버전 이력과 내보내기 기록은 백업에 포함하지 않습니다.
“이 탭의 모든 기록 삭제”는 메모리와 진행 메타데이터를 지우며 저장된 프로파일은 유지합니다. /profiles 또는 /privacy의 “로컬 저장 끄고 모두 삭제”는 IndexedDB와 저장 설정을 지웁니다. 로컬 문서는 교사나 브라우저가 삭제할 때까지 보관하며 서버 기여의 보유기간과는 다릅니다.
기술 구성
- Next.js 16 App Router, React 19, TypeScript strict
- Tailwind CSS 4, shadcn/ui, Lucide
- React Hook Form, Zod
- OpenAI JavaScript SDK와 Responses API Structured Outputs
- Supabase JavaScript SDK, PostgreSQL RLS
- Vitest, React Testing Library, Playwright
- pnpm, ESLint, Prettier
- Vercel
OpenAI와 Supabase Secret Key를 사용하는 코드는 모두 Next.js Route Handler 및 server-only 모듈에 한정됩니다. 브라우저에서 두 서비스로 직접 요청하지 않습니다.
OpenAI 모델
| 작업 | 환경 변수 | 기본값 | reasoning effort |
|---|
| 후속 질문 판단·생성 | OPENAI_INTERVIEW_MODEL | gpt-5.6-luna | none |
| 전체 프로필·Markdown 내용 생성 | OPENAI_PROFILE_MODEL | gpt-6-luna | medium |
| 최종 개인정보 검토 | OPENAI_PRIVACY_MODEL | gpt-5.6-terra | low |
모델은 환경 변수로 교체할 수 있습니다. 교체 전 Structured Output 호환성, Zod 검증, 충실성, 개인정보 평가를 다시 실행해야 합니다. 비용은 OpenAI 계정의 해당 모델 입력·출력 토큰 단가에 따라 달라지므로 운영 시 실제 사용량과 공식 가격표를 확인하세요. 애플리케이션 로그에는 모델명, 처리 시간, 토큰 사용량, 성공 여부만 남기며 질문·답변·프로필 본문은 남기지 않습니다.
Supabase 저장 구조
public.teacher_context_submissions에는 사용자가 최종 확인하고 명시적으로 동의한 경우에만 다음을 저장합니다.
- canonical
profile_json
- 동일 JSON에서 만든
profile_markdown
- 사용자가 확인한
confirmed_tags
- 최종
privacy_review
- 학교급·역할·중고등학교 담당 교과 및 스키마·프롬프트·앱·동의·모델 버전
- 동의 시각, 보유 만료 시각
- 삭제 코드의 해시
원본 인터뷰의 전사본이나 별도 답변 필드, 이름, 이메일, IP 주소, 실제 학교명, 학생명, 브라우저 식별자, 삭제 코드 원문은 저장하지 않습니다. 교사가 근거별 문장과 AI 작성 제목·요약·원칙·지침을 검토한 최종 프로필만 선택적으로 저장하며, 이 프로필에는 학교급·학년·교과·대략적인 학급 규모·수업 환경·익명 집단 경향처럼 인터뷰에서 확인한 수업 맥락이 요약될 수 있습니다. RLS를 강제하고 anon 및 authenticated에는 읽기·쓰기 정책과 권한을 주지 않습니다.
선택적 데이터 기여
Markdown 다운로드가 가장 중요한 동작이며 데이터 기여는 별도 보조 동작입니다. 체크박스는 기본 해제 상태이고, 저장 항목·목적·최대 365일 실제 보유기간을 확인한 사용자가 명시적으로 동의해야만 서버가 저장합니다. 기본 정책에서는 일일 정리 작업이 끝날 때까지의 최대 하루를 보유기간 안에 포함하기 위해 기여 364일 뒤 삭제 대상으로 전환합니다.
저장 시 반환되는 tcontext-submission-receipt-{submissionId}.txt에는 제출 ID와 일회성 삭제 코드가 들어 있습니다. 로그인이나 이메일을 수집하지 않으므로 이 코드를 잃으면 제출물을 다시 찾거나 삭제하기 어렵습니다.
삭제는 /delete에서 제출 ID와 삭제 코드를 입력해 실행합니다. 서버는 코드 원문을 저장하지 않고 안전한 해시만 비교합니다. 저장된 프로필을 공개 API로 다시 조회하는 기능은 없습니다.
관리자 문서 열람
/admin은 운영자가 명시적 동의를 받아 저장된 최종 문서를 읽기 전용으로 확인하는 비공개 화면입니다. 목록·학교급 필터·상세 문서·저장된 Markdown 원문과 다운로드를 제공하며, 삭제 코드 해시와 원본 인터뷰 답변은 조회하지 않습니다. 공개 메뉴에는 관리자 링크를 노출하지 않습니다.
로컬 관리자 자격증명은 다음 명령으로 생성합니다. 비밀번호는 한 번만 표시되므로 비밀번호 관리자에 보관하고 개발 서버를 다시 시작하세요.
pnpm admin:setup
Vercel에서는 생성된 ADMIN_PASSWORD_HASH, ADMIN_SESSION_SECRET, ADMIN_SESSION_TTL_HOURS를 Preview와 Production에 각각 설정합니다. 관리자 세션은 서명된 HttpOnly 쿠키를 사용하며 기본 유효시간은 8시간입니다.
Markdown
구조화 JSON이 canonical source이며 Markdown은 그 JSON에서 결정적으로 생성됩니다. 전체본의 문서 형식 2.0에는 익명 메타데이터, 목적과 해석 원칙, 근거 상태가 구분된 7개 모듈, 수업 설계 원칙, 지원 고려사항, 현실적 제약과 대체안, AI 협업 지침, 생성 결과 점검표가 포함됩니다. 분석용 태그는 canonical JSON에만 유지하고 수업 설계용 본문에는 노출하지 않습니다.
전체본 끝에는 교과·단원·성취기준·시간처럼 수업마다 달라지는 정보를 적는 YAML 양식과 다른 AI에 함께 전달할 짧은 실행 프롬프트가 들어갑니다. 현재 수업의 정보가 장기 교사 프로필과 다르면 현재 작업 정보를 우선합니다. 관리자 화면은 새 형식과 이미 동의받아 저장된 구형 Markdown을 모두 검증해 열람합니다.
결과 화면의 “필요한 만큼만 전달하기”에서 세 형식을 선택해 실제 전달 내용을 미리보고, 복사하거나 BOM을 포함한 UTF-8 Markdown으로 내려받을 수 있습니다. AI 활용 가이드의 교사 Markdown 다운로드에서도 같은 형식을 고를 수 있습니다.
| 형식 | 담는 내용 |
|---|
| 전체본 | 기존 문서 형식 2.0의 모든 모듈과 수업 작업 양식 |
| 핵심본 | 교사가 검토한 전체·모듈 요약과 수업 원칙·학급 지원·제약·AI 협업 지침. 개별 진술 문장과 수업별 작업 양식·실행 프롬프트는 생략 |
| 모듈 선택본 | 선택한 모듈과 선택 섹션. 포함 범위 안내와 AI 협업 지침·판단 경계는 항상 포함 |
핵심본 2.0은 교사가 검토한 요약과 종합 목록을 원문 그대로 담습니다. 사용 규칙에서 AI가 종합하고 교사가 확인한 내용임을 밝히며, 개별 진술 근거가 필요하면 전체본이나 모듈 선택본을 사용합니다. 중복된 목록 항목도 원래 순서대로 유지합니다. 기준 시점은 문서 앞에 한 번 표시합니다.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
