Feature #990
closedFeature #980: [2026 OIBC] 공모전 참가 준비 및 접수 완료
[OIBC] Baseline VPP Partition 설계
100%
Description
Random/균등 분할 등 기준이 되는 Baseline VPP 구성방식과 Capacity Validator 구조 설계
영조 Updated by 영우 조 22 days ago
진행 기록 — 2026-10-27 KST¶
완료한 부분¶
- 기존 P0-08 Baseline 설계에 패키지의 >=20,000kW 제약과 원본 capacity_kw 정밀도를 연결했습니다.
- 용량 균등 greedy는 용량 내림차순·동률 ID 순으로 처리하여 현재 용량 합이 작은 그룹에 배정합니다. 단순 교대 배정과 구분합니다.
- 작은 용량부터 한 그룹에 넣어 임계값 이상이 되면 멈추는 threshold 후보도 정의했습니다. 정확한 최소 subset·최악 수익·수익 하한을 보장하지 않는 스트레스 후보입니다.
- 실제 용량표의 단발 진단 결과: greedy 127/126개, 21,334.500/21,320.870kW(여유 +1,334.500/+1,320.870kW). threshold 218/35개, 20,248.335/22,407.035kW(여유 +248.335/+2,407.035kW).
- 두 후보 모두 ID 전체 일치·중복 없음·두 그룹 최소 용량 충족을 확인했습니다. 입력 순서를 바꿔도 같은 mapping이 나왔습니다.
- 합성 반례 greedy 25/19 실패와 대안 20/24 성공을 구분했고, 경계값 포함도 확인했습니다. 후보 실패를 전체 문제 불가능으로 표시하지 않습니다.
- 후보 assignment와 입력/mapping SHA를 로컬 JSON에 보존했습니다. 그룹은 최소 ID 순으로 정규화하며, 참조 진단 JSON의 G1=B/G2=A는 제공 baseline의 라벨과 다르므로 forecast에도 같은 매핑을 적용해야 합니다.
팀원 확인이 필요한 부분¶
- 문길래: random N=100·seed 0~99 제안과 RNG/시도 정책, 공용 엔진/adapter 경계 검토. random은 아직 실행하지 않았습니다.
- 황수아: 용량 정밀도·단위·기준표와 단발 진단 교차 검토.
- 이상재: 같은 plant forecast/split으로 후보를 비교할 수 있는 검증된 OOF 예측 artifact 및 버전 제공.
상태·산출물¶
- 상태는 README_CAPACITY_PASS_UNREVIEWED이며 공식 승인·제품용 validator 완료가 아닙니다. 실제 S는 null/PREDICTION_NOT_READY입니다.
- 로컬 산출물: OIBC_990_993_설계_진행보고_20261027.md 및 reference/capacity_greedy/threshold_extreme 용량진단 JSON.
- greedy mapping SHA-256: 8ccfcd88dfc505d6f8c41c7947b3bc137b6ca0059aef52ad3503d6be2d1a239e.
- threshold mapping SHA-256: 5c3bcc74109cacdbeae4dd6bf899f4e2fd7098b2b224073d6bde43a2e66c0b65.
- 제품 엔진·제출 CSV·실제 수익 평가는 미수행입니다.
영조 Updated by 영우 조 22 days ago
- Status changed from New to In Progress
- % Done changed from 0 to 30
Capacity Validator 구현 착수 — 2026-10-27 KST¶
사용자 지시에 따라 #990의 Capacity Validator를 구현합니다. 기존 baseline 설계·용량 진단을 바탕으로 착수 상태를 In Progress, 진척도 30%로 기록합니다. 이는 단계 기준 관리 추정치이며 작업시간 비율이나 팀 승인율이 아닙니다.
이번 범위: 정확한 최소 용량 경계(>= 및 strict 설정), ID 누락·중복·미등록 검증, 그룹·용량 입력 오류 보고, 합성 테스트 및 기존 로컬 후보의 회귀 확인. 실제 수익 평가·제출은 범위 밖입니다.
팀 확인 대기: 황수아의 ID/용량 계약·AC/DC 검토, 문길래의 정본·엔진 배치 검토와 random 정책. 구현·테스트 결과가 준비되면 진척도와 증거를 다시 갱신하겠습니다.
영조 Updated by 영우 조 22 days ago
- % Done changed from 30 to 70
Capacity Validator 구현·검증 결과 — 2026-10-27 KST¶
완료한 부분¶
- 최신 origin/main(4452e8cdc1c5c71148bb5aa5721f38075318a15e) 기반 전용 브랜치 vpp/oibc-capacity-validator-20261027에서 구현했습니다. 기존 Spec 브랜치와 CAD 작업트리는 보존했습니다.
- 신규 파일 4개: scripts/vpp_capacity_validator.py, scripts/oibc2026_capacity_rule_v0_1.json, tests/unit/test_vpp_capacity_validator.py, docs/OIBC_CAPACITY_VALIDATOR_V0_1.md.
- 공용 함수는 발전소 집합·그룹 수/이름·최소 용량·단위·quantum·경계 포함 여부를 설정으로 받습니다. OIBC 숫자는 별도 설정 파일로 분리했습니다. 공용 엔진 디렉터리나 CAD 서버 연결은 만들지 않았습니다.
- 용량은 Decimal/10진 문자열/정수로 받고 0.001kW 정수 단위로 정확히 합산합니다. float·NaN/Inf·음수·무단 반올림·단위 불일치는 거부합니다. 0 용량은 명시적 정책으로 구분합니다.
- ID 누락·중복·미등록, 기준표 중복, 그룹 수/라벨/빈 그룹, 필드 누락을 검사합니다. ID 원문·선행 0은 보존합니다. 잘못된 ID 입력의 부분 합계는 null로 보고합니다.
- 경계 19,999.999/20,000/20,000.001kW를 >= 및 strict 설정으로 검증했습니다. 그룹별 발전소 수·합계·최소 대비 여유와 오류 코드를 반환합니다.
- 명령행 도구는 입력 CSV를 읽기만 하며 JSON 보고서와 종료코드(통과 0/제약 실패 1/입력·설정 오류 2)를 제공합니다.
검증한 것¶
- 저장소에서 해당 pytest 테스트 42개 전부 통과(0.67초). CLI 성공·실패·잘못된 헤더/설정도 포함합니다. CAD 전체 테스트를 실행했다는 뜻은 아닙니다.
- 원본 sites.csv와 기존 로컬 후보 3개의 회귀 확인: reference 22,189.715/20,465.655kW, greedy 21,334.500/21,320.870kW, threshold 20,248.335/22,407.035kW. 모두 통과하고 기존 합계·여유와 일치했습니다. reference의 G1/G2는 기존 진단의 라벨 정규화를 유지합니다.
- 실제 후보에서 ID를 누락시키거나 같은 행 수로 중복/미등록 ID를 넣은 3개 변형은 모두 거부했습니다. 정상 입력 순서를 뒤집어도 보고서는 같았습니다.
- 검증 로그: OIBC_990_capacity_validator_tests_20261027.xml. 회귀 증거: OIBC_990_capacity_validator_regression_20261027.json(실행 파일 4개 SHA 포함). 원본 데이터는 Git이나 이 일감에 첨부하지 않았습니다.
팀 확인·남은 범위¶
- 황수아: ID/용량 계약, AC/DC 의미, 0 용량·정밀도 정책과 구현 교차 검토.
- 문길래: 최신 문제정의서·설정과 임시 scripts 배치 검토, random N/seed 정책 결정.
- random baseline 실행·OOF 수익 비교·정산/제출 엔진·Gate 승인은 미완료입니다. 검증 성공은 README 기반 주입 설정에 대한 결과이며 공식 승인과 구분합니다.
- 현재 코드는 로컬 신규 파일 상태이며 커밋/push/PR/merge는 하지 않았습니다. base SHA와 실제 실행 파일 SHA를 구분해 기록했습니다.
진척도 갱신¶
- 30% → 70%, In Progress 유지. 'baseline 설계 + Capacity Validator 구현/테스트/후보 회귀 확인 완료, 팀 검토·정책 결정 대기'에 대한 단계 기준 추정치입니다. 팀 승인율이나 시간 비율이 아닙니다. 확인 전 100%/Resolved로 처리하지 않습니다.
영조 Updated by 영우 조 21 days ago
- % Done changed from 70 to 90
추가 기능 검토·수정 및 회귀 검증 — 2026-10-27 KST¶
완료한 부분¶
- Claude가 추가한 vpp_baseline_partition.py를 검토했습니다. reference(A→G1/B→G2), 용량 균등 greedy, threshold, seed 고정 random 진단 생성기를 기존 Capacity Validator와 연결한 상태를 확인했습니다.
- CSV 저장을 표준 quoting 방식으로 수정해 쉼표·따옴표가 있는 ID도 보존합니다. CLI는 입력 CSV/규정 JSON을 동일 byte snapshot으로 읽고 hash하여 실행 입력과 증거의 불일치를 방지합니다.
- 제공 sites.csv 회귀 통과: reference G1=134개/20465.655kW, G2=119개/22189.715kW. reference mapping SHA256=34d049514183f5eb1f82ae01911af9760bbd6fd0dbcbb07938125bad1e54aa91. 이전 단발 진단의 G1=B/G2=A 라벨 정규화와 구분하며, 현재 reference는 제공 baseline 라벨을 유지합니다.
- greedy/threshold의 기존 mapping hash·용량·개수 회귀도 통과했습니다.
검증 근거¶
- 수정 반영된 OIBC 전용 작업트리 전체 관련 테스트: 406 passed, 1 skipped in 28.29s. 실제 sites/SMP 축(253×8760)에 합성 0 예측을 사용한 집계·CSV package roundtrip 검증을 포함합니다. 실제 발전량 예측·수익 결과는 아닙니다.
- JUnit: OIBC_Claude_추가기능_검토수정_tests_20261027.xml. Parquet/pandas 검증 패키지는 별도 로컬 테스트 폴더에만 설치했으며 프로젝트 의존성은 변경하지 않았습니다.
팀 확인·남은 범위¶
- 문길래: Candidate 1 reference 채택, random N/seed 정책, 공용 엔진 배치 및 의존성 승인.
- 황수아: 용량 정본/AC·DC 의미 등 계약 최종 확인. 이상재: 실제 forecast/OOF artifact 제공 후 동일 예측 기준 수익 비교.
- 실제 OOF 최적화·수익 개선·공식 제출·승인은 미수행입니다. 공식 점수=null/승인=false 유지. 코드는 로컬 미커밋이며 push/PR/merge하지 않았습니다.
진척도¶
- 70% → 90%, In Progress 유지. Baseline 생성기·Capacity Validator 개발 및 회귀 검증 완료 단계입니다. PM 확인 전 100%/Resolved로 처리하지 않습니다.
영조 Updated by 영우 조 20 days ago
[2026-10-29 KST #990 선행 승인 반영 및 기존 구현 재검증]
상태: In Progress / 90% 유지 — 구현과 재검증 완료, #990 최종 검토 및 정책 결정 대기. #989는 PM의 APPROVE_WITH_OPEN_ITEMS 판정에 따라 Closed 100%, #990 시작 승인됨: https://sulfite-footbath-next.ngrok-free.dev/issues/989#note-4
완료 및 확인:
- 기존 Capacity Validator·Baseline 생성기(reference/greedy/threshold/random)를 승인된 #989 기준과 대조: 253개 발전소, 2개 그룹, 각 그룹 20,000kW 이상(경계 포함), 원본 capacity_kw를 kW로 사용. 규칙의 정밀도 0.001kW, zero capacity 거부는 현 구현 설정이며 별도 공식 정책 승인으로 단정하지 않음.
- 원본 ZIP SHA256 f8b8914d1e45c7a7e8108fc2bfb2c1287373a07e2621cfe653bb3a12a438834e 및 sites.csv SHA256 93d166fffd009c3643db748fc6d5a1d48851e5f70b314171130e6ab6b7997ea2 확인. 코드와 테스트를 작업공간에 복사한 뒤 원본 253개소 회귀 포함 관련 테스트 84 passed (Python 3.12.10). 경계값·누락/중복/미등록 ID 및 CLI 검증을 포함.
- 실제 용량 기반 재검증: reference A→G1/B→G2 134/119개, 20,465.655/22,189.715kW; greedy 127/126개, 21,334.500/21,320.870kW; threshold 218/35개, 20,248.335/22,407.035kW. 세 후보 모두 용량 검증 PASS, 기존 mapping SHA와 일치. threshold는 스트레스 후보이며 수익 하한이 아님.
- 진단 random seed 0~99를 각 1회 실행: 유효 42/100, 무효 58/100. 재시도·best seed 선택 없음. 공식 N/seed/RNG·실패 처리 정책으로 승인된 결과는 아님.
- 검증한 파일 SHA256: baseline 9c9d9e977311743b89e25be5f5079c81f2c58e143d50aff7ab913abd178e7d37; capacity validator c41ecdf05fec552ed05c6faafe82f10dc5d98fc9440a8bdf5a612b70822a65db; 규칙 JSON 8fe3a89b7ce9212a81ea6adeafeadca0a612a6d676a86dc6705549597780d7ae. 로컬 재검증 요약: work/oibc_990_review/baseline_review_result.json. 이 검증은 저장소 원본 수정 없이 복사본을 사용했으며 현재 PR HEAD 전체와 동일하다는 의미는 아님.
최종 검토 필요: PM의 baseline 후보(reference 채택 여부 포함) 및 random N/seed/RNG/무효 처리, 코드 배치와 #990 최종 검수. AC/DC 의미·최신 문제정의서/추가 무효 조건·제출 간 변경은 #989 PM 판정에 따라 미확정 별도 추적. D05=HOLD이며 이번 결과는 공식 점수·최종 수익 개선이 아님. #990 완료 및 다음 일감 진행은 최종 검수 후 처리.
영조 Updated by 영우 조 20 days ago
- Status changed from In Progress to Closed
- % Done changed from 90 to 100
[2026-10-29 #990 PM 최종 검수 결과]
PM 판정: APPROVED / 100%. Slack 헬리오포지 채널 #990 검수 요청 스레드 10:58 답변 기준.
• 기준 baseline: 제공 reference A→G1 / B→G2. greedy는 결정적 비교 후보, threshold는 스트레스·진단용 후보.
• random은 진단용: seed 0~99, seed당 1회, 자동 재시도 및 좋은 seed만 선택 금지.
• Capacity Validator는 현재 확인 범위에서 승인. 기존 복사본 기반 테스트 84개 통과와 실제 용량 회귀 결과는 note-5 참조. 복사본이 당시 현재 main 전체와 동일했다는 증거는 없으며, PM은 이를 완료 blocker로 보지 않음.
• PM이 가능하면 요청한 현재 main 핵심 smoke test는 이번에 실행하지 못했습니다. 현재 main의 해당 파일 존재는 확인했으나 테스트 실행 결과나 동일성을 주장하지 않습니다.
• D05는 HOLD 유지. 이번 승인은 공식 점수, 수익 개선 또는 최종 제출 승인이 아닙니다. #989에서 남긴 공식 규칙 미확정 항목은 별도 추적합니다.