프로젝트 구조 설계

agentdesk/ ├── public/ # 웹 루트 (외부 접근 가능) │ ├── index.php # 프론트 컨트롤러 (모든 요청의 시작점) │ ├── .htaccess # URL 리라이트 규칙 │ └── assets/ # CSS, JS, 이미지 │ ├── css/ │ ├── js/ │ └── img/ ├── app/ # 애플리케이션 핵심 코드 │ ├── Controllers/ # 컨트롤러 (요청 처리) │ │ ├── AuthController.php │ │ ├── DashboardController.php │ │ ├── AgentController.php │ │ └── ApiController.php │ ├── Models/ # 모델 (데이터베이스 로직) │ │ ├── User.php │ │ ├── Tenant.php │ │ ├── Subscription.php │ │ ├── AIAgent.php │ │ └── Conversation.php │ ├── Views/ # 뷰 (HTML 템플릿) │ │ ├── layouts/ │ │ │ └── main.php │ │ ├── auth/ │ │ │ ├── login.php │ │ │ └── register.php │ │ ├── dashboard/ │ │ └── agent/ │ ├── Middleware/ # 미들웨어 (인증, 권한 체크) │ │ ├── AuthMiddleware.php │ │ └── TenantMiddleware.php │ └── Services/ # 서비스 (비즈니스 로직) │ ├── AIService.php │ ├── PaymentService.php │ └── EmailService.php ├── core/ # 프레임워크 핵심 │ ├── Router.php │ ├── Database.php │ ├── Request.php │ ├── Response.php │ └── App.php ├── config/ # 설정 파일 │ ├── config.php │ ├── database.php │ └── routes.php ├── storage/ # 로그, 캐시, 업로드 │ ├── logs/ │ ├── cache/ │ └── uploads/ ├── migrations/ # DB 마이그레이션 파일 ├── vendor/ # Composer 의존성 (자동 생성) ├── .env # 환경변수 (Git 제외!) ├── .env.example # 환경변수 템플릿 ├── .gitignore └── composer.json

<?php /** * AgentDesk - Front Controller * 모든 HTTP 요청의 시작점 */ declare(strict_types=1); // 에러 리포팅 (개발 중) error_reporting(E_ALL); ini_set('display_errors', '1'); // 프로젝트 루트 정의 define('ROOT_PATH', dirname(__DIR__)); // Composer 오토로더 require ROOT_PATH . '/vendor/autoload.php'; // 환경변수 로드 $dotenv = Dotenv\Dotenv::createImmutable(ROOT_PATH); $dotenv->load(); // 세션 시작 session_start(); // 설정 로드 $config = require ROOT_PATH . '/config/config.php'; // 애플리케이션 초기화 및 실행 $app = new Core\App($config); $app->run();

RewriteEngine On # HTTPS 리다이렉트 RewriteCond %{HTTPS} off RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301] # 실제 파일이나 디렉토리가 아니면 index.php로 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?url=$1 [QSA,L] # 보안: .env, .git 등 숨김 파일 접근 차단 RewriteRule (^\.|/\.) - [F] # 디렉토리 목록 비활성화 Options -Indexes

<?php // 환경변수에서 값을 가져와 배열로 반환 return [ 'app' => [ 'name' => $_ENV['APP_NAME'] ?? 'AgentDesk', 'env' => $_ENV['APP_ENV'] ?? 'production', 'debug' => ($_ENV['APP_DEBUG'] ?? 'false') === 'true', 'url' => $_ENV['APP_URL'] ?? 'http://localhost', ], 'database' => [ 'host' => $_ENV['DB_HOST'] ?? '127.0.0.1', 'port' => $_ENV['DB_PORT'] ?? '3306', 'database' => $_ENV['DB_DATABASE'] ?? 'agentdesk', 'username' => $_ENV['DB_USERNAME'] ?? 'root', 'password' => $_ENV['DB_PASSWORD'] ?? '', 'charset' => 'utf8mb4', ], 'ai' => [ 'openai_key' => $_ENV['OPENAI_API_KEY'] ?? '', 'model' => $_ENV['AI_MODEL'] ?? 'gpt-4o-mini', 'max_tokens' => (int)($_ENV['AI_MAX_TOKENS'] ?? 1000), ], ];