feat: chapter19

_chapter19/section79/.air.toml

@@ -0,0 +1,43 @@
+root = '.'
+tmp_dir = 'tmp'
+
+[build]
+cmd = "go build -o ./tmp/main ." #Go 프로젝트를 빌드
+bin = "./tmp/main"                 #빌드된 실행 파일 경로
+#실행 파일 실행 시 필요한 환경 변수와 인자 설정 -> 80번 포트 사용하도록 인수 지정
+full_bin = "APP_ENV=dev APP_USER=air ./tmp/main 80"
+
+# 파일 변경 감지 설정 -> 변경을 감지할 파일 확장자
+include_ext = ["go", "tpl", "tmpl", "html"]
+# 감지하지 않을 디렉터리 목록
+exclude_dir = ["assets", "tmp", "vendor", "frontend/node_modules", "_tools", "cert", "testutil"]
+include_dir = []
+exclude_file = []
+exclude_regex = ["_test.go"]
+exclude_unchanged = true
+exclude_underscore = false
+follow_symlink = false
+
+#로깅 설정 : 로그파일 경로, 파일 변경 감지 후 재빌드 대기 시간
+log = "air.log"
+delay = 1000
+
+#오류 처리 설정
+stop_on_error = true
+send_interrupt = false
+kill_delay = 500
+
+[log]
+time = false
+
+[color]
+#로그 출력 시 사용할 색상 설정
+main = "magenta"
+watcher = "cyan"
+build = "yellow"
+runner = "green"
+
+#프로그램 종료 시 임시 디렉터리 삭제 여부
+[misc]
+clean_on_exit = true
+

_chapter19/section79/.dockerignore

@@ -0,0 +1,2 @@
+.git
+.DS_Store

_chapter19/section79/.golangci.yml

@@ -0,0 +1,19 @@
+linters-settings:
+  gocyclo:
+    min-complexity: 30
+  misspell:
+    locale: US
+
+linters:
+  disable-all: true
+  enable:
+    - goimports
+    - unused
+    - errcheck
+    - gocognit
+    - gocyclo
+    - gofmt
+    - govet
+    - misspell
+    - staticcheck
+    - whitespace

_chapter19/section79/.octocov.yml

@@ -0,0 +1,20 @@
+coverage:
+  paths:
+    - coverage.out
+codeToTestRatio:
+  code:
+    - '**/*.go'
+    - '!**/*_test.go'
+  test:
+    - '**/*_test.go'
+testExecutionTime:
+  if: true
+diff:
+  datastores:
+    - artifact://${GITHUB_REPOSITORY}
+comment:
+  if: is_pull_request
+report:
+  if: is_default_branch
+  datastores:
+    - artifact://${GITHUB_REPOSITORY}

_chapter19/section79/Dockerfile

@@ -0,0 +1,43 @@
+#최종 배포할 실행 파일 만드는 과정
+#multi-stage build에서 이 단계의 이름을 'deploy-builder'로 지정
+FROM golang:1.23.1-bullseye AS deploy-builder
+
+#app 디렉토리 생성 및 작업 디렉토리로 설정
+WORKDIR /app
+
+#종속성 파일(go.mod go.sum)만 복사해서 캐시 활용
+#소스코드가 변경되어도 종속성이 변경되지 않았다면 도커의 캐시 활용
+COPY go.mod go.sum ./
+#프로젝트의 모든 종속성 다운로드
+RUN go mod download
+
+#전체 소스 파일을 /app으로 복사하고 최적화된 바이너리 생성
+COPY . .
+RUN go build -trimpath -ldflags="-w -s" -o app
+
+# 최종 배포 단계 : 실제 운영 환경에서 실행될 최소한의 이미지 생성
+#경량화된 Degian 이미지 사용
+FROM debian:bullseye-slim AS deploy
+
+#시스템 패키지 최신화
+RUN apt-get update
+
+#첫 번째 단계에서 만든 실행 파일만 복사
+COPY --from=deploy-builder /app/app .
+
+#컨테이너 시작 시 애플리케이션 자동 실행
+CMD ["./app"]
+
+#개발자의 로컬 환경을 위한 설정
+FROM golang:1.23 AS dev
+
+#/app 디렉토리를 작업공간으로 설정
+WORKDIR /app
+
+#air 도구 설치 (코드 변경 시 자동 재빌드 지원)
+RUN go install github.com/air-verse/air@latest
+
+#개발 서버 자동 시작
+CMD ["air"]
+
+## docker-compose down -v <= 실행중인 컨테이너를 멈추고 매핑된 볼륨들을 제거

_chapter19/section79/Makefile

@@ -0,0 +1,38 @@
+.PHONY: help build build-local up down logs ps test dry-migrate migrate generate
+.DEFAULT_GOAL := help
+
+DOCKER_TAG := latest
+build: ## Build the docker image
+	docker build -t gleaming9/go_todo_app:${DOCKER_TAG} \
+ 		--target deploy ./
+
+build-local: ## Build the docker image for local development
+	docker compose build --no-cache
+
+up: ## 자동 새로고침을 사용한 도커 컴포즈 실행
+	docker compose up -d
+
+down: ## 도커 컴포즈 종료
+	docker compose down
+
+logs: ## 도커 컴포즈 로그 출력
+	docker compose logs -f
+
+ps: ## 실행중인 컨테이너 확인
+	docker compose ps
+
+test: ## 테스트 실행
+	go test -race -shuffle=on ./...
+
+dry-migrate: ## 마이그레이션 실행 전 미리보기
+	mysqldef -u todo -p todo -h 127.0.0.1 -P 33306 todo --dry-run < ./_tools/mysql/schema.sql
+
+migrate:  ## 마이그레이션 실행
+	mysqldef -u todo -p todo -h 127.0.0.1 -P 33306 todo < ./_tools/mysql/schema.sql
+
+generate: ## Generate codes
+	go generate ./...
+
+help: ## 옵션 보기
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+    		awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

_chapter19/section79/_tools/mysql/conf.d/mysql.cnf

@@ -0,0 +1,2 @@
+[mysql]
+default_character_set=utf8mb4

_chapter19/section79/_tools/mysql/conf.d/mysqld.cnf

@@ -0,0 +1,4 @@
+[mysqld]
+default-authentication-plugin=mysql_native_password
+character_set_server=utf8mb4
+sql_mode=TRADITIONAL,NO_AUTO_VALUE_ON_ZERO,ONLY_FULL_GROUP_BY

_chapter19/section79/_tools/mysql/schema.sql

@@ -0,0 +1,21 @@
+CREATE TABLE `user`
+(
+    `id`       BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '사용자 식별자',
+    `name`     varchar(20) NOT NULL COMMENT '사용자명',
+    `password` VARCHAR(80) NOT NULL COMMENT '패스워드 해시',
+    `role`     VARCHAR(80) NOT NULL COMMENT '역할',
+    `created`  DATETIME(6) NOT NULL COMMENT '레코드 작성 시간',
+    `modified` DATETIME(6) NOT NULL COMMENT '레코드 수정 시간',
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uix_name` (`name`) USING BTREE
+) Engine=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='사용자';
+
+CREATE TABLE `task`
+(
+    `id`       BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '태스크 식별자',
+    `title`    VARCHAR(128) NOT NULL COMMENT '태스크 타이틀',
+    `status`   VARCHAR(20)  NOT NULL COMMENT '태스크 상태',
+    `created`  DATETIME(6) NOT NULL COMMENT '레코드 작성 시간',
+    `modified` DATETIME(6) NOT NULL COMMENT '레코드 수정 시간',
+    PRIMARY KEY (`id`)
+) Engine=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='태스크';

_chapter19/section79/clock/clock.go

@@ -0,0 +1,19 @@
+package clock
+
+import "time"
+
+type Clocker interface {
+	Now() time.Time
+}
+
+type RealClocker struct{}
+
+func (r RealClocker) Now() time.Time {
+	return time.Now()
+}
+
+type FixedClocker struct{}
+
+func (fc FixedClocker) Now() time.Time {
+	return time.Date(2022, 5, 10, 12, 34, 56, 0, time.UTC)
+}

_chapter19/section79/config/config.go

@@ -0,0 +1,24 @@
+package config
+
+import "github.com/caarlos0/env/v6"
+
+// Config 구조체는 애플리케이션 설정을 위한 구조체이다.
+// 환경 변수에서 값을 가져와서 필드를 초기화한다.
+type Config struct {
+	Env        string `env:"TODO_ENV" envDefault:"dev"`
+	Port       int    `env:"PORT" envDefault:"80"`
+	DBHost     string `env:"TODO_DB_HOST" envDefault:"127.0.0.1"`
+	DBPort     int    `env:"TODO_DB_PORT" envDefault:"33306"`
+	DBUser     string `env:"TODO_DB_USER" envDefault:"todo"`
+	DBPassword string `env:"TODO_DB_PASSWORD" envDefault:"todo"`
+	DBName     string `env:"TODO_DB_NAME" envDefault:"todo"`
+}
+
+// New 함수는 Config 구조체를 생성하고 환경 변수를 파싱하여 필드를 초기화
+func New() (*Config, error) {
+	cfg := &Config{} // config 구조체 초기화
+	if err := env.Parse(cfg); err != nil {
+		return nil, err
+	}
+	return cfg, nil
+}

_chapter19/section79/config/config_test.go

@@ -0,0 +1,23 @@
+package config
+
+import (
+	"fmt"
+	"testing"
+)
+
+func TestNeow(t *testing.T) {
+	wantPort := 3333
+	t.Setenv("PORT", fmt.Sprint(wantPort))
+
+	got, err := New()
+	if err != nil {
+		t.Fatalf("cannot create config: %v", err)
+	}
+	if got.Port != wantPort {
+		t.Errorf("want %d, but %d", wantPort, got.Port)
+	}
+	wantEnv := "dev"
+	if got.Env != wantEnv {
+		t.Errorf("want %s, but %s", wantEnv, got.Env)
+	}
+}

_chapter19/section79/docker-compose.yml

@@ -0,0 +1,49 @@
+services:
+
+  # 'app'이라는 이름의 서비스(컨테이너)를 정의
+  app:
+    # 사용할 Docker 이미지 이름 : 'gotodo'
+    image: gotodo
+
+    build:
+      #빌드할 파일들이 있는 위치를 지정 : .. <- 한칸 위 폴더에 go.mod 위치
+      #go_todo_app 폴더를 컨텍스트로 설정
+      context: .
+      dockerfile: Dockerfile
+      # target=dev로 설정하여 Dockerfile의 dev stage를 빌드
+      args:
+        target: dev
+    environment: # 환경 변수 설정
+      TODO_ENV: dev
+      PORT: 8080
+      TODO_DB_HOST: todo-db
+      TODO_DB_PORT: 3306
+      TODO_DB_USER: todo
+      TODO_DB_PASSWORD: todo
+      TODO_DB_NAME: todo
+
+    # 로컬 컴퓨터의 파일과 컨테이너 안의 파일을 연결, 코드 수정 시 바로 컨테이너에 반영
+    volumes:
+      - .:/app # go_todo_app 루트 디렉터리를 컨테이너의 /app에 마운트
+
+    # 컨테이너가 사용할 포트를 지정
+    ports:
+        # 웹 브라우저에서 localhost:18000으로 접속하면 컨테이너의 8080번 포트로 연결
+        # 왼쪽은 내 컴퓨터의 포트, 오른쪽은 컨테이너 안의 포트
+        - "18000:8080"
+  todo-db:
+    image: mysql:8.0.29
+    platform: linux/amd64
+    container_name: todo-db
+    environment:
+      MYSQL_ROOT_PASSWORD: "yes"
+      MYSQL_DATABASE: todo
+      MYSQL_USER: todo
+      MYSQL_PASSWORD: todo
+    volumes:
+      - todo-db-data:/var/lib/mysql
+      - ./_tools/mysql/conf.d:/etc/mysql/conf.d:cached
+    ports:
+        - "33306:3306"
+volumes:
+    todo-db-data:

_chapter19/section79/entity/task.go

@@ -0,0 +1,22 @@
+package entity
+
+import "time"
+
+type TaskID int64
+type TaskStatus string
+
+const (
+	TaskStatusTodo  TaskStatus = "todo"
+	TaskStatusDoing TaskStatus = "doing"
+	TaskStatusDone  TaskStatus = "done"
+)
+
+type Task struct {
+	ID       TaskID     `json:"id" db:"id"`
+	Title    string     `json:"title" db:"title"`
+	Status   TaskStatus `json:"status" db:"status"`
+	Created  time.Time  `json:"created" db:"created"`
+	Modified time.Time  `json:"modified" db:"modified"`
+}
+
+type Tasks []*Task

_chapter19/section79/entity/user.go

@@ -0,0 +1,14 @@
+package entity
+
+import "time"
+
+type UserID int64
+
+type User struct {
+	ID       UserID    `json:"id" db:"id"`
+	Name     string    `json:"name" db:"name"`
+	Password string    `json:"password" db:"password"`
+	Role     string    `json:"role" db:"role"`
+	Created  time.Time `json:"created" db:"created"`
+	Modified time.Time `json:"modified" db:"modified"`
+}

_chapter19/section79/go.mod

@@ -0,0 +1,22 @@
+module go_todo_app
+
+go 1.23.1
+
+require (
+	filippo.io/edwards25519 v1.1.0 // indirect
+	github.com/DATA-DOG/go-sqlmock v1.5.2 // indirect
+	github.com/caarlos0/env/v6 v6.10.1 // indirect
+	github.com/go-chi/chi/v5 v5.1.0 // indirect
+	github.com/go-playground/locales v0.14.1 // indirect
+	github.com/go-playground/universal-translator v0.18.1 // indirect
+	github.com/go-playground/validator v9.31.0+incompatible // indirect
+	github.com/go-sql-driver/mysql v1.8.1 // indirect
+	github.com/google/go-cmp v0.6.0 // indirect
+	github.com/jmoiron/sqlx v1.4.0 // indirect
+	github.com/leodido/go-urn v1.4.0 // indirect
+	github.com/matryer/moq v0.5.0 // indirect
+	golang.org/x/crypto v0.29.0 // indirect
+	golang.org/x/mod v0.22.0 // indirect
+	golang.org/x/sync v0.9.0 // indirect
+	golang.org/x/tools v0.27.0 // indirect
+)