145 lines
4.0 KiB
Markdown
145 lines
4.0 KiB
Markdown
|
# 바로빌 회원사관리 - 레거시 마이그레이션 계획
|
||
|
|
|
||
|
|
> 레거시 소스: `sam/sales/barobill/registration/index.php`
|
||
|
|
|
||
|
|
## 1. 레거시 분석
|
||
|
|
|
||
|
|
### 기술 스택
|
||
|
|
- Frontend: React 18 + Babel (브라우저 트랜스파일링)
|
||
|
|
- Backend: PHP + PDO (api.php)
|
||
|
|
- UI: Tailwind CSS + Lucide Icons
|
||
|
|
|
||
|
|
### 데이터베이스 구조 (`barobill_members` 테이블)
|
||
|
|
|
||
|
|
| 필드명 | 타입 | 설명 |
|
||
|
|
|--------|------|------|
|
||
|
|
| `id` | INT | PK, Auto Increment |
|
||
|
|
| `biz_no` | VARCHAR | 사업자번호 (Unique) |
|
||
|
|
| `corp_name` | VARCHAR | 상호명 |
|
||
|
|
| `ceo_name` | VARCHAR | 대표자명 |
|
||
|
|
| `addr` | VARCHAR | 주소 |
|
||
|
|
| `biz_type` | VARCHAR | 업태 |
|
||
|
|
| `biz_class` | VARCHAR | 종목 |
|
||
|
|
| `barobill_id` | VARCHAR | 바로빌 아이디 |
|
||
|
|
| `barobill_pwd` | VARCHAR | 바로빌 비밀번호 (해시) |
|
||
|
|
| `manager_name` | VARCHAR | 담당자명 |
|
||
|
|
| `manager_email` | VARCHAR | 담당자 이메일 |
|
||
|
|
| `manager_hp` | VARCHAR | 담당자 전화번호 |
|
||
|
|
| `created_at` | TIMESTAMP | 생성일시 |
|
||
|
|
|
||
|
|
### API 엔드포인트 (레거시)
|
||
|
|
|
||
|
|
| Method | Endpoint | 설명 |
|
||
|
|
|--------|----------|------|
|
||
|
|
| GET | `api.php` | 전체 목록 조회 |
|
||
|
|
| GET | `api.php?id={id}` | 단일 조회 |
|
||
|
|
| POST | `api.php` | 신규 등록 (사업자번호 중복 체크) |
|
||
|
|
| PUT | `api.php` | 정보 수정 |
|
||
|
|
| DELETE | `api.php?id={id}` | 삭제 |
|
||
|
|
|
||
|
|
### UI 기능
|
||
|
|
|
||
|
|
1. **통계 카드 (4개)**
|
||
|
|
- 연동 회원사 수 (DB 실시간)
|
||
|
|
- API 키 상태
|
||
|
|
- 트래픽 상태
|
||
|
|
- 서버 상태
|
||
|
|
|
||
|
|
2. **탭 네비게이션**
|
||
|
|
- 목록 조회
|
||
|
|
- 신규 등록
|
||
|
|
|
||
|
|
3. **목록 테이블 컬럼**
|
||
|
|
- 사업자번호
|
||
|
|
- 상호 / 대표자
|
||
|
|
- 바로빌 ID
|
||
|
|
- 담당자 정보
|
||
|
|
- 작업 (수정/삭제)
|
||
|
|
|
||
|
|
4. **등록 폼 필드**
|
||
|
|
- 사업자번호 (필수)
|
||
|
|
- 상호명 (필수)
|
||
|
|
- 대표자명 (필수)
|
||
|
|
- 업태
|
||
|
|
- 종목
|
||
|
|
- 주소
|
||
|
|
- 바로빌 아이디 (필수, 등록 시만)
|
||
|
|
- 비밀번호 (필수, 등록 시만)
|
||
|
|
- 담당자명
|
||
|
|
- 담당자 HP
|
||
|
|
- 담당자 이메일
|
||
|
|
- **자동완성 버튼** (테스트 데이터 입력)
|
||
|
|
|
||
|
|
5. **수정 모달**
|
||
|
|
- 등록 폼과 동일 (아이디/비밀번호 제외)
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. Laravel 마이그레이션 계획
|
||
|
|
|
||
|
|
### 생성할 파일 목록
|
||
|
|
|
||
|
|
#### Model & Migration
|
||
|
|
```
|
||
|
|
app/Models/BarobillMember.php
|
||
|
|
database/migrations/xxxx_create_barobill_members_table.php
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Controller
|
||
|
|
```
|
||
|
|
app/Http/Controllers/Barobill/BarobillController.php (이미 생성됨)
|
||
|
|
app/Http/Controllers/Api/Admin/BarobillController.php (API용)
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Views
|
||
|
|
```
|
||
|
|
resources/views/barobill/members/index.blade.php (이미 생성됨 - 업데이트 필요)
|
||
|
|
resources/views/barobill/members/partials/table.blade.php
|
||
|
|
resources/views/barobill/members/partials/form.blade.php
|
||
|
|
resources/views/barobill/members/partials/modal-edit.blade.php
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Routes
|
||
|
|
```php
|
||
|
|
// Web Routes (이미 추가됨)
|
||
|
|
Route::prefix('barobill')->name('barobill.')->group(function () {
|
||
|
|
Route::get('/members', [BarobillController::class, 'members'])->name('members.index');
|
||
|
|
});
|
||
|
|
|
||
|
|
// API Routes (추가 필요)
|
||
|
|
Route::prefix('barobill')->name('barobill.')->group(function () {
|
||
|
|
Route::get('/members', [BarobillApiController::class, 'index']);
|
||
|
|
Route::get('/members/{id}', [BarobillApiController::class, 'show']);
|
||
|
|
Route::post('/members', [BarobillApiController::class, 'store']);
|
||
|
|
Route::put('/members/{id}', [BarobillApiController::class, 'update']);
|
||
|
|
Route::delete('/members/{id}', [BarobillApiController::class, 'destroy']);
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
### 구현 순서
|
||
|
|
|
||
|
|
1. [ ] Migration 생성 및 실행
|
||
|
|
2. [ ] Model 생성 (fillable, casts 설정)
|
||
|
|
3. [ ] API Controller 생성 (CRUD)
|
||
|
|
4. [ ] API Routes 추가
|
||
|
|
5. [ ] View 업데이트 (HTMX + Blade)
|
||
|
|
- 통계 카드
|
||
|
|
- 탭 (목록/등록)
|
||
|
|
- 테이블 (HTMX 로드)
|
||
|
|
- 등록 폼
|
||
|
|
- 수정 모달
|
||
|
|
6. [ ] 테스트
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. 참고 사항
|
||
|
|
|
||
|
|
### 레거시 코드 위치
|
||
|
|
- Frontend: `sam/sales/barobill/registration/index.php`
|
||
|
|
- Backend API: `sam/sales/barobill/registration/api.php`
|
||
|
|
|
||
|
|
### 주의 사항
|
||
|
|
- 사업자번호 중복 체크 로직 필요
|
||
|
|
- 비밀번호는 해시 저장 (password_hash)
|
||
|
|
- 바로빌 API 연동은 별도 Service 클래스로 분리 권장
|