project_handover
Root
📋 Yc Brain Lab 프로젝트 인수인계 보고서
작성일: 2025년 12월 7일
1. 프로젝트 구조 (The Metaphor)
이 프로젝트는 **항공모함(Platform)**과 함재기(Projects) 모델로 구성되어 있습니다.
🏭 1) 동적 항공모함 (Dynamic Carrier)
- 정체: Next.js 기반의 동적 웹 애플리케이션 (대시보드)
- 역할: 사용자 인증, API 처리, 그리고 정적 전투기들을 실어 나르는 기지
- 위치:
D:\1v\Cursor\Projects\dashboard_ui - 갑판(Deck):
D:\1v\Cursor\Projects\dashboard_ui\public- 이곳에 빌드된 전투기(정적 파일들)가 배치되면 웹에서 바로 접근 가능합니다.
🛠️ 2) 안티그래비티 정비소 (Antigravity Development Center)
모든 동적 전투기의 개발과 수정(정비)은 이곳에서 이루어집니다. 수정이 완료되면 빌드(조립) 후 항공모함으로 출고합니다.
| 전투기 이름 | 소스 코드 위치 (정비소) | 현재 상태 |
| :--- | :--- | :--- |
| 서울 강남 피부과 | D:\1v\Antigravity\skin-clinic | 정비 중 (최신 소스 이전됨) |
| 운반 로봇 (AgriBot) | D:\1v\Antigravity\AgriBot_Voice_Operating_System | 대기 중 |
2. 개발 환경 및 명령어 (Command Center)
언제 어디서든 즉시 실행할 수 있도록 C:\commands에 배치 파일들이 준비되어 있습니다.
🛠️ 로컬 개발 (Local Development)
| 상황 | 명령어 | 설명 | URL |
| :--- | :--- | :--- | :--- |
| 피부과기 정비 | 피부과_정비 | Antigravity에 있는 소스를 열어 실시간 수정(정비)합니다. | http://localhost:5173 |
| 동적 항모 출항 | 동적홈 | Next.js 서버(항모)를 띄웁니다. | http://localhost:3000 |
| 서버 긴급 복구 | 동적홈_복구 | 파일 잠금 등 오류 발생 시 초기화하고 재시작합니다. | - |
🚀 배포 워크플로우 (Deployment Workflow)
- 전투기 정비 (Development)
피부과_정비.bat실행 (Antigravity 소스 구동) -> 수정 및 확인
- 전투기 조립 (Build)
- 정비소에서
npm run build실행 - 결과물
dist폴더 생성됨
- 정비소에서
- 항모 탑재 (Deploy)
- 정적 항모용:
dist내용물을D:\1v\Cursor\bp.co.kr\skin-clinic\dist로 복사 - 동적 항모용:
dist내용물을D:\1v\Cursor\Projects\dashboard_ui\public\skin-clinic로 복사
- 정적 항모용:
3. 서버 배포 경로 (Server Mapping)
로컬의 작업물이 실제 서버(bp.co.kr)의 어디로 연결되는지 보여주는 지도입니다.
| 구분 | 로컬 경로 (Local) | 서버 경로 (Server/Ubuntu) | URL |
| :--- | :--- | :--- | :--- |
| 동적 항모 (Next.js) | D:\1v\Cursor\Projects\dashboard_ui | /home/ubuntu/bp_project/api_server (추정) | https://bp.co.kr |
| 정적 포털 (Hub) | D:\1v\Cursor\bp.co.kr | /var/www/html | https://bp.co.kr/index.html |