WeddingPlatform.Program 클래스 참조

더 자세히 ...

정적 Public 멤버 함수
static void	Main ()

정적 Private 멤버 함수
static void	Run ()
static bool	IsTcpPortAvailable (int port, bool listenAnyIp)
static int	GetFreeLoopbackPort ()
static void	WriteStartupFailureLog (Exception ex)
static int	GetInt (IConfiguration cfg, string key, int fallback)
static bool	GetBool (IConfiguration cfg, string key, bool fallback)
static string	ResolvePath (string? configuredPath, string fallback)

상세한 설명

Program 기능과 관련 상태를 캡슐화합니다.

Program.cs 파일의 26 번째 라인에서 정의되었습니다.

멤버 함수 문서화

GetBool()

bool WeddingPlatform.Program.GetBool ( IConfiguration cfg, string key, bool fallback )

inlinestaticprivate

Bool 값을 가져옵니다.

매개변수

cfg	cfg에 사용할 IConfiguration 값입니다.
key	key에 사용할 string 값입니다.
fallback	fallback에 사용할 bool 값입니다.

반환값

Get Bool 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

Program.cs 파일의 368 번째 라인에서 정의되었습니다.

                                                                               =>
        bool.TryParse(cfg[key], out bool v) ? v : fallback;

다음에 의해서 참조됨 : Run().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetFreeLoopbackPort()

int WeddingPlatform.Program.GetFreeLoopbackPort ( )

inlinestaticprivate

Free Loopback Port 값을 가져옵니다.

반환값

Get Free Loopback Port 작업에서 생성한 int 결과입니다.

Program.cs 파일의 236 번째 라인에서 정의되었습니다.

    {
        var listener = new TcpListener(IPAddress.Loopback, 0);
        listener.Start();
        try
        {
            return ((IPEndPoint)listener.LocalEndpoint).Port;
        }
        finally
        {
            listener.Stop();
        }
    }

다음에 의해서 참조됨 : Run().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetInt()

int WeddingPlatform.Program.GetInt ( IConfiguration cfg, string key, int fallback )

inlinestaticprivate

Int 값을 가져옵니다.

매개변수

cfg	cfg에 사용할 IConfiguration 값입니다.
key	key에 사용할 string 값입니다.
fallback	fallback에 사용할 int 값입니다.

반환값

Get Int 작업에서 생성한 int 결과입니다.

Program.cs 파일의 325 번째 라인에서 정의되었습니다.

                                                                            =>
        int.TryParse(cfg[key], out int v) ? v : fallback;

다음에 의해서 참조됨 : Run().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

IsTcpPortAvailable()

bool WeddingPlatform.Program.IsTcpPortAvailable ( int port, bool listenAnyIp )

inlinestaticprivate

Is Tcp Port Available 조건을 확인합니다.

매개변수

port	port에 사용할 int 값입니다.
listenAnyIp	listen Any Ip에 사용할 bool 값입니다.

반환값

Is Tcp Port Available 조건이 충족되면 true이고, 그렇지 않으면 false입니다.

Program.cs 파일의 199 번째 라인에서 정의되었습니다.

    {
        if (port <= 0) return false;
 
        TcpListener? listener = null;
        try
        {
            listener = new TcpListener(listenAnyIp ? IPAddress.Any : IPAddress.Loopback, port);
            listener.Start();
            return true;
        }
        catch (SocketException)
        {
            return false;
        }
        finally
        {
            listener?.Stop();
        }
    }

다음에 의해서 참조됨 : Run().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

Main()

void WeddingPlatform.Program.Main ( )

inlinestatic

Main 작업을 수행합니다.

Program.cs 파일의 37 번째 라인에서 정의되었습니다.

    {
        try
        {
            Run();
        }
        catch (Exception ex)
        {
            WriteStartupFailureLog(ex);
            System.Windows.MessageBox.Show(
                $"Wedding Platform 실행 중 오류가 발생했습니다.\n\n{ex.Message}\n\n자세한 내용은 로그를 확인하세요.",
                "Wedding Platform",
                System.Windows.MessageBoxButton.OK,
                System.Windows.MessageBoxImage.Error);
        }
    }

다음을 참조함 : Run(), WriteStartupFailureLog().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

ResolvePath()

string WeddingPlatform.Program.ResolvePath ( string? configuredPath, string fallback )

inlinestaticprivate

Resolve Path 작업을 수행합니다.

매개변수

configuredPath	configured Path에 사용할 string? 값입니다.
fallback	fallback에 사용할 string 값입니다.

반환값

Resolve Path 작업에서 생성한 string 결과입니다.

Program.cs 파일의 403 번째 라인에서 정의되었습니다.

    {
        if (string.IsNullOrWhiteSpace(configuredPath))
        {
            return fallback;
        }
 
        return Path.IsPathRooted(configuredPath)
            ? configuredPath
            : Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, configuredPath));
    }

다음에 의해서 참조됨 : Run().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

Run()

void WeddingPlatform.Program.Run ( )

inlinestaticprivate

Run 작업을 수행합니다.

Program.cs 파일의 62 번째 라인에서 정의되었습니다.

    {
        HostApplicationBuilder builder = Host.CreateApplicationBuilder();
        builder.Configuration.AddUserSecrets("codemaru-oauth-2ba4e1b2");
 
        int serverPort = GetInt(builder.Configuration, "WeddingServer:Port", 5050);
        bool listenAnyIp = GetBool(builder.Configuration, "WeddingServer:ListenAnyIp", true);
        bool useEmbeddedWebView = GetBool(builder.Configuration, "WeddingShell:UseEmbeddedWebView", true);
        if (!IsTcpPortAvailable(serverPort, listenAnyIp))
        {
            serverPort = GetFreeLoopbackPort();
            listenAnyIp = false;
        }
 
        AuthOptions authOptions =
            builder.Configuration.GetSection(AuthOptions.SectionName).Get<AuthOptions>() ?? new AuthOptions();
        string usersDbPath = ResolvePath(
            builder.Configuration[$"{AuthOptions.SectionName}:UsersDbPath"],
            Path.Combine(AppContext.BaseDirectory, "App_Data", "codemaru.db"));
 
        builder.Services.AddDreamineHybridWpf();
        builder.Services.AddDreamineIdentityWpfHost();
 
        // ── Wedding 서비스 ─────────────────────────────────────────
        var weddingOpts = WeddingOptions.From(builder.Configuration);
        builder.Services.AddSingleton(weddingOpts);
        builder.Services.AddSingleton<ITenantStore, JsonTenantStore>();
        builder.Services.AddSingleton<IGuestbookStorage, CsvGuestbookStorage>();
        builder.Services.AddSingleton<IGlobalSettingsStore, JsonGlobalSettingsStore>();
        builder.Services.AddSingleton<IMediaQuotaPolicyResolver, MediaQuotaPolicyResolver>();
        builder.Services.AddSingleton<IImageOptimizationService, SystemDrawingImageOptimizationService>();
        builder.Services.AddSingleton<IMediaMigrationService, JsonMediaMigrationService>();
        builder.Services.AddSingleton<IMediaUsageQueryService, FileSystemMediaUsageQueryService>();
        builder.Services.AddSingleton<ISuperAdminSessionTokenService, SuperAdminSessionTokenService>();
        builder.Services.AddSingleton<IPhotoService, LocalPhotoService>();
 
        builder.Services.AddSingleton<Views.MainWindow>();
        builder.Services.AddHostedService<GhostAccountCleanupService>();
 
        builder.Services.AddDreamineBlazorServer<AppShell>(options =>
        {
            options.Port = serverPort;
            options.ListenAnyIp = listenAnyIp;
            options.UseEmbeddedWebView = useEmbeddedWebView;
            // Wedding 서비스 Blazor 호스트에 공유 (ViewModel은 AutoRegisterViewModels로 자동 등록)
            options.SharedServiceTypes.Add(typeof(WeddingOptions));
            options.SharedServiceTypes.Add(typeof(ITenantStore));
            options.SharedServiceTypes.Add(typeof(IGuestbookStorage));
            options.SharedServiceTypes.Add(typeof(IGlobalSettingsStore));
            options.SharedServiceTypes.Add(typeof(IMediaQuotaPolicyResolver));
            options.SharedServiceTypes.Add(typeof(IImageOptimizationService));
            options.SharedServiceTypes.Add(typeof(IMediaMigrationService));
            options.SharedServiceTypes.Add(typeof(IMediaUsageQueryService));
            options.SharedServiceTypes.Add(typeof(ISuperAdminSessionTokenService));
            options.SharedServiceTypes.Add(typeof(IPhotoService));
            // 업로드된 사진을 /wedding-data/ URL로 제공
            options.AddPhysicalStaticFiles(weddingOpts.ResolvedDataPath, "/wedding-data");
 
            // InputFile(동영상 등 대용량 업로드)은 SignalR 회선을 통해 청크 단위로 전송되는데,
            // 기본 SignalR 메시지 크기 제한(32KB)과 짧은 타임아웃 때문에 큰 파일은 매우 느리거나
            // 응답 없이 멈춘 것처럼 보입니다. 업로드 용량 검증은 LocalPhotoService에서 별도로
            // 하고 있으므로 전송 한도 자체는 풀어줍니다.
            options.ConfigureServices = services =>
            {
                services.AddServerSideBlazor()
                    .AddHubOptions(o =>
                    {
                        o.MaximumReceiveMessageSize = null; // 무제한 (용량 검증은 LocalPhotoService에서 수행)
                        o.ClientTimeoutInterval = TimeSpan.FromMinutes(10);
                        o.HandshakeTimeout = TimeSpan.FromMinutes(2);
                        o.KeepAliveInterval = TimeSpan.FromSeconds(10);
                        o.EnableDetailedErrors = false;
                    });
 
                // 삼성 인터넷 등 일부 브라우저가 SameSite 쿠키 정책에 엄격한 경우
                // Blazor 회로 토큰(antiforgery 쿠키)이 차단될 수 있습니다.
                // Lax + SameAsRequest 설정으로 호환성을 높입니다.
                services.AddAntiforgery(o =>
                {
                    o.Cookie.SameSite = Microsoft.AspNetCore.Http.SameSiteMode.Lax;
                    o.Cookie.SecurePolicy = Microsoft.AspNetCore.Http.CookieSecurePolicy.SameAsRequest;
                });
 
                // CircuitOptions: 회선 연결 실패 후 유지 시간 증가 (재접속 시 기존 상태 복원)
                services.Configure<CircuitOptions>(o =>
                {
                    o.DisconnectedCircuitMaxRetained = 100;
                    o.DisconnectedCircuitRetentionPeriod = TimeSpan.FromMinutes(3);
                    o.JSInteropDefaultCallTimeout = TimeSpan.FromMinutes(1);
                    o.MaxBufferedUnacknowledgedRenderBatches = 10;
                });
 
                services.AddScoped<WeddingUserContext>();
            };
 
            options.AddDreamineIdentity(authOptions, usersDbPath);
        });
 
        // OG 플랫폼 이미지 자동 생성 (없을 때만)
        var wwwroot = Path.Combine(AppContext.BaseDirectory, "wwwroot");
        try { OgImageGenerator.EnsureGenerated(wwwroot); } catch { /* 이미지 생성 실패해도 앱 계속 실행 */ }
 
        builder.Build().RunDreamineWpfApp<App>();
    }

다음을 참조함 : WeddingPlatform.Services.OgImageGenerator.EnsureGenerated(), WeddingPlatform.Services.WeddingOptions.From(), GetBool(), GetFreeLoopbackPort(), GetInt(), IsTcpPortAvailable(), ResolvePath().

다음에 의해서 참조됨 : Main().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

WriteStartupFailureLog()

void WeddingPlatform.Program.WriteStartupFailureLog ( Exception ex )

inlinestaticprivate

Startup Failure Log 데이터를 씁니다.

매개변수

ex	ex에 사용할 Exception 값입니다.

Program.cs 파일의 266 번째 라인에서 정의되었습니다.

    {
        try
        {
            var dir = Path.Combine(
                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
                "WeddingPlatform",
                "Logs");
            Directory.CreateDirectory(dir);
            var path = Path.Combine(dir, "startup-error.log");
            File.AppendAllText(path,
                $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] {ex}\r\n\r\n");
        }
        catch
        {
            // 마지막 안전망: 오류 로그 작성 실패가 앱 종료 원인이 되지 않게 둡니다.
        }
    }

다음에 의해서 참조됨 : Main().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• Program.cs