브랜치/코드 정리: 단일 서버 파일 모듈화 및 화면 스크립트 분리 #19

New Issue

Hyein · 2026-04-22T17:32:53+09:00

Hyein commented

2026-04-22 17:32:53 +09:00

대상 브랜치: manage

배경

현재 핵심 로직이 server/ptc_api_server.py와 PTC/management_dashboard_preview.html에 집중되어 있어,
기능 추가 시 회귀 위험과 리뷰 난이도가 빠르게 증가하고 있습니다.

목표

유지보수성 개선
회귀 범위 축소
기능별 책임 분리

정리 범위

백엔드 모듈 분리
- 라우팅/핸들러
- 데이터 접근/쿼리
- 도메인 로직(배분/계정 정책)
프론트 스크립트 분리
- 상태관리
- API 통신
- 모달/컴포넌트 렌더링
공통 상수 분리
- 계정 제외 코드
- 프로젝트 타입/공법 매핑
최소 스모크 테스트 스크립트 추가
- 배분 저장/삭제
- 프로젝트 상세 조회
- 숨김 계정 비노출

완료 기준 (Acceptance Criteria)

핵심 파일 크기가 기능 단위로 분해되어 코드 탐색 시간이 단축된다.
변경 영향 범위를 모듈 단위로 설명할 수 있다.
주요 흐름(배분/상세/집계)의 스모크 테스트가 자동 실행된다.

제안 산출물

server/api/*.py, server/services/*.py, server/repository/*.py (예시)
PTC/js/manage/*.js (예시)
tests/smoke/*.js 또는 간단한 API 검증 스크립트

참조 커밋

6e8f606
bc611c3
90042a0

대상 브랜치: manage ## 배경 현재 핵심 로직이 `server/ptc_api_server.py`와 `PTC/management_dashboard_preview.html`에 집중되어 있어, 기능 추가 시 회귀 위험과 리뷰 난이도가 빠르게 증가하고 있습니다. ## 목표 - 유지보수성 개선 - 회귀 범위 축소 - 기능별 책임 분리 ## 정리 범위 1. 백엔드 모듈 분리 - 라우팅/핸들러 - 데이터 접근/쿼리 - 도메인 로직(배분/계정 정책) 2. 프론트 스크립트 분리 - 상태관리 - API 통신 - 모달/컴포넌트 렌더링 3. 공통 상수 분리 - 계정 제외 코드 - 프로젝트 타입/공법 매핑 4. 최소 스모크 테스트 스크립트 추가 - 배분 저장/삭제 - 프로젝트 상세 조회 - 숨김 계정 비노출 ## 완료 기준 (Acceptance Criteria) - 핵심 파일 크기가 기능 단위로 분해되어 코드 탐색 시간이 단축된다. - 변경 영향 범위를 모듈 단위로 설명할 수 있다. - 주요 흐름(배분/상세/집계)의 스모크 테스트가 자동 실행된다. ## 제안 산출물 - `server/api/*.py`, `server/services/*.py`, `server/repository/*.py` (예시) - `PTC/js/manage/*.js` (예시) - `tests/smoke/*.js` 또는 간단한 API 검증 스크립트 ## 참조 커밋 - `6e8f606` - `bc611c3` - `90042a0`

Hyein referenced this issue

2026-04-22 17:32:53 +09:00

[Master] PTC 전용 차세대 실행 분석 및 자금 관리 통합 플랫폼 구축 #1

Hyein changed title from ~~[manage] 브랜치/코드 정리: 단일 서버 파일 모듈화 및 화면 스크립트 분리~~ to 브랜치/코드 정리: 단일 서버 파일 모듈화 및 화면 스크립트 분리

2026-04-22 17:34:04 +09:00

Hyein added reference manage

2026-04-22 17:35:46 +09:00

Hyein closed this issue

2026-04-22 17:52:10 +09:00

Hyein added the ptc 실행분석 label 2026-05-04 09:28:30 +09:00

Sign in to join this conversation.