feat: implement multi-tenant company management system

Architecture: - Create companies table with company_code as unique identifier - Add company_id foreign key to admin_users for multi-tenant support - Implement backward compatibility with DEFAULT company for existing users Core Components: - Company entity with full CRUD operations - ICompanyRepository interface following Repository pattern - CompanyRepository with Dapper implementation - CompanyService with business logic and validation - CompanyController with REST API endpoints Admin UI: - CompanyForm reusable component (Create/Edit pattern) - CompanyList.razor with pagination and company overview - CompanyCreate.razor for registering new companies - CompanyEdit.razor for managing existing companies with delete - All pages follow admin-page-hero pattern for consistency SOLID Principles: - Single Responsibility: Each component has one reason to change - Open/Closed: Extensible without modifying existing code - Interface Segregation: Clean repository and service contracts - Dependency Inversion: All layers depend on abstractions Database Migration (V014): - Creates companies table with active/inactive status - Assigns existing admin users to DEFAULT company - Provides foundation for role-based access control Future Enhancement: - Admin users can belong to specific companies - Data filtering based on company_id (multi-tenant isolation) - Company-based permission model
2026-06-28 16:52:22 +09:00
parent c65742a0c7
commit 7dd51a1169
12 changed files with 756 additions and 0 deletions
@@ -0,0 +1,51 @@
+@page "/admin/companies/create"
+@attribute [Authorize]
+@using TaxBaik.Web.Components.Admin.Forms
+@inject IApiClient ApiClient
+@inject NavigationManager Navigation
+@inject ISnackbar Snackbar
+
+<PageTitle>고객사 등록</PageTitle>
+
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">Settings</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">새 고객사 등록</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">새로운 고객사를 추가합니다.</MudText>
+    </div>
+    <MudButton Variant="Variant.Outlined" StartIcon="@Icons.Material.Filled.Close" @onclick="GoBack">취소</MudButton>
+</section>
+
+<MudPaper Class="pa-4 mt-4" Elevation="1">
+    <CompanyForm ButtonText="등록" OnSubmit="HandleCreate" OnCancel="GoBack" />
+</MudPaper>
+
+@code {
+    private void GoBack()
+    {
+        Navigation.NavigateTo("/taxbaik/admin/companies");
+    }
+
+    private async Task HandleCreate(CompanyForm.CompanyFormModel model)
+    {
+        try
+        {
+            await ApiClient.PostAsync<object>("company", new
+            {
+                companyCode = model.CompanyCode,
+                companyName = model.CompanyName,
+                contactPerson = model.ContactPerson,
+                phone = model.Phone,
+                email = model.Email,
+                memo = model.Memo
+            });
+
+            Snackbar.Add("고객사가 등록되었습니다.", Severity.Success);
+            Navigation.NavigateTo("/taxbaik/admin/companies");
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"등록 실패: {ex.Message}", Severity.Error);
+        }
+    }
+}
@@ -0,0 +1,128 @@
+@page "/admin/companies/{id:int}/edit"
+@attribute [Authorize]
+@using TaxBaik.Web.Components.Admin.Forms
+@inject IApiClient ApiClient
+@inject NavigationManager Navigation
+@inject ISnackbar Snackbar
+@inject IDialogService DialogService
+
+<PageTitle>고객사 수정</PageTitle>
+
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">Settings</MudText>
+        <MudText Typo="Typo.h4" Class="admin-page-title">고객사 수정</MudText>
+        <MudText Typo="Typo.body2" Class="admin-page-subtitle">고객사 정보를 수정합니다.</MudText>
+    </div>
+    <MudButton Variant="Variant.Outlined" StartIcon="@Icons.Material.Filled.Close" @onclick="GoBack">취소</MudButton>
+</section>
+
+@if (isLoading)
+{
+    <MudProgressLinear Color="Color.Primary" Indeterminate="true" Class="mt-4" />
+}
+else if (formModel == null)
+{
+    <MudAlert Severity="Severity.Error" Class="mt-4">고객사를 찾을 수 없습니다.</MudAlert>
+}
+else
+{
+    <MudPaper Class="pa-4 mt-4" Elevation="1">
+        <CompanyForm ButtonText="수정" InitialData="formModel" OnSubmit="HandleUpdate" OnCancel="GoBack" />
+
+        <MudDivider Class="my-4" />
+
+        <MudButton Variant="Variant.Outlined" Color="Color.Error" @onclick="DeleteCompany" Class="mt-2">
+            고객사 삭제
+        </MudButton>
+    </MudPaper>
+}
+
+@code {
+    [Parameter]
+    public int Id { get; set; }
+
+    private CompanyForm.CompanyFormModel? formModel;
+    private bool isLoading = true;
+
+    protected override async Task OnInitializedAsync()
+    {
+        try
+        {
+            var company = await ApiClient.GetAsync<dynamic>($"company/{Id}");
+            IDictionary<string, object>? dict = company as IDictionary<string, object>;
+            if (dict != null)
+            {
+                formModel = new CompanyForm.CompanyFormModel
+                {
+                    CompanyCode = (string)dict["companyCode"],
+                    CompanyName = (string)dict["companyName"],
+                    ContactPerson = (string?)dict["contactPerson"],
+                    Phone = (string?)dict["phone"],
+                    Email = (string?)dict["email"],
+                    Memo = (string?)dict["memo"],
+                    IsActive = (bool)(dynamic)dict["isActive"]
+                };
+            }
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"고객사 로드 실패: {ex.Message}", Severity.Error);
+        }
+        finally
+        {
+            isLoading = false;
+        }
+    }
+
+    private void GoBack()
+    {
+        Navigation.NavigateTo("/taxbaik/admin/companies");
+    }
+
+    private async Task HandleUpdate(CompanyForm.CompanyFormModel model)
+    {
+        try
+        {
+            await ApiClient.PutAsync<object>($"company/{Id}", new
+            {
+                companyCode = model.CompanyCode,
+                companyName = model.CompanyName,
+                contactPerson = model.ContactPerson,
+                phone = model.Phone,
+                email = model.Email,
+                memo = model.Memo,
+                isActive = model.IsActive
+            });
+
+            Snackbar.Add("고객사가 수정되었습니다.", Severity.Success);
+            Navigation.NavigateTo("/taxbaik/admin/companies");
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"수정 실패: {ex.Message}", Severity.Error);
+        }
+    }
+
+    private async Task DeleteCompany()
+    {
+        var result = await DialogService.ShowMessageBox(
+            "고객사 삭제",
+            "정말 삭제하시겠습니까? 이 작업은 취소할 수 없습니다.",
+            "삭제", "취소");
+
+        if (result != true)
+            return;
+
+        try
+        {
+            await ApiClient.DeleteAsync($"company/{Id}");
+            Snackbar.Add("고객사가 삭제되었습니다.", Severity.Success);
+            Navigation.NavigateTo("/taxbaik/admin/companies");
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"삭제 실패: {ex.Message}", Severity.Error);
+        }
+    }
+}
@@ -0,0 +1,134 @@
+@page "/admin/companies"
+@attribute [Authorize]
+@inject IApiClient ApiClient
+@inject ISnackbar Snackbar
+
+<PageTitle>고객사 관리</PageTitle>
+
+<section class="admin-page-hero">
+    <div>
+        <MudText Typo="Typo.caption" Class="admin-eyebrow">Settings</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"
+        Href="/taxbaik/admin/companies/create">새 고객사 등록</MudButton>
+</section>
+
+<MudPaper Class="admin-surface mb-4 mt-4" Elevation="0">
+    <MudStack Row="true" AlignItems="AlignItems.Center" Justify="Justify.SpaceBetween">
+        <MudText Typo="Typo.subtitle1">@($"전체 고객사 {totalCompanies}개")</MudText>
+        <MudText Typo="Typo.body2">페이지 @currentPage / @totalPages</MudText>
+    </MudStack>
+</MudPaper>
+
+<MudDataGrid Items="@companies" Striped="true" Hoverable="true" Loading="@isLoading" Class="admin-grid">
+    <Columns>
+        <PropertyColumn Property="x => x.CompanyCode" Title="회사코드" />
+        <PropertyColumn Property="x => x.CompanyName" Title="회사명" />
+        <PropertyColumn Property="x => x.ContactPerson" Title="담당자" />
+        <PropertyColumn Property="x => x.Phone" Title="전화" />
+        <PropertyColumn Property="x => x.Email" Title="이메일" />
+        <PropertyColumn Property="x => x.IsActive" Title="활성">
+            <CellTemplate Context="cell">
+                <MudCheckBox T="bool" Value="@cell.Item.IsActive" Disabled="true" />
+            </CellTemplate>
+        </PropertyColumn>
+        <PropertyColumn Property="x => x.CreatedAt" Title="등록일" Format="yyyy-MM-dd" />
+        <TemplateColumn>
+            <CellTemplate Context="cell">
+                <MudButton Variant="Variant.Outlined" Size="Size.Small" Color="Color.Primary"
+                    Href="@($"/taxbaik/admin/companies/{cell.Item.Id}/edit")">수정</MudButton>
+            </CellTemplate>
+        </TemplateColumn>
+    </Columns>
+</MudDataGrid>
+
+<MudStack Row="true" Justify="Justify.Center" Class="mt-4" Spacing="2">
+    <MudButton Variant="Variant.Outlined" Disabled="@(currentPage <= 1 || isLoading)" @onclick="PreviousPage">이전</MudButton>
+    <MudButton Variant="Variant.Outlined" Disabled="@(currentPage >= totalPages || isLoading)" @onclick="NextPage">다음</MudButton>
+</MudStack>
+
+@code {
+    private List<CompanyDto> companies = [];
+    private bool isLoading = true;
+    private int currentPage = 1;
+    private int totalPages = 1;
+    private int totalCompanies = 0;
+    private const int PageSize = 20;
+
+    protected override async Task OnInitializedAsync()
+    {
+        await LoadData();
+    }
+
+    private async Task LoadData()
+    {
+        try
+        {
+            isLoading = true;
+            var response = await ApiClient.GetAsync<dynamic>($"company?page={currentPage}&pageSize={PageSize}");
+
+            IDictionary<string, object>? dict = response as IDictionary<string, object>;
+            if (dict != null)
+            {
+                totalCompanies = (int)(dynamic)dict["total"];
+                totalPages = (totalCompanies + PageSize - 1) / PageSize;
+
+                if (dict["data"] is System.Collections.IEnumerable dataList)
+                {
+                    companies = new List<CompanyDto>();
+                    foreach (var item in dataList)
+                    {
+                        if (item is IDictionary<string, object> companyDict)
+                        {
+                            companies.Add(new CompanyDto
+                            {
+                                Id = (int)(dynamic)companyDict["id"],
+                                CompanyCode = (string)companyDict["companyCode"],
+                                CompanyName = (string)companyDict["companyName"],
+                                ContactPerson = (string?)companyDict["contactPerson"],
+                                Phone = (string?)companyDict["phone"],
+                                Email = (string?)companyDict["email"],
+                                IsActive = (bool)(dynamic)companyDict["isActive"],
+                                CreatedAt = DateTime.Parse(companyDict["createdAt"].ToString()!)
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            Snackbar.Add($"고객사 로드 실패: {ex.Message}", Severity.Error);
+        }
+        finally
+        {
+            isLoading = false;
+        }
+    }
+
+    private async Task NextPage()
+    {
+        currentPage++;
+        await LoadData();
+    }
+
+    private async Task PreviousPage()
+    {
+        currentPage = Math.Max(1, currentPage - 1);
+        await LoadData();
+    }
+
+    private class CompanyDto
+    {
+        public int Id { get; set; }
+        public string CompanyCode { get; set; } = "";
+        public string CompanyName { get; set; } = "";
+        public string? ContactPerson { get; set; }
+        public string? Phone { get; set; }
+        public string? Email { get; set; }
+        public bool IsActive { get; set; }
+        public DateTime CreatedAt { get; set; }
+    }
+}