From dd3c46a7c9ae61e228a4a85df44e942020317908 Mon Sep 17 00:00:00 2001 From: GA Pro Date: Thu, 21 May 2026 22:36:13 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=ED=94=84=EB=A1=9C=EC=A0=9D=ED=8A=B8=20?= =?UTF-8?q?=ED=95=9C=20=EB=B2=88=EC=97=90=20=EC=8B=A4=ED=96=89=ED=95=98?= =?UTF-8?q?=EB=8A=94=20=EB=B0=A9=EB=B2=95=20(=EC=8B=A4=ED=96=89.bat=20+=20?= =?UTF-8?q?=EC=8B=A4=ED=96=89=EB=B0=A9=EB=B2=95.md)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 비개발자도 더블클릭 한 번으로 백엔드(ga-api 8082)+프론트(ga-frontend 3000)를 동시에 띄우도록 실행.bat 추가. 실행/접속/종료/문제해결을 실행방법.md에 정리. Co-Authored-By: Claude Opus 4.7 (1M context) --- 실행.bat | 28 ++++++++++ 실행방법.md | 152 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 180 insertions(+) create mode 100644 실행.bat create mode 100644 실행방법.md diff --git a/실행.bat b/실행.bat new file mode 100644 index 0000000..5cd5ee9 --- /dev/null +++ b/실행.bat @@ -0,0 +1,28 @@ +@echo off +chcp 65001 >nul +cd /d "%~dp0" + +echo ============================================ +echo GA 수수료 정산 시스템 - 전체 실행 +echo ============================================ +echo. +echo 백엔드(ga-api) + 프론트엔드(ga-frontend)를 +echo 각각 새 창에서 동시에 시작합니다. +echo 열리는 검은 창 2개는 끄지 마세요. +echo. + +start "GA 백엔드 (ga-api 8082)" cmd /k "cd /d %~dp0 && gradlew.bat :ga-api:bootRun" +start "GA 프론트엔드 (3000)" cmd /k "cd /d %~dp0ga-frontend && npm install && npm run dev" + +echo. +echo 실행 준비 중입니다. +echo - 처음 실행하면 몇 분 걸립니다 (다운로드/빌드). +echo - 두 창 모두 준비되면 아래 주소로 접속하세요. +echo. +echo http://localhost:3000 +echo. +echo 로그인: admin / admin1234! +echo. +echo 종료할 때는 열린 검은 창 2개를 닫으면 됩니다. +echo. +pause diff --git a/실행방법.md b/실행방법.md new file mode 100644 index 0000000..6ac88b8 --- /dev/null +++ b/실행방법.md @@ -0,0 +1,152 @@ +# GA 수수료 정산 시스템 — 실행 방법 + +이 문서 하나만 보면 프로젝트를 처음부터 끝까지 실행할 수 있습니다. + +--- + +## 1. 제일 쉬운 방법 (이것만 기억하세요) + +1. `C:\Users\kyu\Desktop\ga_pro\ga-commission-system` 폴더를 엽니다. +2. **`실행.bat` 파일을 더블클릭**합니다. +3. 검은 창 2개가 열립니다. **끄지 말고** 1~2분 기다립니다. +4. 인터넷 브라우저(크롬 등)를 열고 주소창에 입력: **http://localhost:3000** +5. 로그인 — 아이디 `admin` / 비밀번호 `admin1234!` + +끝입니다. 이게 "한 번에 실행"하는 방법입니다. + +> 종료하려면 열려 있는 **검은 창 2개를 닫으면** 됩니다. + +--- + +## 2. 처음 한 번만 — 준비물 확인 + +이 PC에는 이미 다 설치되어 있어서 **추가 설치는 필요 없습니다.** 참고용으로만 적어둡니다. + +| 준비물 | 용도 | 현재 상태 | +|---|---|---| +| Java 17 | 백엔드 실행 | 설치됨 (17.0.11) | +| Node.js | 프론트엔드 실행 | 설치됨 (v24) | +| 데이터베이스 | 데이터 저장 | 원격 서버 사용 (아래 참고) | + +**중요 — 데이터베이스 서버가 켜져 있어야 합니다.** +이 시스템은 데이터를 `192.168.0.60` 서버의 PostgreSQL에 저장합니다. +그 서버(또는 기기)가 꺼져 있으면 백엔드가 데이터를 못 읽어 화면이 비어 보이거나 오류가 납니다. +→ 실행 전에 `192.168.0.60` 기기가 켜져 있는지 확인하세요. + +--- + +## 3. 실행하기 + +### 방법 A — `실행.bat` 더블클릭 (권장) + +`실행.bat`을 더블클릭하면 자동으로 두 가지가 동시에 켜집니다. + +- **백엔드 창** : "GA 백엔드 (ga-api 8082)" — 서버 프로그램 +- **프론트엔드 창** : "GA 프론트엔드 (3000)" — 화면(웹페이지) + +각 창에 아래 글자가 보이면 준비 완료입니다. + +- 백엔드 창: `Started GaApiApplication` +- 프론트엔드 창: `Local: http://localhost:3000` + +> 처음 실행하면 다운로드/빌드 때문에 **몇 분** 걸립니다. 두 번째부터는 빠릅니다. + +### 방법 B — 손으로 직접 실행 (참고용) + +`실행.bat`이 안 될 때를 위해 적어둡니다. 창을 **2개** 열어서 각각 입력하세요. + +**창 1 — 백엔드** (`ga-commission-system` 폴더에서): +``` +gradlew.bat :ga-api:bootRun +``` + +**창 2 — 프론트엔드** (`ga-commission-system\ga-frontend` 폴더에서): +``` +npm install +npm run dev +``` + +--- + +## 4. 접속 & 로그인 + +- 주소: **http://localhost:3000** +- 아이디: `admin` +- 비밀번호: `admin1234!` (관리자 계정, 모든 메뉴 권한) + +브라우저에서 `localhost:3000`은 화면이고, 화면이 데이터를 요청하면 +자동으로 백엔드(`localhost:8082`)로 전달됩니다. 그래서 주소는 `3000` 하나만 기억하면 됩니다. + +--- + +## 5. 종료하기 + +- 열려 있는 **검은 창 2개를 그냥 닫으면** 종료됩니다. +- 또는 각 창에서 `Ctrl + C` 를 누르고 `Y` 입력. + +--- + +## 6. 무엇이 어떻게 도는지 (구조) + +``` + [브라우저] http://localhost:3000 + | + | 화면이 데이터를 요청 (/api/...) + v + [프론트엔드] ga-frontend (포트 3000) ← 검은 창 2번 + | + | /api 요청을 백엔드로 전달 + v + [백엔드] ga-api (포트 8082) ← 검은 창 1번 + | + | 데이터 읽기/쓰기 + v + [데이터베이스] PostgreSQL + 192.168.0.60 : 55432 (원격 서버, trading_ai/ga) +``` + +- 창이 2개인 이유: 화면(프론트)과 서버(백엔드)는 별개 프로그램이라 따로 켭니다. +- 데이터베이스는 이 PC가 아니라 **원격 서버**에 있어서 따로 켜지 않습니다(이미 운영 중). + +--- + +## 7. 문제가 생기면 + +| 증상 | 원인 / 해결 | +|---|---| +| 화면이 안 열림 (`localhost:3000` 접속 안 됨) | 프론트엔드 창에 `http://localhost:3000` 글자가 나올 때까지 더 기다리세요. | +| 화면은 열리는데 데이터가 비어있음 / 로그인 오류 | 백엔드 창이 준비됐는지 확인. 그리고 `192.168.0.60` DB 서버가 켜져 있는지 확인. | +| 백엔드 창에 `Port 8082 ... in use` | 이미 백엔드가 켜져 있다는 뜻. 그 창은 닫아도 됨 (기존 것이 동작 중). | +| 백엔드 창에 `Connection refused` / DB 관련 오류 | `192.168.0.60` DB 서버 기기가 꺼져 있음 → 그 기기를 켜고 다시 실행. | +| `실행.bat` 더블클릭해도 아무 일도 없음 | 방법 B(손으로 직접 실행)로 하세요. | +| 첫 실행이 너무 오래 걸림 | 정상입니다. 다운로드+빌드로 처음엔 3~5분 걸릴 수 있어요. | + +--- + +## 8. 상태 확인용 명령 (선택) + +문제 진단이 필요할 때만 사용. `ga-commission-system` 폴더에서: + +``` +# 데이터베이스 서버가 켜져 있는지 + 현재 버전 확인 +python ..\check_db_status.py + +# 백엔드 주요 기능이 정상 동작하는지 점검 +python smoke_v78.py +``` + +--- + +## 9. 참고 — Docker 방식 (지금은 사용 안 함) + +`docker-compose.yml` 파일이 있어서, Docker가 설치돼 있다면 +`docker compose up` 한 줄로 DB까지 포함해 전부 띄울 수 있습니다. +**단, 이 경우 데이터베이스가 빈 상태로 새로 만들어집니다**(원격 운영 DB와 다름). +현재 이 PC에는 Docker가 설치돼 있지 않고, 운영 데이터는 원격 DB에 있으므로 +**위 1번 방법(`실행.bat`)을 사용하세요.** + +--- + +## 요약 한 줄 + +> **`ga-commission-system\실행.bat` 더블클릭 → 1~2분 대기 → 브라우저 `http://localhost:3000` → `admin` / `admin1234!`**