docs: Embedded Redis 반영 가이드 업데이트 + auth guard 경고 수정

- 설치가이드_OnPremise.pdf: Redis를 선택 사항으로 변경, Embedded Redis 안내
- 개발자가이드.pdf: Docker/Redis 필수 → 선택, Embedded Redis 자동 구동 안내
- 개발환경_사전설치_가이드.txt: Docker/Redis 섹션 Embedded Redis 기반으로 수정
- regenerate_pdfs.py: PDF 재생성 스크립트 추가
- auth.guard.ts: Vue Router deprecated next() 콜백 → return 방식으로 수정

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
이 Commit은 다음에 포함되어 있습니다:
2026-03-27 15:08:48 +09:00
부모 6b248c6a69
커밋 dd263a6e46
5개의 변경된 파일396개의 추가작업 그리고 25개의 파일을 삭제

파일 보기

@@ -81,9 +81,10 @@
2. 선택 소프트웨어 (권장)
--------------------------------------------------------------------------------
[2-1] Docker Desktop
[2-1] Docker Desktop (선택 — DB 컨테이너 사용 시에만 필요)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
용도: 로컬 개발용 DB(MySQL/PostgreSQL) + Redis를 컨테이너로 실행
용도: 로컬 개발용 DB(MySQL/PostgreSQL)를 컨테이너로 실행
※ Redis는 Embedded Redis가 자동 구동되므로 Docker 불필요
* Windows
winget install --id Docker.DockerDesktop
@@ -119,19 +120,19 @@
GRANT ALL ON mos.* TO 'jsh'@'%';
[2-3] Redis
[2-3] Redis (설치 불필요)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
용도: 캐시, 세션 저장소
* Windows (Docker 권장, 네이티브 미지원)
docker run -d -p 6379:6379 redis:7-alpine
WBX Spring Framework에 Embedded Redis가 내장되어 있어 별도 설치가
필요하지 않습니다. 앱 시작 시 다음 순서로 자동 동작합니다:
* macOS
brew install redis && brew services start redis
1) 외부 Redis 감지 → 그대로 사용 (운영 환경)
2) 외부 Redis 없음 → Embedded Redis 자동 시작 (개발 환경)
3) Embedded Redis 실패 → 인메모리 캐시 전환 (최후 안전장치)
* Linux
sudo apt install -y redis-server (Ubuntu)
sudo yum install -y redis (RHEL)
운영 환경에서 외부 Redis를 사용하려면 .env에 설정:
SPRING_DATA_REDIS_HOST=redis.company.com
--------------------------------------------------------------------------------
@@ -151,7 +152,7 @@
scripts\install.bat (Windows)
./scripts/install.sh (Linux/macOS)
# 3) Docker로 MySQL + Redis 시작
# 3) Docker로 MySQL 시작 (Redis는 Embedded Redis 자동 구동)
docker compose -f docker-compose-dev.yml up -d
# 4) .env 파일 수정 (DB 비밀번호를 docker-compose 설정에 맞춤)
@@ -185,13 +186,11 @@
# 3) MySQL/PostgreSQL 설치 후 DB 생성
# 위 [2-2] 참고
# (Redis는 Embedded Redis 자동 구동 — 설치 불필요)
# 4) Redis 설치
# 위 [2-3] 참고
# 4) .env 파일을 실제 DB 정보에 맞게 수정
# 5) .env 파일을 실제 DB 정보에 맞게 수정
# 6~7) 앱 실행 및 확인 (위와 동일)
# 5~6) 앱 실행 및 확인 (위와 동일)
--------------------------------------------------------------------------------
@@ -206,7 +205,7 @@
| MySQL 8.0 | 3306 | jsh | PW: jsh@ (기본 프로필) |
| | | | root PW: rootpassword |
| PostgreSQL 16 | 5432 | jsh | PW: jsh@ (--profile pg) |
| Redis 7 | 6379 | - | 인증 없음 (개발용) |
| Redis 7 | 6379 | - | Embedded Redis 자동 구동 |
+------------------+--------+----------+------------------------------+
프로필별 실행:
@@ -250,7 +249,7 @@
| 8081 | wtm-api | WTM API, Admin, Swagger |
| 3306 | MySQL | 기본 DB (mysql 프로필) |
| 5432 | PostgreSQL | 대안 DB (postgresql 프로필) |
| 6379 | Redis | 캐시, 세션 |
| 6379 | Redis | Embedded Redis 자동 구동 (별도 설치 불필요)|
| 5173 | wtm-frontend | Vue 3 개발 서버 |
| 8001 | WBX FastAPI | 선택, 그룹웨어 동시 운영 시 |
+--------+------------------+------------------------------------------+
@@ -273,9 +272,10 @@
2) .env 파일의 DB_HOST, DB_PORT, DB_PASS 확인
3) telnet localhost 3306 으로 연결 가능 여부 확인
Q: Redis 연결 실패
A: docker ps 에서 redis 컨테이너 실행 중인지 확인
또는 Redis를 직접 설치하고 기본 포트(6379) 확인
Q: Redis 관련 로그가 나옴
A: Embedded Redis가 자동 구동됩니다. 별도 조치 불필요.
로그에 "[WBX] Embedded Redis 시작" 출력 시 정상 동작.
포트 6379가 이미 사용 중이면 외부 Redis를 자동 감지하여 사용합니다.
Q: Lombok 관련 컴파일 에러
A: IDE에서 Annotation Processor 활성화 필요