# MNG 관리자 패널 구조 현황

> **최종 갱신**: 2026-02-27
> **기술 스택**: Laravel 12 + HTMX 2 + DaisyUI 5 + Tailwind 3

---

## 1. 프로젝트 규모

| 항목 | 수량 |
|------|------|
| 컨트롤러 | 171 |
| 블레이드 템플릿 | 436 |
| 모델 | 185 |
| 서비스 | 98 |
| FormRequest | 37 |
| 미들웨어 | 4 |
| Console Commands | 4 |
| Traits | 4 |

---

## 2. 디렉토리 구조

```
app/
├── Http/Controllers/
│   ├── Api/Admin/         관리자 API (바로빌, HR, PM, 견적)
│   ├── Auth/              인증
│   ├── Barobill/          바로빌 연동
│   ├── Credit/            신용조회
│   ├── DevTools/          API Explorer, Flow Tester
│   ├── ESign/             전자서명
│   ├── Finance/           재무
│   ├── HR/                인사
│   ├── Lab/               실험/테스트
│   ├── Sales/             영업
│   ├── Stats/             통계
│   ├── System/            시스템 설정
│   └── Video/             영상/튜토리얼
├── Models/                api/ 모델과 별도 (동일 DB 사용)
│   ├── Admin/             PM 관리 (프로젝트, 태스크, 이슈)
│   ├── Barobill/          바로빌
│   ├── Commons/           공통 (파일, 메뉴)
│   ├── Documents/         문서
│   ├── Equipment/         설비
│   ├── ESign/             전자서명
│   ├── Finance/           재무
│   ├── HR/                인사
│   ├── Items/             품목
│   ├── Quote/             견적
│   ├── Sales/             영업
│   ├── Stats/             통계
│   └── Tenants/           테넌트
├── Services/              (98개)
│   ├── ApiExplorer/       API 탐색기
│   ├── Barobill/          바로빌 연동
│   ├── FlowTester/        API 플로우 테스터
│   ├── HR/                인사
│   ├── ProjectManagement/ PM
│   ├── Quote/             견적
│   ├── Sales/             영업
│   └── Video/             영상
└── Traits/
    ├── BelongsToTenant
    ├── HasTenantFilter
    ├── ModelTrait
    └── UppercaseAttributes
```

---

## 3. 뷰(블레이드) 도메인 구조

| 도메인 | 주요 뷰 디렉토리 | 기능 |
|--------|-----------------|------|
| barobill | bank-account, billing, card-usage, etax, hometax, kakaotalk, sms | 바로빌 연동 전체 |
| finance | accounts, fund-schedules, settlement, sales-commission | 재무/회계 |
| hr | attendances, employees, leaves, payrolls, employee-tenure | 인사관리 |
| sales | admin-prospects, business-cards, dashboard, interviews, products, prospects | 영업관리 |
| project-management | projects, tasks, issues | 프로젝트 관리 |
| dev-tools | api-explorer, flow-tester | 개발 도구 |
| system | ai-config, ai-token-usage, alerts, holidays | 시스템 설정 |
| equipment | inspections, repairs | 설비관리 |
| esign | sign/ | 전자서명 |
| video | tutorial, veo3 | 영상 관리 |
| quote-formulas | categories | 견적 공식 |

---

## 4. 아키텍처 패턴

### 프론트엔드
- **HTMX 2**: SPA 프레임워크 없이 서버 렌더링 + 부분 업데이트
- **DaisyUI 5** + Tailwind 3: UI 컴포넌트 + 스타일
- **Axios**: AJAX 호출 (HTMX 보조)
- **Vite 7**: 빌드 도구

### 백엔드
- **Service-First**: 비즈니스 로직 → Service 클래스
- **BelongsToTenant**: Multi-tenant 데이터 격리
- **FormRequest**: 입력 검증 (37개)
- **api와 동일 DB**: `samdb` 공유, 자체 모델 보유

### api ↔ mng 관계
- 동일 MySQL DB (`samdb`) 공유
- 각자 독립적인 모델 보유 (api: 205개, mng: 185개)
- **DB 마이그레이션은 api에서만** — mng에 migrations 없음
- 내부 통신: HMAC 기반 `INTERNAL_EXCHANGE_SECRET`
- 파일 공유: mng가 api의 `storage/app/tenants` 마운트

### 주요 기능 (mng 전용)
- **API Explorer**: API 엔드포인트 탐색/테스트 도구
- **Flow Tester**: API 호출 시나리오 테스트
- **바로빌 관리**: 세금계산서, 카드매입, 홈택스 연동
- **프로젝트 관리**: PM 도구 (프로젝트, 태스크, 이슈, 일일 로그)
- **영상 관리**: 튜토리얼, Veo3 영상 생성
- **AI 설정**: AI 토큰 사용량, 음성 녹음, 가격 설정

---

## 5. 라우트

| 파일 | 설명 |
|------|------|
| `routes/web.php` | 메인 웹 라우트 (Blade 뷰) |
| `routes/api.php` | 내부 API (mng 전용) |
| `routes/console.php` | Artisan 커맨드 |

---

## 6. 도메인

| 도메인 | URL |
|--------|-----|
| `mng.sam.kr` | 메인 관리자 |
| `admin.sam.kr` | 동일 서버 (nginx alias) |