권혁성
d4e5f62413
- system/overview.md: 전체 아키텍처 개요 - system/api-structure.md: API 구조 (220 모델, 1027 엔드포인트, 18 라우트 도메인) - system/react-structure.md: React 구조 (249 페이지, 612 컴포넌트) - system/mng-structure.md: MNG 구조 (171 컨트롤러, 436 Blade 뷰) - system/docker-setup.md: Docker 7 컨테이너 구성 - system/database/README.md + 9개 도메인 스키마 (270+ 테이블) - core, hr, sales, production, finance, boards, files, system, erp-analysis Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
137 lines
4.7 KiB
Markdown
137 lines
4.7 KiB
Markdown
# 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) | |