📘 연 통합 규격 YUV-5.5

• 가입 순서대로 자동 발급 (1, 2, 3, …)
• 표기: 7자리 (예: Y-0001234)

(function autoDetectBackend(){
  if (location.protocol === 'file:' ||
      location.hostname === 'localhost' ||
      location.hostname === '127.0.0.1' ||
      location.hostname.endsWith('.local')) {
    return;
  }
  window.YEON_HOSTED = true;
  var domain = location.hostname.replace(/^www\./, '');
  Promise.any([
    location.origin + '/api',
    'https://api.' + domain,
    'https://' + domain + '/api'
  ].map(function(url){
    return fetch(url + '/health').then(function(r){
      if(!r.ok) throw 0; return url;
    });
  })).then(function(base){
    window.YEON_BACKEND_BASE = base;
    onBackendConnected();
  }).catch(function(){});
})();

{
  "uid": "...", "y_user_no": 1234,
  "role": "student" | "teacher" | "branch_admin" | "server_admin",
  "name": "...", "id": "...", "pw_hash": "...",
  "id_changed_at": "...", "pw_changed_at": "...",
  "branch_id": "본점" | "삼산",
  "code": "123450", "issued_by": "123400",
  "apps_installed": [...],
  "verification_status": "pending" | "verified",
  "verification_grace_until": "...",
  "extra_info": { "school": "...", "grade": "..." }
}

match /y_accounts/{uid} {
  allow read:  if request.auth.uid == uid
                  || request.auth.token.role == 'server_admin'
                  || (request.auth.token.role == 'branch_admin'
                      && resource.data.branch_id == request.auth.token.branch_id);
  allow write: if request.auth.uid == uid
                  || request.auth.token.role == 'server_admin';
}
match /y_account_changes/{cid} {
  allow create: if request.auth != null;
  allow update, delete: if false;  // 불변
}

• y_accounts 사용 (앱별 DB ❌)
• 같은 ID/PW 로 모든 앱 자동 로그인
• y_user_no 모든 사용자에게 부여
• ID/PW 변경 → y_account_changes 로그
• 비밀번호 해시만, 평문 ❌

• 권한 4계층 분리
• 5회 실패 5분 잠금 (클라+서버)
• "API" 단어 노출 ❌

• 6자리 코드 §2 일치
• 학생 첫 인증 = 임시 등록
• 10일 유예 동안 모든 기능 사용
• 선생님 본인 확인 화면 동작

• 공통 헤더 ("연 AI 학습코칭 아카데미")
• 기본 엔진 = Gemma 4 26B
• FAB 드래그 + 위치 저장

• §6-2 IIFE 페이지 로드 시
• file://·localhost 폴백
• 🚧 TODO[YEON-HOST] 마커 7곳

• --yp-* 토큰 1순위
• 모바일 터치 44px+
• 모바일 우선 380px 기준

• Service Worker 등록
• version.json 5분 폴링
• idle 상태에서만 리로드

• Thin Client 구조
• AI 프롬프트·풀이 알고리즘 서버 함수에
• Cloudflare Pages + Workers + Firebase (Netlify·Vercel·Supabase ❌)
• minify 적용
• GitHub push → 자동 배포

• manifest + Service Worker
• 아이콘 3종 (192·512·apple-touch)
• "📲 앱 설치" 버튼 동적
• theme-color 메타

• Vault 4단 깊이
• AI 자동 분류 + Wiki Link
• 내보내기 6형식 지원

• 새 버전 폴더 {앱이름}_v{주.부}_{YYYYMMDD}
• 옛 버전은 _백업\ 폴더로

const VERSION_CHECK_INTERVAL = 5 * 60 * 1000;
let currentVersion = window.YEON_BUILD_VERSION || 'dev';

async function checkVersion() {
  try {
    const r = await fetch('/version.json?t=' + Date.now(), { cache: 'no-cache' });
    const j = await r.json();
    if (j.version !== currentVersion) {
      if (j.force) { showToast('보안 업데이트…'); setTimeout(() => location.reload(), 1000); }
      else { showToast('새 버전이 준비됐어요 ✨'); scheduleSoftReload(); }
    }
  } catch(_) {}
}
function scheduleSoftReload() {
  let lastActivity = Date.now();
  ['click','keydown','touchstart'].forEach(ev =>
    window.addEventListener(ev, () => lastActivity = Date.now()));
  const tick = setInterval(() => {
    const idle = Date.now() - lastActivity > 30000;
    const isInput = ['INPUT','TEXTAREA'].includes(document.activeElement?.tagName);
    if (idle && !isInput && !window.YEON_CHAT_PENDING) {
      clearInterval(tick);
      showToast('새 버전 적용됐어요 ✨', 3000);
      setTimeout(() => location.reload(), 600);
    }
  }, 5000);
}
setInterval(checkVersion, VERSION_CHECK_INTERVAL);
checkVersion();

수풀AI_v2.1_20260519\
├── index.html
├── /public
├── /src
├── /functions          ← Cloudflare Workers ⭐
│   ├── api/
│   │   ├── solve.js    ← 풀이 알고리즘 (클라이언트 ❌)
│   │   ├── chat.js     ← 챗봇 (프롬프트 포함)
│   │   ├── auth.js
│   │   └── health.js
│   └── _shared/prompts/
├── version.json
├── wrangler.toml
└── firebase.json

{
  "keywords": ["수학", "미적분", "수능", "함수", "도함수"],
  "main_folder": "04_영상분석/강의/수학",
  "shortcut_folders": ["05_학습자료/시험대비/수학", "00_일반분석"]
}

앱폴더/
├── index.html       (PWA 메타)
├── manifest.json
├── sw.js
├── icon-192.svg
├── icon-512.svg
└── apple-touch-icon.svg (180×180)

• 자동화 시간 budget 2분 준수?
• 한국어 경로 = PowerShell 단일따옴표 패턴 사용?
• 같은 카테고리 재시도 금지 (.bat 실패 → 다른 카테고리로 분기)?
• 메모리·가이드북 권한 한계 사전 안내?
• 정리(cleanup)도 본 작업과 같은 신중함?

• yeon-guidebook 으로 충분한 작업(0~90%)?
• yeon-guidebook §17 자동 트리거 작동?

• 챗봇 기본 엔진 = Gemma 4 26B
• Gemini 키 재사용 (별도 키 ❌)

• Cloudflare Pages + Workers + Firebase
• Netlify·Vercel·Supabase 사용 ❌