[BackEnd] MVC2 구조 [v0.1]

[sooah-0208]

배경

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

검토안

• MVC2 구조

1차 결정

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

참고사항

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

영향 범위

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

담당자

@mpsddd-commits , @choiyc05 @sooah-0208

결정일

2026-04-22

[sooah-0208]

0423
회원 관리 섹션 수정(apis/user.py)
이메일 / 사업자번호 중복확인 ENDPOINT -> GET으로 추가함

[sooah-0208]

추가 로직 변동사항이 많아 재업로드 예정입니다.
재업로드 후 해당 Log 삭제 예정입니다.
감사합니다.

[sooah-0208]

0423
추가 api
회원정보 수정창 진입시 / 수정버튼 클릭시 endpoint 분리
2차 비밀번호 검증 endpoint 생성 후 수정에 넣을지 탈퇴에 넣을지 결정

[frankie516c]

@sooah-0208
실시간 로직 변동 사항 업데이트 감사합니다.
중복 확인 Endpoint를 GET으로 분리하신 부분은 RESTful한 설계 관점에서 매우 유용할 것으로 보입니다.

한 가지 제안 드리고 싶은 부분이 있습니다.
기존 로그 삭제가 아닌 본문의 [1차 결정] 섹션을 수정하시고 댓글에는 '무엇이 왜 바뀌었는지' 기록을 남겨주실 수 있을지요? 추후에 히스토리를 파악하기 수월하여 Decision making process를 구두로 다시 설명하는 일이 없을 것이라고 생각합니다.

재업로드 하실 때 제목에 [v1.1] 처럼 버전을 달아주시면 더 명확할 것 같습니다.
수고 많으셨습니다.
감사합니다.

[sooah-0208]

재업로드 하실 때 제목에 [v1.1] 처럼 버전을 달아주시면 더 명확할 것 같습니다. 해당 부분 체크하였습니다.
1차 결정 섹션을 살려둔 상태로
버전 추가하여 새업로드 하며 2차, 3차 등 변경 사항을 해당 페이지에 추가하도록 하겠습니다.