- % Done changed from 0 to 90
[PM 공통 결정] 모든 관리자 기준정보의 추가·수정·사용 중지 및 변경 이력 관리¶
결정일: 2026-11-12
적용 범위: MD Global University 학사관리 시스템 전체
1. 공통 원칙¶
시스템에서 관리하는 모든 기준정보와 정책은 개발자가 코드에 고정하지 않고, 권한 있는 관리자가 관리자 화면에서 직접 관리할 수 있도록 합니다.
다음 기능을 공통으로 지원합니다.
- 추가(Create): 관리자가 새로운 항목을 자유롭게 등록
- 조회(Read): 전체 항목과 사용 중·사용 중지 상태 조회
- 수정(Update): 기존 항목의 명칭·금액·조건·설정값 변경
- 삭제(Deactivate): 기존 항목을 사용 중지 처리
- 재사용(Reactivate): 사용 중지 항목을 다시 활성화
- 변경 이력(Audit): 변경자·변경 시각·변경 전후 값·변경 사유 기록
초기 Seed 데이터는 예시값이며 고정된 운영 규정이 아닙니다.
2. 적용 대상¶
본 원칙은 특정 기능에 한정하지 않고 모든 관리자 관리항목에 공통 적용합니다.
- 대학·학과·전공·학위과정
- 학기 유형 및 학기 운영 기준
- 성적 등급·평점·GPA·재수강 기준
- 졸업·수료 요건
- 증명서 종류·서식·발급번호 규칙
- 등록금 항목 및 금액
- 장학금·감면 종류와 적용 기준
- 환불·분납 정책
- 통화·환율 설정
- 기타 향후 추가되는 기준정보 및 정책
3. 등록금 및 금액 관리¶
등록금과 각종 비용은 학위과정별 금액만 수정하는 방식으로 제한하지 않습니다.
관리자는 금액 항목 자체를 자유롭게 추가·수정·사용 중지할 수 있어야 합니다.
예시:
- 등록금
- 입학금
- 실습비
- 증명서 발급 수수료
- 기타 비용
각 항목은 필요에 따라 다음 속성을 관리합니다.
- 항목 코드 및 명칭
- 금액
- 통화(KRW/CNY)
- 적용 학위과정 및 학기
- 시행일 및 종료일
- 사용 여부
- 변경 이력
새로운 금액 항목을 추가하기 위해 소스코드를 수정하거나 배포할 필요가 없어야 합니다.
4. 삭제 및 과거 데이터 보호¶
삭제는 기본적으로 물리적 삭제가 아닌 사용 중지 방식으로 구현합니다.
- 사용 중지된 항목은 신규 등록·청구·발급 등의 선택 목록에서 제외
- 과거 거래·성적·증명서 등 기존 기록은 유지
- 기존 기록에 적용된 금액과 규정은 임의 변경 금지
- 참조 중인 항목의 물리적 삭제는 금지
- 필요 시 관리자 권한으로 재활성화 가능
5. 시행일 및 버전 관리¶
금액이나 정책처럼 적용 시점이 중요한 항목은 시행일 기반 버전 관리를 지원합니다.
- 관리자가 시행일 지정
- 신규 업무에는 해당 시점에 유효한 기준 적용
- 기존 확정 기록에는 당시 기준 유지
- 변경 이력과 승인 기록 보존
- 필요 시 적용 대상(학위과정·학기·입학년도 등) 지정
단순 명칭 수정과 정책 변경은 영향 범위가 다르므로, 과거 기록에 영향을 주는 변경은 별도 버전으로 관리합니다.
6. 개발 지침¶
- 기존 모델·서비스·관리자 UI를 우선 재사용합니다.
- 관리자 변경이 필요한 값을 코드에 하드코딩하지 않습니다.
- 공통 CRUD·활성 상태·감사 로그 기능을 최대한 재사용합니다.
- 변경된 설정이 실제 업무에 반영되는지 검증합니다.
- 과거 데이터 정합성 및 참조 관계를 유지합니다.
- 관리자 권한에 따른 변경 제한을 적용합니다.
- 기존 기능에 없는 부분은 영향 범위를 확인한 후 후속 일감으로 분리합니다.
7. 담당자 요청¶
우섭님은 본 공통 원칙을 #1602~#1605 및 관련 개발 담당자에게 공유해 주세요.
특히 등록금 담당 서현님과 협의하여 금액 항목 자체를 추가·수정·사용 중지할 수 있는 관리자 기능이 구현 범위에 포함되도록 확인해 주세요.
기존 구현과 비교하여 추가 개발이 필요한 항목은 별도로 보고해 주세요.
최종 결정: 모든 관리자 관리항목은 추가·조회·수정·사용 중지·재활성화·변경 이력 관리를 기본 원칙으로 합니다.