From d0b62dc9ffef1093be095d0cd2646c00121f65a2 Mon Sep 17 00:00:00 2001
From: nkey <nkey241127@gmail.com>
Date: Wed, 28 Jan 2026 12:30:43 +0900
Subject: [PATCH] =?UTF-8?q?Docs:=20[main]=20oracle-server=20README=20?=
 =?UTF-8?q?=EC=9E=91=EC=84=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 132 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 132 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..95be45a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,132 @@
+# oracle-server
+작성: AI / 수정: nkey
+
+자동화 워크플로우 서버(n8n), PostgreSQL 데이터베이스, 그리고 웹 모니터링 서비스(WMS)를 함께 배포하는 서버 구성입니다.
+
+---
+
+## 📌 개요
+
+이 저장소는 **도커 컴포즈 기반 서버 스택 구성**을 담고 있습니다:
+
+- **n8n** — 자동화 워크플로우 엔진  
+- **PostgreSQL** — n8n 및 서비스 데이터 저장  
+- **WMS (Laravel 기반)** — 웹 모니터링 서비스  
+    참고: `/wms/README.md`
+- **Nginx** — 리버스 프록시 및 정적 서비스 제공  
+
+---
+
+## 🚀 빠른 시작
+
+### 1. 코드 클론
+
+```bash
+git clone https://nkeystudy.site/gitea/2025-capstone/oracle-server.git
+cd oracle-server
+```
+
+---
+
+### 2. 환경변수 파일 준비
+
+```bash
+# 기본 .env 생성 (예시)
+cp .env.example .env
+
+# n8n용 env 파일 생성
+mkdir -p n8n
+cp n8n/.env.example n8n/.env
+
+# WMS용 env 파일 생성
+mkdir -p wms
+cp wms/.env.example wms/.env
+```
+
+> 각 `.env` 에서 DB 접속 정보, BASE_URL 등 값을 실제 환경에 맞게 설정합니다.
+
+---
+
+### 3. 서비스 실행
+
+```bash
+docker compose up -d
+```
+
+---
+
+### 4. 상태 확인
+
+```bash
+docker compose ps
+```
+
+각 서비스(n8n, postgres, php-app, nginx)가 정상적으로 올라오는지 확인합니다.
+
+---
+
+## 📂 구성 요소
+
+### 🧱 서비스 구성
+
+| 서비스 | 이미지 / 경로 | 포트 | 설명 |
+|---------|----------------|------|------|
+| n8n | `n8nio/n8n:latest` | 5678 | 자동화 워크플로우 엔진 |
+| PostgreSQL | `postgres:15` | 5432 | 데이터 저장소 |
+| WMS (Laravel) | `nkey01/laravel-wms:1.0.0` | — | 웹 모니터링 서비스 |
+| Nginx | `nginx:1.27-alpine` | 80 | 리버스 프록시 및 정적 파일 |
+
+---
+
+## 🔌 엔드포인트
+
+- **http://localhost/** — WMS 웹 인터페이스
+- **http://localhost/n8n/** — n8n 에디터/실행 UI
+
+---
+
+## 📌 환경 변수
+
+`.env` 에서 다음 값들을 반드시 설정하세요.
+
+| 키 | 설명 |
+|------|------|
+| `POSTGRES_DB` | PostgreSQL DB 이름 |
+| `POSTGRES_USER` | DB 사용자 |
+| `POSTGRES_PASSWORD` | DB 비밀번호 |
+| `BASE_URL` | n8n Editor/Webhook 기준 URL |
+
+
+---
+
+## 🖼 n8n flow
+
+
+![n8n_flow](docs/assets/n8n_flow.png)
+
+---
+
+## 📦 폴더 구조
+
+```
+.
+├── docker-compose.yml
+├── .env.example
+├── nginx/
+│   └── conf.d/
+│       └── custom.conf
+├── n8n/
+│   └── .env.example
+├── wms/
+│   └── .env.example
+└── ...
+```
+
+---
+
+## ⚠️ 참고
+
+- 이 구성은 개발/테스트 목적 기준입니다.
+- 운영 환경에서는 SSL, 도메인, 보안 설정 추가가 필요합니다.
+
+---