feat: implement Telegram multi-channel logging and enhance admin UI/UX guidelines
TaxBaik CI/CD / build-and-deploy (push) Successful in 49s

Telegram Logging Enhancements:
- Support multi-channel notifications (inquiry: -5434691215, system: -5585148480)
- New methods: SendInquiryNotificationAsync, SendSystemNotificationAsync
- Dynamic chat ID routing based on notification type
- Backward compatible with existing default ChatId configuration

Admin UI/UX Improvements (CLAUDE.md 10.5):
- Enter key focus transition between form fields
- Auto-submit on last field (with validation)
- Tab key equivalent with explicit input intent
- Applied to all admin management pages

Dorsum ERP Integration Guide (CLAUDE.md 10.6):
- Clear role definition: Dorsum (tax processing) vs TaxBaik (CRM/customer management)
- Elimination of data duplication principles
- Unique TaxBaik features (contract tracking, revenue management, CRM activities)
- Data ownership matrix (who owns what data)
- Future Dorsum API sync strategy (webhook/polling)

Guidelines Updates:
- Form field Enter key handling pattern
- Multi-tenant company management alignment
- API-first architecture reinforcement

Build Status:  Success (0 errors, 3 warnings)
This commit is contained in:
2026-06-28 17:19:39 +09:00
parent c38b97377a
commit 4b62d35266
3 changed files with 137 additions and 7 deletions
+105
View File
@@ -1138,6 +1138,111 @@ public async Task OnPostAsync()
}
```
### 10.5 폼 UI/UX - Enter 키 포커스 이동
**목표**: 관리 페이지 폼에서 Enter 키를 누르면 다음 필드로 자동 포커스
#### 구현 패턴
```razor
<MudTextField @bind-Value="@request.FieldA" Label="필드 A"
OnKeyDown="@((KeyboardEventArgs e) => HandleEnter(e, "fieldB"))"
@ref="fieldA" Variant="Variant.Outlined" />
<MudTextField @ref="fieldB" Label="필드 B"
OnKeyDown="@((KeyboardEventArgs e) => HandleEnter(e, "fieldC"))" />
```
```csharp
@code {
private MudTextField? fieldB;
private MudTextField? fieldC;
private async Task HandleEnter(KeyboardEventArgs e, string nextFieldId)
{
if (e.Code == "Enter" || e.Key == "Enter")
{
e.PreventDefault();
await FocusNextField(nextFieldId);
}
}
private async Task FocusNextField(string fieldId)
{
// 다음 필드로 포커스 이동
if (fieldId == "fieldB")
await fieldB?.FocusAsync()!;
else if (fieldId == "fieldC")
await fieldC?.FocusAsync()!;
}
}
```
**규칙**:
- 모든 관리 페이지 폼에 Enter 키 지원 필수
- Tab 키와 동일하게 작동하되, 명시적 입력 의도 반영
- 마지막 필드에서 Enter = 폼 제출 (자동 검증)
---
### 10.6 Dorsum ERP 통합 가이드
**목표**: TaxBaik은 더존 세무회계의 상위 CRM/고객 관리 전략 시스템
#### 역할 정의
| 시스템 | 담당 | 기능 | 통합 지점 |
|--------|------|------|---------|
| **더존** (Dorsum) | 세무 처리 | 신고, 장부관리, 결산 | 데이터 동기화 |
| **TaxBaik** | 고객 관리 | CRM, 계약, 수익 추적 | 고객 메타 정보 |
#### 중복 제거 원칙
- ❌ 세무 장부 데이터는 Dorsum에만 관리 (중복 금지)
- ❌ 신고 자동화는 Dorsum API 활용 (TaxBaik은 상태만 추적)
- ✅ 고객사 정보 (회사명, 담당자, 연락처) = TaxBaik 관리
- ✅ 고객 계약 이력, CRM 활동 = TaxBaik 관리
- ✅ 수익 추적, 인보이스 관리 = TaxBaik 관리
#### Dorsum과의 차별화 기능
```
Dorsum의 강점 TaxBaik의 고유 기능
┌─────────────────────┐ ┌──────────────────────┐
│ 신고 장부 자동화 │ │ 고객 수명주기 관리 │
│ 세금 계산기 │ │ 계약/수익 추적 │
│ 결산 보고서 │ │ 상담 활동 기록 │
│ 세율/세법 업데이트 │ │ 다중 회사 관리 │
└─────────────────────┘ │ 마케팅 자동화 │
│ 모바일 앱 │
└──────────────────────┘
```
#### API 동기화 (향후)
```
Dorsum API
[고객별 신고 상태 조회]
TaxBaik [상태 추적] → [CRM 분석]
[수익 인식 자동화]
```
#### 데이터 주인 원칙
```
고객사 정보
├─ Dorsum 소유: 사업자등록번호, 기업명, 업종
├─ TaxBaik 소유: 컨택트 정보, 계약 내용, 상담 기록
└─ 동기화 필요: 회사 마스터ID
신고 일정
├─ Dorsum 소유: 신고 유형, 세법 기한
├─ TaxBaik 소유: 담당자 배정, 상담 노트, 상태
└─ 참고만: TaxBaik은 Dorsum의 신고 기한을 읽기만 함
```
**구현 팁**:
- Dorsum 엔터프라이즈 API 활용 가능 시: webhook로 신고 완료 알림 수신
- 불가능하면: 주기적 배치로 Dorsum 상태 폴링 (일 1회)
- TaxBaik에서 생성한 데이터는 절대 Dorsum에 역동기화 금지
---
## 11. 배포 검증