Hyein/PTC
1
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

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

New Issue
Open
opened 2026-03-23 14:54:48 +09:00 by Hyein · 1 comment
Hyein commented 2026-03-23 14:54:48 +09:00
Owner
Copy Link
Copy Source

1. 프로젝트 목적

PTC의 복잡한 계정 체계와 분산된 엑셀 데이터를 통합하여, 실시간으로 프로젝트별 손익과 자금 흐름을 추적할 수 있는 엔터프라이즈급 분석 플랫폼을 구축합니다.

2. 통합 관리 체크리스트

🏗️ 인프라 및 서버 통합

  • 통합 서빙 로직 구현: API 서버(4000 포트)가 /PTC/ 경로로 프론트엔드를 직접 서비스하도록 통합
  • 포트 개방 문제 해결: 단일 포트 운영을 통해 사내망 접속 제한 및 보안 설정 간소화
  • 프론트엔드 진단 엔진: 스크립트 로드 실패 시 원인(CDN 차단 등)을 안내하는 Fallback UI 구현

📊 데이터 정합성 및 성능

  • 고성능 인덱싱: 대용량 거래 데이터(6,800건+) 고속 조회를 위한 SQLite 인덱스 8종 최적화
  • 동적 데이터 소스 로드: ptc_source_path.txt 기반으로 소스 엑셀 파일을 자유롭게 교체 가능
  • 3단계 계정 재매핑(Remap): 개별/일괄/행단위 계정 교정 기능을 통한 데이터 정합성 100% 확보

🔨 프로젝트 및 분석 기능

  • 공법 분류 체계 정립: Family/Method 2단계 분류 및 다중 프로젝트 일괄 공법 업데이트 도구 개발
  • 시공 타임라인 관리: 프로젝트별 시작/종료일 관리 및 기간 외 거래 탐지 기반 마련
  • 다차원 Drill-down: 업체-계정-프로젝트 간의 크로스 분석 모달 및 상세 전표 조회 인터페이스

🚀 운영 지원 및 UX

  • Windows 경로 헬퍼: set_ptc_source.bat을 통한 윈도우-WSL 간 경로 변환 및 설정 자동화
  • 검색 성능 최적화: Debounce 및 Deferred Value 적용으로 입력 지연 및 UI 프리징 해결
  • 보고서 자동 생성: 분석 데이터를 기반으로 한 현장용 엑셀 보고서 출력 엔진 (예정)

📊 통합 대시보드(Dashboard) 시각화 및 재무 진단 (신규)

  • 통합 현황 분석: 프로젝트 전반의 입금/출금, 수익률(Margin Rate), 진행률 실시간 연동 시각화
  • 공법/규모별 분석: 5억~50억 규모별 버킷(Buckets) 및 제품군(Family)/공법별 통계 자동 산출
  • 재무 상태 자동 판별: '정상', '선투입', '회수지연', '원가위험' 등 Status Bands 자동 진단 로직 구현
  • 사내망 공유 고도화: PowerShell 스크립트(start_ptc_share.ps1)를 통한 포트 프록시 및 방화벽 자동 설정

3. 핵심 기술 사양

  • Backend: Python 3.12 (BaseHTTP), SQLite3 Optimized
  • Frontend: React 18, Babel Standalone, IBM Plex Sans KR Typography
## 1. 프로젝트 목적 PTC의 복잡한 계정 체계와 분산된 엑셀 데이터를 통합하여, 실시간으로 프로젝트별 손익과 자금 흐름을 추적할 수 있는 **엔터프라이즈급 분석 플랫폼**을 구축합니다. ## 2. 통합 관리 체크리스트 ### 🏗️ 인프라 및 서버 통합 - [x] **통합 서빙 로직 구현**: API 서버(4000 포트)가 `/PTC/` 경로로 프론트엔드를 직접 서비스하도록 통합 - [x] **포트 개방 문제 해결**: 단일 포트 운영을 통해 사내망 접속 제한 및 보안 설정 간소화 - [x] **프론트엔드 진단 엔진**: 스크립트 로드 실패 시 원인(CDN 차단 등)을 안내하는 Fallback UI 구현 ### 📊 데이터 정합성 및 성능 - [x] **고성능 인덱싱**: 대용량 거래 데이터(6,800건+) 고속 조회를 위한 SQLite 인덱스 8종 최적화 - [x] **동적 데이터 소스 로드**: `ptc_source_path.txt` 기반으로 소스 엑셀 파일을 자유롭게 교체 가능 - [x] **3단계 계정 재매핑(Remap)**: 개별/일괄/행단위 계정 교정 기능을 통한 데이터 정합성 100% 확보 ### 🔨 프로젝트 및 분석 기능 - [x] **공법 분류 체계 정립**: Family/Method 2단계 분류 및 다중 프로젝트 일괄 공법 업데이트 도구 개발 - [x] **시공 타임라인 관리**: 프로젝트별 시작/종료일 관리 및 기간 외 거래 탐지 기반 마련 - [x] **다차원 Drill-down**: 업체-계정-프로젝트 간의 크로스 분석 모달 및 상세 전표 조회 인터페이스 ### 🚀 운영 지원 및 UX - [x] **Windows 경로 헬퍼**: `set_ptc_source.bat`을 통한 윈도우-WSL 간 경로 변환 및 설정 자동화 - [x] **검색 성능 최적화**: Debounce 및 Deferred Value 적용으로 입력 지연 및 UI 프리징 해결 - [ ] **보고서 자동 생성**: 분석 데이터를 기반으로 한 현장용 엑셀 보고서 출력 엔진 (예정) ### 📊 통합 대시보드(Dashboard) 시각화 및 재무 진단 (신규) - [x] **통합 현황 분석**: 프로젝트 전반의 입금/출금, 수익률(Margin Rate), 진행률 실시간 연동 시각화 - [x] **공법/규모별 분석**: 5억~50억 규모별 버킷(Buckets) 및 제품군(Family)/공법별 통계 자동 산출 - [x] **재무 상태 자동 판별**: '정상', '선투입', '회수지연', '원가위험' 등 Status Bands 자동 진단 로직 구현 - [x] **사내망 공유 고도화**: PowerShell 스크립트(`start_ptc_share.ps1`)를 통한 포트 프록시 및 방화벽 자동 설정 ## 3. 핵심 기술 사양 - **Backend**: Python 3.12 (BaseHTTP), SQLite3 Optimized - **Frontend**: React 18, Babel Standalone, IBM Plex Sans KR Typography
Hyein added the ptc 실행분석 label 2026-03-23 14:54:48 +09:00
Hyein changed title from [마스터] [PTC::실행분석] 통합 실행 분석 및 계정 관리 시스템 구축 to [마스터] [PTC::실행분석] 전용 실행 분석 및 계정 관리 시스템 구축 2026-03-23 14:57:40 +09:00
Hyein changed title from [마스터] [PTC::실행분석] 전용 실행 분석 및 계정 관리 시스템 구축 to [마스터] PTC 전용 실행 분석 및 계정 관리 시스템 구축 2026-03-23 15:28:32 +09:00
Hyein changed title from [마스터] PTC 전용 실행 분석 및 계정 관리 시스템 구축 to [마스터] PTC 전용 실행 분석 및 통합 관리 시스템 구축 2026-03-24 13:24:56 +09:00
Hyein changed title from [마스터] PTC 전용 실행 분석 및 통합 관리 시스템 구축 to [Master] PTC 전용 차세대 실행 분석 및 자금 관리 통합 플랫폼 구축 2026-03-24 13:26:51 +09:00
Hyein commented 2026-04-22 17:32:53 +09:00
Author
Owner
Copy Link
Copy Source

manage 브랜치 최근 반영(6e8f606, bc611c3, 90042a0) 기준으로 누락 트랙을 세분화했습니다.

신규 세부 이슈

  • #16 [manage] 프로젝트 생애주기 배분 팝업 영속성/정합성 회귀 안정화\n - #16
  • #17 [manage] 프로젝트/생애주기 화면의 숨김 계정 정책 표준화 (기타 수지·자산 비노출)\n - #17
  • #18 [manage] 카드 합계 vs 상세 내역 차이 원인 추적 도구(배분/숨김 반영) 추가\n - #18
  • #19 [manage] 브랜치/코드 정리: 단일 서버 파일 모듈화 및 화면 스크립트 분리\n - #19
  • #20 [manage] 이슈/문서 동기화 체계 수립 (README-마스터이슈-릴리즈노트 일치)\n - #20

기존 마스터 이슈는 상위 개요로 유지하고, 구현/검증은 위 세부 이슈 기준으로 추적하면 됩니다.

manage 브랜치 최근 반영(`6e8f606`, `bc611c3`, `90042a0`) 기준으로 누락 트랙을 세분화했습니다. ### 신규 세부 이슈 - #16 [manage] 프로젝트 생애주기 배분 팝업 영속성/정합성 회귀 안정화\n - https://gitea.hmac.kr/Hyein/PTC/issues/16 - #17 [manage] 프로젝트/생애주기 화면의 숨김 계정 정책 표준화 (기타 수지·자산 비노출)\n - https://gitea.hmac.kr/Hyein/PTC/issues/17 - #18 [manage] 카드 합계 vs 상세 내역 차이 원인 추적 도구(배분/숨김 반영) 추가\n - https://gitea.hmac.kr/Hyein/PTC/issues/18 - #19 [manage] 브랜치/코드 정리: 단일 서버 파일 모듈화 및 화면 스크립트 분리\n - https://gitea.hmac.kr/Hyein/PTC/issues/19 - #20 [manage] 이슈/문서 동기화 체계 수립 (README-마스터이슈-릴리즈노트 일치)\n - https://gitea.hmac.kr/Hyein/PTC/issues/20 기존 마스터 이슈는 상위 개요로 유지하고, 구현/검증은 위 세부 이슈 기준으로 추적하면 됩니다.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ptc 실행분석
PTC 실행분석 관련 작업
No labels ptc 실행분석
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
Hyein (김혜인)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Hyein/PTC#1