10. 최종 검수
문서 개편 완료와 앱의 운영 배포 완료는 별개입니다. 이 문서는 현재 구현을 기준으로 시연·인수인계·운영 이전 시 확인할 항목을 정리합니다.
개발환경 (HW / SW)
| 구분 | 확인할 내용 |
|---|---|
| 실행 환경 | Linux·Python 가상환경·Node·잠금 파일 버전 |
| 데이터 | PostgreSQL·pgvector, Alembic 적용 버전, 원천 기준일 |
| 모델 | LLM·임베딩 제공자·모델 이름·연결·예산 |
| 화면 | Next.js, /api/backend 프록시, MapLibre·브이월드 타일 |
| 문서 | Jekyll·just-the-docs, 서비스와 다른 도메인 |
개발내용 Flow
동작과정
원천 수집 → 집계·판정 배치 → 지도 조회 → 사실 선수집·설명 리포트 → 지원 → 자금 계산·상담 준비. 시스템 아키텍처
설치방법 (Source 이전 및 환경구성 방안)
아래는 향후 인수인계 절차이며 이번 문서 작업에서 실행한 서버 작업이 아닙니다.
- 실행할 브랜치·커밋을 고정하고 잠금 파일과 환경변수 이름을 확인합니다. 확인 기준은
feat/warning-copy/750b4e5이며 main 배포본과 같다고 가정하지 않습니다. - 별도 검증 DB를 준비하고 Alembic 적용 상태·pgvector 확장을 확인합니다. 개발·운영 DB에 테스트를 실행하지 않습니다.
- 수집·색인·판정 배치 순서와 마지막 성공 로그, 원천 기준일을 확인합니다. ORM 개수와 실제 DB 테이블 개수를 구별합니다.
- LLM·임베딩·지도 외부 연결, 백엔드 주소와 프론트 프록시 설정을 확인합니다.
- 별도 승인된 실행 환경에서 서버를 구동하고 서비스 흐름의 경로와 예외를 리허설합니다.
Local → 운영 이전
2026-10-12에 백엔드를 AWS 서울 리전(EKS·RDS)으로 옮기고 프론트를 Vercel에 연결해 완전 이전까지 끝냈습니다. DB는 이전 뒤 표별 행 수와 벡터 검색 표본을 로컬과 비교해 확인했습니다. 요구사항·구조·선택 이유·배포·남은 일정은 서버 이전 계획 및 실행에 정리했습니다.
예외처리
판정 없음, 표본 부족, 요약·판정의 독립 실패, LLM 지연, 지원 공고 없음, 계획 입력 변경을 시나리오 테스트에 따라 확인합니다. 자동으로 사전 생성 리포트를 보여주는 기능은 검증되지 않았으므로 약속하지 않습니다.
사용자정의 설정방안
비밀값은 저장소 밖에서 관리합니다. NEXT_PUBLIC_API_BASE, 백엔드 프록시 주소, 지도 키, 모델 제공자, HTTPS 쿠키·OAuth 리다이렉트·전달 IP 신뢰 범위를 배포 환경에 맞춥니다. 새 업종은 매핑뿐 아니라 원천·표본·백테스트 검증이 필요합니다.
테스트 시나리오 / 시나리오 상세
- 운영 대상 커밋·스키마·데이터 시점 확인
- 앱 전체 테스트·시연·성능 검사 결과 첨부
- 공개 서비스 URL 확인: beyondfacade.cloud (사용자 확인)
- 실제 서비스의 HTTPS·인증·쿠키·프록시 동작 점검
- 백업·복원·보존 정리·장애 대응 검증
- 원천 이용 조건·공개 개인정보 안내 검토
- 최종 기간·담당·산출물 인수 확인
이 목록은 앱 최종 검수 대기 항목입니다. 문서 사이트 정비가 끝났다고 자동 체크하지 않습니다.
유지보수 방안
버전 로그, 배치 로그, 판정·검색 평가 기록에 기준일·커밋을 붙입니다. cloud.beyondfacade/docs/jekyll.md가 개발 일지 원본이며 scripts/jekyll-devlog.sh가 문서 저장소로 복사합니다. 복사본만 고치지 않습니다. 현재 방향 안내는 문서 저장소의 공통 레이아웃에서 제공합니다.