📚 Libeye (스마트 서고 관리 시스템)

🚀 전체 개발 워크플로우 (필독)

본 프로젝트는 AI 연산과 도커(Docker) 환경이 **우분투 서버(Ubuntu Server)**에 완벽하게 세팅되어 있습니다. 따라서 로컬(개인 노트북)에서 자체적으로 서버를 띄워 테스트하는 것은 불가능하며, 아래의 3단계 파이프라인을 엄격하게 준수하여 개발 및 테스트를 진행해야 합니다.

💻 1. 노트북에서 작업 및 업로드 (Local ➔ GitHub)

개인 노트북은 오직 **'코드를 작성하는 공간'**입니다. node_modules나 AI 가중치(.pt) 파일이 없어서 에디터에 빨간 줄이 뜨더라도 무시하고 작업을 진행합니다.

# 1. 원격 저장소 최신화 (작업 전 필수)
git pull origin main

# 2. 코드 수정 후 깃허브로 업로드
git add .
git commit -m "기능 추가"
git push origin main

🖥️ 2. 우분투 서버 최신화 (GitHub ➔ Ubuntu)

노트북에서 작업한 코드를 실제 서버 환경(우분투)으로 가져옵니다. 테스트를 위해서는 이 과정이 무조건 선행되어야 합니다.

gpuadmin@gpusystem:~$ cd Libeye
gpuadmin@gpusystem:~/Libeye$ sudo git pull origin main
Username for 'https://github.com': dongdong-guk
Password for 

1. 프론트엔드 (Vue, TS, HTML) 코드만 수정했을 때

도커 재시작할 필요 없음! ubuntu에서 sudo git pull origin main

2. 백엔드 (Python) 코드를 수정했을 때

pull 받고 백엔드(api), 워커(ai-worker) 또는 해당하는 컨테이너 재시작 docker-compose restart api ai-worker

3. 새로운 패키지를 설치했을 때 (npm / pip)

pull 받고 도커 이미지 새로 굽기 docker-compose up -d --build

📱 3. 모바일 기기 테스트 (ngrok)

코드가 우분투 서버에 반영되면, 스마트폰이나 외부 PC의 브라우저에서 ngrok 주소를 통해 접속하여 실제 동작을 테스트합니다.

접속 주소: https://pyramidlike-distendedly-debroah.ngrok-free.dev

GUI를 통한 Storage, DB 확인

Ubuntu 내부에서만 가능합니다.

MinIO: http://210.94.222.176:9001

• ID: admin
• PW:

PostgreSQL: http://210.94.222.176:8080

• System: PostgreSQL
• Server: libeye-postgres (중요: 컨테이너 이름을 넣어야 합니다)
• Username: libeye_admin
• Password:
• Database: libeye_db