From c960ab2304b0027321bb1be923243d4c9a4524d6 Mon Sep 17 00:00:00 2001
From: Jisu Lim <69844138+Ji-soo708@users.noreply.github.com>
Date: Sat, 1 Feb 2025 21:32:41 +0900
Subject: [PATCH] =?UTF-8?q?[YS-242]=20docs:=20README.md=20=EC=97=85?=
 =?UTF-8?q?=EB=8D=B0=EC=9D=B4=ED=8A=B8=20(#74)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: update README.md

* docs: update README.md

* docs: update image

* docs: update with correct package name

---------

Co-authored-by: Sujung Shin <113707388+chock-cho@users.noreply.github.com>
---
 README.md | 95 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 94 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 98d724f6..6ecf61a2 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,94 @@
-# 25th-Web-Team-2-BE
+# Gradmeet 🔬
+
+
+## 📎 Architecture
+<img width="850" alt="architecture" src="https://github.com/user-attachments/assets/8d88b127-eceb-4310-a11f-2e510f9b60a1" />
+
+<br>
+
+## ✨ Tech Stack
+
+| IDE | IntelliJ                         |
+|:---|:---------------------------------|
+| Language | Kotlin                           |
+| Framework | Spring Boot 3.4.1, Gradle        |
+| Authentication | Spring Security, JSON Web Tokens |
+| Orm | Spring Data JPA                  |
+| Database | MariaDB                          |
+| External | Nginx, Docker, Redis             |
+| CI/CD | Github Action                    |
+| API Docs | Swagger                          |
+
+<br>
+
+
+## 📦 Package Structure
+
+### domain: 도메인 계층
+
+```text
+- 비즈니스 로직을 처리하는 핵심 도메인 객체들 (model)
+- 도메인 객체의 영속성 및 외부 시스템과의 인터페이스 (gateway)
+```
+
+|             | presentation | infrastructure | application | util | domain |
+|-------------|---|---------|------|---------|--------|
+| 의존 가능 여부 | - | -       | -    | O       | -      |
+
+### util: 유틸 패키지
+
+```text
+- 비즈니스 로직과 직접적인 관련이 없는 공통적인 기능을 제공하는 유틸리티 클래스
+- TsidUtils 등
+```
+
+|             | presentation | infrastructure | application | util | domain |
+|-------------|---|---------|------|---------|--------|
+| 의존 가능 여부 | - | -       | -    | -       | -      |
+
+### application: 응용 서비스/UseCase 계층
+
+```text
+- 비즈니스 로직을 수행하는 서비스 및 유즈케이스 구현
+- 도메인 객체를 활용하여 애플리케이션의 주요 동작을 처리
+```
+
+|             | presentation | infrastructure | application | util | domain |
+|-------------|---|---------|------|---------|--------|
+| 의존 가능 여부 | - | -       | -    | O       | O      |
+
+
+### infrastructure : 외부 통신 계층
+
+```text
+- DB, 외부 API 등 외부 시스템과의 연결을 담당하는 계층
+- JPA Repository, FeignClient, S3, Redis 등의 **구현체**가 위치
+- 도메인 계층과 직접 연결되지 않고 gateway(인터페이스)를 통해 접근
+```
+
+|             | presentation | infrastructure | application | util | domain |
+|-------------|---|---------|------|---------|--------|
+| 의존 가능 여부 | - | -       | -    | O       | O      |
+
+### presentation : 요청 처리 계층
+
+```text
+- 클라이언트의 요청을 받아 응답을 반환하는 역할
+- 비즈니스 로직을 직접 수행하지 않고 application 계층을 호출하여 처리
+- Controller, Request/Response DTO, ExceptionHandler 등이 위치
+```
+
+|             | presentation | infrastructure | application | util | domain |
+|-------------|---|---------|-------------|---------|--------|
+| 의존 가능 여부 | - | -       | O           | O       | O      |
+
+<br>
+
+## 👩🏻‍💻 Contributors
+<div>
+
+|                  [@Ji-soo708](https://github.com/Ji-soo708)                  |                                       [@chock-cho](https://github.com/chock-cho)                                        |
+|:----------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------:|
+| <img width="300" src="https://avatars.githubusercontent.com/u/69844138?v=4"> | <img width="300" src="https://avatars.githubusercontent.com/u/113707388?v=4"> |
+
+</div>