동적항모_부품정비실_갑판배치_완성품.dist
Root
📋 Yc Brain Lab 프로젝트 인수인계 보고서
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) 전투기 (Fighter Jets)
각각의 개별 프로젝트(앱)들입니다. 소스 코드 위치가 현재 두 곳으로 나뉘어 있어 정리가 필요합니다.
| 전투기 이름 | 소스 코드 위치 (격납고) | 현재 상태 | 비고 |
| :--- | :--- | :--- | :--- |
| 서울 강남 피부과 | D:\1v\Cursor\bp.co.kr\skin-clinic | 출격 완료 (로컬/항모 탑재됨) | Antigravity 폴더에도 사본이 있으나, 최신 작업은 bp.co.kr에서 진행됨. 이관 필요. |
| 운반 로봇 (AgriBot) | D:\1v\Antigravity\AgriBot_Voice_Operating_System | 대기 중 | 곧 작업하여 항모에 탑재 예정 |
| Red Bulk | D:\1v\Cursor\bp.co.kr\red-bulk | 탑재됨 | |
| 부동산 리노베이션 | D:\1v\Cursor\bp.co.kr\renovation | 탑재됨 | |
2. 개발 환경 및 명령어 (Command Center)
언제 어디서든 즉시 실행할 수 있도록 C:\commands에 배치 파일들이 준비되어 있습니다.
🛠️ 로컬 개발 (Local Development)
| 상황 | 명령어 | 설명 | URL |
| :--- | :--- | :--- | :--- |
| 동적 항모 출항 | 동적홈 | Next.js 서버(항모)를 띄웁니다. | http://localhost:3000 |
| 피부과기 정비 | 피부과_정비 | 피부과 앱만 따로 띄워 빠르게 수정합니다. (Hot Reload) | http://localhost:5173 |
| 서버 긴급 복구 | 동적홈_복구 | 파일 잠금 등 오류 발생 시 초기화하고 재시작합니다. | - |
🚀 배포 워크플로우 (Deployment Workflow)
- 전투기 정비 (Development)
피부과_정비.bat실행 -> 코드 수정 -> 확인
- 전투기 조립 (Build)
- 소스 폴더(
skin-clinic)에서npm run build실행 - 결과물(
dist) 생성됨
- 소스 폴더(
- 항모 탑재 (Deploy to Deck)
dist폴더의 내용물을dashboard_ui\public\skin-clinic(갑판)으로 복사
- 최종 서버 배포 (Deploy to Server)
dashboard_ui전체를 서버로 업로드
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 |
[참고] 현재 서버의
bp.co.kr루트("/")는 Next.js가 차지하고 있으며, 정적 파일들은/index.html처럼 명시적으로 접근하거나 Next.js의public폴더를 통해 서비스됩니다.
4. 향후 계획 (Next Steps)
- AgriBot 이관:
D:\1v\Antigravity에 있는 AgriBot을 빌드하여 동적 항모(public)에 탑재. - 피부과 소스 통합:
bp.co.kr에서 작업하던 피부과 소스를Antigravity로 옮겨서 관리 일원화.