docs: [문서정리] 전체 문서 업데이트 및 admin→mng 전환 반영
- Phase 1-3: 핵심/보조 문서 업데이트, 버전 최신화 - Phase 4: 오래된 파일 정리 및 아카이브 - D0.8 Storyboard → history/2025-12/ 이동 - admin 참조 4개 파일 수정 (docker-setup, git-conventions, project-launch-roadmap, remote-work-setup) - 빈 디렉토리 6개 삭제 - 버전 정보: React 19.2.1, Next.js 15.5.7 - remote-work-setup.md DEPRECATED 표시
This commit is contained in:
@@ -1,8 +1,8 @@
|
||||
# SAM 데이터베이스 스키마
|
||||
|
||||
**업데이트**: 2025-11-24
|
||||
**데이터베이스**: samdb (MySQL 8.0.43)
|
||||
**전체 테이블**: 92개
|
||||
**업데이트**: 2025-12-26
|
||||
**데이터베이스**: samdb (MySQL 8.0.44)
|
||||
**전체 테이블**: 171개
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -12,8 +12,9 @@ SAM 프로젝트는 Docker Compose를 사용하여 로컬 개발 환경을 구
|
||||
services:
|
||||
nginx: # 리버스 프록시
|
||||
api: # Laravel 12 API (PHP 8.4)
|
||||
admin: # Laravel 12 Admin (PHP 8.4)
|
||||
mng: # Laravel 12 관리자 패널 (PHP 8.4)
|
||||
react: # Next.js 15 (Node 20)
|
||||
design: # 디자인 시스템 (Storybook)
|
||||
mysql: # MySQL 8.0
|
||||
```
|
||||
|
||||
@@ -27,7 +28,7 @@ services:
|
||||
|
||||
**도메인 매핑**:
|
||||
- `api.sam.kr` → Laravel API 서버
|
||||
- `admin.sam.kr` → Laravel Admin 패널
|
||||
- `mng.sam.kr`, `admin.sam.kr` → Laravel 관리자 패널
|
||||
- `dev.sam.kr` → Next.js 프론트엔드
|
||||
|
||||
**주요 기능**:
|
||||
@@ -69,25 +70,25 @@ services:
|
||||
|
||||
**작업 디렉토리**: `/var/www/api`
|
||||
|
||||
### 3. admin - Laravel 12 Admin 패널
|
||||
### 3. mng - Laravel 12 관리자 패널
|
||||
|
||||
**이미지**: `php:8.4-fpm`
|
||||
|
||||
**기술 스택**:
|
||||
- PHP 8.4-fpm
|
||||
- Filament v4
|
||||
- Pure Blade + Tailwind CSS
|
||||
- Composer 2
|
||||
- Supervisor (nginx + php-fpm)
|
||||
|
||||
**환경 변수**: api와 동일
|
||||
|
||||
**볼륨**:
|
||||
- `../admin:/var/www/admin` - 소스 코드
|
||||
- `../docker/admin/nginx.conf` - Nginx 설정
|
||||
- `../docker/admin/supervisord.conf` - Supervisor 설정
|
||||
- `../docker/admin/uploads.ini` - PHP 업로드 설정
|
||||
- `../mng:/var/www/mng` - 소스 코드
|
||||
- `../docker/mng/nginx.conf` - Nginx 설정
|
||||
- `../docker/mng/supervisord.conf` - Supervisor 설정
|
||||
- `../docker/mng/uploads.ini` - PHP 업로드 설정
|
||||
|
||||
**작업 디렉토리**: `/var/www/admin`
|
||||
**작업 디렉토리**: `/var/www/mng`
|
||||
|
||||
### 4. react - Next.js 15 프론트엔드
|
||||
|
||||
@@ -140,9 +141,9 @@ services:
|
||||
|
||||
**서비스 간 통신**:
|
||||
- `api.sam.kr` → `mysql:3306`
|
||||
- `admin.sam.kr` → `mysql:3306`
|
||||
- `mng.sam.kr` → `mysql:3306`
|
||||
- `nginx` → `api:9000` (PHP-FPM)
|
||||
- `nginx` → `admin:9000` (PHP-FPM)
|
||||
- `nginx` → `mng:9000` (PHP-FPM)
|
||||
- `nginx` → `react:3000` (Next.js)
|
||||
|
||||
## 사용 방법
|
||||
@@ -182,8 +183,8 @@ docker-compose down
|
||||
# API 컨테이너에서 마이그레이션
|
||||
docker-compose exec api php artisan migrate
|
||||
|
||||
# Admin 컨테이너에서 Composer 설치
|
||||
docker-compose exec admin composer install
|
||||
# MNG 컨테이너에서 Composer 설치
|
||||
docker-compose exec mng composer install
|
||||
|
||||
# React 컨테이너에서 npm 설치
|
||||
docker-compose exec react npm install
|
||||
@@ -196,7 +197,7 @@ docker-compose exec mysql mysql -u samuser -psampass samdb
|
||||
|
||||
### .env 파일
|
||||
|
||||
각 애플리케이션 디렉토리(`api/`, `admin/`, `react/`)에 `.env` 파일을 생성해야 합니다.
|
||||
각 애플리케이션 디렉토리(`api/`, `mng/`, `react/`)에 `.env` 파일을 생성해야 합니다.
|
||||
|
||||
**api/.env 예시**:
|
||||
```env
|
||||
@@ -214,13 +215,13 @@ DB_USERNAME=samuser
|
||||
DB_PASSWORD=sampass
|
||||
```
|
||||
|
||||
**admin/.env 예시**:
|
||||
**mng/.env 예시**:
|
||||
```env
|
||||
APP_NAME=SAM Admin
|
||||
APP_NAME=SAM MNG
|
||||
APP_ENV=local
|
||||
APP_KEY=
|
||||
APP_DEBUG=true
|
||||
APP_URL=http://admin.sam.kr
|
||||
APP_URL=http://mng.sam.kr
|
||||
|
||||
DB_CONNECTION=mysql
|
||||
DB_HOST=sam-mysql-1
|
||||
@@ -244,6 +245,7 @@ NEXT_PUBLIC_APP_NAME=SAM
|
||||
|
||||
```bash
|
||||
127.0.0.1 api.sam.kr
|
||||
127.0.0.1 mng.sam.kr
|
||||
127.0.0.1 admin.sam.kr
|
||||
127.0.0.1 dev.sam.kr
|
||||
```
|
||||
@@ -266,7 +268,7 @@ kill -9 <PID>
|
||||
```bash
|
||||
# storage 디렉토리 권한 설정
|
||||
docker-compose exec api chmod -R 775 storage
|
||||
docker-compose exec admin chmod -R 775 storage
|
||||
docker-compose exec mng chmod -R 775 storage
|
||||
```
|
||||
|
||||
### 컨테이너 재빌드
|
||||
@@ -336,5 +338,5 @@ docker-compose up -d
|
||||
|
||||
---
|
||||
|
||||
**업데이트**: 2025-11-18 (PHP 8.4, Next.js 15 반영)
|
||||
**업데이트**: 2025-12-26 (admin→mng 전환, design 서비스 추가)
|
||||
|
||||
|
||||
@@ -1,7 +1,11 @@
|
||||
# 다른 장소에서 작업 환경 구축 가이드
|
||||
|
||||
> ⚠️ **DEPRECATED**: 이 문서는 2025-09-19에 작성되었으며, 현재 프로젝트 구조와 맞지 않습니다.
|
||||
> 최신 정보는 `docs/architecture/system-overview.md` 및 `docs/specs/docker-setup.md`를 참조하세요.
|
||||
|
||||
**생성일**: 2025-09-19 21:50 KST
|
||||
**목적**: 다른 장소에서 동일한 개발 환경으로 작업 재개
|
||||
**상태**: ⚠️ DEPRECATED (2025-12-26)
|
||||
|
||||
## 🚀 빠른 시작 (5분 내 완료)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user