king
9c58b022e2
- ERP 셸: 좌측 사이드바 + 상단 헤더 + 콘텐츠 영역(erp_base.html)
- 분기: 슈퍼관리자 → 업무모듈 카드, 일반사용자 → ERP 메인(erp_home.html)
- 신규 라우트: /modules (슈퍼관리자 모듈 카드 재진입)
- 개인경비 모듈: app/modules/expense/ (라우터/저장소/템플릿)
- JSON 저장소(ExpenseStore) + PostgreSQL 저장소(ExpenseDBStore)
- 팩토리: EXPENSE_DB_URL 있으면 DB, 없으면 JSON 폴백
- DB: scripts/sql/expense_db_init.sql (멱등 DDL, postgres-db 컨테이너)
- expense_db, 역할 expense_app, 테이블 expense_items, 인덱스/트리거
- 마이그레이션: scripts/migrate_expense_json_to_db.py (멱등, --dry-run)
- 의존성: psycopg[binary,pool]>=3.2
- 환경변수: EXPENSE_DB_URL 추가
- 문서: CLAUDE.md 작업 기준 + docs/{PROJECT_OVERVIEW,SERVER_ARCHITECTURE,DATABASES,DEPLOYMENT}.md
- main-app 배포 경로 /opt/www/main 고정 명시
- 위험 명령(DROP/TRUNCATE/rm -rf/volume 삭제) 사용자 승인 정책
2.7 KiB
2.7 KiB
Server Architecture
전체 구성도
[Windows 개발 PC]
│ Git push / 파일 수정
▼
[Gitea Repository] (https://gitea.no1king.freeddns.org/king/dbx-main.git)
│ git pull
▼
[Ubuntu Server / Proxmox VM]
│
├─ Nginx Proxy Manager (NPM)
│ dbx.no1king.freeddns.org → http://192.168.0.194:80
│
├─ Docker
│ ├─ main-app 컨테이너 (FastAPI / Uvicorn)
│ ├─ PostgreSQL 컨테이너
│ └─ 기타 부속 컨테이너
│
└─ PostgreSQL Databases
├─ itemcode_db
├─ orderlist_db
└─ return_db
요청 흐름
- 사용자 브라우저 →
https://dbx.no1king.freeddns.org - NPM(외부 HTTPS) → 내부 HTTP
192.168.0.194:80 - 서버 내부 Nginx/Compose 포워딩 →
main-app컨테이너 (FastAPI) - FastAPI → PostgreSQL 컨테이너(같은 Docker 네트워크) 또는 외부 쇼핑몰/택배 API
구성요소
| 구성요소 | 설명 |
|---|---|
| Ubuntu Server | 호스트 OS. 도커 호스트. systemd로 docker.service 관리 |
| Docker | 모든 앱·DB는 컨테이너로 운영. Compose 파일 단위 배포 |
| PostgreSQL | Docker 컨테이너에서 운영. 데이터는 named volume |
| Nginx Proxy Manager | 외부 HTTPS 종단, 인증서 자동 갱신, 호스트명 라우팅 |
| FastAPI (main-app) | 메인 ERP 백엔드. 인증·라우팅·외부 API 연동 |
| Gitea | 소스 저장소(사내 호스팅) |
네트워크 / 포트
| 항목 | 값 |
|---|---|
| 외부 도메인 | dbx.no1king.freeddns.org (HTTPS, NPM 종단) |
| 내부 호스트 | 192.168.0.194 |
| 내부 노출 포트 | 80 (NPM → 컨테이너) |
| 로컬 개발 포트 | 8080 |
| PostgreSQL | Docker 내부 네트워크에서만 접근 (호스트 노출 금지 권장) |
배포 경로
운영 서버 기준, 아래 중 하나에 클론한다. 상세는 DEPLOYMENT.md.
/opt/dbx-corm/opt/dbx-orderlist/opt/www/main
같은 호스트에 여러 서비스를 운영하므로, 경로는 서비스별로 분리한다.
인증 흐름
- 사용자가
/auth/google진입 → Google OAuth 동의 화면 - 콜백에서
id_token검증 (hd=dbxcorp.co.kr힌트는 참고용) - 서버에서 이메일 도메인 +
ALLOWED_EMAILS화이트리스트 검사 - 통과 시 세션 쿠키 발급(
SESSION_SECRET_KEY서명)
운영 시 점검 포인트
- NPM 호스트 매핑이 살아있는가 (
dbx.no1king.freeddns.org → 192.168.0.194:80) docker compose ps로main-app,postgres컨테이너 상태- PostgreSQL volume 마운트 경로와 백업 위치
.env값 유실 여부 (특히GOOGLE_CLIENT_*,SESSION_SECRET_KEY)