[BackEnd] MVC2 구조 [v0.2]

[sooah-0208]

배경

front 및 DB 팀, 문서팀 과 해당 안건 공유하기 위함

검토안

• MVC2 구조 2차 확정

2차 결정

gateway/
├── logset.py					# Log 관리, 파일 저장 (JSON 형식 등)

backend/
└── src/
    ├── utils/					# 외부 라이브러리 및 공통 모듈 관리
        ├── setting.py			# 환경 변수 관리 (Env, Config)
        ├── **kafkasv.py**		# Kafka 서비스 (Pd: 생산, Cs1: 이메일 발송, Cs2: AI 처리) 
        ├── **rediscl.py**		# Redis 클라이언트 설정 및 연결
        ├──**ocr.py**			# 문서 텍스트화
        ├── websc.py			# 실시간 로그 화면 출력 및 알람 처리 (WebSocket 등)
        ├── **db.py**			# 데이터베이스(DB) 연결 및 세션 관리
        ├── **file.py**			# 파일 업로드 및 다운로드 로직
        ├── **tokenset.py**		# 인증 토큰 관리 (Access Token, Refresh Token)
        └── crypto.py			# 데이터 암호화 및 복호화 처리
    ├── apis/
        ├── **user.py**			# 회원 관리 (/get: 중복체크, /post: OCR, /put : 회원 가입, /patch : 회원 수정, /delete : 회원 탈퇴)
        ├── **auth.py**			# 인증 관리 (/get : 비밀번호 찾기 메일 발송,/post : 로그인, /patch: 비밀번호 확인, /delete : 로그아웃,)
        ├── invite.py			# /put : 초대 관리
        └── board.py			# /get : KPI 정보 조회
    └── models/
        ├── model.py			# BaseModel 통해 만들어진 model들 
        ├── **user.py**			# 회원 관련
        ├── **auth.py**			# 인증 관련
        ├── invite.py			# 초대 관련
        └── board.py			# KPI 정보 조회

담당자(auth: @shellfolders )

kafkasv.py: @choiyc05
rediscl.py: @HorieZA
db.py: @sooah-0208
file.py: @choegayoung
tokenset.py: @mpsddd-commits
ocr.py: @choegayoung @luniana217

참고사항

• Models : Model / (front) : View / apis : Controller / utils : 유틸
• 추가적으로 작업중 수정 가능성 높음. 수정시 해당 파일 수정 및 댓글로 수정사항 알리도록 함

영향 범위

FE @x2bjvhmmwg-gif / BE / DB @leeej9801-max / 문서 @frankie516c

담당자

@HorieZA , @mpsddd-commits , @choiyc05 @sooah-0208 , @choegayoung , @luniana217

결정일

2026-04-27

[mpsddd-commits]

0428
FE 팀에서 OCR 성능 저하 이슈와 보안성 강화를 위해 BE팀으로 기능 이관 -> 디렉토리 수정 utils/ocr.py 추가

[sooah-0208]

0430

user.py중 /post: OCR EndPoint 추가
사업자등록증에서 파싱된 데이터를 front에 전달하기 위한 로직을 추가하였습니다.

auth.py중 /patch: 비밀번호 확인 EndPoint 추가
회원정보 수정등의 상황에 보안 상향을 위하여 2차인증 기능을 추가하였습니다.