PaynEat POS로 매장을 여는 네 가지 방법

1. Docker Desktop 설치 후 실행

   없으시면 docker.com에서 받아 설치하고 실행하세요. 왼쪽 아래에 Engine running이 뜰 때까지 기다립니다.

2. PowerShell 열기

   Windows 키를 누르고 PowerShell을 입력한 뒤 Enter를 누르세요.

3. 이 한 줄을 붙여 넣고 Enter

   상자 모서리의 복사를 누르고, PowerShell 창에서 마우스 오른쪽 버튼으로 붙여 넣으세요.

   PowerShell

   [Net.ServicePointManager]::SecurityProtocol = 3072; iex ((New-Object Net.WebClient).DownloadString('https://github.com/SuruchBoss/PaynEat/releases/download/demo/install-demo.ps1'))

4. 잠시 기다린 뒤 로그인

   브라우저가 http://localhost:8080 을 알아서 엽니다. admin / admin123으로 로그인하거나 로그인 화면의 데모 계정 버튼을 누르세요.

✅PowerShell에 초록색으로 PaynEat is ready: http://localhost:8080이 나오고 브라우저에 로그인 화면이 뜨면 성공입니다.

⚠️ 체험용 설정입니다 (데모 계정, 가상 저울, 실제로 보내지지 않는 이메일). 또한 이 PC에서만 열립니다 — 매장의 휴대폰과 태블릿까지 연결하시려면 방법 3을 쓰세요. 붙여 넣기 전에 스크립트 내용을 보시려면: install-demo.ps1

1. 코드 내려받기

   가장 쉬운 방법: ZIP 파일 내려받기 후 압축을 풀면 PaynEat-main 폴더가 생깁니다. git이 있으시면 이렇게 하셔도 됩니다:

   Terminal

   git clone https://github.com/SuruchBoss/PaynEat.git

2. 이 컴퓨터의 IP 찾기

   Windows: PowerShell에서 ipconfig를 입력하고 IPv4 Address를 보세요. Mac/Linux: ifconfig | grep inet. 192.168.1.15 같은 모양입니다.

3. 서버 비밀 값 설정

   코드 폴더(docker-compose.yml 옆)에 .env 파일을 만들고 JWT_SECRET= 뒤에 매장 고유의 무작위 값을 넣으세요. 이 줄이 없으면 시스템이 시작되지 않고 설정 방법을 안내합니다. Mac/Linux는 아래 명령을, Windows PowerShell은 ("JWT_SECRET=" + [guid]::NewGuid().ToString("N") + [guid]::NewGuid().ToString("N")) | Out-File -Encoding ascii .env를 사용하세요.

   Terminal (Mac/Linux)

   echo "JWT_SECRET=$(openssl rand -hex 32)" > .env

4. 앱에 서버 위치 알려 주기

   같은 .env 파일에 이 줄을 추가하세요. 숫자는 사장님 IP로 바꿉니다. 이 컴퓨터에서만 쓰실 거라면 건너뛰셔도 됩니다.

   .env

   API_BASE_URL=http://192.168.1.15:3000

5. 시작하기

   코드 폴더에서 터미널(Windows는 PowerShell)을 열고 실행하세요. 처음에는 앱을 빌드하느라 5~10분 걸립니다.

   Terminal

   docker compose up --build

6. 모든 기기에서 열기

   같은 와이파이에서 휴대폰·태블릿·주방 화면으로 http://192.168.1.15:8080 (사장님 IP)을 여세요. 서버 컴퓨터에서는 http://localhost:8080 도 됩니다.

✅터미널에 payneat-api와 payneat-web이 보이고 http://localhost:3000/health 가 응답하면 성공입니다.

💡 다른 기기에서 안 열리면: 같은 와이파이인지, 서버 컴퓨터 방화벽이 8080과 3000 포트를 허용하는지 확인하세요. 직원이 실제로 쓰기 전에 운영 전 체크리스트를 모두 마쳐 주세요.

1. 코드 받기

   Terminal

   git clone https://github.com/SuruchBoss/PaynEat.git
   cd PaynEat

2. 창 1 — 서버

   .env에는 로컬용 JWT_SECRET이 들어 있고, 없으면 서버가 시작되지 않습니다 (Windows는 cp 대신 copy). 데이터베이스와 예시 데이터는 자동으로 만들어집니다.

   Terminal 1

   cd backend
   npm install
   cp .env.example .env
   npm run dev

3. 창 2 — 앱

   새 창을 여세요. 첫 번째 창은 닫지 마세요.

   Terminal 2

   cd app
   flutter pub get
   flutter run -d chrome

✅창 1에 PaynEat POS API listening on http://localhost:3000 줄이 나오고 Chrome에 로그인 화면이 뜨면 성공입니다.

구조, API, 모든 테스트는 README (영문)에 있습니다.

1. 다른 디스크에 두 번째 위치 지정

   첫 번째 백업은 데이터베이스와 같은 디스크에 있어 디스크가 고장 나면 둘 다 잃습니다. USB 드라이브를 꽂거나 매장 NAS의 폴더를 쓰고, backend/.env에 아래 줄을 추가(폴더는 본인 것으로)한 뒤 서버를 다시 시작하세요

   backend/.env (코드에서 실행)

   BACKUP_COPY_DIR=E:\PaynEat-backup

2. Docker: 두 번째 백업을 컨테이너 밖에 두기

   docker-compose.yml의 api 아래 volumes:에서 - /mnt/usb-backup/payneat:/backup-copy 줄의 주석을 풀고(: 앞부분을 본인 폴더로, Linux에서는 uid 1000이 쓸 수 있게: sudo chown 1000:1000 /mnt/usb-backup/payneat) .env에 아래 줄을 추가한 뒤 docker compose up -d를 실행하세요

   .env (Docker)

   BACKUP_COPY_DIR=/backup-copy

3. 한 번 백업해서 확인

   관리자로 로그인해 설정 → 백업에서 지금 백업을 누르세요. 두 위치 모두 초록색 체크가 떠야 합니다

4. 복원: 먼저 서버 멈추기

   서버가 켜져 있으면 복원 명령이 실행되지 않습니다 · 코드에서 실행: 서버 창에서 Ctrl+C · Docker: 코드 폴더에서 아래 명령 실행

   Terminal (Docker)

   docker compose stop api

5. 복원할 파일 고르기

   파일 이름에 시각과 이유가 있습니다. 예: payneat-2026-09-29T221530+0700-shift-close.sqlite는 29일 22:15 교대 마감 후 파일입니다 · 코드에서 실행: backend/data/backups 폴더 확인 · Docker: 아래 명령으로 목록 보기

   Terminal (Docker)

   docker compose run --rm api ls data/backups

6. 복원하기

   코드에서 실행: cd backend 후 npm run db:restore -- data/backups/<파일 이름> · Docker: 아래 명령 · PaynEat이 파일을 먼저 검사하고, 현재 데이터를 항상 pre-restore 파일로 남기므로 잘못 골라도 되돌릴 수 있습니다

   Terminal (Docker)

   docker compose run --rm api npm run db:restore -- data/backups/payneat-2026-09-29T221530+0700-shift-close.sqlite

7. 서버 다시 켜기

   코드에서 실행: npm start (또는 npm run dev) · Docker: 아래 명령

   Terminal (Docker)

   docker compose start api

✅복원 명령이 pre-restore 파일 이름과 함께 Restored … from …을 출력하고, 변경 이력에 백업에서 복원 항목이 생깁니다

🔒 백업 파일에는 고객 전화번호와 직원 비밀번호 해시가 있습니다. USB 드라이브는 잠기는 곳에 두고, 공유하거나 클라우드에 올리지 마세요 · Windows 한 줄 설치(데모): PowerShell에서 같은 Docker 명령을 쓰되 docker compose 뒤에 -f "$env:USERPROFILE\PaynEat-Demo\docker-compose.yml"를 붙이세요