문헌 열람실 > project_handover
Y

descriptionproject_handover

folderRoot

📋 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)

  1. 전투기 정비 (Development)
    • 피부과_정비.bat 실행 (Antigravity 소스 구동) -> 수정 및 확인
  2. 전투기 조립 (Build)
    • 정비소에서 npm run build 실행
    • 결과물 dist 폴더 생성됨
  3. 항모 탑재 (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 |