add webhosting

CLAUDE.md

@@ -0,0 +1,381 @@
+# CLAUDE.md
+
+이 파일은 Claude Code (claude.ai/code)가 이 저장소에서 작업할 때 참고할 가이드를 제공합니다.
+
+## 프로젝트 개요
+
+**ECO2 (Energy Calculation Optimization 2)**는 한국 건축물 에너지효율등급 인증 기준(녹색건축인증)에 따라 건물의 1차 에너지 소요량, CO2 배출량, 신재생에너지 생산량을 계산하는 VB.NET 및 WinForms 기반 응용 프로그램입니다.
+
+**주 언어**: Visual Basic .NET (VB.NET) with .NET Framework 4.0
+**추가 언어**: C# (유틸리티 라이브러리만)
+**플랫폼**: Windows 데스크톱 응용 프로그램 (x86 타겟)
+
+## 솔루션 구조
+
+솔루션 `ArinWareT4.sln`은 모듈화된 아키텍처로 구성된 6개의 프로젝트를 포함합니다:
+
+### 메인 응용 프로그램
+- **ECO2_2025V1** (`ArinWarev1/`) - 주 WinForms 응용 프로그램
+  - 진입점: `MdiMain.vb` - 메뉴 시스템을 갖춘 MDI 부모 폼
+  - `Calculator/` 하위 디렉토리의 핵심 계산 엔진
+  - 기능별 폼 구성: `Forms/`, `Forms_Input/`, `Forms_Report/`, `Forms_Basic/`
+  - `Data/`의 기상 데이터 (XML 형식)
+  - 타입 데이터셋: `eco2DataSet.xsd` (데이터 모델링용)
+
+### 지원 라이브러리 (SubProject 폴더 그룹)
+- **CEnergy** (`CEnergy/ArinClassV2/`) - 핵심 비즈니스 로직 라이브러리
+  - 공통 유틸리티, 데이터베이스 액세스, INI 파일 처리
+  - 여러 프로젝트에서 공유
+
+- **ArinNet** - 네트워크 통신 유틸리티
+
+- **ArinLogin** - 인증 및 사용자 관리
+  - 라이선스 검증, 암호화/복호화
+
+- **ArinLog** - 로깅 기능
+
+- **Utility** (C#) - 압축 유틸리티
+  - 데이터 압축을 위한 MiniLZO 구현
+
+### 배포
+- **Setup1** - 설치 프로그램 프로젝트 (`.vdproj`)
+
+## 빌드 및 실행
+
+### 솔루션 빌드
+
+```bash
+# Visual Studio에서 솔루션 열기
+start ArinWareT4.sln
+
+# 명령줄에서 빌드 (Visual Studio 필요)
+msbuild ArinWareT4.sln /p:Configuration=Debug /p:Platform="Any CPU"
+msbuild ArinWareT4.sln /p:Configuration=Release /p:Platform="Any CPU"
+```
+
+### 출력 경로
+- **Debug**: `..\..\..\..\..\eco2\debug_2016\` (프로젝트 기준 상대 경로)
+- **Release**: `c:\eco2\debug_2016\`
+
+### 플랫폼 설정
+- 타겟 플랫폼: **x86** (32비트)
+- 프레임워크: **.NET Framework 4.0**
+- Option Strict: **Off** (VB.NET 특성)
+
+### 빌드 구성
+- Debug / Release (표준)
+- CD_ROM / DVD-5 / SingleImage (배포 구성)
+
+## 아키텍처 개요
+
+### 계산 엔진 (`ArinWarev1/Calculator/`)
+
+계산 엔진은 건물 에너지 계산을 수행하는 전문 모듈로 구성됩니다:
+
+**핵심 계산기 클래스**:
+- `Calculator.vb` - 모든 계산 모듈을 조율하는 메인 오케스트레이터
+- `CZone.vb` - 존 레벨 계산 (열존, 난방/냉방 부하)
+- `CAirHandling.vb` - 공조 시스템 계산
+- `CHeating.vb` - 난방 시스템 계산 (기기, 분배, 공급)
+- `CCooling.vb` - 냉방 시스템 계산 (기기, 분배)
+- `CRenewable.vb` - 신재생에너지 생산량 계산
+- `CSummary.vb` - 결과 집계 및 요약 생성
+- `CShared.vb` - 공유 계산 변수 및 유틸리티
+
+**결과 처리** (`Calculator/Result/`):
+- `CResult.vb` - 결과 데이터 구조
+- `C1차소요량.vb` - 1차 에너지 소요량 계산
+- `CCo2발생량.vb` - CO2 배출량 계산
+- `C생산에너지.vb` - 에너지 생산량 계산
+- `C사용면적.vb` - 사용 면적 계산
+- `CZones.vb` - 존 결과 집계
+
+### 데이터 흐름
+
+```
+사용자 입력 폼 (Forms_Input/)
+    ↓
+DataSet (eco2DataSet - DS, DSR)
+    ↓
+계산 엔진 (Calculator)
+    ↓
+결과 클래스 (CResult, DSR)
+    ↓
+리포트 폼 (Forms_Report/)
+```
+
+### 주요 데이터셋
+- `DS` (DSET) - 입력 데이터 (사용자 입력 건물 정보)
+- `DSR` (DSETR) - 결과 데이터 (계산된 에너지 값)
+- `CResult` - 구조화된 계산 결과
+
+### 폼 구성
+
+**Forms_Input/** - 데이터 입력 폼
+- `Frm_Desc.vb` - 건물 개요
+- `Frm_kongjo.vb` - 공조 처리 입력
+- `Frm_Bunbae.vb` - 분배 시스템 입력
+- `Frm_custom_profile.vb` - 커스텀 사용 프로파일
+
+**Forms_Report/** - 출력 및 보고
+- `Frm_Upload.vb` - 인증 서버 업로드
+- `Frm_Macro.vb`, `Frm_Macro2.vb` - Excel 리포트 생성
+- `Frm_Export.vb` - 데이터 내보내기 기능
+
+**Forms_Basic/** - 유틸리티 폼
+- `Frm_Calc.vb` - 계산 트리거
+- `Frm_Filter.vb` - 데이터 필터링
+- `Frm_FileInfo.vb` - 파일 메타데이터
+
+**Forms/** - 일반 응용 프로그램 폼
+- `Frm_About.vb` - About 대화상자
+- `Frm_Common.vb` - 공통 대화상자
+
+### 메뉴 시스템 (MdiMain.vb)
+
+`E_MenuIdx` 열거형에 정의된 메뉴 인덱스:
+- 입력존
+- 입력면
+- 공조처리
+- 난방기기/공급/분배
+- 냉방기기/분배
+- 신재생및열병합
+- 열관류율
+- 건물개요
+- 월별에너지사용량
+
+### 사용자 권한
+
+`Prj.UserAuthType`을 통해 제어되는 사용자 유형:
+- `ADMIN` - 전체 액세스
+- `BOTH` - 전문 사용자 (계산 + 인증)
+- `BOTH0` - 일반 사용자 (제한된 액세스)
+- `BOTH1` - 확장 전문 사용자 액세스
+
+## 외부 종속성
+
+### FarPoint Spread (v5.0.3505.2008)
+- 데이터 입력을 위한 Excel 형식의 스프레드시트 컨트롤
+- 구성 요소: CalcEngine, Excel, PDF, Win, Chart
+- 입력 폼에서 광범위하게 사용
+
+### Microsoft ReportViewer
+- `Microsoft.ReportViewer.Common.dll`
+- `Microsoft.ReportViewer.WinForms.dll`
+- 형식화된 보고서 생성에 사용
+
+### Excel Interop
+- `Interop.Excel.dll` - Excel 자동화를 위한 COM interop
+- 매크로/내보내기 기능에 사용
+
+### LOV 구성 요소
+- `Lov.dll` - 값 목록 컨트롤 라이브러리
+
+## 파일 형식 및 데이터 저장
+
+### 프로젝트 파일 (.tpl 파일)
+- LZO 압축 바이너리 형식 (Utility 프로젝트 사용)
+- 건물 데이터, 계산 입력값, 결과 포함
+- 사용자 지정 위치에 저장
+- 최근 파일은 응용 프로그램 설정에서 추적
+
+### 기상 데이터 (Data/*.xml)
+- `weather_temp.xml` - 온도 데이터
+- `weather_supdo.xml` - 습도 데이터
+- `weather_ilsa.xml` - 일사량 데이터
+- `weather_group.xml` - 기상 관측소 그룹
+- `tbl_weather.xml` - 기상 위치 테이블
+
+### 구성 파일
+- `Frm_Setting.ini` - UI 상태 지속성 (창 크기, 위치)
+- `login.dat` - 사용자 자격 증명 (암호화됨)
+- `app.config` - 응용 프로그램 설정
+
+## 한국 건축물 에너지 기준
+
+이 응용 프로그램은 한국 건축물 에너지효율등급 인증 기준을 구현합니다:
+
+### 주요 용어
+- 건물개요
+- 1차 에너지 소요량
+- CO2 발생량
+- 난방 / 냉방
+- 급탕
+- 조명 / 환기
+- 신재생에너지
+- 열관류율
+- 공조
+- 용도지역
+
+### 계산 버전 관리
+
+`StartVersion` 상수를 통한 버전 제어:
+- 규제 준수를 위한 계산 엔진 버전 관리
+- `Calculator.New()` 생성자에서 버전 확인
+- 기준 버전 "2009123100"
+
+## 개발 가이드라인
+
+### VB.NET 규칙
+- Option Strict는 OFF - 암시적 형식 변환 허용
+- 한글 주석 및 변수명은 표준 관행
+- 명명: 클래스, 메서드는 PascalCase; 로컬 변수는 엄격한 규칙 없음
+
+### DataSet 사용
+- 항상 타입 데이터셋 (`DS`, `DSR`) 사용
+- 모듈 수준 변수 `DSET1`, `DSETR1`을 통해 액세스
+- 타입 안전 액세스를 위해 DataRow 객체 사용
+
+### 폼 관리
+- `MdiMain`을 통한 MDI 자식 폼 관리
+- `OpenedForm` 속성을 통해 열린 폼 추적
+- `Prj.Opened`를 사용하여 프로젝트 파일 로드 여부 확인
+
+### 계산 흐름
+1. 프로젝트 파일 로드 → `DSET` 채우기
+2. 사용자가 입력 폼 수정 → `DSET` 업데이트
+3. 계산 트리거 → `Calculator` 클래스가 `DSET` 처리 → `DSETR` 및 `CResult` 채우기
+4. 리포트 폼에 결과 표시
+
+### 파일 작업
+- 항상 MdiMain의 `Save_File()` / `Load_File()` 메서드 사용
+- Utility 라이브러리를 통한 파일 압축 처리
+- `PrjChanged` 플래그를 통한 파일 변경 추적
+
+## 일반 작업
+
+### 계산 실행
+
+계산은 메뉴 또는 폼 버튼에서 트리거되고 `Calculator` 클래스를 통해 처리됩니다:
+
+```vb
+' 데이터셋 및 결과 객체로 계산기 초기화
+Dim calc As New Calculator(version, DSET1, DSETR1, Result2, isSimulation)
+
+' 초기화 오류 확인
+If calc.IsError Then
+    ' 오류 처리
+    Return
+End If
+
+' DSETR1 및 Result2에서 계산 결과 사용 가능
+```
+
+### 새 입력 필드 추가
+
+1. 적절한 테이블에 열을 추가하도록 `eco2DataSet.xsd` 수정
+2. 해당 입력 폼(`Forms_Input/*.vb`) 업데이트
+3. 관련 `Calculator/*.vb` 클래스의 계산 로직 업데이트
+4. 필요한 경우 리포트 폼 업데이트
+
+### 새 계산 모듈 추가
+
+1. `Calculator/` 디렉토리에 새 클래스 생성
+2. 기존 모듈의 계산 패턴 상속
+3. 생성자에서 `DS`, `DSR`, `CResult` 수락
+4. `Calculator.vb` 오케스트레이터에 연결
+5. `CSummary.vb`의 요약 집계 업데이트
+
+### FarPoint Spread 컨트롤 작업
+
+FarPoint 컨트롤은 그리드 기반 입력에 광범위하게 사용됩니다:
+
+```vb
+' Spread 컨트롤 액세스
+Dim spread As FarPoint.Win.Spread.FpSpread = Me.FpSpread1
+
+' 셀 값 설정
+spread.ActiveSheet.Cells(row, col).Value = value
+
+' 셀 값 읽기
+Dim value = spread.ActiveSheet.Cells(row, col).Value
+
+' 셀 속성 설정
+spread.ActiveSheet.Cells(row, col).BackColor = Color.Yellow
+```
+
+## 알려진 패턴 및 규칙
+
+### 전역 모듈 변수
+- `DSET1` - 전역 입력 데이터셋 (DS 타입)
+- `DSETR1` - 전역 결과 데이터셋 (DSR 타입)
+- `Result2` - 전역 결과 객체 (CResult 타입)
+- `Prj` - 전역 프로젝트 상태 객체
+- `CLang` - 언어/지역화 문자열
+
+### 오류 처리
+- 계산 클래스의 `IsError` 속성 패턴
+- 사용자 대면 오류에 대한 메시지 박스
+- `On Error Resume Next`를 사용한 VB.NET 오류 처리 (레거시 패턴)
+
+### 이벤트 처리
+- 클래스 수준 이벤트 핸들러를 위한 WithEvents 패턴
+- `Handles` 키워드를 통한 폼 이벤트 처리
+
+### INI 파일 액세스
+```vb
+Dim ini As New MyINI(filePath)
+Dim value = ini.Read(section, key, defaultValue)
+ini.Write(section, key, value)
+```
+
+## 테스트 및 디버깅
+
+### 디버그 모드
+- Debug 구성으로 빌드
+- 로컬 디버그 폴더로 출력
+- 전체 심볼 정보 사용 가능
+
+### 테스트 데이터
+사용 가능한 샘플 프로젝트 파일:
+- `sample.tpl` - 표준 샘플 건물
+- `sample_0307.tpl` - 대체 샘플
+- `sample_200.tpl` - 대형 건물 샘플
+
+### 로깅
+응용 프로그램 로깅에 ArinLog 라이브러리 사용:
+```vb
+pLog.Add("이벤트 설명", includeStackTrace)
+```
+
+## 언어 관련 참고사항
+
+응용 프로그램은 한국 사용자를 위해 설계되었습니다:
+- 모든 UI 텍스트는 한글
+- 사용자 문서는 한글
+- 한국 건축 기준 및 용어
+- 날짜/시간 형식: 한국 표준
+- 인코딩: 소스 파일은 UTF-8
+
+주석 및 변수명은 한글과 영어를 혼용합니다 - 이는 의도적이며 이 코드베이스의 표준입니다.
+
+## 배포 참고사항
+
+### 설치
+- 설치 프로그램 프로젝트: `Setup1/Setup1.vdproj`
+- 메인 프로젝트에 구성된 ClickOnce 배포
+- 게시 URL: `ftp://tindevil.com/www/mynetapp/t4/`
+- 설치 URL: `http://tindevil.com/mynetapp/t4/`
+
+### 버전 관리
+- AssemblyInfo의 버전 정보
+- ArinLogin 라이브러리를 통한 버전 확인
+- 서버 측 버전 검증
+
+### 업데이트
+- 시작 시 업데이트 확인
+- Foreground 업데이트 모드 (실행 전 업데이트)
+- 7일 업데이트 간격 구성
+
+## 보안 참고사항
+
+### 인증
+- ArinLogin 라이브러리를 통한 사용자 인증
+- MAC 주소 검증 (상태 표시줄의 `lbl_mac`)
+- 라이선스 관리 시스템
+- `login.dat`의 암호화된 자격 증명
+
+### 데이터 보호
+- 데이터 보호를 위한 파일 압축
+- ArinLogin.EnDec 클래스를 통한 암호화/복호화
+- 라이선스 준수를 위한 네트워크 검증