feat(portal): 고객 포털 인증과 소셜 로그인 기반 추가

.env.example

@@ -3,3 +3,9 @@ ASPNETCORE_URLS=http://0.0.0.0:5001
 ConnectionStrings__Default=Host=localhost;Database=taxbaikdb;Username=taxbaik;Password=change-me
 Jwt__SecretKey=dev-secret-key-change-in-production-min-32-chars!
 Admin__PasswordResetToken=change-this-reset-token
+Authentication__Google__ClientId=
+Authentication__Google__ClientSecret=
+Authentication__Naver__ClientId=
+Authentication__Naver__ClientSecret=
+Authentication__Kakao__ClientId=
+Authentication__Kakao__ClientSecret=

.gitea/workflows/deploy.yml

@@ -38,18 +38,29 @@ jobs:
           JWT_SECRET_KEY="${{ secrets.TAXBAIK_JWT_SECRET_KEY }}"
           TELEGRAM_BOT_TOKEN="${{ secrets.TAXBAIK_TELEGRAM_BOT_TOKEN }}"
           TELEGRAM_CHAT_ID="${{ secrets.TAXBAIK_TELEGRAM_CHAT_ID }}"
+          TELEGRAM_INQUIRY_CHAT_ID="${{ secrets.TAXBAIK_TELEGRAM_INQUIRY_CHAT_ID }}"
+          TELEGRAM_SYSTEM_CHAT_ID="${{ secrets.TAXBAIK_TELEGRAM_SYSTEM_CHAT_ID }}"
           [ -z "$JWT_SECRET_KEY" ]        && { echo "Missing TAXBAIK_JWT_SECRET_KEY" >&2;        exit 1; }
           [ -z "$TELEGRAM_BOT_TOKEN" ]    && { echo "Missing TAXBAIK_TELEGRAM_BOT_TOKEN" >&2;    exit 1; }
           [ -z "$TELEGRAM_CHAT_ID" ]      && { echo "Missing TAXBAIK_TELEGRAM_CHAT_ID" >&2;      exit 1; }
+          [ -z "$TELEGRAM_INQUIRY_CHAT_ID" ] && TELEGRAM_INQUIRY_CHAT_ID="$TELEGRAM_CHAT_ID"
+          [ -z "$TELEGRAM_SYSTEM_CHAT_ID" ]  && TELEGRAM_SYSTEM_CHAT_ID="-5585148480"
           JWT_SECRET_KEY="$JWT_SECRET_KEY" \
           TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" \
           TELEGRAM_CHAT_ID="$TELEGRAM_CHAT_ID" \
+          TELEGRAM_INQUIRY_CHAT_ID="$TELEGRAM_INQUIRY_CHAT_ID" \
+          TELEGRAM_SYSTEM_CHAT_ID="$TELEGRAM_SYSTEM_CHAT_ID" \
           python3 -c '
           import json, os, pathlib
           pathlib.Path("./publish/appsettings.Production.json").write_text(
             json.dumps({
               "Jwt":      {"SecretKey": os.environ["JWT_SECRET_KEY"]},
-              "Telegram": {"BotToken": os.environ["TELEGRAM_BOT_TOKEN"], "ChatId": os.environ["TELEGRAM_CHAT_ID"]}
+              "Telegram": {
+                "BotToken": os.environ["TELEGRAM_BOT_TOKEN"],
+                "ChatId": os.environ["TELEGRAM_CHAT_ID"],
+                "InquiryChatId": os.environ["TELEGRAM_INQUIRY_CHAT_ID"],
+                "SystemChatId": os.environ["TELEGRAM_SYSTEM_CHAT_ID"]
+              }
             }, ensure_ascii=False, indent=2),
             encoding="utf-8"
           )'
@@ -98,6 +109,34 @@ jobs:
           COMMIT=$(git rev-parse --short HEAD)
           DEPLOY_HOST="${{ secrets.DEPLOY_HOST }}"
           DEPLOY_USER="${{ secrets.DEPLOY_USER }}"
+          TELEGRAM_BOT_TOKEN="${{ secrets.TAXBAIK_TELEGRAM_BOT_TOKEN }}"
+          TELEGRAM_SYSTEM_CHAT_ID="${{ secrets.TAXBAIK_TELEGRAM_SYSTEM_CHAT_ID }}"
+          TELEGRAM_CHAT_ID="${TELEGRAM_SYSTEM_CHAT_ID:--5585148480}"
+
+          send_telegram() {
+            local text="$1"
+            if [ -z "$TELEGRAM_BOT_TOKEN" ]; then
+              echo "Skipping Telegram notification: missing TAXBAIK_TELEGRAM_BOT_TOKEN" >&2
+              return 0
+            fi
+
+            curl -fsS -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+              -d "chat_id=${TELEGRAM_CHAT_ID}" \
+              --data-urlencode "text=${text}" \
+              -d "parse_mode=HTML" >/dev/null || true
+          }
+
+          notify_failure() {
+            local exit_code=$?
+            send_telegram "❌ <b>TaxBaik 배포 실패</b>
+
+커밋: <code>${COMMIT}</code>
+시간: <code>${TIMESTAMP}</code>
+단계: CI/CD deploy"
+            exit "$exit_code"
+          }
+
+          trap notify_failure ERR
 
           echo "=== Deploying TaxBaik $COMMIT ($TIMESTAMP) ==="
 
@@ -179,3 +218,9 @@ jobs:
           REMOTE
 
           echo "✓ 배포 완료: taxbaik_${TIMESTAMP} @ $DEPLOY_HOST"
+          send_telegram "✅ <b>TaxBaik 배포 완료</b>
+
+커밋: <code>${COMMIT}</code>
+시간: <code>${TIMESTAMP}</code>
+대상: <code>${DEPLOY_HOST}</code>
+채널: <code>${TELEGRAM_CHAT_ID}</code>"

CLAUDE.md

@@ -1093,6 +1093,219 @@ Admin 로그인 페이지만 [AllowAnonymous]:
 - **메모이제이션**: `OnParametersSet` vs `OnInitializedAsync` 구분
 - **API 캐싱**: 변경이 없으면 `IMemoryCache` 사용 (5분 TTL)
 
+### 8.7 Blazor 페이지 추가 표준 가이드 ✅ (2026-06-28 갱신)
+
+**목표**: 모든 관리자 페이지가 일관된 구조와 UX를 유지하도록 강제
+
+#### 필수 구조 (기존 Dashboard 패턴 준수)
+
+**Step 1: 페이지 헤더 (`<section class="admin-page-hero">`)**
+```razor
+@page "/admin/새페이지"
+@attribute [Authorize]
+@inject INewPageClient NewPageClient
+@inject NavigationManager Nav
+
+<PageTitle>페이지 제목</PageTitle>
+
+<!-- 반드시 포함할 요소 -->
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">카테고리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">페이지 제목</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">한 줄 설명</MudText>
+    </div>
+    <MudButton Variant="Variant.Filled" Color="Color.Primary" StartIcon="@Icons.Material.Filled.Add" OnClick="OpenCreateDialog">
+        새 항목 추가
+    </MudButton>
+</section>
+```
+
+**Step 2: 콘텐츠 영역**
+```razor
+<!-- 로딩 상태 -->
+@if (items == null)
+{
+    <MudProgressCircular Indeterminate="true" Class="mt-4" />
+}
+<!-- 빈 상태 -->
+else if (items.Count == 0)
+{
+    <MudAlert Severity="Severity.Info" Class="mt-4">데이터가 없습니다.</MudAlert>
+}
+<!-- 데이터 그리드 -->
+else
+{
+    <MudDataGrid T="YourEntity"
+        Items="@items"
+        Dense="true"
+        Hover="true"
+        Striped="true"
+        Virtualize="true"
+        RowsPerPage="30"
+        Class="admin-grid mt-4">
+        <Columns>
+            <!-- 필수: 컬럼 정의 -->
+        </Columns>
+    </MudDataGrid>
+}
+```
+
+**Step 3: 모달 다이얼로그 (Create/Edit)**
+```razor
+<MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
+    <TitleContent>
+        <MudText Typo="Typo.h6">@(isEditMode ? "항목 수정" : "새 항목 추가")</MudText>
+    </TitleContent>
+    <DialogContent>
+        <MudForm @ref="form">
+            <!-- 폼 필드 -->
+        </MudForm>
+    </DialogContent>
+    <DialogActions>
+        <MudButton OnClick="CloseDialog">취소</MudButton>
+        <MudButton Color="Color.Primary" OnClick="SaveItem">저장</MudButton>
+    </DialogActions>
+</MudDialog>
+```
+
+**Step 4: @code 섹션 구조**
+```csharp
+@code {
+    private List<YourEntity>? items;
+    private List<RelatedEntity> relatedItems = [];
+    private Dictionary<int, string> itemMap = new();
+    
+    private MudForm? form;
+    private bool isDialogOpen;
+    private bool isEditMode;
+    private YourEntity? editingItem;
+    private YourItemForm itemForm = new();
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadData();
+    }
+
+    private async Task LoadData()
+    {
+        try
+        {
+            items = await YourItemClient.GetAllAsync();
+            // 필요시 관련 데이터 로드
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"데이터 로드 실패: {ex.Message}", Severity.Error);
+        }
+    }
+
+    private void OpenCreateDialog()
+    {
+        isEditMode = false;
+        editingItem = null;
+        itemForm = new();
+        isDialogOpen = true;
+    }
+
+    private async Task OpenEditDialog(YourEntity item)
+    {
+        isEditMode = true;
+        editingItem = item;
+        itemForm = new YourItemForm { /* 초기화 */ };
+        isDialogOpen = true;
+    }
+
+    private async Task SaveItem()
+    {
+        try
+        {
+            if (isEditMode)
+            {
+                await YourItemClient.UpdateAsync(editingItem!.Id, /* params */);
+                Snackbar.Add("항목이 업데이트되었습니다.", Severity.Success);
+            }
+            else
+            {
+                var newId = await YourItemClient.CreateAsync(/* params */);
+                if (newId > 0)
+                {
+                    Snackbar.Add("항목이 추가되었습니다.", Severity.Success);
+                }
+            }
+            CloseDialog();
+            await LoadData();
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"저장 실패: {ex.Message}", Severity.Error);
+        }
+    }
+
+    private async Task DeleteItem(int id)
+    {
+        var parameters = new DialogParameters();
+        parameters.Add("Title", "삭제 확인");
+        parameters.Add("Message", "이 항목을 삭제하시겠습니까?");
+
+        var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
+        var result = await dialog.Result;
+
+        if (result?.Canceled ?? true)
+            return;
+
+        try
+        {
+            await YourItemClient.DeleteAsync(id);
+            Snackbar.Add("항목이 삭제되었습니다.", Severity.Success);
+            await LoadData();
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"삭제 실패: {ex.Message}", Severity.Error);
+        }
+    }
+
+    private void CloseDialog()
+    {
+        isDialogOpen = false;
+        isEditMode = false;
+        editingItem = null;
+        itemForm = new();
+    }
+
+    private class YourItemForm
+    {
+        // DTO 필드
+    }
+}
+```
+
+#### 체크리스트 (모든 페이지)
+
+- [ ] @page 지시문 확인
+- [ ] @attribute [Authorize] 추가
+- [ ] @inject로 필요한 Client 주입
+- [ ] <PageTitle> 추가
+- [ ] <section class="admin-page-hero"> (캡션, 제목, 부제, 추가 버튼)
+- [ ] 로딩 상태 (MudProgressCircular)
+- [ ] 빈 상태 (MudAlert)
+- [ ] MudDataGrid (Dense=true, Virtualize=true, RowsPerPage=30, admin-grid 클래스)
+- [ ] MudDialog (Create/Edit 모달)
+- [ ] ConfirmDialog (Delete 확인)
+- [ ] @code 섹션: OnInitializedAsync → LoadData() 패턴
+- [ ] 모든 에러 처리 (try-catch, Snackbar 메시지)
+- [ ] CloseDialog() 메서드로 모달 상태 초기화
+
+#### 위반 사항
+
+❌ **이 패턴을 따르지 않는 페이지는 실시간 코드 리뷰 대상:**
+- 페이지 헤더 (admin-page-hero) 누락
+- 인라인 스타일로 레이아웃 구성
+- MudDialog 없이 별도 라우트로 Create/Edit 처리 (흰 화면 플래시)
+- @code 섹션 구조 다름
+- 모달에서 직접 onSubmit 대신 Snackbar 피드백 미제공
+
 ---
 
 ## 9. Do's & Don'ts

TaxBaik.Application/DependencyInjection.cs

@@ -25,6 +25,8 @@ public static class DependencyInjection
         services.AddScoped<ConsultingActivityService>();
         services.AddScoped<ContractService>();
         services.AddScoped<RevenueTrackingService>();
+        services.AddScoped<TelegramReportService>();
+        services.AddScoped<PortalUserService>();
         return services;
     }
 }

TaxBaik.Application/Services/ClientService.cs

@@ -22,6 +22,15 @@ public class ClientService(IClientRepository repository)
     public async Task<Client?> GetByIdAsync(int id, CancellationToken ct = default) =>
         await repository.GetByIdAsync(id, ct);
 
+    public async Task<Client?> GetByEmailAsync(string email, CancellationToken ct = default) =>
+        await repository.GetByEmailAsync(email, ct);
+
+    public async Task<Client?> GetByPhoneAsync(string phone, CancellationToken ct = default) =>
+        await repository.GetByPhoneAsync(phone, ct);
+
+    public async Task<int> CountCreatedAtRangeAsync(DateTime startDateUtc, DateTime endDateUtc, CancellationToken ct = default) =>
+        await repository.CountByCreatedAtRangeAsync(startDateUtc, endDateUtc, ct);
+
     public async Task<int> CreateAsync(CreateClientDto dto, CancellationToken ct = default)
     {
         if (string.IsNullOrWhiteSpace(dto.Name))

TaxBaik.Application/Services/PortalUserService.cs

@@ -0,0 +1,59 @@
+namespace TaxBaik.Application.Services;
+
+using TaxBaik.Domain.Entities;
+using TaxBaik.Domain.Interfaces;
+
+public class PortalUserService(IPortalUserRepository repository)
+{
+    public async Task<PortalUser?> GetByEmailAsync(string email, CancellationToken ct = default) =>
+        await repository.GetByEmailAsync(email.Trim(), ct);
+
+    public async Task<PortalUser?> GetByProviderAsync(string provider, string providerId, CancellationToken ct = default) =>
+        await repository.GetByProviderAsync(provider.Trim(), providerId.Trim(), ct);
+
+    public async Task<int> RegisterLocalAsync(string name, string email, string phone, string? passwordHash, int? clientId = null, CancellationToken ct = default) =>
+        await RegisterAsync(name, email, phone, "local", null, passwordHash, clientId, ct);
+
+    public async Task<int> RegisterOAuthAsync(string name, string email, string? phone, string provider, string providerId, int? clientId = null, CancellationToken ct = default) =>
+        await RegisterAsync(name, email, phone, provider, providerId, null, clientId, ct);
+
+    public async Task LinkOAuthAsync(PortalUser user, string provider, string providerId, string? displayName = null, string? email = null, CancellationToken ct = default)
+    {
+        user.Name = string.IsNullOrWhiteSpace(displayName) ? user.Name : displayName.Trim();
+        user.Email = string.IsNullOrWhiteSpace(email) ? user.Email : email.Trim();
+        if (string.IsNullOrWhiteSpace(user.PasswordHash))
+        {
+            user.Provider = provider.Trim();
+            user.ProviderId = providerId.Trim();
+        }
+        await repository.UpdateAsync(user, ct);
+    }
+
+    public async Task AttachClientAsync(PortalUser user, int clientId, CancellationToken ct = default)
+    {
+        user.ClientId = clientId;
+        await repository.UpdateAsync(user, ct);
+    }
+
+    private async Task<int> RegisterAsync(string name, string email, string? phone, string provider, string? providerId, string? passwordHash, int? clientId, CancellationToken ct)
+    {
+        if (string.IsNullOrWhiteSpace(name))
+            throw new ValidationException("이름을 입력하세요.");
+        if (string.IsNullOrWhiteSpace(email))
+            throw new ValidationException("이메일을 입력하세요.");
+
+        var user = new PortalUser
+        {
+            ClientId = clientId,
+            Name = name.Trim(),
+            Email = email.Trim(),
+            Phone = string.IsNullOrWhiteSpace(phone) ? null : phone.Trim(),
+            Provider = provider,
+            ProviderId = providerId,
+            PasswordHash = passwordHash,
+            CreatedAt = DateTime.UtcNow
+        };
+
+        return await repository.CreateAsync(user, ct);
+    }
+}

TaxBaik.Application/Services/TelegramReportService.cs

@@ -0,0 +1,74 @@
+namespace TaxBaik.Application.Services;
+
+public record TelegramDailyReport(
+    DateOnly Date,
+    int NewInquiries,
+    int PendingInquiries,
+    int NewClients,
+    int PendingTaxFilings,
+    int PendingPayments);
+
+public record TelegramWeeklyReport(
+    DateOnly WeekStart,
+    DateOnly WeekEnd,
+    int NewInquiries,
+    int NewClients,
+    int UpcomingTaxFilings,
+    decimal RevenueThisWeek);
+
+public class TelegramReportService(
+    InquiryService inquiryService,
+    ClientService clientService,
+    TaxFilingScheduleService taxFilingScheduleService,
+    RevenueTrackingService revenueTrackingService)
+{
+    public async Task<TelegramDailyReport> BuildDailyReportAsync(DateOnly date, CancellationToken ct = default)
+    {
+        var start = date.ToDateTime(TimeOnly.MinValue, DateTimeKind.Utc);
+        var end = date.ToDateTime(TimeOnly.MaxValue, DateTimeKind.Utc);
+
+        return new TelegramDailyReport(
+            Date: date,
+            NewInquiries: await inquiryService.CountByDateRangeAsync(start, end, ct),
+            PendingInquiries: await inquiryService.CountByStatusAsync("new", ct),
+            NewClients: await clientService.CountCreatedAtRangeAsync(start, end, ct),
+            PendingTaxFilings: await taxFilingScheduleService.GetPendingCountAsync(ct),
+            PendingPayments: (await revenueTrackingService.GetPendingPaymentsAsync(ct)).Count());
+    }
+
+    public async Task<TelegramWeeklyReport> BuildWeeklyReportAsync(DateOnly weekStart, CancellationToken ct = default)
+    {
+        var weekEnd = weekStart.AddDays(6);
+        var start = weekStart.ToDateTime(TimeOnly.MinValue, DateTimeKind.Utc);
+        var end = weekEnd.ToDateTime(TimeOnly.MaxValue, DateTimeKind.Utc);
+        var upcomingEnd = weekEnd.AddDays(7).ToDateTime(TimeOnly.MaxValue, DateTimeKind.Utc);
+
+        var revenue = await revenueTrackingService.GetTotalRevenueAsync(start, end, ct);
+
+        return new TelegramWeeklyReport(
+            WeekStart: weekStart,
+            WeekEnd: weekEnd,
+            NewInquiries: await inquiryService.CountByDateRangeAsync(start, end, ct),
+            NewClients: await clientService.CountCreatedAtRangeAsync(start, end, ct),
+            UpcomingTaxFilings: (await taxFilingScheduleService.GetUpcomingDuesAsync(14, ct))
+                .Count(x => x.DueDate >= start && x.DueDate <= upcomingEnd),
+            RevenueThisWeek: revenue);
+    }
+
+    public static string FormatDailyMessage(TelegramDailyReport report) =>
+        $"<b>📊 일간 리포트</b>\n\n" +
+        $"기준일: <code>{report.Date:yyyy-MM-dd}</code>\n" +
+        $"신규 문의: <code>{report.NewInquiries}</code>\n" +
+        $"처리 대기 문의: <code>{report.PendingInquiries}</code>\n" +
+        $"신규 고객: <code>{report.NewClients}</code>\n" +
+        $"신고 대기: <code>{report.PendingTaxFilings}</code>\n" +
+        $"미수 청구: <code>{report.PendingPayments}</code>";
+
+    public static string FormatWeeklyMessage(TelegramWeeklyReport report) =>
+        $"<b>📈 주간 리포트</b>\n\n" +
+        $"기간: <code>{report.WeekStart:yyyy-MM-dd}</code> ~ <code>{report.WeekEnd:yyyy-MM-dd}</code>\n" +
+        $"신규 문의: <code>{report.NewInquiries}</code>\n" +
+        $"신규 고객: <code>{report.NewClients}</code>\n" +
+        $"다가오는 신고: <code>{report.UpcomingTaxFilings}</code>\n" +
+        $"주간 매출: <code>₩{report.RevenueThisWeek:N0}</code>";
+}

TaxBaik.Domain/Entities/PortalUser.cs

@@ -0,0 +1,14 @@
+namespace TaxBaik.Domain.Entities;
+
+public class PortalUser
+{
+    public int Id { get; set; }
+    public int? ClientId { get; set; }
+    public string Email { get; set; } = "";
+    public string Name { get; set; } = "";
+    public string? Phone { get; set; }
+    public string Provider { get; set; } = "local";
+    public string? ProviderId { get; set; }
+    public string? PasswordHash { get; set; }
+    public DateTime CreatedAt { get; set; }
+}

TaxBaik.Domain/Interfaces/IClientRepository.cs

@@ -8,6 +8,9 @@ public interface IClientRepository
         int page, int pageSize, string? status = null, string? search = null,
         CancellationToken ct = default);
     Task<Client?> GetByIdAsync(int id, CancellationToken ct = default);
+    Task<Client?> GetByEmailAsync(string email, CancellationToken ct = default);
+    Task<Client?> GetByPhoneAsync(string phone, CancellationToken ct = default);
+    Task<int> CountByCreatedAtRangeAsync(DateTime startDateUtc, DateTime endDateUtc, CancellationToken ct = default);
     Task<int> CreateAsync(Client client, CancellationToken ct = default);
     Task UpdateAsync(Client client, CancellationToken ct = default);
     Task DeleteAsync(int id, CancellationToken ct = default);

TaxBaik.Domain/Interfaces/IPortalUserRepository.cs

@@ -0,0 +1,12 @@
+namespace TaxBaik.Domain.Interfaces;
+
+using TaxBaik.Domain.Entities;
+
+public interface IPortalUserRepository
+{
+    Task<PortalUser?> GetByIdAsync(int id, CancellationToken ct = default);
+    Task<PortalUser?> GetByEmailAsync(string email, CancellationToken ct = default);
+    Task<PortalUser?> GetByProviderAsync(string provider, string providerId, CancellationToken ct = default);
+    Task<int> CreateAsync(PortalUser user, CancellationToken ct = default);
+    Task UpdateAsync(PortalUser user, CancellationToken ct = default);
+}

TaxBaik.Infrastructure/DependencyInjection.cs

@@ -19,6 +19,7 @@ public static class DependencyInjection
         services.AddScoped<IClientRepository, ClientRepository>();
         services.AddScoped<IFaqRepository, FaqRepository>();
         services.AddScoped<IConsultationRepository, ConsultationRepository>();
+        services.AddScoped<IPortalUserRepository, PortalUserRepository>();
         services.AddScoped<ITaxFilingRepository, TaxFilingRepository>();
         services.AddScoped<ICompanyRepository, CompanyRepository>();
         services.AddScoped<ITaxProfileRepository, TaxProfileRepository>();

TaxBaik.Infrastructure/Repositories/ClientRepository.cs

@@ -40,6 +40,33 @@ public class ClientRepository(IDbConnectionFactory connectionFactory) : BaseRepo
             new { Id = id });
     }
 
+    public async Task<Client?> GetByEmailAsync(string email, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstOrDefaultAsync<Client>(
+            $"SELECT {SelectColumns} FROM clients WHERE email = @Email",
+            new { Email = email });
+    }
+
+    public async Task<Client?> GetByPhoneAsync(string phone, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstOrDefaultAsync<Client>(
+            $"SELECT {SelectColumns} FROM clients WHERE phone = @Phone",
+            new { Phone = phone });
+    }
+
+    public async Task<int> CountByCreatedAtRangeAsync(DateTime startDateUtc, DateTime endDateUtc, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.ExecuteScalarAsync<int>(
+            @"SELECT COUNT(*)
+              FROM clients
+              WHERE created_at >= @StartDateUtc
+                AND created_at <= @EndDateUtc",
+            new { StartDateUtc = startDateUtc, EndDateUtc = endDateUtc });
+    }
+
     public async Task<int> CreateAsync(Client client, CancellationToken ct = default)
     {
         using var conn = Conn();

TaxBaik.Infrastructure/Repositories/PortalUserRepository.cs

@@ -0,0 +1,64 @@
+namespace TaxBaik.Infrastructure.Repositories;
+
+using Dapper;
+using TaxBaik.Domain.Entities;
+using TaxBaik.Domain.Interfaces;
+
+public class PortalUserRepository(IDbConnectionFactory connectionFactory) : BaseRepository(connectionFactory), IPortalUserRepository
+{
+    public async Task<PortalUser?> GetByIdAsync(int id, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstOrDefaultAsync<PortalUser>(
+            @"SELECT id, client_id, email, name, phone, provider, provider_id, password_hash, created_at
+              FROM portal_users
+              WHERE id = @Id",
+            new { Id = id });
+    }
+
+    public async Task<PortalUser?> GetByEmailAsync(string email, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstOrDefaultAsync<PortalUser>(
+            @"SELECT id, client_id, email, name, phone, provider, provider_id, password_hash, created_at
+              FROM portal_users
+              WHERE email = @Email",
+            new { Email = email });
+    }
+
+    public async Task<PortalUser?> GetByProviderAsync(string provider, string providerId, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstOrDefaultAsync<PortalUser>(
+            @"SELECT id, client_id, email, name, phone, provider, provider_id, password_hash, created_at
+              FROM portal_users
+              WHERE provider = @Provider AND provider_id = @ProviderId",
+            new { Provider = provider, ProviderId = providerId });
+    }
+
+    public async Task<int> CreateAsync(PortalUser user, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        return await conn.QueryFirstAsync<int>(
+            @"INSERT INTO portal_users (client_id, email, name, phone, provider, provider_id, password_hash, created_at)
+              VALUES (@ClientId, @Email, @Name, @Phone, @Provider, @ProviderId, @PasswordHash, NOW())
+              RETURNING id",
+            user);
+    }
+
+    public async Task UpdateAsync(PortalUser user, CancellationToken ct = default)
+    {
+        using var conn = Conn();
+        await conn.ExecuteAsync(
+            @"UPDATE portal_users
+              SET client_id = @ClientId,
+                  email = @Email,
+                  name = @Name,
+                  phone = @Phone,
+                  provider = @Provider,
+                  provider_id = @ProviderId,
+                  password_hash = @PasswordHash
+              WHERE id = @Id",
+            user);
+    }
+}

TaxBaik.Web/Components/Admin/Pages/ConsultingActivities.razor

@@ -8,21 +8,28 @@
 
 <PageTitle>상담 활동 관리</PageTitle>
 
-<div class="admin-container">
-    <div class="admin-header">
-        <MudText Typo="Typo.h5" Class="font-weight-bold">상담 활동 관리</MudText>
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">CRM & 세무관리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">상담 활동 관리</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">고객별 상담 이력과 팔로업을 추적합니다.</MudText>
+    </div>
     <MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="OpenCreateDialog" StartIcon="@Icons.Material.Filled.Add">
         새 활동 기록
     </MudButton>
-    </div>
+</section>
 
-    @if (activities == null)
+<MudPaper Class="admin-surface" Elevation="0">
+    @if (activities is null)
     {
-        <MudProgressCircular Indeterminate="true" Class="mt-4" />
+        <MudProgressLinear Indeterminate="true" />
     }
     else if (activities.Count == 0)
     {
-        <MudAlert Severity="Severity.Info" Class="mt-4">상담 활동이 없습니다.</MudAlert>
+        <div class="pa-6 text-center">
+            <MudIcon Icon="@Icons.Material.Filled.Timeline" Style="font-size:3rem; opacity:.3;" />
+            <MudText Class="mt-2 text-muted">상담 활동이 없습니다.</MudText>
+        </div>
     }
     else
     {
@@ -33,7 +40,7 @@
             Striped="true"
             Virtualize="true"
             RowsPerPage="30"
-            Class="admin-grid mt-4">
+            Class="admin-grid">
             <Columns>
                 <PropertyColumn Property="x => x.Id" Title="ID" Sortable="true" />
                 <TemplateColumn Title="고객">
@@ -82,9 +89,8 @@
             </Columns>
         </MudDataGrid>
     }
-</div>
+</MudPaper>
 
-<!-- Create/Edit Dialog -->
 <MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
     <TitleContent>
         <MudText Typo="Typo.h6">@(editingActivity == null ? "새 활동 기록" : "활동 기록 수정")</MudText>
@@ -201,9 +207,11 @@
 
     private async Task DeleteActivity(int id)
     {
-        var parameters = new DialogParameters();
-        parameters.Add("Title", "삭제 확인");
-        parameters.Add("Message", "이 활동을 삭제하시겠습니까?");
+        var parameters = new DialogParameters
+        {
+            { "Title", "삭제 확인" },
+            { "Message", "이 활동을 삭제하시겠습니까?" }
+        };
 
         var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
         var result = await dialog.Result;
@@ -239,20 +247,3 @@
         public DateTime? NextFollowupDate { get; set; }
     }
 }
-
-<style>
-.admin-container {
-    padding: 20px;
-}
-
-.admin-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-}
-
-.admin-grid {
-    font-size: 13px;
-}
-</style>

TaxBaik.Web/Components/Admin/Pages/Contracts.razor

@@ -8,29 +8,35 @@
 
 <PageTitle>계약 관리</PageTitle>
 
-<div class="admin-container">
-    <div class="admin-header">
+<section class="admin-page-hero">
     <div>
-            <MudText Typo="Typo.h5" Class="font-weight-bold">계약 관리</MudText>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">CRM & 세무관리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">계약 관리</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">고객 계약과 월 정기수익을 함께 관리합니다.</MudText>
         @if (mrr > 0)
         {
             <MudText Typo="Typo.body2" Class="mt-2">
-                    월 정기수익: <MudChip Size="Size.Small" Color="Color.Primary" Variant="Variant.Filled">₩@mrr.ToString("N0")</MudChip>
+                월 정기수익:
+                <MudChip Size="Size.Small" Color="Color.Primary" Variant="Variant.Filled">₩@mrr.ToString("N0")</MudChip>
             </MudText>
         }
     </div>
     <MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="OpenCreateDialog" StartIcon="@Icons.Material.Filled.Add">
         새 계약 추가
     </MudButton>
-    </div>
+</section>
 
-    @if (contracts == null)
+<MudPaper Class="admin-surface" Elevation="0">
+    @if (contracts is null)
     {
-        <MudProgressCircular Indeterminate="true" Class="mt-4" />
+        <MudProgressLinear Indeterminate="true" />
     }
     else if (contracts.Count == 0)
     {
-        <MudAlert Severity="Severity.Info" Class="mt-4">계약이 없습니다.</MudAlert>
+        <div class="pa-6 text-center">
+            <MudIcon Icon="@Icons.Material.Filled.Description" Style="font-size:3rem; opacity:.3;" />
+            <MudText Class="mt-2 text-muted">계약이 없습니다.</MudText>
+        </div>
     }
     else
     {
@@ -41,7 +47,7 @@
             Striped="true"
             Virtualize="true"
             RowsPerPage="30"
-            Class="admin-grid mt-4">
+            Class="admin-grid">
             <Columns>
                 <PropertyColumn Property="x => x.Id" Title="ID" Sortable="true" />
                 <TemplateColumn Title="고객">
@@ -92,7 +98,7 @@
             </Columns>
         </MudDataGrid>
     }
-</div>
+</MudPaper>
 
 <!-- Create Dialog -->
 <MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
@@ -181,9 +187,11 @@
 
     private async Task DeleteContract(int id)
     {
-        var parameters = new DialogParameters();
-        parameters.Add("Title", "삭제 확인");
-        parameters.Add("Message", "이 계약을 삭제하시겠습니까?");
+        var parameters = new DialogParameters
+        {
+            { "Title", "삭제 확인" },
+            { "Message", "이 계약을 삭제하시겠습니까?" }
+        };
 
         var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
         var result = await dialog.Result;
@@ -218,20 +226,3 @@
         public decimal? MonthlyFee { get; set; }
     }
 }
-
-<style>
-.admin-container {
-    padding: 20px;
-}
-
-.admin-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-}
-
-.admin-grid {
-    font-size: 13px;
-}
-</style>

TaxBaik.Web/Components/Admin/Pages/RevenueTrackings.razor

@@ -8,21 +8,28 @@
 
 <PageTitle>수익 추적 관리</PageTitle>
 
-<div class="admin-container">
-    <div class="admin-header">
-        <MudText Typo="Typo.h5" Class="font-weight-bold">수익 추적 관리</MudText>
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">CRM & 세무관리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">수익 추적 관리</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">청구, 납부, 미수금 상태를 한 화면에서 관리합니다.</MudText>
+    </div>
     <MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="OpenCreateDialog" StartIcon="@Icons.Material.Filled.Add">
         새 청구 추가
     </MudButton>
-    </div>
+</section>
 
-    @if (revenues == null)
+<MudPaper Class="admin-surface" Elevation="0">
+    @if (revenues is null)
     {
-        <MudProgressCircular Indeterminate="true" Class="mt-4" />
+        <MudProgressLinear Indeterminate="true" />
     }
     else if (revenues.Count == 0)
     {
-        <MudAlert Severity="Severity.Info" Class="mt-4">청구 기록이 없습니다.</MudAlert>
+        <div class="pa-6 text-center">
+            <MudIcon Icon="@Icons.Material.Filled.Payments" Style="font-size:3rem; opacity:.3;" />
+            <MudText Class="mt-2 text-muted">청구 기록이 없습니다.</MudText>
+        </div>
     }
     else
     {
@@ -33,7 +40,7 @@
             Striped="true"
             Virtualize="true"
             RowsPerPage="30"
-            Class="admin-grid mt-4">
+            Class="admin-grid">
             <Columns>
                 <PropertyColumn Property="x => x.Id" Title="ID" Sortable="true" />
                 <TemplateColumn Title="고객">
@@ -77,7 +84,7 @@
             </Columns>
         </MudDataGrid>
     }
-</div>
+</MudPaper>
 
 <!-- Create Dialog -->
 <MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
@@ -180,9 +187,11 @@
 
     private async Task DeleteRevenue(int id)
     {
-        var parameters = new DialogParameters();
-        parameters.Add("Title", "삭제 확인");
-        parameters.Add("Message", "이 청구를 삭제하시겠습니까?");
+        var parameters = new DialogParameters
+        {
+            { "Title", "삭제 확인" },
+            { "Message", "이 청구를 삭제하시겠습니까?" }
+        };
 
         var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
         var result = await dialog.Result;
@@ -218,20 +227,3 @@
         public DateTime? DueDate { get; set; }
     }
 }
-
-<style>
-.admin-container {
-    padding: 20px;
-}
-
-.admin-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-}
-
-.admin-grid {
-    font-size: 13px;
-}
-</style>

TaxBaik.Web/Components/Admin/Pages/TaxFilingSchedules.razor

@@ -6,23 +6,33 @@
 @inject IDialogService DialogService
 @attribute [Authorize]
 
-<PageTitle>신고 일정 관리</PageTitle>
+<PageTitle>신고 일정</PageTitle>
 
-<div class="admin-container">
-    <div class="admin-header">
-        <MudText Typo="Typo.h5" Class="font-weight-bold">신고 일정 관리</MudText>
-        <MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="OpenCreateDialog" StartIcon="@Icons.Material.Filled.Add">
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">CRM & 세무관리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">신고 일정</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">고객별 마감일과 처리 상태를 한 화면에서 관리합니다.</MudText>
+    </div>
+    <MudButton Variant="Variant.Filled"
+               Color="Color.Primary"
+               OnClick="OpenCreateDialog"
+               StartIcon="@Icons.Material.Filled.Add">
         새 일정 추가
     </MudButton>
-    </div>
+</section>
 
-    @if (schedules == null)
+<MudPaper Class="admin-surface" Elevation="0">
+    @if (schedules is null)
     {
-        <MudProgressCircular Indeterminate="true" Class="mt-4" />
+        <MudProgressLinear Indeterminate="true" />
     }
     else if (schedules.Count == 0)
     {
-        <MudAlert Severity="Severity.Info" Class="mt-4">신고 일정이 없습니다.</MudAlert>
+        <div class="pa-6 text-center">
+            <MudIcon Icon="@Icons.Material.Filled.EventBusy" Style="font-size:3rem; opacity:.3;" />
+            <MudText Class="mt-2 text-muted">신고 일정이 없습니다.</MudText>
+        </div>
     }
     else
     {
@@ -33,7 +43,7 @@
                      Striped="true"
                      Virtualize="true"
                      RowsPerPage="30"
-            Class="admin-grid mt-4">
+                     Class="admin-grid">
             <Columns>
                 <PropertyColumn Property="x => x.Id" Title="ID" Sortable="true" />
                 <TemplateColumn Title="고객">
@@ -55,8 +65,14 @@
                         }
                         <MudChip Size="Size.Small" Color="@statusColor" Variant="Variant.Filled">
                             @context.Item.DueDate.ToString("yyyy-MM-dd")
-                            @if (daysLeft >= 0) { <span>(D-@daysLeft)</span> }
-                            else { <span>(마감@(Math.Abs(daysLeft))일경과)</span> }
+                            @if (daysLeft >= 0)
+                            {
+                                <span class="ms-1">(D-@daysLeft)</span>
+                            }
+                            else
+                            {
+                                <span class="ms-1">(마감 @Math.Abs(daysLeft)일 경과)</span>
+                            }
                         </MudChip>
                     </CellTemplate>
                 </TemplateColumn>
@@ -78,27 +94,36 @@
                         <MudButtonGroup Size="Size.Small" Variant="Variant.Outlined">
                             @if (context.Item.Status != "completed")
                             {
-                                <MudIconButton Icon="@Icons.Material.Filled.CheckCircle" Color="Color.Success"
-                                    OnClick="@(async () => await CompleteSchedule(context.Item.Id))" Title="완료" />
+                                <MudIconButton Icon="@Icons.Material.Filled.CheckCircle"
+                                               Color="Color.Success"
+                                               OnClick="@(async () => await CompleteSchedule(context.Item.Id))"
+                                               Title="완료" />
                             }
-                            <MudIconButton Icon="@Icons.Material.Filled.Delete" Color="Color.Error"
-                                OnClick="@(async () => await DeleteSchedule(context.Item.Id))" />
+                            <MudIconButton Icon="@Icons.Material.Filled.Delete"
+                                           Color="Color.Error"
+                                           OnClick="@(async () => await DeleteSchedule(context.Item.Id))"
+                                           Title="삭제" />
                         </MudButtonGroup>
                     </CellTemplate>
                 </TemplateColumn>
             </Columns>
         </MudDataGrid>
     }
-</div>
+</MudPaper>
 
-<!-- Create/Edit Dialog -->
 <MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
     <TitleContent>
-        <MudText Typo="Typo.h6">@(editingSchedule == null ? "새 신고 일정 추가" : "신고 일정 수정")</MudText>
+        <MudText Typo="Typo.h6">새 신고 일정 추가</MudText>
     </TitleContent>
     <DialogContent>
         <MudForm @ref="form">
-            <MudSelect T="int" @bind-Value="scheduleForm.ClientId" Label="고객" Required="true" Variant="Variant.Outlined" FullWidth="true" Class="mb-4">
+            <MudSelect T="int"
+                       @bind-Value="scheduleForm.ClientId"
+                       Label="고객"
+                       Required="true"
+                       Variant="Variant.Outlined"
+                       FullWidth="true"
+                       Class="mb-4">
                 @foreach (var client in clients)
                 {
                     <MudSelectItem Value="@client.Id">@client.CompanyName</MudSelectItem>
@@ -121,13 +146,9 @@
     private Dictionary<int, string> clientMap = new();
     private MudForm? form;
     private bool isDialogOpen;
-    private TaxFilingSchedule? editingSchedule;
     private TaxFilingScheduleForm scheduleForm = new();
 
-    protected override async Task OnInitializedAsync()
-    {
-        await LoadData();
-    }
+    protected override async Task OnInitializedAsync() => await LoadData();
 
     private async Task LoadData()
     {
@@ -146,21 +167,18 @@
 
     private void OpenCreateDialog()
     {
-        editingSchedule = null;
-        scheduleForm = new();
+        scheduleForm = new TaxFilingScheduleForm { FilingYear = DateTime.Now.Year };
         isDialogOpen = true;
     }
 
     private async Task SaveSchedule()
     {
         try
-        {
-            if (editingSchedule == null)
         {
             var newId = await TaxFilingClient.CreateAsync(
                 scheduleForm.ClientId,
                 scheduleForm.FilingType,
-                    scheduleForm.DueDate ?? DateTime.Now,
+                scheduleForm.DueDate ?? DateTime.Today,
                 scheduleForm.FilingYear);
 
             if (newId > 0)
@@ -169,6 +187,9 @@
                 CloseDialog();
                 await LoadData();
             }
+            else
+            {
+                Snackbar.Add("등록에 실패했습니다.", Severity.Error);
             }
         }
         catch (Exception ex)
@@ -193,13 +214,14 @@
 
     private async Task DeleteSchedule(int id)
     {
-        var parameters = new DialogParameters();
-        parameters.Add("Title", "삭제 확인");
-        parameters.Add("Message", "이 신고 일정을 삭제하시겠습니까?");
+        var parameters = new DialogParameters
+        {
+            { "Title", "삭제 확인" },
+            { "Message", "이 신고 일정을 삭제하시겠습니까?" }
+        };
 
         var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
         var result = await dialog.Result;
-
         if (result?.Canceled ?? true)
             return;
 
@@ -218,7 +240,6 @@
     private void CloseDialog()
     {
         isDialogOpen = false;
-        editingSchedule = null;
         scheduleForm = new();
     }
 
@@ -230,20 +251,3 @@
         public int FilingYear { get; set; } = DateTime.Now.Year;
     }
 }
-
-<style>
-.admin-container {
-    padding: 20px;
-}
-
-.admin-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-}
-
-.admin-grid {
-    font-size: 13px;
-}
-</style>

TaxBaik.Web/Components/Admin/Pages/TaxProfiles.razor

@@ -6,15 +6,18 @@
 @inject IDialogService DialogService
 @attribute [Authorize]
 
-<PageTitle>세무 프로필 관리</PageTitle>
+<PageTitle>세무 프로필</PageTitle>
 
-<div class="admin-container">
-    <div class="admin-header">
-        <MudText Typo="Typo.h5" Class="font-weight-bold">세무 프로필 관리</MudText>
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">CRM & 세무관리</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">세무 프로필</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">고객별 세무 프로필, 신고 일정, 위험도 추적</MudText>
+    </div>
     <MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="OpenCreateDialog" StartIcon="@Icons.Material.Filled.Add">
         새 프로필 추가
     </MudButton>
-    </div>
+</section>
 
 @if (profiles == null)
 {
@@ -73,12 +76,11 @@
         </Columns>
     </MudDataGrid>
 }
-</div>
 
 <!-- Create/Edit Dialog -->
 <MudDialog @bind-IsVisible="isDialogOpen" Options="new DialogOptions { MaxWidth = MaxWidth.Small, FullWidth = true }">
     <TitleContent>
-        <MudText Typo="Typo.h6">@(editingProfile == null ? "새 프로필 추가" : "프로필 수정")</MudText>
+        <MudText Typo="Typo.h6">@(isEditMode ? "세무 프로필 수정" : "새 세무 프로필 추가")</MudText>
     </TitleContent>
     <DialogContent>
         <MudForm @ref="form">
@@ -110,6 +112,7 @@
     private Dictionary<int, string> clientMap = new();
     private MudForm? form;
     private bool isDialogOpen;
+    private bool isEditMode;
     private TaxProfile? editingProfile;
     private TaxProfileForm profileForm = new();
 
@@ -135,6 +138,7 @@
 
     private void OpenCreateDialog()
     {
+        isEditMode = false;
         editingProfile = null;
         profileForm = new();
         isDialogOpen = true;
@@ -142,6 +146,7 @@
 
     private async Task OpenEditDialog(TaxProfile profile)
     {
+        isEditMode = true;
         editingProfile = profile;
         profileForm = new TaxProfileForm
         {
@@ -158,33 +163,29 @@
     {
         try
         {
-            if (editingProfile == null)
-            {
-                var newId = await TaxProfileClient.CreateAsync(
-                    profileForm.ClientId,
-                    profileForm.BusinessType);
-
-                if (newId > 0)
-                {
-                    Snackbar.Add("프로필이 생성되었습니다.", Severity.Success);
-                    CloseDialog();
-                    await LoadData();
-                }
-            }
-            else
+            if (isEditMode)
             {
                 await TaxProfileClient.UpdateAsync(
-                    editingProfile.Id,
+                    editingProfile!.Id,
                     profileForm.BusinessType,
                     null,
                     profileForm.NextFilingDueDate,
                     profileForm.TaxRiskLevel);
-
-                Snackbar.Add("프로필이 업데이트되었습니다.", Severity.Success);
+                Snackbar.Add("세무 프로필이 업데이트되었습니다.", Severity.Success);
+            }
+            else
+            {
+                var newId = await TaxProfileClient.CreateAsync(
+                    profileForm.ClientId,
+                    profileForm.BusinessType);
+                if (newId > 0)
+                {
+                    Snackbar.Add("세무 프로필이 추가되었습니다.", Severity.Success);
+                }
+            }
             CloseDialog();
             await LoadData();
         }
-        }
         catch (Exception ex)
         {
             Snackbar.Add($"저장 실패: {ex.Message}", Severity.Error);
@@ -195,7 +196,7 @@
     {
         var parameters = new DialogParameters();
         parameters.Add("Title", "삭제 확인");
-        parameters.Add("Message", "이 프로필을 삭제하시겠습니까?");
+        parameters.Add("Message", "이 세무 프로필을 삭제하시겠습니까?");
 
         var dialog = await DialogService.ShowAsync<ConfirmDialog>("", parameters);
         var result = await dialog.Result;
@@ -206,7 +207,7 @@
         try
         {
             await TaxProfileClient.DeleteAsync(id);
-            Snackbar.Add("프로필이 삭제되었습니다.", Severity.Success);
+            Snackbar.Add("세무 프로필이 삭제되었습니다.", Severity.Success);
             await LoadData();
         }
         catch (Exception ex)
@@ -218,11 +219,12 @@
     private void CloseDialog()
     {
         isDialogOpen = false;
+        isEditMode = false;
         editingProfile = null;
         profileForm = new();
     }
 
-    private Color GetRiskColor(string level) => level switch
+    private Color GetRiskColor(string riskLevel) => riskLevel switch
     {
         "high" => Color.Error,
         "normal" => Color.Warning,
@@ -239,20 +241,3 @@
         public string? SpecialNotes { get; set; }
     }
 }
-
-<style>
-.admin-container {
-    padding: 20px;
-}
-
-.admin-header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    margin-bottom: 20px;
-}
-
-.admin-grid {
-    font-size: 13px;
-}
-</style>

TaxBaik.Web/Pages/Portal/ExternalCallback.cshtml

@@ -0,0 +1,9 @@
+@page "/portal/external-callback"
+@model TaxBaik.Web.Pages.Portal.ExternalCallbackModel
+@{
+    ViewData["Title"] = "포털 인증 처리";
+}
+
+<section class="container py-5">
+    <div class="alert alert-info">인증을 처리하는 중입니다...</div>
+</section>

TaxBaik.Web/Pages/Portal/ExternalCallback.cshtml.cs

@@ -0,0 +1,97 @@
+using System.Security.Claims;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using TaxBaik.Application.Services;
+using TaxBaik.Web.Services;
+
+namespace TaxBaik.Web.Pages.Portal;
+
+public class ExternalCallbackModel : PageModel
+{
+    private readonly PortalUserService _portalUserService;
+    private readonly ClientService _clientService;
+
+    public ExternalCallbackModel(PortalUserService portalUserService, ClientService clientService)
+    {
+        _portalUserService = portalUserService;
+        _clientService = clientService;
+    }
+
+    public async Task<IActionResult> OnGetAsync(string provider)
+    {
+        var external = await HttpContext.AuthenticateAsync(PortalOAuthDefaults.ExternalScheme);
+        if (external?.Principal is null)
+            return RedirectToPage("/Portal/Login");
+
+        var email = external.Principal.FindFirstValue(ClaimTypes.Email);
+        var name = external.Principal.FindFirstValue(ClaimTypes.Name) ?? "고객";
+        var providerId = external.Principal.FindFirstValue(ClaimTypes.NameIdentifier) ?? "";
+
+        if (string.IsNullOrWhiteSpace(providerId))
+            return RedirectToPage("/Portal/Login");
+
+        var existing = await _portalUserService.GetByProviderAsync(provider, providerId);
+        if (existing is null && !string.IsNullOrWhiteSpace(email))
+        {
+            existing = await _portalUserService.GetByEmailAsync(email);
+            if (existing is null)
+            {
+                int? clientId = null;
+                var linkedClient = await _clientService.GetByEmailAsync(email);
+                if (linkedClient is null && !string.IsNullOrWhiteSpace(external.Principal.FindFirstValue("phone")))
+                    linkedClient = await _clientService.GetByPhoneAsync(external.Principal.FindFirstValue("phone")!);
+                if (linkedClient is not null)
+                    clientId = linkedClient.Id;
+
+                await _portalUserService.RegisterOAuthAsync(
+                    name,
+                    email,
+                    external.Principal.FindFirstValue("phone") ?? "",
+                    provider,
+                    providerId,
+                    clientId);
+                existing = await _portalUserService.GetByEmailAsync(email);
+            }
+            else if (!string.Equals(existing.Provider, provider, StringComparison.OrdinalIgnoreCase) ||
+                     !string.Equals(existing.ProviderId, providerId, StringComparison.OrdinalIgnoreCase))
+            {
+                await _portalUserService.LinkOAuthAsync(existing, provider, providerId, name, email);
+            }
+        }
+
+        if (existing is not null && !existing.ClientId.HasValue && !string.IsNullOrWhiteSpace(email))
+        {
+            var linkedClient = await _clientService.GetByEmailAsync(email);
+            if (linkedClient is null && !string.IsNullOrWhiteSpace(external.Principal.FindFirstValue("phone")))
+                linkedClient = await _clientService.GetByPhoneAsync(external.Principal.FindFirstValue("phone")!);
+            if (linkedClient is not null)
+            {
+                await _portalUserService.AttachClientAsync(existing, linkedClient.Id);
+                existing.ClientId = linkedClient.Id;
+            }
+        }
+
+        if (existing is null)
+            return RedirectToPage("/Portal/Login");
+
+        var claims = new List<Claim>
+        {
+            new(ClaimTypes.NameIdentifier, existing.Id.ToString()),
+            new(ClaimTypes.Name, existing.Name),
+            new(ClaimTypes.Email, existing.Email),
+            new("portal_user_id", existing.Id.ToString())
+        };
+
+        if (existing.ClientId.HasValue)
+            claims.Add(new("client_id", existing.ClientId.Value.ToString()));
+
+        await HttpContext.SignInAsync(
+            PortalAuthDefaults.Scheme,
+            new ClaimsPrincipal(new ClaimsIdentity(claims, PortalAuthDefaults.Scheme)),
+            new AuthenticationProperties { IsPersistent = true });
+
+        await HttpContext.SignOutAsync(PortalOAuthDefaults.ExternalScheme);
+        return RedirectToPage("/Portal/Index");
+    }
+}

TaxBaik.Web/Pages/Portal/Index.cshtml

@@ -0,0 +1,34 @@
+@page "/portal"
+@model TaxBaik.Web.Pages.Portal.IndexModel
+@{
+    ViewData["Title"] = "고객 포털";
+    ViewData["Description"] = "고객이 신고 일정, 상담 요약, 중요 알림을 확인하는 전용 포털입니다.";
+    ViewData["CanonicalUrl"] = $"{Request.Scheme}://{Request.Host}/taxbaik/portal";
+}
+
+<section class="container py-5">
+    <div class="row g-4 align-items-start">
+        <div class="col-lg-7">
+            <p class="text-uppercase text-muted small mb-2">Portal</p>
+            <h1 class="display-6 fw-bold mb-3">고객 포털</h1>
+            <p class="lead text-muted mb-4">
+                신고 일정, 상담 요약, 승인된 알림을 확인할 수 있는 전용 공간입니다.
+            </p>
+            <div class="d-flex gap-2 flex-wrap">
+                <a class="btn btn-dark" href="/taxbaik/portal/login">로그인</a>
+                <a class="btn btn-outline-dark" href="/taxbaik/portal/register">회원가입</a>
+            </div>
+        </div>
+        <div class="col-lg-5">
+            <div class="p-4 bg-light border rounded-3">
+                <h2 class="h5 fw-bold mb-3">제공 예정 기능</h2>
+                <ul class="mb-0 text-muted">
+                    <li>본인 신고 일정 확인</li>
+                    <li>상담 요약 열람</li>
+                    <li>중요 알림 수신</li>
+                    <li>관리자 승인 범위 내 정보 제공</li>
+                </ul>
+            </div>
+        </div>
+    </div>
+</section>

TaxBaik.Web/Pages/Portal/Index.cshtml.cs

@@ -0,0 +1,13 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using TaxBaik.Web.Services;
+
+namespace TaxBaik.Web.Pages.Portal;
+
+[Authorize(AuthenticationSchemes = PortalAuthDefaults.Scheme)]
+public class IndexModel : PageModel
+{
+    public void OnGet()
+    {
+    }
+}

TaxBaik.Web/Pages/Portal/Login.cshtml

@@ -0,0 +1,40 @@
+@page "/portal/login"
+@model TaxBaik.Web.Pages.Portal.LoginModel
+@{
+    ViewData["Title"] = "고객 포털 로그인";
+    ViewData["Description"] = "고객 포털 로그인 페이지입니다.";
+    ViewData["CanonicalUrl"] = $"{Request.Scheme}://{Request.Host}/taxbaik/portal/login";
+}
+
+<section class="container py-5" style="max-width: 560px;">
+    <h1 class="h3 fw-bold mb-4">고객 포털 로그인</h1>
+    <div class="alert alert-secondary">
+        포털 인증은 다음 단계에서 이메일/비밀번호와 소셜 로그인으로 연결됩니다.
+    </div>
+    @if (!string.IsNullOrWhiteSpace(Model.ErrorMessage))
+    {
+        <div class="alert alert-danger">@Model.ErrorMessage</div>
+    }
+    <form method="post" class="vstack gap-3">
+        <div>
+            <label class="form-label">이메일</label>
+            <input class="form-control" asp-for="Email" />
+        </div>
+        <div>
+            <label class="form-label">비밀번호</label>
+            <input class="form-control" asp-for="Password" type="password" />
+        </div>
+        <button class="btn btn-dark" type="submit">로그인</button>
+    </form>
+    <div class="d-grid gap-2 mt-4">
+        <form method="post" asp-page-handler="Google">
+            <button class="btn btn-outline-dark w-100" type="submit">Google로 로그인</button>
+        </form>
+        <form method="post" asp-page-handler="Naver">
+            <button class="btn btn-outline-success w-100" type="submit">Naver로 로그인</button>
+        </form>
+        <form method="post" asp-page-handler="Kakao">
+            <button class="btn btn-outline-warning w-100" type="submit">Kakao로 로그인</button>
+        </form>
+    </div>
+</section>

TaxBaik.Web/Pages/Portal/Login.cshtml.cs

@@ -0,0 +1,56 @@
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using TaxBaik.Web.Services;
+
+namespace TaxBaik.Web.Pages.Portal;
+
+public class LoginModel : PageModel
+{
+    private readonly PortalAuthService _portalAuthService;
+
+    [BindProperty]
+    public string Email { get; set; } = "";
+
+    [BindProperty]
+    public string Password { get; set; } = "";
+
+    [BindProperty]
+    public string? ErrorMessage { get; set; }
+
+    public LoginModel(PortalAuthService portalAuthService)
+    {
+        _portalAuthService = portalAuthService;
+    }
+
+    public void OnGet()
+    {
+    }
+
+    public async Task<IActionResult> OnPostAsync()
+    {
+        if (string.IsNullOrWhiteSpace(Email) || string.IsNullOrWhiteSpace(Password))
+        {
+            ErrorMessage = "이메일과 비밀번호를 입력하세요.";
+            return Page();
+        }
+
+        var signedIn = await _portalAuthService.SignInAsync(Email, Password);
+        if (!signedIn)
+        {
+            ErrorMessage = "로그인 정보를 확인할 수 없습니다.";
+            return Page();
+        }
+
+        return RedirectToPage("/Portal/Index");
+    }
+
+    public IActionResult OnPostGoogle() => Challenge(BuildProps("google"), PortalOAuthDefaults.GoogleScheme);
+
+    public IActionResult OnPostNaver() => Challenge(BuildProps("naver"), PortalOAuthDefaults.NaverScheme);
+
+    public IActionResult OnPostKakao() => Challenge(BuildProps("kakao"), PortalOAuthDefaults.KakaoScheme);
+
+    private static AuthenticationProperties BuildProps(string provider) =>
+        new() { RedirectUri = $"/taxbaik/portal/external-callback?provider={provider}" };
+}

TaxBaik.Web/Pages/Portal/Register.cshtml

@@ -0,0 +1,35 @@
+@page "/portal/register"
+@model TaxBaik.Web.Pages.Portal.RegisterModel
+@{
+    ViewData["Title"] = "고객 포털 회원가입";
+    ViewData["Description"] = "고객 포털 회원가입 페이지입니다.";
+    ViewData["CanonicalUrl"] = $"{Request.Scheme}://{Request.Host}/taxbaik/portal/register";
+}
+
+<section class="container py-5" style="max-width: 640px;">
+    <h1 class="h3 fw-bold mb-4">고객 포털 회원가입</h1>
+    <div class="alert alert-secondary">
+        가입 흐름은 다음 단계에서 이메일/전화번호 검증과 소셜 로그인으로 확장합니다.
+    </div>
+    <form method="post" class="row g-3">
+        <div class="col-md-6">
+            <label class="form-label">이름</label>
+            <input class="form-control" asp-for="Name" />
+        </div>
+        <div class="col-md-6">
+            <label class="form-label">연락처</label>
+            <input class="form-control" asp-for="Phone" />
+        </div>
+        <div class="col-12">
+            <label class="form-label">이메일</label>
+            <input class="form-control" asp-for="Email" />
+        </div>
+        <div class="col-12">
+            <label class="form-label">비밀번호</label>
+            <input class="form-control" asp-for="Password" type="password" />
+        </div>
+        <div class="col-12">
+            <button class="btn btn-dark" type="submit">가입하기</button>
+        </div>
+    </form>
+</section>

TaxBaik.Web/Pages/Portal/Register.cshtml.cs

@@ -0,0 +1,75 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using TaxBaik.Application.Services;
+using TaxBaik.Web.Services;
+
+namespace TaxBaik.Web.Pages.Portal;
+
+public class RegisterModel : PageModel
+{
+    private readonly PortalUserService _portalUserService;
+    private readonly ClientService _clientService;
+
+    [BindProperty]
+    public string Name { get; set; } = "";
+
+    [BindProperty]
+    public string Phone { get; set; } = "";
+
+    [BindProperty]
+    public string Email { get; set; } = "";
+
+    [BindProperty]
+    public string Password { get; set; } = "";
+
+    [BindProperty]
+    public string? ErrorMessage { get; set; }
+
+    public RegisterModel(PortalUserService portalUserService, ClientService clientService)
+    {
+        _portalUserService = portalUserService;
+        _clientService = clientService;
+    }
+
+    public void OnGet()
+    {
+    }
+
+    public async Task<IActionResult> OnPostAsync()
+    {
+        if (string.IsNullOrWhiteSpace(Name) || string.IsNullOrWhiteSpace(Email))
+        {
+            ErrorMessage = "이름과 이메일을 입력하세요.";
+            return Page();
+        }
+
+        if (string.IsNullOrWhiteSpace(Password) || Password.Length < 8)
+        {
+            ErrorMessage = "비밀번호는 8자 이상이어야 합니다.";
+            return Page();
+        }
+
+        var existing = await _portalUserService.GetByEmailAsync(Email);
+        if (existing is not null)
+        {
+            ErrorMessage = "이미 등록된 이메일입니다.";
+            return Page();
+        }
+
+        int? clientId = null;
+        var linkedClient = await _clientService.GetByEmailAsync(Email);
+        if (linkedClient is null && !string.IsNullOrWhiteSpace(Phone))
+            linkedClient = await _clientService.GetByPhoneAsync(Phone);
+        if (linkedClient is not null)
+            clientId = linkedClient.Id;
+
+        await _portalUserService.RegisterLocalAsync(
+            Name,
+            Email,
+            Phone,
+            PortalAuthService.HashPassword(Password),
+            clientId: clientId);
+
+        return RedirectToPage("/Portal/Login");
+    }
+}

TaxBaik.Web/Pages/_Layout.cshtml

@@ -54,6 +54,7 @@
                 <p>© 2026 백원숙 세무회계. All rights reserved.</p>
                 <a href="/taxbaik/privacy" class="text-decoration-none text-muted me-2">개인정보처리방침</a>
                 <a href="/taxbaik/terms" class="text-decoration-none text-muted">이용약관</a>
+                <a href="/taxbaik/portal" class="text-decoration-none text-muted ms-2">고객 포털</a>
                 @if (Context.RequestServices.GetService(typeof(VersionInfo)) is VersionInfo version)
                 {
                     <div class="mt-2 text-muted" style="font-size: 0.75rem; opacity: 0.6;">

TaxBaik.Web/Program.cs

@@ -3,6 +3,8 @@ using System.Text;
 using System.Text.Encodings.Web;
 using System.Text.Unicode;
 using Microsoft.AspNetCore.Authentication.JwtBearer;
+using Microsoft.AspNetCore.Authentication.Cookies;
+using Microsoft.AspNetCore.Authentication.OAuth;
 using Microsoft.AspNetCore.Components.Authorization;
 using Microsoft.AspNetCore.HttpOverrides;
 using Microsoft.AspNetCore.ResponseCompression;
@@ -80,6 +82,85 @@ builder.Services.AddAuthentication(opts =>
         ValidateLifetime = true,
         ClockSkew = TimeSpan.FromMinutes(1)
     };
+})
+.AddCookie(PortalAuthDefaults.Scheme, opts =>
+{
+    opts.Cookie.Name = PortalAuthDefaults.CookieName;
+    opts.Cookie.HttpOnly = true;
+    opts.Cookie.SameSite = SameSiteMode.Lax;
+    opts.Cookie.SecurePolicy = isProduction ? CookieSecurePolicy.Always : CookieSecurePolicy.SameAsRequest;
+    opts.LoginPath = "/taxbaik/portal/login";
+    opts.AccessDeniedPath = "/taxbaik/portal/login";
+    opts.SlidingExpiration = true;
+    opts.ExpireTimeSpan = TimeSpan.FromDays(7);
+})
+.AddCookie(PortalOAuthDefaults.ExternalScheme, opts =>
+{
+    opts.Cookie.Name = "TaxBaik.Portal.External";
+    opts.Cookie.HttpOnly = true;
+    opts.Cookie.SameSite = SameSiteMode.Lax;
+    opts.Cookie.SecurePolicy = isProduction ? CookieSecurePolicy.Always : CookieSecurePolicy.SameAsRequest;
+})
+.AddGoogle(PortalOAuthDefaults.GoogleScheme, opts =>
+{
+    opts.SignInScheme = PortalOAuthDefaults.ExternalScheme;
+    opts.ClientId = builder.Configuration["Authentication:Google:ClientId"] ?? "";
+    opts.ClientSecret = builder.Configuration["Authentication:Google:ClientSecret"] ?? "";
+    opts.CallbackPath = "/taxbaik/portal/signin-google";
+})
+.AddOAuth(PortalOAuthDefaults.NaverScheme, opts =>
+{
+    opts.SignInScheme = PortalOAuthDefaults.ExternalScheme;
+    opts.ClientId = builder.Configuration["Authentication:Naver:ClientId"] ?? "";
+    opts.ClientSecret = builder.Configuration["Authentication:Naver:ClientSecret"] ?? "";
+    opts.CallbackPath = "/taxbaik/portal/signin-naver";
+    opts.AuthorizationEndpoint = "https://nid.naver.com/oauth2.0/authorize";
+    opts.TokenEndpoint = "https://nid.naver.com/oauth2.0/token";
+    opts.UserInformationEndpoint = "https://openapi.naver.com/v1/nid/me";
+    opts.SaveTokens = true;
+    opts.Events = new OAuthEvents
+    {
+        OnCreatingTicket = async context =>
+        {
+            var request = new HttpRequestMessage(HttpMethod.Get, opts.UserInformationEndpoint);
+            request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", context.AccessToken);
+            var response = await context.Backchannel.SendAsync(request, context.HttpContext.RequestAborted);
+            response.EnsureSuccessStatusCode();
+            using var payload = System.Text.Json.JsonDocument.Parse(await response.Content.ReadAsStringAsync(context.HttpContext.RequestAborted));
+            var responseRoot = payload.RootElement.GetProperty("response");
+            context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.NameIdentifier, responseRoot.GetProperty("id").GetString() ?? ""));
+            context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.Name, responseRoot.GetProperty("name").GetString() ?? ""));
+            context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.Email, responseRoot.GetProperty("email").GetString() ?? ""));
+        }
+    };
+})
+.AddOAuth(PortalOAuthDefaults.KakaoScheme, opts =>
+{
+    opts.SignInScheme = PortalOAuthDefaults.ExternalScheme;
+    opts.ClientId = builder.Configuration["Authentication:Kakao:ClientId"] ?? "";
+    opts.ClientSecret = builder.Configuration["Authentication:Kakao:ClientSecret"] ?? "";
+    opts.CallbackPath = "/taxbaik/portal/signin-kakao";
+    opts.AuthorizationEndpoint = "https://kauth.kakao.com/oauth/authorize";
+    opts.TokenEndpoint = "https://kauth.kakao.com/oauth/token";
+    opts.UserInformationEndpoint = "https://kapi.kakao.com/v2/user/me";
+    opts.SaveTokens = true;
+    opts.Events = new OAuthEvents
+    {
+        OnCreatingTicket = async context =>
+        {
+            var request = new HttpRequestMessage(HttpMethod.Get, opts.UserInformationEndpoint);
+            request.Headers.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", context.AccessToken);
+            var response = await context.Backchannel.SendAsync(request, context.HttpContext.RequestAborted);
+            response.EnsureSuccessStatusCode();
+            using var payload = System.Text.Json.JsonDocument.Parse(await response.Content.ReadAsStringAsync(context.HttpContext.RequestAborted));
+            var kakaoAccount = payload.RootElement.GetProperty("kakao_account");
+            var profile = kakaoAccount.GetProperty("profile");
+            context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.NameIdentifier, payload.RootElement.GetProperty("id").GetInt64().ToString()));
+            context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.Name, profile.GetProperty("nickname").GetString() ?? ""));
+            if (kakaoAccount.TryGetProperty("email", out var emailProp))
+                context.Identity?.AddClaim(new System.Security.Claims.Claim(System.Security.Claims.ClaimTypes.Email, emailProp.GetString() ?? ""));
+        }
+    };
 });
 
 // Blazor 인증
@@ -178,6 +259,11 @@ builder.Services.AddResponseCompression(opts => {
     opts.Providers.Add<GzipCompressionProvider>();
 });
 builder.Services.AddScoped<IInquiryNotificationService, TelegramInquiryNotificationService>();
+builder.Services.AddHostedService<TelegramReportBackgroundService>();
+builder.Services.AddHttpContextAccessor();
+builder.Services.AddScoped<PortalAuthService>();
+
+builder.Services.Configure<PortalAuthOptions>(builder.Configuration.GetSection("Authentication"));
 
 // 한글 포함 다국어 문자를 유니코드 엔티티로 변환하지 않도록 설정
 builder.Services.AddSingleton(HtmlEncoder.Create(UnicodeRanges.All));

TaxBaik.Web/Services/PortalAuthDefaults.cs

@@ -0,0 +1,7 @@
+namespace TaxBaik.Web.Services;
+
+public static class PortalAuthDefaults
+{
+    public const string Scheme = "PortalCookie";
+    public const string CookieName = "TaxBaik.Portal.Auth";
+}

TaxBaik.Web/Services/PortalAuthOptions.cs

@@ -0,0 +1,14 @@
+namespace TaxBaik.Web.Services;
+
+public sealed class PortalAuthOptions
+{
+    public ExternalProviderOptions Google { get; set; } = new();
+    public ExternalProviderOptions Naver { get; set; } = new();
+    public ExternalProviderOptions Kakao { get; set; } = new();
+
+    public sealed class ExternalProviderOptions
+    {
+        public string ClientId { get; set; } = "";
+        public string ClientSecret { get; set; } = "";
+    }
+}

TaxBaik.Web/Services/PortalAuthService.cs

@@ -0,0 +1,70 @@
+namespace TaxBaik.Web.Services;
+
+using System.Security.Claims;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Authentication.Cookies;
+using Microsoft.AspNetCore.Identity;
+using TaxBaik.Application.Services;
+using TaxBaik.Domain.Entities;
+
+public class PortalAuthService(
+    IHttpContextAccessor httpContextAccessor,
+    PortalUserService portalUserService)
+{
+    private static readonly PasswordHasher<PortalUser> Hasher = new();
+
+    public async Task<bool> SignInAsync(string email, string password, CancellationToken ct = default)
+    {
+        var httpContext = httpContextAccessor.HttpContext
+            ?? throw new InvalidOperationException("HTTP context is unavailable.");
+
+        var user = await portalUserService.GetByEmailAsync(email, ct);
+        if (user is null)
+            return false;
+
+        if (string.IsNullOrWhiteSpace(user.PasswordHash))
+            return false;
+
+        var verify = Hasher.VerifyHashedPassword(user, user.PasswordHash, password);
+        if (verify == PasswordVerificationResult.Failed)
+            return false;
+
+        var claims = new List<Claim>
+        {
+            new(ClaimTypes.NameIdentifier, user.Id.ToString()),
+            new(ClaimTypes.Name, user.Name),
+            new(ClaimTypes.Email, user.Email),
+            new("portal_user_id", user.Id.ToString())
+        };
+
+        if (user.ClientId.HasValue)
+            claims.Add(new("client_id", user.ClientId.Value.ToString()));
+
+        var identity = new ClaimsIdentity(claims, PortalAuthDefaults.Scheme);
+        var principal = new ClaimsPrincipal(identity);
+
+        await httpContext.SignInAsync(
+            PortalAuthDefaults.Scheme,
+            principal,
+            new AuthenticationProperties
+            {
+                IsPersistent = true
+            });
+
+        return true;
+    }
+
+    public static string HashPassword(string password)
+    {
+        var tempUser = new PortalUser();
+        return Hasher.HashPassword(tempUser, password);
+    }
+
+    public async Task SignOutAsync()
+    {
+        var httpContext = httpContextAccessor.HttpContext
+            ?? throw new InvalidOperationException("HTTP context is unavailable.");
+
+        await httpContext.SignOutAsync(PortalAuthDefaults.Scheme);
+    }
+}

TaxBaik.Web/Services/PortalOAuthDefaults.cs

@@ -0,0 +1,9 @@
+namespace TaxBaik.Web.Services;
+
+public static class PortalOAuthDefaults
+{
+    public const string ExternalScheme = "PortalExternal";
+    public const string GoogleScheme = "PortalGoogle";
+    public const string NaverScheme = "PortalNaver";
+    public const string KakaoScheme = "PortalKakao";
+}

TaxBaik.Web/Services/TelegramNotificationService.cs

@@ -33,8 +33,8 @@ public class TelegramNotificationService : ITelegramNotificationService
         _httpClient = httpClient;
         _logger = logger;
         _botToken = config["Telegram:BotToken"] ?? "";
-        _defaultChatId = config["Telegram:ChatId"] ?? "";
-        _inquiryChatId = config["Telegram:InquiryChatId"] ?? "-5434691215";
+        _defaultChatId = config["Telegram:ChatId"] ?? "-5434691215";
+        _inquiryChatId = config["Telegram:InquiryChatId"] ?? _defaultChatId;
         _systemChatId = config["Telegram:SystemChatId"] ?? "-5585148480";
     }
 
@@ -88,7 +88,7 @@ public class TelegramNotificationService : ITelegramNotificationService
     public async Task SendErrorAsync(string title, string details, CancellationToken ct = default)
     {
         var message = $"<b>❌ {title}</b>\n\n{details}\n\n<i>{DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC</i>";
-        await SendMessageAsync(message, ct);
+        await SendToChat(_systemChatId, message, ct);
     }
 
     public async Task SendInfoAsync(string title, string message, CancellationToken ct = default)

TaxBaik.Web/Services/TelegramReportBackgroundService.cs

@@ -0,0 +1,82 @@
+namespace TaxBaik.Web.Services;
+
+using Microsoft.Extensions.Hosting;
+using TaxBaik.Application.Services;
+
+public class TelegramReportBackgroundService(
+    IServiceScopeFactory scopeFactory,
+    ILogger<TelegramReportBackgroundService> logger) : BackgroundService
+{
+    private static readonly TimeZoneInfo KoreaTimeZone = GetKoreaTimeZone();
+    private DateOnly? _lastDailyReportDate;
+    private DateOnly? _lastWeeklyReportWeekStart;
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        using var timer = new PeriodicTimer(TimeSpan.FromMinutes(30));
+
+        while (await timer.WaitForNextTickAsync(stoppingToken))
+        {
+            try
+            {
+                var now = TimeZoneInfo.ConvertTime(DateTimeOffset.UtcNow, KoreaTimeZone);
+                await TrySendReportsAsync(now, stoppingToken);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError(ex, "Telegram report background loop failed");
+            }
+        }
+    }
+
+    private async Task TrySendReportsAsync(DateTimeOffset nowKst, CancellationToken ct)
+    {
+        if (nowKst.Hour is 9 or 10)
+            await SendDailyIfNeededAsync(DateOnly.FromDateTime(nowKst.DateTime), ct);
+
+        if (nowKst.DayOfWeek == DayOfWeek.Monday && nowKst.Hour is 9 or 10)
+            await SendWeeklyIfNeededAsync(DateOnly.FromDateTime(nowKst.DateTime).AddDays(-7), ct);
+    }
+
+    private async Task SendDailyIfNeededAsync(DateOnly date, CancellationToken ct)
+    {
+        if (_lastDailyReportDate == date)
+            return;
+
+        using var scope = scopeFactory.CreateScope();
+        var reportService = scope.ServiceProvider.GetRequiredService<TelegramReportService>();
+        var telegram = scope.ServiceProvider.GetRequiredService<ITelegramNotificationService>();
+
+        var report = await reportService.BuildDailyReportAsync(date, ct);
+        await telegram.SendSystemNotificationAsync(TelegramReportService.FormatDailyMessage(report), ct);
+        _lastDailyReportDate = date;
+        logger.LogInformation("Daily telegram report sent for {Date}", date);
+    }
+
+    private async Task SendWeeklyIfNeededAsync(DateOnly weekStart, CancellationToken ct)
+    {
+        if (_lastWeeklyReportWeekStart == weekStart)
+            return;
+
+        using var scope = scopeFactory.CreateScope();
+        var reportService = scope.ServiceProvider.GetRequiredService<TelegramReportService>();
+        var telegram = scope.ServiceProvider.GetRequiredService<ITelegramNotificationService>();
+
+        var report = await reportService.BuildWeeklyReportAsync(weekStart, ct);
+        await telegram.SendSystemNotificationAsync(TelegramReportService.FormatWeeklyMessage(report), ct);
+        _lastWeeklyReportWeekStart = weekStart;
+        logger.LogInformation("Weekly telegram report sent for {WeekStart}", weekStart);
+    }
+
+    private static TimeZoneInfo GetKoreaTimeZone()
+    {
+        try
+        {
+            return TimeZoneInfo.FindSystemTimeZoneById("Korea Standard Time");
+        }
+        catch (TimeZoneNotFoundException)
+        {
+            return TimeZoneInfo.FindSystemTimeZoneById("Asia/Seoul");
+        }
+    }
+}

TaxBaik.Web/TaxBaik.Web.csproj

@@ -14,6 +14,7 @@
   <ItemGroup>
     <PackageReference Include="MudBlazor" Version="6.10.0" />
     <PackageReference Include="BCrypt.Net-Next" Version="4.0.3" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.Google" Version="10.0.9" />
     <PackageReference Include="System.IdentityModel.Tokens.Jwt" Version="8.19.1" />
     <PackageReference Include="Microsoft.IdentityModel.Tokens" Version="8.19.1" />
     <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="10.0.9" />

TaxBaik.Web/appsettings.json

@@ -19,13 +19,27 @@
   },
   "Telegram": {
     "BotToken": "8679990909:AAGLLRUIAuEbYAZVGOYDu-UuTu4ihroEiX0",
-    "ChatId": "-5585148480",
+    "ChatId": "-5434691215",
     "InquiryChatId": "-5434691215",
     "SystemChatId": "-5585148480"
   },
   "Admin": {
     "PasswordResetToken": "dev-reset-token-12345"
   },
+  "Authentication": {
+    "Google": {
+      "ClientId": "",
+      "ClientSecret": ""
+    },
+    "Naver": {
+      "ClientId": "",
+      "ClientSecret": ""
+    },
+    "Kakao": {
+      "ClientId": "",
+      "ClientSecret": ""
+    }
+  },
   "SiteSettings": {
     "PhoneNumber": "010-4122-8268",
     "EmailAddress": "taxbaik5668@gmail.com",

db/migrations/V016__CreatePortalUsers.sql

@@ -0,0 +1,14 @@
+CREATE TABLE IF NOT EXISTS portal_users (
+    id SERIAL PRIMARY KEY,
+    client_id INT NULL REFERENCES clients(id) ON DELETE SET NULL,
+    email VARCHAR(255) NOT NULL UNIQUE,
+    name VARCHAR(100) NOT NULL,
+    phone VARCHAR(50),
+    provider VARCHAR(30) NOT NULL DEFAULT 'local',
+    provider_id VARCHAR(200),
+    password_hash TEXT,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_portal_users_provider
+    ON portal_users(provider, provider_id);