AssetPilot OrangePi 5 Pluse Server-First Commit

This commit is contained in:
Wind
2026-02-10 12:23:22 +09:00
commit bf87175f51
45 changed files with 4060 additions and 0 deletions

View File

@@ -0,0 +1,126 @@
# Asset Pilot - Orange Pi 빠른 시작 가이드
## 🚀 5분 안에 시작하기
### 1⃣ 파일 전송
Orange Pi에 `asset_pilot_orangepi.tar.gz` 파일을 전송:
```bash
# Windows에서 (PowerShell)
scp asset_pilot_orangepi.tar.gz orangepi@192.168.1.100:~/
# Linux/Mac에서
scp asset_pilot_orangepi.tar.gz orangepi@192.168.1.100:~/
```
### 2⃣ Orange Pi에서 설치
```bash
# SSH 접속
ssh orangepi@192.168.1.100
# 압축 해제
tar -xzf asset_pilot_orangepi.tar.gz
cd asset_pilot_orangepi
# 자동 설치 스크립트 실행
bash install.sh
```
스크립트가 다음을 자동으로 처리합니다:
- PostgreSQL 설치 및 설정
- Python 가상환경 생성
- 필요한 패키지 설치
- 데이터베이스 초기화
- 서비스 등록
### 3⃣ 접속
웹 브라우저에서:
```
http://[Orange_Pi_IP]:8000
```
예: `http://192.168.1.100:8000`
---
## 📱 스마트폰에서 접속
1. 같은 Wi-Fi 네트워크에 연결
2. 브라우저에서 `http://[IP]:8000` 접속
3. "홈 화면에 추가" → 앱처럼 사용!
---
## 🔧 주요 명령어
```bash
# 서비스 상태 확인
sudo systemctl status asset_pilot
# 로그 실시간 보기
sudo journalctl -u asset_pilot -f
# 서비스 재시작
sudo systemctl restart asset_pilot
# 서비스 중지
sudo systemctl stop asset_pilot
```
---
## 📊 Windows 데이터 가져오기
기존 `user_assets.csv` 파일이 있다면:
```bash
# CSV 파일을 Orange Pi로 복사
scp user_assets.csv orangepi@192.168.1.100:~/
# Orange Pi에서 가져오기
cd ~/asset_pilot_orangepi
source venv/bin/activate
python import_csv.py ../user_assets.csv
```
---
## ❓ 문제 해결
### 접속이 안 될 때
1. 서비스 확인:
```bash
sudo systemctl status asset_pilot
```
2. 방화벽 확인:
```bash
sudo ufw allow 8000/tcp
```
3. IP 주소 확인:
```bash
ip addr show
```
### 데이터가 수집되지 않을 때
로그 확인:
```bash
sudo journalctl -u asset_pilot -n 100
```
---
## 📚 더 자세한 정보
- **전체 가이드**: MIGRATION_GUIDE.md
- **프로젝트 문서**: README.md (프로젝트 내)
---
**준비 완료! 이제 자산을 모니터링하세요! 💰**