SamProject/sam-docs
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
db63fcff859b71c768be03ee68f01a82188a76a4
sam-docs/system/mng-structure.md
권혁성 d4e5f62413 docs: [종합정비] Phase 1 시스템 현황 문서 14개 작성 
- 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>
2026-02-27 18:03:13 +09:00

4.7 KiB
Raw Blame History

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)