admin/front 분리

This commit is contained in:
2026-07-20 17:49:24 +09:00
parent 9269278e40
commit ed41ef24cb
673 changed files with 16782 additions and 11277 deletions
+10 -4
View File
@@ -16,10 +16,13 @@
| 구분 | 문서 | 경로(URL) |
|------|------|-----------|
| 기본 | [프로젝트 개요](docs/project-overview.md) | `docs/project-overview.md` |
| 기본 | [구조 한눈에 보기](docs/architecture-at-a-glance.md) | `docs/architecture-at-a-glance.md` |
| 기본 | [Core 모듈 설계](docs/core-module-design.md) | `docs/core-module-design.md` |
| 기본 | [코드 컨벤션](docs/code-conventions.md) | `docs/code-conventions.md` |
| 기본 | [보안 및 응답 규칙](docs/security-and-response.md) | `docs/security-and-response.md` |
| 기본 | [설정 및 실행 가이드](docs/runtime-config.md) | `docs/runtime-config.md` |
| 기본 | [검증 및 체크리스트](docs/verification-checklist.md) | `docs/verification-checklist.md` |
| 기본 | [테스트 전략](docs/testing-strategy.md) | `docs/testing-strategy.md` |
| 기본 | [Codex 작업 규칙](docs/agent-workflow.md) | `docs/agent-workflow.md` |
| 기본 | [현재 코드베이스 메모](docs/codebase-notes.md) | `docs/codebase-notes.md` |
| 정책 | [정책서 요약 인덱스](docs/policy/index.md) | `docs/policy/index.md` |
@@ -30,10 +33,13 @@
| 정책 | [정책서: 인터페이스/도메인/운영](docs/policy/interfaces-and-operations.md) | `docs/policy/interfaces-and-operations.md` |
## 빠른 판단 가이드
- core `standard`/`bespoke` 구조와 이관 기준은 `docs/core-module-design.md` 를 우선 본다.
- 프로젝트에 처음 참여했거나 core/admin/front 책임을 빠르게 파악해야 하면 `docs/architecture-at-a-glance.md` 를 먼저 본다.
- 구조, 네이밍, DTO/VO/Form, Mapper 작성 방식은 `docs/code-conventions.md` 를 우선 본다.
- 인증/인가, 공통 응답, 예외 처리, 응답 코드는 `docs/security-and-response.md` 를 우선 본다.
- 프로파일, 설정 파일, 로깅, Swagger, 실행 명령은 `docs/runtime-config.md` 를 우선 본다.
- 테스트 범위, 배포 전 점검, 파일/권한/설정 변경 확인사항은 `docs/verification-checklist.md` 를 우선 본다.
- 단위 테스트, 통합 테스트, 실제 연동 검증의 범위와 Red-Green 흐름은 `docs/testing-strategy.md` 를 우선 본다.
- Codex 협업 방식과 응답 원칙은 `docs/agent-workflow.md` 를 우선 본다.
- 도메인 정책, 역할, 강좌/콘텐츠/LMS 규칙은 `docs/policy/` 하위 문서를 우선 본다.
@@ -50,9 +56,9 @@
- 기존 서비스 회원 DB와 학습 이력은 완전 마이그레이션 대상이 아니므로 최초 로그인 연동, 레거시 병행 운영, 데이터 재구조화 정책을 함께 고려해야 한다.
## 프로젝트 핵심 정보
- 프로젝트 유형: Gradle 기반 Spring Boot 애플리케이션
- 프로젝트 유형: Gradle 기반 Spring Boot 멀티모듈 모놀리식
- Java 버전: 21
- Spring Boot 버전: 3.5.10
- 기본 애플리케이션 이름: `api`
- 기본 포트: `8106`
- 실행 진입점: `src/main/java/com/alist/api/ApiApplication.java`
- 모듈: `01-api-core`, `02-api-admin`, `03-api-front`
- admin 포트: `8111`, 실행 진입점: `com.alist.api.admin.ApiAdminApplication`
- front 포트: `8112`, 실행 진입점: `com.alist.api.front.ApiFrontApplication`