refactor: API 서버 구조 개선 및 표준화

- 통합 에러 처리 시스템 구축:
  * utils/errorHandler.js: ApiError 클래스 및 에러 미들웨어
  * 데이터베이스, 유효성 검사, 권한 에러 표준화
  * 비동기 함수 래퍼 (asyncHandler) 추가

- 응답 포맷터 시스템 구축:
  * utils/responseFormatter.js: 일관된 API 응답 형식
  * 성공, 페이지네이션, 인증, 파일업로드 등 전용 포맷터
  * Express 응답 확장 미들웨어

- 유효성 검사 시스템 구축:
  * utils/validator.js: 스키마 기반 유효성 검사
  * 필수 필드, 타입, 길이, 형식 검사 함수들
  * 일반적인 스키마 정의 (사용자, 프로젝트, 작업보고서 등)

- 코드 정리 및 표준화:
  * 삭제된 테이블 참조 제거 (work_report_audit_log 등)
  * 대문자 테이블명을 소문자로 통일 (Users -> users)
  * authController.js에 새로운 유틸리티 적용 예시

- 미들웨어 통합:
  * index.js에 에러 핸들러 및 응답 포맷터 적용
  * 헬스체크 엔드포인트 개선
This commit is contained in:
Hyungi Ahn
2025-11-03 10:42:29 +09:00
parent 31e941cfbd
commit 4716434d65
8 changed files with 720 additions and 105 deletions

View File

@@ -4,96 +4,99 @@ services:
# MariaDB 데이터베이스
db:
image: mariadb:10.9
container_name: fb_db
container_name: tkfb_db
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD=hyungi_root_password_2025
- MYSQL_ROOT_PASSWORD=tkfb2024!
- MYSQL_DATABASE=hyungi
- MYSQL_USER=hyungi
- MYSQL_PASSWORD=hyungi_password_2025
- MYSQL_USER=hyungi_user
- MYSQL_PASSWORD=hyungi2024!
volumes:
- db_data:/var/lib/mysql
- ./api.hyungi.net/migrations:/docker-entrypoint-initdb.d
ports:
- "20306:3306"
networks:
- fb_network
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
timeout: 20s
retries: 10
networks:
- tkfb_network
# API 서버 (Node.js)
# Node.js API 서버
api:
build:
context: ./api.hyungi.net
dockerfile: Dockerfile
container_name: fb_api
container_name: tkfb_api
depends_on:
db:
condition: service_healthy
restart: unless-stopped
ports:
- "20005:20005"
- "20005:3005"
environment:
- NODE_ENV=production
- PORT=3005
- DB_HOST=db
- DB_PORT=3306
- DB_USER=hyungi_user
- DB_PASSWORD=hyungi2024!
- DB_NAME=hyungi
- DB_USER=hyungi
- DB_PASSWORD=hyungi_password_2025
- DB_ROOT_PASSWORD=hyungi_root_password_2025
- DB_ROOT_PASSWORD=tkfb2024!
- JWT_SECRET=tkfb_jwt_secret_2024_hyungi_secure_key
volumes:
- ./api.hyungi.net/public/img:/usr/src/app/public/img:ro
- ./api.hyungi.net/uploads:/usr/src/app/uploads
- ./api.hyungi.net/logs:/usr/src/app/logs
networks:
- fb_network
- ./api.hyungi.net/routes:/usr/src/app/routes
- ./api.hyungi.net/controllers:/usr/src/app/controllers
- ./api.hyungi.net/models:/usr/src/app/models
- ./api.hyungi.net/index.js:/usr/src/app/index.js
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"
networks:
- tkfb_network
# UI (Nginx)
web-ui:
# Web UI (Nginx)
web:
build:
context: ./web-ui
dockerfile: Dockerfile
container_name: fb_web_ui
container_name: tkfb_web
restart: unless-stopped
ports:
- "20000:80"
volumes:
- ./web-ui:/usr/share/nginx/html:ro
networks:
- fb_network
depends_on:
- api
networks:
- tkfb_network
# FastAPI 브릿지
fastapi-bridge:
# FastAPI Bridge
fastapi:
build:
context: ./fastapi-bridge
dockerfile: Dockerfile
container_name: fb_fastapi_bridge
container_name: tkfb_fastapi
restart: unless-stopped
ports:
- "20010:8000"
- "20008:8000"
environment:
- EXPRESS_API_URL=http://api:20005
- NODE_ENV=production
- API_BASE_URL=http://api:3005
depends_on:
- api
networks:
- fb_network
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
interval: 30s
timeout: 10s
retries: 3
- tkfb_network
# phpMyAdmin (DB 관리도구)
# phpMyAdmin
phpmyadmin:
image: phpmyadmin/phpmyadmin:latest
container_name: fb_phpmyadmin
container_name: tkfb_phpmyadmin
depends_on:
- db
restart: unless-stopped
@@ -102,15 +105,16 @@ services:
environment:
- PMA_HOST=db
- PMA_USER=root
- PMA_PASSWORD=hyungi_root_password_2025
- PMA_PASSWORD=tkfb2024!
- UPLOAD_LIMIT=50M
networks:
- fb_network
- tkfb_network
volumes:
db_data:
driver: local
networks:
fb_network:
tkfb_network:
driver: bridge
name: tkfb_network