first commit

This commit is contained in:
2026-03-20 08:52:16 +09:00
commit 8c0b02233e
41 changed files with 6021 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
using System;
using System.ComponentModel;
using System.Diagnostics;
using System.Windows.Forms;
namespace Keps.WinForms.Infrastructure
{
internal static class DesignTimeHelper
{
/// <summary>
/// 현재 실행 컨텍스트가 디자이너(디자인 타임)인지 여부를 판단합니다.
/// WinForms 디자이너나 XAML 디자이너 프로세스에서 실행 중이면 <c>true</c>를 반환합니다.
/// </summary>
/// <param name="control">디자인 모드를 추가로 판별할 대상 컨트롤. null이면 프로세스 이름만으로 판별합니다.</param>
/// <returns>디자인 타임이면 <c>true</c>, 런타임이면 <c>false</c>.</returns>
public static bool IsDesignMode(Control control = null)
{
if (LicenseManager.UsageMode == LicenseUsageMode.Designtime)
{
return true;
}
if (control != null && control.Site != null && control.Site.DesignMode)
{
return true;
}
string processName = Process.GetCurrentProcess().ProcessName;
return string.Equals(processName, "devenv", StringComparison.OrdinalIgnoreCase)
|| string.Equals(processName, "XDesProc", StringComparison.OrdinalIgnoreCase);
}
}
}

View File

@@ -0,0 +1,143 @@
using System;
using System.Collections.Generic;
using System.IO;
using OfficeOpenXml;
namespace Keps.WinForms.Infrastructure
{
public sealed class ExcelEpplusReader : IDisposable
{
private ExcelPackage _package;
/// <summary>
/// 지정된 경로의 Excel 파일(.xlsx/.xlsm)을 열고 내부 패키지를 초기화합니다.
/// </summary>
/// <param name="path">읽어들일 Excel 파일 경로.</param>
/// <exception cref="FileNotFoundException">파일이 존재하지 않을 때 발생합니다.</exception>
/// <exception cref="NotSupportedException">지원하지 않는 확장자일 때 발생합니다.</exception>
public void Open(string path)
{
if (string.IsNullOrWhiteSpace(path) || !File.Exists(path))
{
throw new FileNotFoundException("Excel 파일을 찾을 수 없습니다.", path);
}
string extension = Path.GetExtension(path);
if (!string.Equals(extension, ".xlsx", StringComparison.OrdinalIgnoreCase) &&
!string.Equals(extension, ".xlsm", StringComparison.OrdinalIgnoreCase))
{
throw new NotSupportedException(
"EPPlus 4.5.3.3은 .xlsx/.xlsm만 직접 지원합니다. 입력 파일을 .xlsx로 변환한 뒤 다시 시도하세요.");
}
_package = new ExcelPackage(new FileInfo(path));
}
/// <summary>
/// 현재 열려 있는 Excel 패키지의 모든 워크시트를 순회 가능한 형태로 반환합니다.
/// </summary>
/// <returns><see cref="ExcelSheet"/> 열거 시퀀스.</returns>
/// <exception cref="InvalidOperationException">Open이 선행되지 않은 경우 발생합니다.</exception>
public IEnumerable<ExcelSheet> ReadSheets()
{
if (_package == null)
{
throw new InvalidOperationException("먼저 Open을 호출해야 합니다.");
}
foreach (ExcelWorksheet worksheet in _package.Workbook.Worksheets)
{
if (worksheet == null)
{
continue;
}
yield return new ExcelSheet(worksheet);
}
}
/// <summary>
/// 내부 Excel 패키지 리소스를 해제합니다.
/// </summary>
public void Dispose()
{
if (_package != null)
{
_package.Dispose();
_package = null;
}
}
}
public sealed class ExcelSheet
{
private readonly ExcelWorksheet _worksheet;
/// <summary>
/// EPPlus의 <see cref="ExcelWorksheet"/>를 래핑하는 시트를 생성합니다.
/// </summary>
/// <param name="worksheet">원본 워크시트 인스턴스.</param>
public ExcelSheet(ExcelWorksheet worksheet)
{
_worksheet = worksheet;
}
public string Name
{
get { return _worksheet.Name; }
}
/// <summary>
/// 지정한 행/열 위치의 셀 값을 반환합니다. 범위를 벗어나면 null을 반환합니다.
/// </summary>
/// <param name="row">1부터 시작하는 행 번호.</param>
/// <param name="column">1부터 시작하는 열 번호.</param>
/// <returns>셀 값 또는 범위 밖일 경우 null.</returns>
public object GetValue(int row, int column)
{
if (_worksheet.Dimension == null)
{
return null;
}
if (row < 1 || column < 1)
{
return null;
}
if (row > _worksheet.Dimension.End.Row || column > _worksheet.Dimension.End.Column)
{
return null;
}
return _worksheet.Cells[row, column].Value;
}
/// <summary>
/// 첫 번째 행(헤더 행)에서 주어진 헤더 텍스트와 일치하는 열의 인덱스를 찾습니다.
/// </summary>
/// <param name="header">찾을 헤더 텍스트.</param>
/// <param name="maxColumn">검색을 수행할 최대 열 번호(1 기반).</param>
/// <returns>일치하는 열 번호(1 기반). 찾지 못하면 -1.</returns>
public int FindHeaderColumn(string header, int maxColumn)
{
if (_worksheet.Dimension == null || string.IsNullOrWhiteSpace(header))
{
return -1;
}
int endColumn = Math.Min(maxColumn, _worksheet.Dimension.End.Column);
for (int column = 1; column <= endColumn; column++)
{
object rawValue = _worksheet.Cells[1, column].Value;
string value = rawValue == null ? string.Empty : Convert.ToString(rawValue).Trim();
if (string.Equals(value, header, StringComparison.OrdinalIgnoreCase))
{
return column;
}
}
return -1;
}
}
}

View File

@@ -0,0 +1,60 @@
using System.Collections.Generic;
using System.Globalization;
using Newtonsoft.Json;
namespace Keps.WinForms.Infrastructure
{
public static class JsonHelper
{
/// <summary>
/// 문자열 사전(IDictionary&lt;string, string&gt;)을 JSON 문자열로 직렬화합니다.
/// </summary>
/// <param name="values">직렬화할 키-값 쌍 컬렉션. null이면 빈 사전으로 간주합니다.</param>
/// <returns>JSON 형식의 문자열.</returns>
public static string Serialize(IDictionary<string, string> values)
{
return JsonConvert.SerializeObject(values ?? new Dictionary<string, string>());
}
/// <summary>
/// JSON 문자열을 문자열 사전(Dictionary&lt;string, string&gt;)으로 파싱합니다.
/// </summary>
/// <param name="json">입력 JSON 문자열. null/공백이면 빈 사전을 반환합니다.</param>
/// <returns>파싱된 문자열 사전. 파싱 실패 시 빈 사전.</returns>
public static Dictionary<string, string> ParseStringMap(string json)
{
if (string.IsNullOrWhiteSpace(json))
{
return new Dictionary<string, string>();
}
return JsonConvert.DeserializeObject<Dictionary<string, string>>(json)
?? new Dictionary<string, string>();
}
/// <summary>
/// JSON 문자열을 decimal 값의 사전(Dictionary&lt;string, decimal&gt;)으로 파싱합니다.
/// 내부적으로 문자열 사전을 먼저 파싱한 뒤, 각 값을 decimal로 변환합니다.
/// </summary>
/// <param name="json">입력 JSON 문자열.</param>
/// <returns>키는 문자열, 값은 decimal인 사전. 숫자 변환 실패 시 해당 값은 0m으로 설정됩니다.</returns>
public static Dictionary<string, decimal> ParseDecimalMap(string json)
{
Dictionary<string, string> raw = ParseStringMap(json);
Dictionary<string, decimal> result = new Dictionary<string, decimal>();
foreach (KeyValuePair<string, string> pair in raw)
{
decimal value;
if (!decimal.TryParse(pair.Value, NumberStyles.Any, CultureInfo.InvariantCulture, out value))
{
value = 0m;
}
result[pair.Key] = value;
}
return result;
}
}
}

View File

@@ -0,0 +1,146 @@
using System;
using System.Configuration;
using System.IO;
using System.Linq;
using System.Text.RegularExpressions;
namespace Keps.WinForms.Infrastructure
{
public static class LegacyConnectionResolver
{
/// <summary>
/// App.config 및 레거시 VB6 소스에서 DB 연결 정보를 해석하여 반환합니다.
/// 필수 항목이 누락된 경우 예외를 발생시킵니다.
/// </summary>
/// <returns>해석된 <see cref="LegacyConnectionSettings"/> 인스턴스.</returns>
/// <exception cref="InvalidOperationException">연결 정보를 완성할 수 없을 때 발생합니다.</exception>
public static LegacyConnectionSettings Resolve()
{
LegacyConnectionSettings settings = new LegacyConnectionSettings
{
Server = GetAppSetting("DbServer"),
Database = GetAppSetting("DbName", "keps"),
UserId = GetAppSetting("DbUser"),
Password = GetAppSetting("DbPassword")
};
if (!settings.IsComplete())
{
throw new InvalidOperationException(
"DB 연결 정보를 찾지 못했습니다.\r\n" +
"1) App.config의 LegacySourceFolder에 원본 VB6 소스 폴더를 지정하거나\r\n" +
"2) DbServer/DbName/DbUser/DbPassword를 직접 입력하세요.");
}
return settings;
}
/// <summary>
/// App.config의 <c>LegacySourceFolder</c>에 지정된 VB6 원본 폴더에서 연결 정보를 추출하려 시도합니다.
/// </summary>
/// <returns>완전한 연결 정보가 추출되면 해당 설정, 아니면 null.</returns>
private static LegacyConnectionSettings TryFromLegacySourceFolder()
{
string folder = GetAppSetting("LegacySourceFolder");
if (string.IsNullOrWhiteSpace(folder) || !Directory.Exists(folder))
{
return null;
}
string[] basFiles = Directory
.GetFiles(folder, "*.bas", SearchOption.AllDirectories)
.Where(path =>
string.Equals(Path.GetFileName(path), "kepsmd.bas", StringComparison.OrdinalIgnoreCase)
|| string.Equals(Path.GetFileName(path), "catisvmd.bas", StringComparison.OrdinalIgnoreCase))
.ToArray();
foreach (string path in basFiles)
{
string source = File.ReadAllText(path);
LegacyConnectionSettings settings = ParseFromLegacyBas(source);
if (settings != null && settings.IsComplete())
{
return settings;
}
}
return null;
}
/// <summary>
/// VB6 모듈 소스(.bas) 문자열에서 연결 문자열 구성 요소를 정규식으로 추출합니다.
/// </summary>
/// <param name="source">VB6 원본 소스 코드 텍스트.</param>
/// <returns>
/// 추출된 값으로 구성된 <see cref="LegacyConnectionSettings"/>.
/// 필수 항목을 충족하지 못하면 null.
/// </returns>
private static LegacyConnectionSettings ParseFromLegacyBas(string source)
{
if (string.IsNullOrWhiteSpace(source))
{
return null;
}
string server = MatchValue(source,
@"Server_DB_ip\s*=\s*""([^""]+)""",
@"Data Source=([^;""\r\n]+)",
@"Server=([^;""\r\n]+)");
string database = MatchValue(source,
@"Initial Catalog=([^;""\r\n]+)",
@"Database=([^;""\r\n]+)",
@"Db_Name\s*=\s*""([^""]+)""");
string userId = MatchValue(source,
@"User ID=([^;""\r\n]+)",
@"UID=([^;""\r\n]+)");
string password = MatchValue(source,
@"Password=([^;""\r\n]+)",
@"PWD=([^;""\r\n]+)");
LegacyConnectionSettings settings = new LegacyConnectionSettings
{
Server = server,
Database = string.IsNullOrWhiteSpace(database) ? "keps" : database,
UserId = userId,
Password = password
};
return settings.IsComplete() ? settings : null;
}
/// <summary>
/// 주어진 여러 정규식 패턴을 순서대로 적용하여 첫 번째로 매칭되는 그룹 값을 반환합니다.
/// </summary>
/// <param name="source">검색할 원본 문자열.</param>
/// <param name="patterns">적용할 정규식 패턴 목록. 각 패턴은 그룹 1에 원하는 값을 캡처해야 합니다.</param>
/// <returns>첫 매칭의 그룹 1 값. 매칭이 없으면 null.</returns>
private static string MatchValue(string source, params string[] patterns)
{
foreach (string pattern in patterns)
{
Match match = Regex.Match(source, pattern, RegexOptions.IgnoreCase);
if (match.Success)
{
return match.Groups[1].Value.Trim();
}
}
return null;
}
/// <summary>
/// App.config의 AppSettings에서 키 값을 읽고, 비어있으면 기본값을 반환합니다.
/// </summary>
/// <param name="key">설정 키 이름.</param>
/// <param name="defaultValue">키가 없거나 값이 비어있을 때 사용할 기본값.</param>
/// <returns>설정값 또는 기본값.</returns>
private static string GetAppSetting(string key, string defaultValue = null)
{
string value = ConfigurationManager.AppSettings[key];
return string.IsNullOrWhiteSpace(value) ? defaultValue : value;
}
}
}

View File

@@ -0,0 +1,25 @@
namespace Keps.WinForms.Infrastructure
{
public sealed class LegacyConnectionSettings
{
public string Server { get; set; }
public string Database { get; set; }
public string UserId { get; set; }
public string Password { get; set; }
/// <summary>
/// DB 연결 문자열을 구성하기 위한 필수 항목들이 모두 채워졌는지 확인합니다.
/// </summary>
/// <returns>
/// <c>Server</c>, <c>Database</c>, <c>UserId</c>, <c>Password</c>가 모두 비어있지 않으면 <c>true</c>,
/// 그 외에는 <c>false</c>.
/// </returns>
public bool IsComplete()
{
return !string.IsNullOrWhiteSpace(Server)
&& !string.IsNullOrWhiteSpace(Database)
&& !string.IsNullOrWhiteSpace(UserId)
&& !string.IsNullOrWhiteSpace(Password);
}
}
}

View File

@@ -0,0 +1,170 @@
using System;
using System.Globalization;
using System.Text.RegularExpressions;
namespace Keps.WinForms.Infrastructure
{
/// <summary>
/// DB에서 로드한 레거시 데이터를 정제하고 타입 변환하는 헬퍼 클래스
/// </summary>
public static class LegacyValueHelper
{
/// <summary>
/// 객체 값을 문자열로 변환하면서 null/DBNull 체크 및 공백 제거
/// </summary>
/// <param name="value">변환할 객체 값. null이거나 DBNull.Value이면 빈 문자열 반환</param>
/// <returns>정제된 문자열. 양쪽 공백이 제거되고 null은 빈 문자열로 반환</returns>
public static string CleanString(object value)
{
if (value == null || value == DBNull.Value)
{
return string.Empty;
}
return Convert.ToString(value).Trim();
}
/// <summary>
/// 객체 값을 정수로 변환
/// 쉼표 제거, 부동소수점 값은 소수점 버림 처리, 변환 실패시 0 반환
/// </summary>
/// <param name="value">변환할 객체 값. null이거나 DBNull.Value이면 0 반환</param>
/// <returns>
/// 정수로 변환된 값
/// 부동소수점은 Math.Truncate로 소수점 이하 버림 처리
/// 변환 실패시 기본값 0 반환
/// </returns>
public static int ToInt(object value)
{
if (value == null || value == DBNull.Value)
{
return 0;
}
int result;
// 쉼표를 제거하고 공백을 제거 후 정수 파싱 시도
string text = Convert.ToString(value).Replace(",", "").Trim();
if (int.TryParse(text, NumberStyles.Any, CultureInfo.InvariantCulture, out result))
{
return result;
}
// int 파싱 실패시 decimal로 파싱 후 정수 부분만 취득
decimal decimalValue;
if (decimal.TryParse(text, NumberStyles.Any, CultureInfo.InvariantCulture, out decimalValue))
{
// Math.Truncate: 소수점 이하 버림 (음수도 0 방향으로 버림)
return Convert.ToInt32(Math.Truncate(decimalValue));
}
return 0;
}
/// <summary>
/// 객체 값을 decimal(십진수)로 변환
/// 쉼표 제거, 변환 실패시 0 반환
/// </summary>
/// <param name="value">변환할 객체 값. null이거나 DBNull.Value이면 0m 반환</param>
/// <returns>decimal으로 변환된 값. 변환 실패시 기본값 0m 반환</returns>
public static decimal ToDecimal(object value)
{
if (value == null || value == DBNull.Value)
{
return 0m;
}
decimal result;
// 쉼표를 제거하고 공백을 제거 후 decimal 파싱 시도
string text = Convert.ToString(value).Replace(",", "").Trim();
if (decimal.TryParse(text, NumberStyles.Any, CultureInfo.InvariantCulture, out result))
{
return result;
}
return 0m;
}
/// <summary>
/// 선거구명(District)에서 지역명(Area)을 추출
/// "[지역명_세부구분]" 또는 "지역명.세부구분" 형태에서 지역명만 추출
/// </summary>
/// <param name="districtName">
/// 선거구명 문자열
/// 형식 예시: "[강원_강릉시]", "강원.강릉시", "강원_강릉시" 등
/// null이거나 공백이면 빈 문자열 반환
/// </param>
/// <returns>
/// 추출된 지역명
/// 양쪽 대괄호 제거 후 언더스코어(_)나 점(.)을 기준으로 앞부분만 반환
/// 구분자가 없으면 전체 정규화된 문자열 반환
/// </returns>
public static string DeriveAreaFromDistrict(string districtName)
{
if (string.IsNullOrWhiteSpace(districtName))
{
return string.Empty;
}
// 양쪽의 대괄호 제거 및 공백 제거
string normalized = districtName.Trim().Trim('[', ']');
// 언더스코어(_) 기준으로 앞부분 추출
int underscore = normalized.IndexOf('_');
if (underscore > 0)
{
return normalized.Substring(0, underscore);
}
// 점(.) 기준으로 앞부분 추출
int dot = normalized.IndexOf('.');
if (dot > 0)
{
return normalized.Substring(0, dot);
}
// 구분자가 없으면 정규화된 전체 문자열 반환
return normalized;
}
/// <summary>
/// 투표구명(PollingPlaceName)에서 투표구 번호를 추출
/// "제5투표소", "5 투표소", "제 5 투표" 등의 형식에서 숫자만 추출
/// </summary>
/// <param name="pollingPlaceName">
/// 투표구명 문자열
/// 형식 예시: "제1투표소", "제5투표소", "10투표소", "투표소" 등
/// null이거나 공백이면 "0" 반환
/// </param>
/// <returns>
/// 추출된 투표구 번호 문자열
/// 정규표현식 "제?\s*(\d+)\s*투"로 매칭된 숫자 부분 반환
/// 패턴 미매칭시 투표소로 끝나면 "1" 반환
/// 모두 실패시 "0" 반환
/// </returns>
public static string ExtractPollingPlaceNumber(string pollingPlaceName)
{
if (string.IsNullOrWhiteSpace(pollingPlaceName))
{
return "0";
}
// 정규표현식으로 "제(선택적) + 공백(선택적) + 숫자 + 공백(선택적) + '투'" 패턴 매칭
// 예: "제1투", "제 5 투", "10투" 등에서 숫자 부분 추출
Match match = Regex.Match(pollingPlaceName, @"제?\s*(\d+)\s*투");
if (match.Success)
{
// Groups[1]은 첫 번째 캡처 그룹(괄호 안의 내용)
return match.Groups[1].Value;
}
// 정규표현식 미매칭시 "투표소"로 끝나면 단일 투표소로 간주하여 "1" 반환
if (pollingPlaceName.EndsWith("투표소"))
{
return "1";
}
// 투표구 번호를 찾을 수 없음
return "0";
}
}
}

View File

@@ -0,0 +1,47 @@
using System.Data.SqlClient;
namespace Keps.WinForms.Infrastructure
{
public sealed class SqlConnectionFactory
{
private readonly string _connectionString;
/// <summary>
/// 주어진 레거시 DB 연결 설정으로 <see cref="SqlConnection"/>을 생성하기 위한 팩토리를 초기화합니다.
/// </summary>
/// <param name="settings">서버, 데이터베이스, 사용자, 비밀번호 등의 연결 정보.</param>
public SqlConnectionFactory(LegacyConnectionSettings settings)
{
SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
builder.DataSource = settings.Server;
builder.InitialCatalog = settings.Database;
builder.UserID = settings.UserId;
builder.Password = settings.Password;
builder.IntegratedSecurity = false;
builder.ConnectTimeout = 30;
builder.TrustServerCertificate = true;
builder.Encrypt = false;
_connectionString = builder.ConnectionString;
}
/// <summary>
/// 구성된 연결 문자열로 SQL Server 연결을 열어 반환합니다.
/// </summary>
/// <returns>열린 상태의 <see cref="SqlConnection"/>.</returns>
public SqlConnection Open()
{
SqlConnection connection = new SqlConnection(_connectionString);
connection.Open();
return connection;
}
/// <summary>
/// 내부에서 사용되는 연결 문자열을 반환합니다.
/// </summary>
public string ConnectionString
{
get { return _connectionString; }
}
}
}