diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f04bd54
--- /dev/null
+++ b/README.md
@@ -0,0 +1,138 @@
+# SDL Base
+
+Spring Boot 3 기반 백엔드와 Vue 3/Vite 기반 프론트엔드가 함께 있는 통합 프로젝트입니다.
+
+## 개요
+
+- 백엔드: Spring Boot 3.3.0, Java 17, Maven, MyBatis
+- 프론트엔드: Vue 3, Vite 5, Vue Router, Vuex
+- 배치: Quartz Scheduler
+- 문서: `doc/` 하위 AsciiDoc/HTML 문서
+- 프로필: `local`, `dev`, `prod`
+
+## 프로젝트 구조
+
+```text
+sdl-base/
+├── src/main/java/ # Spring Boot 애플리케이션, 설정, 컨트롤러, 서비스
+├── src/main/resources/ # 공통 리소스, 메시지, MyBatis 매퍼
+├── src/main/resources-local/ # local 프로필 설정
+├── src/main/resources-dev/ # dev 프로필 설정
+├── src/main/resources-prod/ # prod 프로필 설정
+├── frontend/ # Vue 3 + Vite 프론트엔드
+├── doc/ # 설치/구성/기능 문서
+├── source/ # 로컬 Maven 저장소로 참조하는 SDL 라이브러리
+├── pom.xml # 백엔드 빌드 설정
+└── plan.md # 작업 메모 및 환경 정보
+```
+
+## 주요 실행 흐름
+
+1. 백엔드는 `com.samsung.SdlBaseBootApplication`에서 시작합니다.
+2. `local` 프로필에서는 `config.properties`의 `datasource.*` 값을 사용해 직접 DB에 연결합니다.
+3. `dev`, `prod` 프로필에서는 `db.jndi=sdl_ds` 기반 JNDI 데이터소스를 사용합니다.
+4. MyBatis 매퍼는 PostgreSQL 경로인 `src/main/resources/sql/mybatis/postgresql/`를 사용합니다.
+5. 프론트엔드는 `frontend/`에서 Vite로 실행하거나 빌드 산출물을 백엔드 정적 리소스로 내보냅니다.
+
+## 실행 전 준비
+
+### 백엔드
+
+- Java 17 이상
+- Maven 3.9 이상 또는 프로젝트 포함 `./mvnw`
+- PostgreSQL 접근 가능 환경
+- 필요 시 `JASYPT_KEY` 환경변수 설정
+
+예시:
+
+```bash
+export JASYPT_KEY=your-jasypt-key
+```
+
+### 프론트엔드
+
+- Node.js 20.14.0 이상
+- npm
+
+## 로컬 실행 방법
+
+### 1. 프론트엔드 의존성 설치
+
+```bash
+cd frontend
+npm install
+```
+
+### 2. 프론트엔드 개발 서버 실행
+
+```bash
+cd frontend
+npm run local
+```
+
+- 기본 포트: `8081`
+- API 대상: `http://localhost:8080`
+
+### 3. 백엔드 실행
+
+프로젝트 루트에서 실행합니다.
+
+```bash
+./mvnw spring-boot:run -Plocal
+```
+
+또는 IDE에서 `com.samsung.SdlBaseBootApplication`을 Spring Boot Application으로 실행하면 됩니다.
+
+## 빌드 방법
+
+### 백엔드 빌드
+
+```bash
+./mvnw clean package
+```
+
+### 프론트엔드 운영 빌드
+
+```bash
+cd frontend
+npm run build
+```
+
+기본 운영 빌드 결과물은 `frontend/.env.production`의 `VITE_DIST_PATH` 설정에 따라 백엔드 웹 리소스 경로로 출력됩니다.
+
+## 프로필별 설정 파일
+
+- `src/main/resources-local/application.properties`
+- `src/main/resources-local/config.properties`
+- `src/main/resources-dev/application.properties`
+- `src/main/resources-dev/config.properties`
+- `src/main/resources-prod/application.properties`
+- `src/main/resources-prod/config.properties`
+
+## DB 연결 정보
+
+`plan.md` 기준으로 현재 반영된 PostgreSQL 정보는 다음과 같습니다.
+
+- DBMS: PostgreSQL
+- 호스트: `192.168.0.60`
+- 포트: `5432`
+- 데이터베이스: `casaos`
+- 사용자: `casaos`
+- 비밀번호: `casaos`
+
+적용 위치:
+
+- 로컬 메인 데이터소스: `src/main/resources-local/config.properties`
+- Quartz 데이터소스: `src/main/resources-dev/application.properties`
+- Quartz 데이터소스: `src/main/resources-prod/application.properties`
+
+## 참고 문서
+
+- 설치 문서: `doc/설치/로컬설치.adoc`
+- Quartz 문서: `doc/Appendix/QuartzClustering.adoc`
+- 전체 문서 인덱스: `doc/index.html`
+
+## 확인 메모
+
+- 현재 백엔드 MyBatis 설정은 PostgreSQL 매퍼 경로를 사용하도록 정리했습니다.
+- `dev`, `prod`는 애플리케이션 메인 데이터소스를 JNDI로 조회하므로 WAS/JNDI 설정도 별도로 맞아야 합니다.
diff --git a/plan.md b/plan.md
index e69de29..067bb59 100644
--- a/plan.md
+++ b/plan.md
@@ -0,0 +1,8 @@
+# DB 정보
+ - DB : postgresql
+ - DB 이름 : casaos
+ - DB 유저 : casaos
+ - DB 비밀번호 : casaos
+ - DB 포트 : 5432
+ - DB 호스트 : 192.168.0.60
+
diff --git a/pom.xml b/pom.xml
index f38b775..95f6077 100644
--- a/pom.xml
+++ b/pom.xml
@@ -27,6 +27,7 @@
org.projectlombok
lombok
+ ${lombok.version}
true
@@ -76,6 +77,17 @@
mssql-jdbc
12.8.1.jre8
+
+ org.postgresql
+ postgresql
+ 42.7.3
+
+
+ org.checkerframework
+ checker-qual
+
+
+