Skip to content

Commit 5a67fd0

Browse files
Copilotjustinyoo
Copilot
and
justinyoo
committed
Complete Korean localization of Java documentation with all missing sections
Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com>
1 parent 2a49e03 commit 5a67fd0

1 file changed

Lines changed: 121 additions & 0 deletions

File tree

‎localisation/ko/docs/03-java.md‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,127 @@ Python 개발자가 회사를 떠났기 때문에, 이해관계자들은 기존
3333
1. 모델을 `GPT-4.1` 또는 `Claude Sonnet 4` 중 하나로 선택하세요.
3434
1. [MCP 서버](./00-setup.md#mcp-서버-설정)를 구성했는지 확인하세요.
3535

36+
### 커스텀 지시사항 준비
37+
38+
1. `$REPOSITORY_ROOT` 환경 변수를 설정하세요.
39+
40+
```bash
41+
# bash/zsh
42+
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
43+
```
44+
45+
```powershell
46+
# PowerShell
47+
$REPOSITORY_ROOT = git rev-parse --show-toplevel
48+
```
49+
50+
1. 커스텀 지시사항을 복사하세요.
51+
52+
```bash
53+
# bash/zsh
54+
cp -r $REPOSITORY_ROOT/docs/custom-instructions/java/. \
55+
$REPOSITORY_ROOT/.github/
56+
```
57+
58+
```powershell
59+
# PowerShell
60+
Copy-Item -Path $REPOSITORY_ROOT/docs/custom-instructions/java/* `
61+
-Destination $REPOSITORY_ROOT/.github/ -Recurse -Force
62+
```
63+
64+
### Spring Boot 프로젝트 준비
65+
66+
1. `Claude Sonnet 4` 또는 `GPT-4.1` 모델과 함께 GitHub Copilot 에이전트 모드를 사용하고 있는지 확인하세요.
67+
1. `context7` MCP 서버가 실행 중인지 확인하세요.
68+
1. Spring Boot CLI를 설치하세요.
69+
70+
```bash
71+
sdk install springboot
72+
```
73+
74+
1. 아래와 같은 프롬프트를 사용하여 Spring Boot 앱 프로젝트를 스캐폴드하세요.
75+
76+
```text
77+
I'd like to scaffold a Spring Boot app. Follow the instructions below.
78+
79+
- Use context7.
80+
- Your working directory is `java`.
81+
- Identify all the steps first, which you're going to do.
82+
- Use Spring Boot CLI to create the Spring Boot app project.
83+
- Use Gradle as the Java package manager.
84+
- Use the package name of `com.contoso.socialapp`.
85+
- Use the artifact ID of `socialapp`.
86+
- Use the group ID of `com.contoso`.
87+
- Use the package type of `jar`.
88+
- Use OpenJDK version of `21`.
89+
- Add dependencies - `Spring Web`, `Spring Boot Actuator` and `Lombok`.
90+
- Use the port number of `8080`.
91+
- Make sure to allow CORS from everywhere.
92+
- Build the Spring Boot app and verify if the app is built properly.
93+
- Run this Spring Boot app and verify if the app is running properly.
94+
- If either building or running the app fails, analyze the issues and fix them.
95+
```
96+
97+
1. GitHub Copilot의 ![the "keep" button image](https://img.shields.io/badge/keep-blue) 버튼을 클릭하여 변경사항을 적용하세요.
98+
99+
### FastAPI API 앱 마이그레이션
100+
101+
1. `Claude Sonnet 4` 또는 `GPT-4.1` 모델과 함께 GitHub Copilot 에이전트 모드를 사용하고 있는지 확인하세요.
102+
1. `context7` MCP 서버가 실행 중인지 확인하세요.
103+
1. [`product-requirements.md`](../product-requirements.md)와 [`openapi.yaml`](../openapi.yaml)을 GitHub Copilot에 추가하세요.
104+
1. 아래와 같은 프롬프트를 사용하여 FastAPI를 Spring Boot로 마이그레이션하세요.
105+
106+
```text
107+
Now, we're migrating the existing FastAPI-based API app to Spring Boot API app. Follow the instructions below for the migration.
108+
109+
- Use context7.
110+
- The existing FastAPI application is located at `python`.
111+
- Your working directory is `java/socialapp`.
112+
- Identify all the steps first, which you're going to do.
113+
- Analyze the application structure of the existing FastAPI app.
114+
- Migrate all the endpoints. Both corresponding endpoints should be exactly the same as each other.
115+
- Use SQLite as the database.
116+
- Use `sns_api.db` as the name of the SQLite database.
117+
- The database should always be initialized whenever starting the app.
118+
- Use `openapi.yaml` that describes all the endpoints and data schema.
119+
- The API application should render Swagger UI page through a default endpoint.
120+
- The API application should render exactly the same OpenAPI document through a default endpoint.
121+
- DO NOT add anything not defined in `openapi.yaml`.
122+
- DO NOT modify anything defined in `openapi.yaml`.
123+
- If necessary, add more packages for OpenAPI and Swagger UI.
124+
```
125+
126+
1. GitHub Copilot의 ![the "keep" button image](https://img.shields.io/badge/keep-blue) 버튼을 클릭하여 변경사항을 적용하세요.
127+
1. 마이그레이션이 완료되면, 아래와 같은 프롬프트를 사용하여 마이그레이션 결과를 확인하세요.
128+
129+
```text
130+
I'd like to build the Spring Boot app. Follow the instructions.
131+
132+
- Use context7.
133+
- Build the Spring Boot app and verify if the app is built properly.
134+
- If building the app fails, analyze the issues and fix them.
135+
```
136+
137+
> **참고**:
138+
>
139+
> - 빌드가 성공할 때까지 이 단계를 반복하세요.
140+
> - 빌드가 계속 실패하면, 오류 메시지를 확인하고 GitHub Copilot 에이전트에 문의하여 해결하세요.
141+
142+
1. GitHub Copilot의 ![the "keep" button image](https://img.shields.io/badge/keep-blue) 버튼을 클릭하여 변경사항을 적용하세요.
143+
144+
### Spring Boot 백엔드 앱 검증
145+
146+
1. 애플리케이션이 빌드되면, 제대로 작성되었는지 확인하세요.
147+
148+
```text
149+
Run the Spring Boot app and verify if the app is properly running by checking all the endpoints. Also verify the OpenAPI endpoint renders exactly the same content as `openapi.yaml`.
150+
151+
If app running fails, analyze the issues and fix them. Use context7.
152+
```
153+
154+
1. 웹 브라우저를 열고 `http://localhost:8080`으로 이동하세요.
155+
1. GitHub Copilot의 ![the "keep" button image](https://img.shields.io/badge/keep-blue) 버튼을 클릭하여 변경사항을 적용하세요.
156+
36157
---
37158
38159
좋습니다. "Java" 단계를 완료했습니다. [STEP 04: JavaScript에서 .NET으로 마이그레이션](./04-dotnet.md)로 이동하겠습니다.

0 commit comments

Comments
 (0)