Architecture Docs
이 폴더는 백엔드 구조, 저장소 정책, 위험도 산정 정책, 인증/보안을 관리한다.
이 폴더의 현재 구조 문서는 코드와 맞아야 한다. 단, 미래 확장 구상은 현재 구현으로 오해되지 않도록 별도 상태를 표시한다.
읽는 순서
- BACKEND_STRUCTURE.md
- DATA_STORAGE_POLICY.md
- MARKET_INDICATOR_FOUNDATION.md
- RISK_SCORING_POLICY.md
- RISK_ASSESSMENT_EVIDENCE_MODEL.md
- CODEX AI 위험도 산정 엔진
- SECURITY_AUTHENTICATION.md
책임 구조
ZIP:ON은 현재 단순 계층 구조를 유지한다.
audit
common
config
controller
domain
dto
exception
external
mapper
risk
security
service
web| 패키지 | 책임 |
|---|---|
controller, dto | Spring MVC HTTP 요청/응답 경계와 DTO |
service | use case, transaction, 외부 API/mapper orchestration |
mapper | MyBatis 기반 persistence access |
domain | DB row, 진단 계산 값, 내부 판단 model |
external | data.go.kr, VWorld, Juso, 행정표준코드, R-ONE client/parser |
risk | backend-only 구조화 위험 항목 산정과 OpenAI adapter/fallback |
audit | 관리자·운영 행동 감사 AOP, request context, payload sanitizing |
security | Spring Security, JWT, principal, 401/403 handler |
config, web, common, exception | configuration, request correlation, 공통 응답, 공통 예외 |