docs: restore missing contents and align canonical stage names across docs

This commit is contained in:
2026-07-17 13:35:29 +09:00
parent f3c003fdf3
commit c8ed4742d0
11 changed files with 201 additions and 300 deletions
+2 -2
View File
@@ -4,9 +4,9 @@
## 📖 실습 상세 분석 및 가이드 안내
학습의 일관성을 위해, 이 실습의 상세 분석 및 개념 명세는 통합 교재 문서**[docs/MANUSCRIPT.md](file:///home/godopu16/PuKi/lab/canary_projects/grpccanary/docs/MANUSCRIPT.md)**로 통합되었습니다.
학습의 일관성을 위해, 이 실습의 상세 분석 및 개념 명세는 통합 교재의 gRPC 심화 가이드**[docs/GRPC.md](../../docs/GRPC.md)**로 모듈화되어 있습니다. 전체 학습 로드맵은 [docs/MANUSCRIPT.md](../../docs/MANUSCRIPT.md)를 참고하십시오.
[docs/MANUSCRIPT.md](file:///home/godopu16/PuKi/lab/canary_projects/grpccanary/docs/MANUSCRIPT.md) 문서의 **"5. 실습: gRPC 기반 서비스 구현 및 컴파일"** 절에서 다음 내용을 참고하실 수 있습니다:
[docs/GRPC.md](../../docs/GRPC.md) 문서에서 다음 내용을 참고하실 수 있습니다:
* **IDL (`protoapi.proto`) 명세 및 필드 분석**
* **Go에서의 `protoc` 설치 및 Stub 파일 컴파일 방법**
* **gRPC 서버 코드 ([server.go](./server.go)) 구현 상세 분석**
+25
View File
@@ -0,0 +1,25 @@
# examples/httpentity 실습 설명서
본 디렉토리는 Go 언어 웹 프레임워크인 Gin(`gin-gonic`)을 활용한 HTTP 웹 API 서버 실습 예제를 포함하고 있습니다.
## 📖 실습 상세 분석 및 가이드 안내
이 실습에 대한 상세한 코드 구조 설명과 Gin 라우터 설계 이론은 심화 학습 문서인 **[docs/HTTP.md](../../docs/HTTP.md)**에서 상세히 기술되어 있습니다.
[docs/HTTP.md](../../docs/HTTP.md) 문서에서 다음 내용을 공부할 수 있습니다:
* **HTTP 프로토콜 및 REST API 기본 구조**
* **Gin 웹 프레임워크의 라우터 매핑 (`gin.Default()` vs `gin.New()`)**
* **API 라우터와 정적 웹 리소스 서빙 우회 설계 패턴**
---
## 🚀 빠른 실행 방법
이 예제는 리포지토리 루트의 `examples/main.go`를 통해 실행됩니다.
1. 리포지토리 루트의 `examples/main.go`를 엽니다.
2. `main()` 함수 내에서 `httpentity` API 호출 주석을 해제합니다. (현재 주석 상태로, 추후 구현 완성을 위한 예제 뼈대 파일입니다.)
3. 리포지토리 루트에서 다음 명령어를 실행합니다:
```bash
go run ./examples
```
+25
View File
@@ -0,0 +1,25 @@
# examples/jsonexample 실습 설명서
본 디렉토리는 Go 언어 표준 라이브러리(`encoding/json`)를 활용한 JSON 데이터 직렬화 및 역직렬화 실습 예제를 포함하고 있습니다.
## 📖 실습 상세 분석 및 가이드 안내
이 실습에 대한 상세한 코드 해설과 구조체 태그 매핑 원리는 심화 학습 문서인 **[docs/JSON.md](../../docs/JSON.md)**에서 상세히 기술되어 있습니다.
[docs/JSON.md](../../docs/JSON.md) 문서에서 다음 내용을 공부할 수 있습니다:
* **Go 구조체와 JSON 필드 매핑 및 필드 노출 대소문자 규칙**
* **Go `Marshal``Unmarshal` 함수 동작 메커니즘**
* **동적 맵 구조(`map[string]interface{}`)의 직렬화 실습 분석**
---
## 🚀 빠른 실행 방법
이 예제는 리포지토리 루트의 `examples/main.go`를 통해 실행됩니다.
1. 리포지토리 루트의 `examples/main.go`를 엽니다.
2. `main()` 함수 내에서 `jsonexample.JsonParsingExample()`의 주석을 해제합니다.
3. 리포지토리 루트에서 다음 명령어를 실행합니다:
```bash
go run ./examples
```