호스트 구성 · 역할

1. 한눈에 — 주소 3종 × 운영/테스트

모든 주소 앞에 npwp- 를 붙입니다(발주사 확정). 테스트는 npwp-t 입니다.
서버를 주소마다 나누지 않습니다 — WEB 서버의 nginx 하나가 주소를 보고 갈라 줍니다.

2. 왜 주소를 나누나요

주소마다 들어올 수 있는 사람과 열리는 문이 다르기 때문입니다. 하나로 합치면 외부 쇼핑몰이 관리자 기능에 닿을 수 있게 되고, 실수 하나가 사고로 이어집니다.

열지 않은 경로는 아예 없는 것처럼 응답합니다. 관리자 API 가 공개 주소로 새지 않게 하는 장치입니다.

관리자 화면은 정적 파일인데 왜 API 와 주소가 같나요?

같은 주소지만 응답하는 주체가 다릅니다. nginx 가 경로를 보고 갈라, 화면 파일은 자기가 직접 주고 /api/** 만 자바 서버로 넘깁니다. 주소를 나누면 브라우저가 서로 다른 출처로 보아 CORS 설정이 필요해지고, 관리자 토큰을 출처 너머로 실어 보내야 해서 위험이 커집니다. 같은 주소로 두면 그 문제가 아예 생기지 않습니다. 그래서 npwp-admin-api 같은 별도 주소는 만들지 않습니다.

3. 서버 구조 — L4 → WEB(공개망) → WAS(폐쇄망) → DB

발주사 확정 구조입니다. 바깥에서 닿는 것은 WEB 서버뿐이고, 업무 처리와 데이터는 폐쇄망 안에 있습니다.

[ 인터넷 · 외부 쇼핑몰 · 발주사 서버 ]
                 │
         ┌───────┴───────┐
         │ L4 로드밸런서 │   /health 로 각 WEB 서버 생사 확인
         └───────┬───────┘
     ┌───────────┴───────────┐        ← 공개망(DMZ)
 ┌───┴────┐             ┌────┴───┐
 │ WEB #1 │ ··· 동일 ···│ WEB #2 │    nginx — 주소(npwp-api·pg·admin)를 보고 갈라 줌
 └───┬────┘             └────┬───┘    관리자 화면 등 정적 파일도 여기서 직접 응답
     └───────────┬───────────┘
     ┌───────────┴───────────┐        ← 폐쇄망 (외부에서 직접 접속 불가)
 ┌───┴────┐             ┌────┴───┐
 │ WAS #1 │ ··· 동일 ···│ WAS #2 │    자바 API — 업무 처리
 │ 공유폴더│◀── 마운트 ──│        │    파일 실물은 WAS #1 의 폴더를 두 대가 함께 바라봄
 └───┬────┘             └────┬───┘
     └───────────┬───────────┘
             ┌───┴───┐
             │  DB   │   MariaDB (1대)
             └───────┘

4. 개발자 문서 — 주소마다 그 주소의 API 만

각 주소의 /developer 하나로 들어갑니다. 그 주소에서 실제로 부를 수 있는 API 만 설명합니다 — 부를 수 없는 API 를 보여 주면 오히려 헷갈리기 때문입니다.

테스트 주소로 들어오면 문서 맨 위에 “테스트 서버” 띠가 뜨고, 문서 안의 기준 주소도 그 서버 기준으로 바뀝니다. 개발자가 운영·테스트를 헷갈려 열쇠를 잘못 쓰는 사고를 막기 위한 것입니다.

5. 서버 상태 확인

모든 주소에 두 경로가 있습니다.

• /health — L4 가 보는 경로입니다. WEB 서버가 직접 답하므로 WAS 장애 시에도 200 입니다.
• /health/was — WAS 까지 살아 있는지 확인합니다. 운영자·모니터링용입니다.

6. 발주사에 요청드리는 것