# kin.aiasaas.com 전체 기술 명세서 및 아키텍처 가이드 (Full Specification)

## 1. 시스템 아키텍처 개요
- **서버 환경**: Ubuntu 24.04 VPS (104.237.11.24)
- **도메인**: https://kin.aiasaas.com (Porkbun DNS API 연동)
- **웹 서버 / 프록시**: Nginx + Let's Encrypt Certbot SSL
- **애플리케이션 스택**: Python 3.12, FastAPI, Jinja2, Uvicorn, APScheduler, aiosqlite
- **원격 자동화 브라우저**: Windows 노트북2에 위치한 Aside AI Browser (`aside-remote` CLI 브릿지 연동)
- **AI 추론 엔진**: Anthropic Claude 3.5 Sonnet API
- **의사결정 및 검증 게이트**: TypeSafe Jev MCP (착수 판정, 설계 랭킹, 코드 게이트, 실패 분류)

## 2. 데이터베이스 스키마 (SQLite WAL)
- `keywords`: id, keyword, landing_url, landing_template, interval_minutes, is_active, max_answers
- `questions`: id, doc_key (dirId_docId), dir_id, doc_id, keyword, title, link, question_time, answer_count, status, skip_reason, full_content, detail_data_json
- `analyses`: id, question_id, topic, sub_issues_json, facts_json, missing_info_json, urgency, question_type, risk_flags_json, suitability, skip_reason, raw_json
- `drafts`: id, question_id, content, landing_url, quality_score, quality_report_json, version, is_current
- `reviews`: id, question_id, draft_id, status, operator_notes
- `publications`: id, question_id, draft_id, status, answer_url, screenshot_path, error_message, published_at, retry_count
- `knowledge_docs`: id, keyword, filename, title, effective_date, source, content
- `settings`: key, value, description

## 3. 파이프라인 수명 주기 (State Lifecycle)
1. **baseline**: 초기 수집 시 존재하는 질문으로, 이전 데이터이므로 중복/알림 제외 기준선으로 저장.
2. **new**: baseline 이후 새롭게 등록된 질문 감지.
3. **analyzing**: 질문 상세 본문 파싱 및 Claude 사실 추출 JSON 생성.
4. **drafted**: 법률 지식베이스 기반 전문가 수준 초안 생성 및 품질 검사 수행.
5. **needs_review**: 운영자 대시보드 검토 대기열 등록.
6. **approved**: 운영자가 승인하여 Aside 발행 큐 진입.
7. **publishing**: Aside 브라우저를 통한 네이버 지식iN 에디터 진입, 서식 유지 본문 및 링크 삽입 진행.
8. **published**: 발행 완료 및 실제 등록 답변 URL, 스크린샷 캡처 및 영구 보관.
9. **skipped**: 답변이 5개 이상 이미 달렸거나 부적합 판정 질문.
10. **failed**: 발행 중 오류 발생 시 1회 재시도 후 에러 기록.