CleanArchitecture - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #golang #go #deep-learning #docker #nodejs #windows #awesome #kubernetes #pytorch #security #mcp #openai

CleanArchitecture

(★ 348)

Kotlin backend based on the Clean Architecture principles. Ktor, JWT, Exposed, Flyway, OpenAPI/REST & KGraphQL/GraphQL generated endpoints, Gradle.

파일 탐색기

최종 버전 다운로드 (.zip)

- - build.gradle.kts
- - build.gradle.kts
- - build.gradle.kts
- - build.gradle.kts
- - build.gradle.kts
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- - build.gradle.kts
- build.gradle.kts
.gitignore
build.gradle.kts
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ESchouten/CleanArchitecture

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd CleanArchitecture

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd adapters/authentication

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Kotlin Clean Architecture Backend

Kotlin backend based on the Clean Architecture principles.

The application is separated into three modules: Domain, Usecases and Adapters

- Domain module contains all entities, it's validation and repository interfaces
- Usecases module performs actions on the domain entities and repositories and does authorization

The domain and usecases modules do not have any external dependencies.

- Adapter layer: each adapter is implemented as a standalone module, lowering dependence on specific frameworks and
  libraries and making them interchangable. The infrastructure module consumes all adapters (e.g. databases, (graphql)
  endpoints, authentication logic)

GraphQL endpoints are auto-generated from the Usecases

##### Technologies:

Ktor, JWT, Exposed, Flyway, OpenAPI/REST & KGraphQL/GraphQL generated endpoints, Gradle.

![image](https://miro.medium.com/max/800/1*0R0r00uF1RyRFxkxo3HVDg.png)

## OpenAPI REST

Docs URL: http://localhost:8080/docs

API definitions: http://localhost:8080/openapi.json

## GraphQL

Playground URL: http://localhost:8080/graphql

### Login

```
query Login {
  LoginUser(a0: { email: "erik@erikschouten.com", password: "P@ssw0rd!" })
}
```

### Retrieve current user

```
query CurrentUser {
  AuthenticatedUser {
    id
    email
    authorities
  }
}
```

##### HTTP Headers

```
{
  "Authorization": "Bearer [TOKEN FROM LOGIN]"
}
```

### Create new user

```
mutation CreateUser {
  CreateUser(
    a0: {
      email: "calvin@erikschouten.com"
      password: "Penait1!"
      authorities: [USER]
    }
  ) {
    id
    email
    authorities
  }
}
```

##### HTTP Headers

```
{
  "Authorization": "Bearer [TOKEN FROM LOGIN]"
}
```