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:
2025-12-26 16:47:36 +09:00
parent aad94e5377
commit 66eac6b39f
128 changed files with 454 additions and 137 deletions

View File

@@ -1,8 +1,8 @@
# SAM 데이터베이스 스키마
**업데이트**: 2025-11-24
**데이터베이스**: samdb (MySQL 8.0.43)
**전체 테이블**: 92
**업데이트**: 2025-12-26
**데이터베이스**: samdb (MySQL 8.0.44)
**전체 테이블**: 171
---

View File

@@ -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 서비스 추가)

View File

@@ -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분 내 완료)