📑 목차
시스템 개요 개발 배경 및 목적 접근 방법 시스템 아키텍처 데이터 모델 연계 시스템

📋 소스 개선 관리 시스템

코드 개선 사항과 개발 이력을 체계적으로 추적·관리하는 관리자 전용 시스템입니다. 모든 소스코드 변경, 버그 수정, 기능 추가, 성능 개선, 리팩토링 작업을 일관된 형식으로 기록하고 배포까지 추적할 수 있습니다.

🔐 접근 권한: 관리자 전용 페이지입니다. one_member_admin_id 세션이 필요하며, onlyonemaket 계정은 접근이 제한됩니다.

개발 배경 및 목적

🎯 추적성 (Traceability)

누가, 언제, 무엇을, 왜 수정했는지 완전한 감사 추적(audit trail)을 제공합니다. 모든 코드 변경은 날짜·개발자·영향도와 함께 기록됩니다.

📊 가시성 (Visibility)

대시보드를 통해 프로젝트별·카테고리별·상태별 개선 현황을 한눈에 파악할 수 있습니다. 진행 중인 작업과 완료된 작업을 실시간으로 추적합니다.

🔄 연계성 (Integration)

버전 관리 시스템(vermanager)의 릴리즈와 자동 연동되어, 어떤 개선사항이 어떤 버전에 포함되었는지 추적합니다. 공지사항 시스템과도 연결되어 배포 소식을 자동 공지할 수 있습니다.

🤖 자동화 (Automation)

AI가 개발한 내용을 자동 등록 스크립트(auto_register_*.php)로 일괄 등록할 수 있습니다. 중복 체크 로직이 내장되어 있어 안전하게 운영됩니다.

접근 방법

1
관리자 로그인

https://kiam.kr/admin/ 에서 관리자 계정으로 로그인합니다.

2
좌측 메뉴에서 진입

관리자 좌측 메뉴에서 「소스개발관리」 메뉴를 클릭하거나, 직접 URL로 접근합니다.

3
직접 URL

https://kiam.kr/admin/admin_source_improvements.php

상단 breadcrumb: 3종환경비교 → 크론잡관리 → 이슈대시보드 → 소스개발관리

시스템 아키텍처

┌─────────────────────────────────────────────────────────┐
│              소스 개선 관리 시스템                          │
├─────────────────────────────────────────────────────────┤
│  admin_source_improvements.php     ← 메인 목록 페이지      │
│  admin_source_improvements_form.php ← 등록/수정 폼         │
│  /admin/ajax/source_improvements_save.php ← AJAX 저장     │
│  notice_ai-write.php               ← 공지 연동             │
│  auto_register_improvements.php    ← AI 자동 등록 (Phase1) │
│  auto_register_phase3_6.php       ← AI 자동 등록 (Phase3~6)│
├─────────────────────────────────────────────────────────┤
│  DB: source_improvements 테이블 (23개 컬럼)                │
│  ┌──────────────────────────────────────────────────┐   │
│  │ id, date, project, category, title, description   │   │
│  │ developer, files_changed, lines_added, lines_deleted│  │
│  │ status, test_result, environments, deployed_date  │   │
│  │ deployed_by, deployment_log, notice_id            │   │
│  │ impact_level, notes, created_at, updated_at       │   │
│  └──────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────┤
│  연계: vermanager (버전 관리) ← 개선사항 릴리즈 매핑       │
│  연계: notice (공지사항)     ← 배포 공지 자동 발행         │
└─────────────────────────────────────────────────────────┘

데이터 모델 (source_improvements 테이블)

컬럼타입설명
idINT자동 증가 기본 키
dateDATE작업 날짜 (YYYY-MM-DD)
projectVARCHAR(50)프로젝트명 (아이엠플랫폼, SMS, ainote, nalara, 기타)
categoryVARCHAR(50)분류 (버그 수정, 기능 추가, 성능 개선, 보안, 리팩토링, 문서화)
titleVARCHAR(200)개선 제목 (최대 200자)
descriptionTEXT상세 설명 (마크다운 스타일)
developerVARCHAR(50)개발자 이름
files_changedINT수정된 파일 수
lines_addedINT추가된 라인 수
lines_deletedINT삭제된 라인 수
statusVARCHAR(20)상태 (개발중, 테스트중, 완료, 배포됨, 롤백)
test_resultVARCHAR(10)테스트 결과 (PASS, FAIL, SKIP)
environmentsVARCHAR(50)배포 환경 (쉼표 구분: dev,test,prod)
deployed_dateDATETIME배포 일시
deployed_byVARCHAR(50)배포자
impact_levelVARCHAR(10)영향도 (낮음, 중간, 높음, 긴급)
notesTEXT추가 메모
created_atDATETIME생성 일시
updated_atDATETIME수정 일시