diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6713ff3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,747 @@
+<div align="center">
+
+# 🏠 PinHouse
+
+**공공 임대주택 정보 및 청약 진단 플랫폼**
+
+[![Java](https://img.shields.io/badge/Java-21-ED8B00?style=flat&logo=openjdk&logoColor=white)](https://openjdk.org/)
+[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.4.3-6DB33F?style=flat&logo=spring-boot)](https://spring.io/projects/spring-boot)
+[![Gradle](https://img.shields.io/badge/Gradle-8.x-02303A?style=flat&logo=gradle)](https://gradle.org/)
+[![MongoDB](https://img.shields.io/badge/MongoDB-47A248?style=flat&logo=mongodb&logoColor=white)](https://www.mongodb.com/)
+[![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1?style=flat&logo=mysql&logoColor=white)](https://www.mysql.com/)
+[![Redis](https://img.shields.io/badge/Redis-7.2.5-DC382D?style=flat&logo=redis&logoColor=white)](https://redis.io/)
+
+[기술 스택](#-기술-스택) • [아키텍처](#-아키텍처) • [주요 구현 사항](#-주요-구현-사항)
+
+</div>
+
+---
+
+## 📋 목차
+
+- [프로젝트 소개](#-프로젝트-소개)
+- [주요 기능](#-주요-기능)
+- [기술 스택](#-기술-스택)
+- [아키텍처](#-아키텍처)
+- [데이터베이스 설계](#-데이터베이스-설계)
+- [프로젝트 구조](#-프로젝트-구조)
+- [주요 구현 사항](#-주요-구현-사항)
+- [성능 최적화](#-성능-최적화)
+- [보안](#-보안)
+- [CI/CD](#-cicd)
+
+---
+
+## 🎯 프로젝트 소개
+
+**PinHouse**는 공공 임대주택 정보를 제공하고 사용자의 청약 자격을 진단하는 플랫폼입니다.
+복잡한 청약 정보를 직관적으로 제공하며, 위치 기반 서비스를 통해 사용자 맞춤형 주택 정보를 제공합니다.
+
+### 🌟 핵심 가치
+
+- **정보 투명성**: 공공 임대주택 데이터를 통합하여 투명하게 제공
+- **맞춤형 진단**: 사용자 상황에 맞는 청약 자격 자동 진단
+- **위치 기반 추천**: 직장/학교 등 관심 위치 기반 최적 주택 추천
+- **사용자 경험**: 복잡한 정보를 직관적이고 편리하게 제공
+
+---
+
+## ✨ 주요 기능
+
+### 🔐 인증 및 사용자 관리
+- **소셜 로그인**: Kakao, Naver OAuth2 인증
+- **JWT 기반 인증**: Access/Refresh Token을 통한 보안 강화
+- **마이페이지**: 프로필 관리, 좋아요 목록, 진단 이력 조회
+
+### 🏘️ 주택 정보 관리
+- **단지 정보**: 임대주택 단지의 상세 정보 제공
+  - 난방방식, 총세대수, 공급호수
+  - 방 타입별 정보 (면적, 임대료, 관리비)
+  - 주변 인프라 정보 (카페, 편의점, 병원, 학교 등)
+
+- **공고 검색**: 다양한 필터링 및 정렬 옵션
+  - 지역, 공급 유형, 가격 범위, 면적별 검색
+  - 커서 기반 무한 스크롤 페이지네이션
+  - 인기순, 최신순 정렬
+
+- **방 비교 기능**: 여러 방 타입을 한눈에 비교
+
+### 📍 위치 기반 서비스
+- **핀포인트**: 사용자의 관심 위치 등록 (직장, 학교, 부모 집 등)
+- **거리 시뮬레이터**: Odsay API를 활용한 대중교통 경로 계산
+  - 총 소요 시간, 거리, 요금 정보
+  - 구간별 상세 경로 (승차/하차 정보, 노선 색상)
+  - 최대 3개 경로 제공
+
+### 🎓 청약 진단 시스템
+- **자격 진단**: 사용자의 소득, 자산, 가족 구성원 정보 기반 청약 가능 여부 판단
+- **규칙 엔진**: 공급 유형별 복잡한 청약 자격 규칙 자동 적용
+  - 신혼부부 특별공급
+  - 다자녀 가구 특별공급
+  - 생애최초 특별공급
+  - 청년 특별공급
+- **진단 이력 관리**: 과거 진단 결과 저장 및 조회
+
+### 🔍 검색 및 필터링
+- **빠른 검색**: 지역, 방 타입, 임대료 범위로 간편 검색
+- **고급 검색**: 키워드 기반 검색 및 다양한 필터 조합
+- **인기 검색어**: 실시간 인기 검색어 제공
+- **검색 기록**: MongoDB 기반 사용자별 검색 이력 추적
+
+### ❤️ 좋아요 및 북마크
+- 공고, 단지, 방 타입에 대한 좋아요 기능
+- 로그인 사용자별 좋아요 목록 관리
+
+---
+
+## 🛠 기술 스택
+
+### Backend
+- **Language**: Java 21
+- **Framework**: Spring Boot 3.4.3
+- **Build Tool**: Gradle 8.x
+- **Architecture**: Clean Architecture (4-Layer)
+
+### Database
+- **MySQL 8.0**: 관계형 데이터 (사용자, 공고, 단지, 진단 결과)
+- **MongoDB**: 문서 기반 데이터 (핀포인트, 검색 이력, 주변시설)
+- **Redis 7.2.5**: 세션 관리 (JWT Refresh Token, 임시 사용자 정보)
+
+### Security & Auth
+- **Spring Security**: 보안 프레임워크
+- **OAuth2 Client**: 소셜 로그인 (Kakao, Naver)
+- **JWT**: `io.jsonwebtoken:jjwt-api:0.11.5`
+
+### Infrastructure
+- **Docker & Docker Compose**: 컨테이너화
+- **Nginx**: 리버스 프록시
+- **Certbot**: SSL/TLS 인증서 관리
+
+### DevOps
+- **GitHub Actions**: CI/CD 자동화
+- **JUnit 5**: 단위 및 통합 테스트
+
+### External APIs
+- **Odsay API**: 대중교통 경로 및 시간 계산
+- **Kakao Local API**: 주소-좌표 변환
+- **OAuth2 Providers**: Kakao, Naver
+
+### Documentation & Monitoring
+- **Swagger/OpenAPI**: `springdoc-openapi-starter-webmvc-ui:2.8.6`
+- **Spring Actuator**: 애플리케이션 모니터링
+
+---
+
+## 🏗 아키텍처
+
+### 시스템 아키텍처
+
+```mermaid
+graph TB
+    subgraph "Client Layer"
+        Client[Client Application]
+    end
+
+    subgraph "API Gateway"
+        Nginx[Nginx Reverse Proxy]
+    end
+
+    subgraph "Application Server"
+        Spring[Spring Boot 3.4.3]
+
+        subgraph "Clean Architecture Layers"
+            Presentation[Presentation Layer<br/>REST Controllers]
+            Application[Application Layer<br/>UseCase + Services]
+            Domain[Domain Layer<br/>Entities + Repositories]
+            Infrastructure[Infrastructure Layer<br/>DB + External APIs]
+        end
+    end
+
+    subgraph "Data Layer"
+        MySQL[(MySQL 8.0<br/>Relational Data)]
+        MongoDB[(MongoDB<br/>Document Data)]
+        Redis[(Redis 7.2.5<br/>Cache & Session)]
+    end
+
+    subgraph "External Services"
+        Odsay[Odsay API]
+        KakaoLocal[Kakao Local API]
+        OAuth2[OAuth2 Providers<br/>Kakao, Naver]
+    end
+
+    Client -->|HTTPS| Nginx
+    Nginx -->|HTTP| Spring
+    Spring --> Presentation
+    Presentation --> Application
+    Application --> Domain
+    Domain --> Infrastructure
+    Infrastructure --> MySQL
+    Infrastructure --> MongoDB
+    Infrastructure --> Redis
+    Infrastructure --> Odsay
+    Infrastructure --> KakaoLocal
+    Infrastructure --> OAuth2
+
+    style Spring fill:#6DB33F
+    style MySQL fill:#4479A1
+    style MongoDB fill:#47A248
+    style Redis fill:#DC382D
+```
+
+### Clean Architecture (4-Layer)
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                   Presentation Layer                     │
+│              (REST API Controllers - *Api.java)          │
+└───────────────────┬─────────────────────────────────────┘
+                    │ depends on
+┌───────────────────▼─────────────────────────────────────┐
+│                  Application Layer                       │
+│        UseCase Interfaces + Service Implementations      │
+│                   (Business Logic)                       │
+└───────────────────┬─────────────────────────────────────┘
+                    │ depends on
+┌───────────────────▼─────────────────────────────────────┐
+│                    Domain Layer                          │
+│            Entities + Repository Interfaces              │
+│                 (Business Rules)                         │
+└───────────────────┬─────────────────────────────────────┘
+                    │ depends on
+┌───────────────────▼─────────────────────────────────────┐
+│               Infrastructure Layer                       │
+│      Repository Implementations + External APIs          │
+└─────────────────────────────────────────────────────────┘
+```
+
+### 도메인 모듈 구조
+
+각 도메인은 일관된 패키지 구조를 따릅니다:
+
+```
+<domain>/
+├── presentation/           # REST API 엔드포인트
+│   ├── *Api.java          # Controller
+│   └── swagger/           # API 명세
+├── application/
+│   ├── usecase/           # UseCase 인터페이스
+│   ├── service/           # UseCase 구현
+│   └── dto/               # Request/Response DTO
+│       ├── request/
+│       └── response/
+├── domain/
+│   ├── entity/            # JPA/MongoDB Entity
+│   └── repository/        # Repository Interface
+└── external/              # 외부 API 통합 (선택)
+```
+
+### 데이터베이스 아키텍처
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│    MySQL     │     │   MongoDB    │     │    Redis     │
+│              │     │              │     │              │
+│  - User      │     │ - PinPoint   │     │ - JWT Token  │
+│  - Complex   │     │ - Search     │     │ - TempUser   │
+│  - Notice    │     │   History    │     │              │
+│  - Diagnosis │     │ - Facility   │     │              │
+│  - Like      │     │              │     │              │
+└──────────────┘     └──────────────┘     └──────────────┘
+```
+
+---
+
+## 💾 데이터베이스 설계
+
+### Entity Relationship Diagram
+
+```mermaid
+erDiagram
+    USER ||--o{ DIAGNOSIS : has
+    USER ||--o{ LIKE : creates
+    USER ||--o{ PINPOINT : owns
+    USER ||--o{ SEARCH_HISTORY : performs
+
+    NOTICE ||--o{ NOTICE_COMPLEX : contains
+    COMPLEX ||--o{ NOTICE_COMPLEX : included_in
+    COMPLEX ||--o{ UNIT_TYPE : has
+    COMPLEX ||--o{ FACILITY : near
+
+    LIKE }o--|| NOTICE : targets
+    LIKE }o--|| COMPLEX : targets
+    LIKE }o--|| UNIT_TYPE : targets
+
+    USER {
+        uuid id PK
+        string name
+        string profile_image_url
+        string oauth_provider
+        string oauth_id
+        datetime created_at
+        datetime updated_at
+    }
+
+    NOTICE {
+        string id PK
+        string title
+        date recruit_start_date
+        date recruit_end_date
+        string region
+        string supply_type
+    }
+
+    COMPLEX {
+        string id PK
+        string name
+        string address
+        string heating
+        int total_households
+    }
+
+    UNIT_TYPE {
+        string id PK
+        string complex_id FK
+        string type_code
+        int area
+        int rent
+        int deposit
+    }
+
+    DIAGNOSIS {
+        uuid id PK
+        uuid user_id FK
+        json diagnosis_result
+        datetime created_at
+    }
+
+    LIKE {
+        uuid id PK
+        uuid user_id FK
+        string target_type
+        string target_id
+    }
+
+    PINPOINT {
+        string id PK
+        uuid user_id
+        string name
+        coordinate location
+        boolean is_first
+    }
+
+    FACILITY {
+        string id PK
+        string complex_id
+        string facility_type
+        array facilities
+    }
+
+    SEARCH_HISTORY {
+        string id PK
+        uuid user_id
+        string keyword
+        json filters
+        datetime created_at
+    }
+
+    NOTICE_COMPLEX {
+        string notice_id FK
+        string complex_id FK
+    }
+```
+
+### MySQL (Relational Data)
+
+**User 테이블**
+- 사용자 기본 정보 (이름, 프로필 이미지, OAuth 정보)
+- 진단 결과와 1:N 관계
+- 좋아요와 1:N 관계
+
+**Complex 테이블**
+- 임대주택 단지 정보
+- Notice와 N:M 관계 (하나의 공고에 여러 단지)
+- UnitType과 1:N 관계
+
+**Notice 테이블**
+- 청약 공고 정보
+- 모집 기간, 당첨자 발표일, 계약일 등
+
+**Diagnosis 테이블**
+- 청약 진단 결과 저장
+- 사용자 소득, 자산, 가족 구성원 정보
+
+**Like 테이블**
+- 사용자별 좋아요 정보
+- 공고, 단지, 방 타입 구분
+
+### MongoDB (Document-based Data)
+
+**PinPoint Collection**
+- 사용자의 관심 위치 정보
+- Kakao Local API를 통한 좌표 데이터
+- 즐겨찾기(first) 여부
+
+**SearchHistory Collection**
+- 사용자별 검색 기록
+- 검색 키워드, 필터 조건, 타임스탬프
+
+**Facility Collection**
+- 단지 주변 시설 정보
+- 카테고리별 시설 목록
+
+### Redis (Cache & Session)
+
+- **JWT Refresh Token**: 토큰 갱신용 리프레시 토큰 저장
+- **TempUserInfo**: OAuth2 인증 후 회원가입 전 임시 사용자 정보
+
+---
+
+## 📁 프로젝트 구조
+
+```
+server/
+├── src/
+│   ├── main/
+│   │   ├── java/com/pinHouse/server/
+│   │   │   ├── core/                      # 공통 관심사
+│   │   │   │   ├── aop/                   # @CheckLogin AOP
+│   │   │   │   ├── config/                # Swagger, DB 설정
+│   │   │   │   ├── exception/             # 예외 처리
+│   │   │   │   ├── response/              # 표준 응답
+│   │   │   │   └── util/                  # 유틸리티
+│   │   │   ├── security/                  # 보안 및 인증
+│   │   │   │   ├── auth/                  # OAuth2 처리
+│   │   │   │   ├── jwt/                   # JWT 토큰
+│   │   │   │   ├── oauth2/                # OAuth2 설정
+│   │   │   │   └── config/                # Security 설정
+│   │   │   └── platform/                  # 비즈니스 도메인
+│   │   │       ├── user/                  # 사용자
+│   │   │       ├── housing/               # 주택 정보
+│   │   │       │   ├── complex/           # 단지
+│   │   │       │   ├── notice/            # 공고
+│   │   │       │   └── facility/          # 주변시설
+│   │   │       ├── diagnostic/            # 청약 진단
+│   │   │       │   ├── diagnosis/
+│   │   │       │   ├── school/
+│   │   │       │   └── rule/
+│   │   │       ├── pinPoint/              # 핀포인트
+│   │   │       ├── like/                  # 좋아요
+│   │   │       └── search/                # 검색
+│   │   └── resources/
+│   │       ├── application.yml
+│   │       ├── application-local.yml
+│   │       └── application-dev.yml
+│   └── test/                              # 테스트 코드
+├── pinhouse_docker/                       # Docker 설정
+│   └── docker-compose.yml
+├── build.gradle
+├── CLAUDE.md                              # 개발 가이드
+└── README.md
+```
+
+---
+
+## 🔧 주요 구현 사항
+
+### OAuth2 인증 흐름
+
+```mermaid
+sequenceDiagram
+    participant Client
+    participant Backend
+    participant OAuth2 as OAuth2 Provider<br/>(Kakao/Naver)
+    participant Redis
+    participant MySQL
+
+    Client->>Backend: 1. OAuth2 로그인 요청
+    Backend->>OAuth2: 2. 인증 페이지로 리다이렉트
+    OAuth2->>Client: 3. 사용자 동의 후 Authorization Code 반환
+    Client->>Backend: 4. Authorization Code 전달
+    Backend->>OAuth2: 5. Access Token 요청
+    OAuth2->>Backend: 6. Access Token 반환
+    Backend->>OAuth2: 7. 사용자 정보 요청
+    OAuth2->>Backend: 8. 사용자 정보 반환
+
+    alt 신규 사용자
+        Backend->>Redis: 9. 임시 사용자 정보 저장 (tempUserKey)
+        Backend->>Client: 10. tempUserKey 반환
+        Client->>Backend: 11. 회원가입 요청 (tempUserKey + 추가 정보)
+        Backend->>Redis: 12. 임시 정보 조회
+        Backend->>MySQL: 13. 사용자 생성
+        Backend->>Client: 14. JWT Token 발급 (Access + Refresh)
+    else 기존 사용자
+        Backend->>MySQL: 9. 사용자 조회
+        Backend->>Redis: 10. Refresh Token 저장
+        Backend->>Client: 11. JWT Token 발급 (Access + Refresh)
+    end
+```
+
+### 1. Clean Architecture 적용
+
+**의존성 역전 원칙 (DIP) 준수**
+```java
+// UseCase Interface (Application Layer)
+public interface ComplexUseCase {
+    ComplexDetailResponse getComplex(String id, String pinPointId);
+}
+
+// Service Implementation
+@Service
+@RequiredArgsConstructor
+public class ComplexService implements ComplexUseCase {
+    @Override
+    public ComplexDetailResponse getComplex(String id, String pinPointId) {
+        // 구현
+    }
+}
+
+// Controller는 UseCase 인터페이스에 의존
+@RestController
+@RequiredArgsConstructor
+public class ComplexApi {
+    private final ComplexUseCase complexUseCase;  // 구현이 아닌 인터페이스에 의존
+}
+```
+
+### 2. AOP를 통한 인증 처리
+
+```java
+@CheckLogin  // 커스텀 어노테이션
+@GetMapping("/mypage")
+public ApiResponse<MyPageResponse> getMyPage(
+    @AuthenticationPrincipal PrincipalDetails principalDetails
+) {
+    UUID userId = principalDetails.getId();
+    // 비즈니스 로직
+}
+```
+
+**LoginCheckAspect**가 `@CheckLogin` 메서드 호출 전에 인증 여부를 자동 검증합니다.
+
+### 3. 다층 데이터베이스 전략
+
+**MySQL** - 정형 데이터 (JPA)
+```java
+@Entity
+@Table(name = "users")
+public class User extends BaseTimeEntity {
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private UUID id;
+
+    @OneToMany(mappedBy = "user")
+    private List<Diagnosis> diagnoses;
+}
+```
+
+**MongoDB** - 비정형 데이터
+```java
+@Document(collection = "pinpoints")
+public class PinPointDocument {
+    @Id
+    private String id;
+
+    private Coordinate coordinate;  // Nested Document
+    private List<String> tags;      // 유연한 스키마
+}
+```
+
+**Redis** - 세션 및 캐싱
+```java
+@RedirectAttributes
+public void saveRefreshToken(UUID userId, String refreshToken) {
+    redisTemplate.opsForValue()
+        .set("RT:" + userId, refreshToken, 7, TimeUnit.DAYS);
+}
+```
+
+### 4. 복잡한 규칙 엔진 구현
+
+**Chain of Responsibility 패턴을 활용한 청약 자격 판단**
+
+```java
+public interface DiagnosisRule {
+    boolean matches(RuleCriteria criteria);
+    DiagnosisResult apply(UserInfo userInfo);
+}
+
+@Component
+public class RuleChain {
+    private final List<DiagnosisRule> rules;
+
+    public DiagnosisResult diagnose(UserInfo userInfo, RuleCriteria criteria) {
+        return rules.stream()
+            .filter(rule -> rule.matches(criteria))
+            .findFirst()
+            .map(rule -> rule.apply(userInfo))
+            .orElse(DiagnosisResult.notEligible());
+    }
+}
+```
+
+### 5. 효율적인 페이지네이션
+
+**Cursor 기반 무한 스크롤**
+```java
+public record SliceRequest(
+    int page,
+    int size
+) {
+    public Pageable toPageable() {
+        return PageRequest.of(page, size + 1);  // N+1 조회
+    }
+}
+
+public record SliceResponse<T>(
+    List<T> content,
+    boolean hasNext
+) {
+    public static <T> SliceResponse<T> from(Page<T> page) {
+        boolean hasNext = page.getContent().size() > page.getSize();
+        List<T> content = hasNext
+            ? page.getContent().subList(0, page.getSize())
+            : page.getContent();
+        return new SliceResponse<>(content, hasNext);
+    }
+}
+```
+
+### 6. 표준화된 API 응답
+
+```java
+public record ApiResponse<T>(
+    boolean success,
+    T data,
+    ErrorResponse error
+) {
+    public static <T> ApiResponse<T> ok(T data) {
+        return new ApiResponse<>(true, data, null);
+    }
+
+    public static <T> ApiResponse<T> error(ErrorCode errorCode) {
+        return new ApiResponse<>(false, null,
+            new ErrorResponse(errorCode.getCode(), errorCode.getMessage()));
+    }
+}
+```
+
+### 7. 대중교통 경로 정보 최적화
+
+**TransitInfoResponse** - 전체 경로 정보와 구간별 정보 분리
+```java
+public record TransitInfoResponse(
+    String totalTime,              // "약 1시간 23분"
+    Integer totalTimeMinutes,      // 83
+    Double totalDistance,          // 39.6 (km)
+    List<SegmentResponse> segments // 구간별 상세 정보
+) {}
+```
+
+이를 통해 중복 데이터를 제거하고 API 응답 크기를 최적화했습니다.
+
+---
+
+## ⚡️ 성능 최적화
+
+### 1. 다층 데이터베이스 전략
+- **MySQL**: 정형화된 트랜잭션 데이터
+- **MongoDB**: 복잡한 검색 쿼리 및 유연한 스키마
+- **Redis**: 세션 캐싱으로 DB 부하 감소
+
+### 2. 커서 기반 페이지네이션
+- Offset 방식 대신 Cursor 기반 무한 스크롤 구현
+- 대량 데이터 조회 시 성능 최적화 (O(n) → O(1))
+
+### 3. DTO 최적화
+- Java Record 타입으로 불변 객체 생성
+- 중복 데이터 제거 (TransitInfoResponse 구조 개선)
+
+### 4. N+1 문제 해결
+- JPA Fetch Join 및 EntityGraph 활용
+- 연관 관계 데이터 한 번에 조회
+
+### 5. AOP를 통한 횡단 관심사 분리
+- `@CheckLogin` 어노테이션으로 인증 로직 중복 제거
+- 비즈니스 로직에 집중 가능
+
+---
+
+## 🔒 보안
+
+### 인증 및 인가
+- **JWT 기반 인증**: Stateless 인증으로 확장성 확보
+- **Refresh Token**: Redis에 저장하여 보안 강화
+- **OAuth2**: 소셜 로그인으로 패스워드 관리 부담 제거
+
+### 보안 설정
+- **CORS 설정**: 허용된 도메인만 API 접근 가능
+- **HTTPS**: Nginx + Certbot으로 SSL/TLS 적용
+- **SQL Injection 방지**: JPA Prepared Statement 사용
+
+---
+
+## 🔄 CI/CD
+
+### GitHub Actions Workflows
+
+**1. CI Test (`ci-test.yml`)**
+- **트리거**: Pull Request to `develop`
+- **작업**:
+  - MySQL, Redis, MongoDB 서비스 컨테이너 실행
+  - `./gradlew clean build` 실행 (테스트 포함)
+  - JUnit 테스트 결과 발행
+
+**2. Dev Deployment (`dev-ci-cd.yml`)**
+- **트리거**: Push to `develop`
+- **작업**:
+  - Docker 이미지 빌드
+  - Dev 서버 배포
+
+### 개발 워크플로우
+
+```
+feature/* → PR → develop (CI Test) → merge → develop (Deploy to Dev)
+```
+
+---
+
+## 📸 스크린샷 (Screenshots)
+
+> 📝 **Note**: 실제 프로젝트 스크린샷을 추가하면 포트폴리오 효과가 극대화됩니다.
+> - Swagger API 문서 화면
+> - 시스템 모니터링 대시보드
+> - 데이터베이스 ERD 다이어그램
+> - 주요 기능 동작 화면
+
+---
+
+## 👥 개발 팀
+
+**Backend Team**
+- Spring Boot, Clean Architecture, Multi-Database Design
+- OAuth2, JWT 인증/인가 구현
+- 복잡한 비즈니스 로직 설계 (청약 진단 규칙 엔진)
+- Odsay API 연동 및 대중교통 경로 최적화
+- Kakao Local API를 활용한 좌표 변환 시스템
+
+---
+
+## 📄 라이센스
+
+이 프로젝트는 MIT 라이센스를 따릅니다.
+
+---
+
+## 📞 문의
+
+프로젝트에 대한 질문이나 제안이 있으시면 이슈를 등록해주세요.
+
+**Repository**: [PinHouse GitHub](https://github.com/PinHouse/PinHouse_BE)
+
+---
+
+<div align="center">
+
+**Built with ❤️ by PinHouse Team**
+
+</div>
diff --git a/src/main/java/com/pinHouse/server/platform/housing/complex/application/dto/result/SubwayLineType.java b/src/main/java/com/pinHouse/server/platform/housing/complex/application/dto/result/SubwayLineType.java
index 42a7465..945a853 100644
--- a/src/main/java/com/pinHouse/server/platform/housing/complex/application/dto/result/SubwayLineType.java
+++ b/src/main/java/com/pinHouse/server/platform/housing/complex/application/dto/result/SubwayLineType.java
@@ -23,44 +23,45 @@ public enum SubwayLineType {
     SEOUL_LINE_7(7, "수도권 7호선", "#69702D"),
     SEOUL_LINE_8(8, "수도권 8호선", "#E5046C"),
     SEOUL_LINE_9(9, "수도권 9호선", "#CEA43A"),
+
     GTX_A(91, "GTX-A", "#9A6292"),
     AIRPORT(101, "공항철도", "#3CA8EA"),
-    MAGLEV(102, "자기부상철도", "#BBBBBB"),
+    MAGLEV(102, "자기부상철도", "#8FC31F"),
     GYEONGUI_JUNGANG(104, "경의중앙선", "#69CCCC"),
     EVERLINE(107, "에버라인", "#6CAB2A"),
-    GYEONGCHUN(108, "경춘선", "#BBBBBB"),
+    GYEONGCHUN(108, "경춘선", "#0C8E72"),
     SINBUNDANG(109, "신분당선", "#C12B2F"),
     UIJEONGBU(110, "의정부경전철", "#DF7503"),
-    GYEONGGANG(112, "경강선", "#BBBBBB"),
+    GYEONGGANG(112, "경강선", "#003DA5"),
     UISINSEOL(113, "우이신설선", "#AFBF04"),
     SEOHAE(114, "서해선", "#4DA635"),
     GIMPO_GOLDLINE(115, "김포골드라인", "#957326"),
     SUIN_BUNDANG(116, "수인분당선", "#FFCE32"),
-    SILLIM(117, "신림선", "#BBBBBB"),
+    SILLIM(117, "신림선", "#6789CA"),
 
     // 인천
     INCHEON_LINE_1(21, "인천 1호선", "#7EAAD6"),
-    INCHEON_LINE_2(22, "인천 2호선", "#BBBBBB"),
+    INCHEON_LINE_2(22, "인천 2호선", "#F5A200"),
 
     // 대전
-    DAEJEON_LINE_1(31, "대전 1호선", "#BBBBBB"),
+    DAEJEON_LINE_1(31, "대전 1호선", "#007448"),
 
     // 대구
-    DAEGU_LINE_1(41, "대구 1호선", "#BBBBBB"),
-    DAEGU_LINE_2(42, "대구 2호선", "#BBBBBB"),
-    DAEGU_LINE_3(43, "대구 3호선", "#BBBBBB"),
-    DAEGYEONG(48, "대경선", "#BBBBBB"),
+    DAEGU_LINE_1(41, "대구 1호선", "#D93F3F"),
+    DAEGU_LINE_2(42, "대구 2호선", "#00AA80"),
+    DAEGU_LINE_3(43, "대구 3호선", "#F7B500"),
+    DAEGYEONG(48, "대경선", "#4B6CB7"),
 
     // 광주
-    GWANGJU_LINE_1(51, "광주 1호선", "#BBBBBB"),
+    GWANGJU_LINE_1(51, "광주 1호선", "#0094D8"),
 
     // 부산
-    BUSAN_LINE_1(71, "부산 1호선", "#BBBBBB"),
-    BUSAN_LINE_2(72, "부산 2호선", "#BBBBBB"),
-    BUSAN_LINE_3(73, "부산 3호선", "#BBBBBB"),
-    BUSAN_LINE_4(74, "부산 4호선", "#BBBBBB"),
-    DONGHAE(78, "동해선", "#BBBBBB"),
-    BUSAN_GIMHAE(79, "부산-김해경전철", "#BBBBBB"),
+    BUSAN_LINE_1(71, "부산 1호선", "#F06A00"),
+    BUSAN_LINE_2(72, "부산 2호선", "#6AC6B8"),
+    BUSAN_LINE_3(73, "부산 3호선", "#CFA32E"),
+    BUSAN_LINE_4(74, "부산 4호선", "#4E67A1"),
+    DONGHAE(78, "동해선", "#005BAC"),
+    BUSAN_GIMHAE(79, "부산-김해경전철", "#875CAC"),
 
     UNKNOWN(-1, "UNKNOWN", "#BBBBBB");