[BackEnd] MVC2 구조 [v0.3]

[sooah-0208]

배경

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

검토안

• MVC2 구조 3차 확정

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			# 회원 관리 (/post: OCR, /put : 회원 가입, /patch : 회원 수정, /delete : 회원 탈퇴)
        ├── auth.py			# 인증 관리 (/post : 로그인, /patch: 비밀번호 확인, /delete : 로그아웃)
        ├── invite.py			# /put : 초대 관리
        ├── alarm.py			# 알람 (/get : 알람목록 조회, /patch: 읽음처리(개별/전체), /delete: 목록 삭제, /websocket: 실시간 알람)
        ├── verification.py         # 검증과정 (/post: 회원 중복체크, /put: 비밀번호 찾기 메일 발송)
        ├── esgmng.py              # esg관리자 페이지 (/put : 이슈 그룹 관리, /patch : 정보 수정)
        └── board.py			# 게시판, 온보딩 페이지 (/get : KPI 정보 조회, /post: 온보딩 데이터 조회, /put: 온보딩 데이터 입력)

    └── models/
        ├── model.py			# BaseModel 통해 만들어진 model들 
        ├── user.py			# 회원 관련
        ├── auth.py			# 인증 관련
        ├── invite.py			# 초대 관련
        └── board.py			# KPI 정보 조회

담당자

user.py: @mpsddd-commits , @choiyc05
auth.py: @sooah-0208 , @HorieZA @choegayoung

참고사항

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

로직설계
#27 로그인
#48 회원관리
#49 초대
#50 알람
#51 검증
#52 게시판(미정)

응답구조
#29 Response Body
#24 Method

기획안
#22 메일발송
#28 로그

영향 범위

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

담당자

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

결정일

2026-04-27

[sooah-0208]

/GET 방식에서 Body로 객체전달이 불가하여 RESTFull방식에서 소폭 수정하였습니다.

2차 검증 과정을 거치는 로직을 모두 verification.py로 변경합니다.
@frankie516c