ulflow_phattt2901/zee-solution
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Commit without pre

Browse Source
This commit is contained in:
ulflow_phattt2901 2025-06-06 07:24:26 +07:00
parent 95d68e9481
commit 8a313df9f9
56 changed files with 2135 additions and 2324 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
.env.example
View File

@ -1,32 +0,0 @@
# App Configuration
APP_NAME="ULFlow Starter Kit"
APP_VERSION="0.1.0"
APP_ENVIRONMENT="development"
APP_TIMEZONE="Asia/Ho_Chi_Minh"
# Logger Configuration
LOG_LEVEL="info" # debug, info, warn, error
# Server Configuration
SERVER_HOST="0.0.0.0"
SERVER_PORT=3000
SERVER_READ_TIMEOUT=15
SERVER_WRITE_TIMEOUT=15
SERVER_SHUTDOWN_TIMEOUT=30
# Database Configuration
DB_DRIVER="postgres"
DB_HOST="localhost"
DB_PORT=5432
DB_USERNAME="postgres"
DB_PASSWORD="your_password_here"
DB_NAME="ulflow"
DB_SSLMODE="disable"
# JWT Configuration
JWT_SECRET="your-32-byte-base64-encoded-secret-key-here"
JWT_ACCESS_TOKEN_EXPIRE=15 # in minutes
JWT_REFRESH_TOKEN_EXPIRE=10080 # in minutes (7 days)
JWT_ALGORITHM="HS256"
JWT_ISSUER="ulflow-starter-kit"
JWT_AUDIENCE="ulflow-web"

2
.gitea/hooks/pre-commit
View File

@ -12,7 +12,7 @@ if [[ "$STAGED_GO_FILES" = "" ]]; then
else
# Run golangci-lint on staged files
echo "Running golangci-lint..."
golangci-lint run $STAGED_GO_FILES
golangci-lint run ./...
if [ $? -ne 0 ]; then
echo "golangci-lint failed. Please fix the issues before committing."
exit 1

6
.gitea/workflows/ci.yml
View File

@ -16,7 +16,7 @@ jobs:
- name: Set up Go
uses: actions/setup-go@v5
with:
go-version: '1.23'
go-version: '1.24.3'
cache-dependency-path: go.sum
- name: Lint
@ -58,7 +58,7 @@ jobs:
- name: Set up Go
uses: actions/setup-go@v5
with:
go-version: '1.23'
go-version: '1.24.3'
cache-dependency-path: go.sum
- name: Install go-junit-report
@ -93,7 +93,7 @@ jobs:
- name: Set up Go
uses: actions/setup-go@v5
with:
go-version: '1.23'
go-version: '1.24.3'
cache-dependency-path: go.sum
- name: Build

2
Dockerfile
View File

@ -2,7 +2,7 @@
# Production-ready multi-stage build for server deployment
# Build arguments
ARG GO_VERSION=1.23.6
ARG GO_VERSION=1.24.3
ARG ALPINE_VERSION=3.19
ARG APP_USER=appuser
ARG APP_GROUP=appgroup

4
Dockerfile.local
View File

@ -2,13 +2,13 @@
# Optimized for local development with hot reload
# Build stage
FROM golang:1.23-alpine AS builder
FROM golang:1.24.3-alpine AS builder
# Install necessary tools for development
RUN apk add --no-cache git make gcc libc-dev
# Install Air for hot reload
RUN go install github.com/cosmtrek/air@latest
RUN go install github.com/air-verse/air@latest
# Set working directory
WORKDIR /app

39
Makefile
View File

@ -42,23 +42,14 @@ help:
init:
@echo "Installing project dependencies and tools..."
go mod tidy
go install github.com/cosmtrek/air@latest
go install github.com/air-verse/air@latest
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
@echo "Creating necessary directories..."
mkdir -p tmp
mkdir -p logs
if not exist tmp mkdir tmp
if not exist logs mkdir logs
@echo "Copying .env file if not exists..."
@if not exist .env (
if exist templates\.env.example (
copy templates\.env.example .env
@echo "Created .env file from example"
) else (
@echo "Warning: templates/.env.example not found, skipping .env creation"
)
) else (
@echo ".env file already exists, skipping"
)
@if not exist ".env" (if exist "templates\.env.example" (copy "templates\.env.example" ".env" & echo Created .env file from example) else (echo Warning: Could not create .env file)) else (echo .env file already exists, skipping)
@echo "Initialization complete!"
@ -94,16 +85,16 @@ clean:
# Build Docker image
docker-build:
@echo "Building Docker image..."
docker build -t ulflow-starter-kit:latest .
docker build -t ulflow-zee:latest .
# Run application in Docker container
docker-run:
@echo "Running application in Docker container..."
@if not exist .env (
@echo "Warning: .env file not found. Running with default environment variables..."
docker run -p 3000:3000 ulflow-starter-kit:latest
docker run -p 3000:3000 ulflow-zee:latest
) else (
docker run -p 3000:3000 --env-file .env ulflow-starter-kit:latest
docker run -p 3000:3000 --env-file .env ulflow-zee:latest
)
# Run Docker Compose for local development
@ -132,18 +123,22 @@ docker-compose-prod-down:
setup-git-hooks:
@echo "Setting up Git hooks..."
git config --local commit.template .gitea/commit-template.txt
if not exist .git/hooks mkdir .git/hooks
copy /Y .gitea\hooks\pre-commit .git\hooks\ >nul
copy /Y .gitea\hooks\prepare-commit-msg .git\hooks\ >nul
@REM Kiểm tra và tạo thư mục .git/hooks nếu chưa tồn tại
@if not exist .git\hooks (mkdir .git\hooks)
@REM Sao chép các Git hooks
@echo Copying pre-commit hook...
@copy /Y .gitea\hooks\pre-commit .git\hooks\pre-commit >nul || (echo Warning: Could not copy pre-commit hook & exit /b 1)
@echo Copying prepare-commit-msg hook...
@copy /Y .gitea\hooks\prepare-commit-msg .git\hooks\prepare-commit-msg >nul || (echo Warning: Could not copy prepare-commit-msg hook & exit /b 1)
git config --local core.hooksPath .git/hooks
@echo "Git setup complete!"
# Create git message template
setup-git-message:
@echo "Creating Git commit message template..."
if not exist .gitea mkdir .gitea
mkdir -p .gitea
echo "# <type>: <subject>\n\n# <body>\n\n# <footer>\n\n# Types:\n# feat (new feature)\n# fix (bug fix)\n# docs (documentation changes)\n# style (formatting, no code change)\n# refactor (refactoring code)\n# test (adding tests, refactoring tests)\n# chore (updating tasks etc; no production code change)" > .gitea/commit-template.txt
git config --local commit.template .gitea/commit-template.txt
@echo "Git commit message template created!"

88
Readme.md
View File

@ -11,7 +11,74 @@
## Tổng quan
ULFlow Golang Starter Kit là nền tảng khởi tạo dự án backend cho Team ULFlow, được thiết kế để giúp khởi tạo các dự án trong thời gian ngắn, nhanh chóng mà vẫn đảm bảo các yếu tố cơ bản về kiến trúc, bảo mật và khả năng mở rộng.
Tạo ra một trải nghiệm microsite hấp dẫn nơi người dùng trả lời một loạt câu hỏi để khám phá hồ sơ "vibe" của họ, và có cơ hội giành giải thưởng thông qua vòng quay may mắn, đồng thời thu thập dữ liệu người dùng và quảng bá thương hiệu C2.
### Chức năng chính
#### 1. Quản lý Người dùng và Thông tin Cá nhân
* **Đăng ký thông tin người dùng:**
* API để nhận và lưu trữ thông tin cá nhân (Họ tên, Nam/Nữ, Email) người dùng gửi trước khi bắt đầu quiz[cite: 2].
* **Quản lý chấp thuận T&C:**
* API để ghi nhận việc người dùng đã đồng ý với Điều khoản và Điều kiện của chương trình[cite: 2].
---
#### 2. Xử lý Logic Quiz
* **Cung cấp câu hỏi:**
* API để trả về bộ 5 câu hỏi cho frontend[cite: 2].
* Bao gồm logic để tùy chỉnh câu hỏi dựa trên lựa chọn trước đó (ví dụ: Câu 4 tùy theo lựa chọn ở Câu 3, Câu 5 tùy theo lựa chọn ở Câu 4)[cite: 6, 7, 8, 9, 10].
* **Nhận và xử lý câu trả lời:**
* API để nhận các câu trả lời từ người dùng cho từng câu hỏi.
* **Xác định Profile:**
* Logic backend để phân tích các câu trả lời và xác định 1 trong 6 profile tương ứng cho người dùng.
* **Trả kết quả Profile:**
* API để gửi kết quả profile (1 trong 6 profiles) đã xác định về cho frontend hiển thị[cite: 12].
---
#### 3. Quản lý Vòng quay May mắn và Giải thưởng
* **Xử lý lượt quay:**
* API để frontend gọi khi người dùng thực hiện "vòng quay may mắn"[cite: 12].
* **Logic trúng thưởng:**
* Backend chứa logic để xác định ngẫu nhiên việc người dùng có trúng giải hay không trúng giải[cite: 13].
* **Quản lý giải thưởng:**
* Phân bổ số lượng giải thưởng theo ngày[cite: 14].
* Random giá trị voucher Got it[cite: 14].
* Kiểm tra và cập nhật số lượng voucher còn lại[cite: 16].
* Tích hợp với hệ thống mã voucher/API từ brand team để cấp phát voucher (ZEE check hình voucher + mã voucher/API với brand team)[cite: 15].
* **Thông báo kết quả vòng quay:**
* API để trả về kết quả trúng thưởng (hoặc không) cho frontend.
---
#### 4. Lưu trữ và Truy xuất Dữ liệu
* **Lưu thông tin người chơi:**
* Bao gồm thông tin cá nhân đã đăng ký (Họ tên, Nam/Nữ, Email), các câu trả lời quiz, profile kết quả[cite: 16].
* **Lưu danh sách người trúng giải:**
* Ghi nhận thông tin người chơi đã trúng giải và chi tiết giải thưởng[cite: 16].
* **Thống kê:**
* API để cung cấp số liệu về tổng số người tham gia[cite: 16].
* API để cung cấp thông tin về số lượng voucher còn lại[cite: 16].
---
#### 5. Quản lý Trạng thái Chương trình
* **Kiểm tra thời gian chương trình:**
* Logic để xác định chương trình còn hoạt động (trong 2 tuần) hay đã kết thúc.
* **Chuyển trạng thái sau chương trình:**
* Tự động hoặc có cơ chế để chuyển website sang trạng thái "chương trình đã kết thúc" sau 2 tuần.
* Website sẽ được giữ lại khoảng 3 tháng, thông báo chương trình kết thúc, người dùng không thao tác được và drive traffic về fanpage C2.
---
#### 6. Các Chức năng Hỗ trợ và Quản trị (Admin)
* **Quản lý nội dung (Tùy chọn):**
* API để quản lý nội dung các câu hỏi, T&C, mô tả profile nếu cần thay đổi mà không can thiệp code.
* **Quản lý giải thưởng (Tùy chọn):**
* Giao diện hoặc API cho admin để theo dõi, quản lý danh sách trúng thưởng, số lượng voucher.
* **Bảo mật:**
* Đảm bảo an toàn dữ liệu người dùng và tính toàn vẹn của hệ thống.
* **Logging:**
* Ghi lại các hoạt động quan trọng của hệ thống để theo dõi và gỡ lỗi.
### Đặc điểm chính
@ -26,7 +93,7 @@ ULFlow Golang Starter Kit là nền tảng khởi tạo dự án backend cho Tea
### Yêu cầu hệ thống
- Go 1.23
- Go 1.24.3
- Docker và Docker Compose
- Git
@ -103,22 +170,6 @@ Thành phần kiến trúc chi tiết (U-Hierarchy):
- **ublock**: Thành phần hoạt động độc lập tương đối
- **ubundle**: Tính năng hoàn chỉnh cho người dùng
## Cấu trúc thư mục
```
├── cmd/ # Entry points
├── pkg/ # Packages
│ ├── resource/ # Domain resources (DDD Aggregates)
│ ├── transaction/ # Business workflows
│ ├── adapter/ # External system interfaces
│ ├── helper/ # Utilities
│ └── uiux/ # User interfaces
├── config/ # Configuration
├── docs/ # Documentation
├── scripts/ # Helper scripts
└── test/ # Tests
```
## Các lệnh Makefile
```bash
@ -180,7 +231,6 @@ Xem thêm chi tiết trong [docs/workflow.md](docs/workflow.md).
- [CI/CD Workflows](docs/workflows.md)
- [Testing](docs/testing.md)
- [Adapter](docs/adapter.md)
- [UX](docs/ux.md)
- [Changelog](docs/changelog.md)
## Đóng góp

13
cmd/app/main.go
View File

@ -6,13 +6,14 @@ import (
"os"
"time"
"zee/internal/helper/config"
"zee/internal/helper/database"
"zee/internal/helper/feature"
"zee/internal/helper/logger"
"zee/internal/pkg/lifecycle"
"zee/internal/transport/http"
"gorm.io/gorm"
"starter-kit/internal/helper/config"
"starter-kit/internal/helper/database"
"starter-kit/internal/helper/feature"
"starter-kit/internal/helper/logger"
"starter-kit/internal/pkg/lifecycle"
"starter-kit/internal/transport/http"
)
// HTTPService implements the lifecycle.Service interface for the HTTP server

2
configs/config.yaml
View File

@ -41,7 +41,7 @@ jwt:
# Algorithm for JWT signing (HS256, HS384, HS512, RS256, etc.)
algorithm: "HS256"
# Issuer for JWT tokens
issuer: "ulflow-starter-kit"
issuer: "ulflow-zee"
# Audience for JWT tokens
audience: ["ulflow-web"]

46
coverage
View File

@ -1,24 +1,24 @@
mode: set
starter-kit/internal/transport/http/handler/auth_handler.go:18.63,22.2 1 1
starter-kit/internal/transport/http/handler/auth_handler.go:36.48,38.47 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:38.47,41.3 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:44.2,45.16 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:45.16,47.54 1 1
starter-kit/internal/transport/http/handler/auth_handler.go:47.54,49.4 1 0
starter-kit/internal/transport/http/handler/auth_handler.go:49.9,51.4 1 1
starter-kit/internal/transport/http/handler/auth_handler.go:52.3,52.9 1 1
starter-kit/internal/transport/http/handler/auth_handler.go:56.2,57.42 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:72.45,74.47 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:74.47,77.3 2 0
starter-kit/internal/transport/http/handler/auth_handler.go:80.2,81.16 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:81.16,84.3 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:87.2,95.33 3 0
starter-kit/internal/transport/http/handler/auth_handler.go:109.52,115.47 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:115.47,118.3 2 1
starter-kit/internal/transport/http/handler/auth_handler.go:121.2,122.16 2 0
starter-kit/internal/transport/http/handler/auth_handler.go:122.16,125.3 2 0
starter-kit/internal/transport/http/handler/auth_handler.go:128.2,136.33 3 0
starter-kit/internal/transport/http/handler/auth_handler.go:146.46,149.2 1 0
starter-kit/internal/transport/http/handler/health_handler.go:19.58,25.2 1 1
starter-kit/internal/transport/http/handler/health_handler.go:34.53,55.2 3 1
starter-kit/internal/transport/http/handler/health_handler.go:64.46,70.2 1 1
zee/internal/transport/http/handler/auth_handler.go:18.63,22.2 1 1
zee/internal/transport/http/handler/auth_handler.go:36.48,38.47 2 1
zee/internal/transport/http/handler/auth_handler.go:38.47,41.3 2 1
zee/internal/transport/http/handler/auth_handler.go:44.2,45.16 2 1
zee/internal/transport/http/handler/auth_handler.go:45.16,47.54 1 1
zee/internal/transport/http/handler/auth_handler.go:47.54,49.4 1 0
zee/internal/transport/http/handler/auth_handler.go:49.9,51.4 1 1
zee/internal/transport/http/handler/auth_handler.go:52.3,52.9 1 1
zee/internal/transport/http/handler/auth_handler.go:56.2,57.42 2 1
zee/internal/transport/http/handler/auth_handler.go:72.45,74.47 2 1
zee/internal/transport/http/handler/auth_handler.go:74.47,77.3 2 0
zee/internal/transport/http/handler/auth_handler.go:80.2,81.16 2 1
zee/internal/transport/http/handler/auth_handler.go:81.16,84.3 2 1
zee/internal/transport/http/handler/auth_handler.go:87.2,95.33 3 0
zee/internal/transport/http/handler/auth_handler.go:109.52,115.47 2 1
zee/internal/transport/http/handler/auth_handler.go:115.47,118.3 2 1
zee/internal/transport/http/handler/auth_handler.go:121.2,122.16 2 0
zee/internal/transport/http/handler/auth_handler.go:122.16,125.3 2 0
zee/internal/transport/http/handler/auth_handler.go:128.2,136.33 3 0
zee/internal/transport/http/handler/auth_handler.go:146.46,149.2 1 0
zee/internal/transport/http/handler/health_handler.go:19.58,25.2 1 1
zee/internal/transport/http/handler/health_handler.go:34.53,55.2 3 1
zee/internal/transport/http/handler/health_handler.go:64.46,70.2 1 1

2
docker-compose.yml
View File

@ -50,7 +50,7 @@ services:
- GITEA__database__USER=${DB_USER:-user}
- GITEA__database__PASSWD=${DB_PASSWORD:-password}
ports:
- "3000:3000"
- "3001:3000"
- "2222:22"
volumes:
- gitea-data:/data

209
docs/AUTHENTICATION.md
View File

@ -1,209 +0,0 @@
# Hệ thống Xác thực và Phân quyền
## Mục lục
1. [Tổng quan](#tổng-quan)
2. [Luồng xử lý](#luồng-xử-lý)
- [Đăng nhập](#đăng-nhập)
- [Làm mới token](#làm-mới-token)
- [Đăng xuất](#đăng-xuất)
3. [Các thành phần chính](#các-thành-phần-chính)
- [Auth Middleware](#auth-middleware)
- [Token Service](#token-service)
- [Session Management](#session-management)
4. [Bảo mật](#bảo-mật)
5. [Tích hợp](#tích-hợp)
## Tổng quan
Hệ thống xác thực sử dụng JWT (JSON Web Tokens) với cơ chế refresh token để đảm bảo bảo mật. Mỗi phiên đăng nhập sẽ có:
- Access Token: Có thời hạn ngắn (15-30 phút)
- Refresh Token: Có thời hạn dài hơn (7-30 ngày)
- Session ID: Định danh duy nhất cho mỗi phiên
## Luồng xử lý
### Đăng nhập
```mermaid
sequenceDiagram
participant Client
participant AuthController
participant AuthService
participant TokenService
participant SessionStore
Client->>AuthController: POST /api/v1/auth/login
AuthController->>AuthService: Authenticate(credentials)
AuthService->>UserRepository: FindByEmail(email)
AuthService->>PasswordUtil: CompareHashAndPassword()
AuthService->>TokenService: GenerateTokens(userID, sessionID)
TokenService-->>AuthService: tokens
AuthService->>SessionStore: Create(session)
AuthService-->>AuthController: authResponse
AuthController-->>Client: {accessToken, refreshToken, user}
```
### Làm mới Token
```mermaid
sequenceDiagram
participant Client
participant AuthController
participant TokenService
participant SessionStore
Client->>AuthController: POST /api/v1/auth/refresh
AuthController->>TokenService: RefreshToken(refreshToken)
TokenService->>SessionStore: Get(sessionID)
SessionStore-->>TokenService: session
TokenService->>TokenService: ValidateRefreshToken()
TokenService->>SessionStore: UpdateLastUsed()
TokenService-->>AuthController: newTokens
AuthController-->>Client: {accessToken, refreshToken}
```
### Đăng xuất
```mermaid
sequenceDiagram
participant Client
participant AuthController
participant TokenService
participant SessionStore
Client->>AuthController: POST /api/v1/auth/logout
AuthController->>TokenService: ExtractTokenMetadata()
TokenService-->>AuthController: tokenClaims
AuthController->>SessionStore: Delete(sessionID)
AuthController-->>Client: 200 OK
```
## Các thành phần chính
### Auth Middleware
#### `Authenticate()`
- **Mục đích**: Xác thực access token trong header Authorization
- **Luồng xử lý**:
1. Lấy token từ header
2. Xác thực token
3. Kiểm tra session trong store
4. Lưu thông tin user vào context
#### `RequireRole(roles ...string)`
- **Mục đích**: Kiểm tra quyền truy cập dựa trên vai trò
- **Luồng xử lý**:
1. Lấy thông tin user từ context
2. Kiểm tra user có vai trò phù hợp không
3. Trả về lỗi nếu không có quyền
### Token Service
#### `GenerateTokens(userID, sessionID)`
- Tạo access token và refresh token
- Lưu thông tin session
- Trả về cặp token
#### `ValidateToken(token)`
- Xác thực chữ ký token
- Kiểm tra thời hạn
- Trả về claims nếu hợp lệ
### Session Management
#### `CreateSession(session)`
- Tạo session mới
- Lưu vào Redis với TTL
- Trả về session ID
#### `GetSession(sessionID)`
- Lấy thông tin session từ Redis
- Cập nhật thời gian truy cập cuối
- Trả về session nếu tồn tại
## Bảo mật
1. **Token Storage**
- Access Token: Lưu trong memory (không lưu localStorage)
- Refresh Token: HttpOnly, Secure, SameSite=Strict cookie
2. **Token Rotation**
- Mỗi lần refresh sẽ tạo cặp token mới
- Vô hiệu hóa refresh token cũ
3. **Thu hồi token**
- Đăng xuất sẽ xóa session
- Có thể thu hồi tất cả session của user
## Tích hợp
### Frontend
1. **Xử lý token**
```javascript
// Lưu token vào memory
let accessToken = null;
// Hàm gọi API với token
export const api = axios.create({
baseURL: '/api/v1',
headers: {
'Content-Type': 'application/json',
},
});
// Thêm interceptor để gắn token
api.interceptors.request.use(config => {
if (accessToken) {
config.headers.Authorization = `Bearer ${accessToken}`;
}
return config;
});
// Xử lý lỗi 401
export function setupResponseInterceptor(logout) {
api.interceptors.response.use(
response => response,
async error => {
const originalRequest = error.config;
if (error.response.status === 401 && !originalRequest._retry) {
originalRequest._retry = true;
try {
const { accessToken: newToken } = await refreshToken();
accessToken = newToken;
originalRequest.headers.Authorization = `Bearer ${newToken}`;
return api(originalRequest);
} catch (error) {
logout();
return Promise.reject(error);
}
}
return Promise.reject(error);
}
);
}
```
### Backend
1. **Cấu hình**
```yaml
auth:
access_token_expiry: 15m
refresh_token_expiry: 7d
jwt_secret: your-secret-key
refresh_secret: your-refresh-secret
```
2. **Sử dụng middleware**
```go
// Áp dụng auth middleware
router.Use(authMiddleware.Authenticate())
// Route yêu cầu đăng nhập
router.GET("/profile", userHandler.GetProfile)
// Route yêu cầu quyền admin
router.GET("/admin", authMiddleware.RequireRole("admin"), adminHandler.Dashboard)
```

307
docs/adapter.md
View File

@ -1,149 +1,194 @@
# Adapter Layer
# GUIDE
Document details the various connections established by the application. It outlines integrations with external APIs, connections to essential backend services (like queues or storage), and the communication pathways between internal modules. The purpose is to provide a clear map of the application's dependencies and interaction points, aiding in development, troubleshooting, and understanding system dependencies.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## API Connections
### [Numerical order].[API Name]
**Purpose:** [Brief description of the connection purpose]
**Type:** [REST/GraphQL/...]
**Base URL:** [Base URL of the API]
**Version**: [API Version]
**Key Endpoints:**
- [Endpoint 1]: [Brief description of function]
- [Endpoint 2]: [Brief description of function]
**Authentication:** [Authentication method.]
**Adapter Module:** [Module path]
**Notes:** [Key points about integration, errors, limitations, specified error handling requirements]
## Service Connections
### [Numerical order].[Service Name]
**Purpose:** [Brief description of the connection purpose]
**Type:** [Queue/Log/Storage/...]
**Connection Details:** [Address, protocol (e.g., `kafka://...`, `redis://...`), Added message routing strategies]
**Authentication/Authorization:** [Authentication/authorization method]
**Interaction Module:** [Module path]
**Notes:** [Key points about reliability, performance, retention policies, encryption]
## Internal Connections
### [Numerical order].[Module A] - [Module B]
**Purpose:** [Brief description of the interaction purpose]
**Interaction Type:** [n-way connection, Direct function call, Message Bus (channel name), Event (event name)]
**Details:** [Important function/event names, message format (if needed), event schemas and delivery guarantees]
**Notes:** [Key points about data consistency, error handling]
## Tổng quan
Adapter là lớp giao tiếp giữa ứng dụng và các hệ thống bên ngoài. Layer này cung cấp khả năng tích hợp với bên thứ ba và sự độc lập của core business logic.
# CONTENT
---
# ZEE Quiz Application Adapters
app_ver: 1.0.0
doc_ver: A1
## Nguyên tắc thiết kế
- Tách biệt domain logic với chi tiết triển khai bên ngoài
- Dễ dàng thay thế các implementation mà không ảnh hưởng tới business logic
- Dependency inversion - core logic không phụ thuộc vào chi tiết triển khai
- Interface-driven design cho các external services
## API Connections
## Cấu trúc thư mục
```
internal/adapter/
│── persistence/ # Database adapters
│ │── postgres/ # PostgreSQL implementation
│ │── mysql/ # MySQL implementation (optional)
│ └── sqlite/ # SQLite implementation (optional)
│── messaging/ # Messaging system adapters
│── storage/ # File storage adapters
│── externalapi/ # Third-party service adapters
│── notification/ # Notification service adapters
└── cache/ # Cache adapters
```
### 1. Auth0 Authentication API
**Purpose:** Handle user authentication and authorization
**Type:** OAuth 2.0 / OIDC
**Base URL:** `https://{tenant}.auth0.com`
**Version**: v2
**Key Endpoints:**
- `/authorize`: Handle user login
- `/oauth/token`: Get access tokens
- `/userinfo`: Retrieve user profile
- `/dbconnections`: Manage database connections
**Authentication:** JWT Bearer Token
**Adapter Module:** `/src/adapters/auth/auth0.adapter.ts`
**Notes:**
- Implements refresh token rotation
- Rate limited to 1000 requests per minute
- All tokens have a 24-hour expiration
## Database Adapter
### 2. SendGrid Email API
**Purpose:** Send transactional emails (verification, password reset, etc.)
**Type:** REST
**Base URL:** `https://api.sendgrid.com/v3`
**Version**: v3
**Key Endpoints:**
- `/mail/send`: Send emails
- `/templates`: Manage email templates
**Authentication:** API Key
**Adapter Module:** `/src/adapters/email/sendgrid.adapter.ts`
**Notes:**
- Daily quota: 100,000 emails
- Supports dynamic templates with Handlebars
- Webhook integration for delivery status
Adapter database được triển khai với tính năng:
## Service Connections
- Kết nối tự động với PostgreSQL
- Cấu hình connection pool
- Xử lý migration tự động
- Triển khai repository pattern
### 1. Redis Cache
**Purpose:** Caching and session storage
**Type:** In-memory Data Store
**Connection Details:**
- Protocol: `redis://{host}:6379`
- Database: 0 (Sessions), 1 (Cache)
- TLS: Enabled
**Authentication:** Password-based
**Interaction Module:** `/src/infrastructure/cache/redis.client.ts`
**Notes:**
- 30-minute TTL for session data
- LRU eviction policy
- Cluster mode enabled for high availability
### Cấu hình
### 2. PostgreSQL Database
**Purpose:** Primary data storage
**Type:** Relational Database
**Connection Details:**
- Protocol: `postgresql://{user}:{password}@{host}:5432/zee_quiz`
- Pool Size: 20 connections
- SSL: Enforced
**Authentication:** Username/Password with SCRAM-SHA-256
**Interaction Module:** `/src/infrastructure/database/prisma.service.ts`
**Notes:**
- Connection pooling enabled
- Read replicas for scaling
- Daily backups with 30-day retention
Cấu hình database được định nghĩa trong file `configs/config.yaml`:
### 3. AWS S3 Storage
**Purpose:** File storage for user uploads and media
**Type:** Object Storage
**Connection Details:**
- Endpoint: `https://s3.{region}.amazonaws.com`
- Bucket: `zee-quiz-{environment}`
- Region: ap-southeast-1
**Authentication:** AWS IAM Role
**Interaction Module:** `/src/adapters/storage/s3.adapter.ts`
**Notes:**
- Private bucket with signed URLs
- Lifecycle policy for temp files (7-day expiration)
- CORS configured for web client access
```yaml
database:
driver: "postgres"
host: "localhost"
port: 5432
username: "postgres"
password: "postgres"
database: "ulflow"
ssl_mode: "disable"
max_open_conns: 25
max_idle_conns: 5
conn_max_lifetime: 300
migration_path: "migrations"
```
## Internal Connections
## Triển khai adapter
### 1. API Gateway → User Service
**Purpose:** Handle user-related operations
**Interaction Type:** gRPC
**Details:**
- Service: `user.UserService`
- Methods:
- `GetUserProfile(userId: string) → User`
- `UpdateProfile(UpdateProfileRequest) → User`
- `SearchUsers(SearchUsersRequest) → UserList`
**Notes:**
- Request/response logging enabled
- Circuit breaker with 3 retries
- 5-second timeout
### 1. Định nghĩa interface
```go
// pkg/adapter/payment/interface.go
package payment
### 2. Quiz Service → Question Service
**Purpose:** Retrieve and manage quiz questions
**Interaction Type:** GraphQL
**Details:**
- Endpoint: `http://question-service/graphql`
- Queries:
- `getQuestions(quizId: ID!): [Question!]!`
- `validateAnswer(questionId: ID!, answer: String!): Boolean!`
**Notes:**
- Persistent queries for performance
- Batched requests where possible
- 3-second timeout
type PaymentProvider interface {
ProcessPayment(amount float64, currency string, metadata map[string]string) (string, error)
RefundPayment(paymentId string, amount float64) error
GetPaymentStatus(paymentId string) (string, error)
### 3. Notification Service → WebSocket Gateway
**Purpose:** Real-time notifications
**Interaction Type:** WebSocket Events
**Details:**
- Event: `notification:new`
- Payload:
```typescript
{
userId: string;
type: 'QUIZ_COMPLETED' | 'NEW_MESSAGE' | 'SYSTEM';
message: string;
data?: Record<string, any>;
timestamp: string;
}
```
**Notes:**
- Acknowledgment required
- Automatic reconnection with backoff
- Message queuing for offline users
### 2. Triển khai cụ thể
```go
// pkg/adapter/payment/stripe/stripe.go
package stripe
import "github.com/your-project/pkg/adapter/payment"
type StripeAdapter struct {
apiKey string
client *stripe.Client
}
func NewStripeAdapter(apiKey string) *StripeAdapter {
return &StripeAdapter{
apiKey: apiKey,
client: stripe.NewClient(apiKey),
}
}
func (s *StripeAdapter) ProcessPayment(amount float64, currency string, metadata map[string]string) (string, error) {
// Triển khai với Stripe API
}
// Triển khai các phương thức khác...
```
### 3. Sử dụng mock để test
```go
// pkg/adapter/payment/mock/mock.go
package mock
import "github.com/your-project/pkg/adapter/payment"
type MockPaymentAdapter struct {
// Fields to store test data
}
func (m *MockPaymentAdapter) ProcessPayment(amount float64, currency string, metadata map[string]string) (string, error) {
// Mock implementation for testing
}
// Triển khai các phương thức khác...
```
## Dependency Injection
Sử dụng dependency injection để đưa adapter vào business logic:
```go
// pkg/transaction/order/service.go
package order
type OrderService struct {
paymentProvider payment.PaymentProvider
// Other dependencies...
}
func NewOrderService(paymentProvider payment.PaymentProvider) *OrderService {
return &OrderService{
paymentProvider: paymentProvider,
}
}
func (s *OrderService) PlaceOrder(order *resource.Order) error {
// Sử dụng payment provider thông qua interface
paymentId, err := s.paymentProvider.ProcessPayment(
order.TotalAmount,
order.Currency,
map[string]string{"orderId": order.ID},
)
// Xử lý kết quả...
### 4. Analytics Service → Data Pipeline
**Purpose:** Stream quiz attempt data for analysis
**Interaction Type:** Message Queue (Kafka)
**Details:**
- Topic: `quiz.attempts`
- Schema:
```avro
{
"type": "record",
"name": "QuizAttempt",
"fields": [
{"name": "attemptId", "type": "string"},
{"name": "userId", "type": "string"},
{"name": "quizId", "type": "string"},
{"name": "score", "type": "float"},
{"name": "duration", "type": "int"},
{"name": "timestamp", "type": "string", "logicalType": "timestamp-millis"}
]
}
```
**Notes:**
- Exactly-once delivery semantics
- 7-day retention period
- Schema evolution enabled
## Best Practices
1. **Mỗi adapter chỉ giao tiếp với một dịch vụ bên ngoài**
2. **Xử lý lỗi phù hợp và mapping sang domain errors**
3. **Cung cấp logging và metrics cho mỗi adapter**
4. **Retry mechanisms cho các dịch vụ không ổn định**
5. **Circuit breaking để tránh cascading failures**
6. **Feature toggles để dễ dàng chuyển đổi giữa các provider**
---
*Last Updated: 2025-06-06*
*Next Review: 2025-07-01*

552
docs/architecture.md
View File

@ -1,234 +1,374 @@
# Kiến trúc hệ thống
# GUIDE
This document outlines the technical architecture and organization of the project. It details the high-level architectural design, the rationale behind the codebase structure, descriptions of key functional components, and illustrates primary data flows within the system. The aim is to provide a clear and comprehensive guide for developers and architects involved with the project.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## 1. Architecture Overview
[Explanation of the overall architecture model (e.g., Microservices, Monolithic, Layered). Brief description of the main parts of the system and their high-level relationships. Can include a high-level architecture diagram (if available).]
## 2. Project Structure
[Brief overview of how the directory structure organizes the codebase and the reasoning behind this organization.]
### Directory Tree
A/
├── B/
│   ├── C/        # [Brief explanation]
│   │   ├── C1/   # [Brief explanation]
│   │   └── C2/   # [Brief explanation]
│   ├── D/        # [Brief explanation]
│   │   ├── D1/ # [Brief explanation]
### Structure Explanation
[More detailed explanation of the roles and responsibilities of the main layers and directories. Why this structure was chosen.]
## 3. Key Components
### [Numerical order]. [Component Name]
* **Description:** [Detailed description of the component's function and responsibilities.]
* **Location in Directory Tree (if relevant):** [Directory path]
* **Dependencies:** [List of components this component depends on]
* **Interactions with Other Components:** [Description of how this component interacts with other parts of the system.]
## 4. Main Data Flow
[Description of the most important data flows in the system, such as user creation flow, order processing flow. Can use a Mermaid diagram for visualization.]
```
[mermaid flow chart here]
```
## Project Overview
- Đây là dự án tạo ra Starter Kit Golang Backend cho Team ULFlow để có thể khởi tạo các dự án trong thời gian ngắn, nhanh chóng mà vẫn đảm bảo các yếu tố cơ bản
- Sử dụng Mô hình DDD (Domain Driven Development) - Customize
- `Resource`: Các Aggregate DDD
- `Transaction`: Các Saga điều phối luồng nghiệp vụ phức tạp
- `Adapter`: Xử lý giao tiếp với các hệ thống bên ngoài
- `Helper`: Các thư viện, tiện ích dùng chung
- `Transport`: Lớp giao diện người dùng
- Thành phần kiến trúc chi tiết (U-Hierarchy)
- `ubit`: Đơn vị logic nhỏ nhất (hàm, type, hằng số)
- `ubrick`: Tập hợp các `ubit` liên quan
- `ublock`: Thành phần hoạt động độc lập tương đối
- `ubundle`: Tính năng hoàn chỉnh cho người dùng
---
# CONTENT
## Nguyên tắc thiết kế
- **User-Centric**: Ưu tiên trải nghiệm người dùng, giảm thiểu sự phức tạp
- **Data-Oriented Programming (DOP)**: Thiết kế xoay quanh luồng dữ liệu và các biến đổi dữ liệu
- **Domain-Driven Design (DDD)**: Áp dụng các khái niệm cốt lõi (Bounded Context, Aggregates, Domain Events)
## Title: ZEE Quiz Application
app_ver: 1.0.0
doc_ver: A1
## Áp dụng DDD trong Dự án
## 1. Architecture Overview
### Resource
- Tuân theo nguyên tắc Aggregate trong DDD
- Mỗi Resource đại diện cho một thực thể nghiệp vụ
- Bao gồm các thuộc tính và hành vi liên quan
- Đảm bảo tính nhất quán và logic nghiệp vụ
### 1.1. System Architecture
### Transaction
- Triển khai mẫu Saga để điều phối các hoạt động phức tạp
- Đảm bảo tính toàn vẹn dữ liệu xuyên suốt các Resource
- Xử lý các trường hợp lỗi và rollback khi cần thiết
The ZEE Quiz Application follows a **modular monolith** architecture with **Domain-Driven Design (DDD)** principles. This approach provides the right balance between maintainability and development velocity while keeping the system simple to deploy and operate.
### Adapter
- Cung cấp giao diện giao tiếp với hệ thống bên ngoài
- Triển khai mẫu Adapter để đảm bảo tính linh hoạt
- Dễ dàng thay thế các thành phần khi cần thiết
**Key Architectural Principles:**
- **Domain-Driven Design (DDD)** for clear domain boundaries
- **Clean Architecture** for separation of concerns
- **Container-First** design for cloud-native deployment
### Helper
- Cung cấp các tiện ích dùng chung
- Triển khai các công cụ hỗ trợ phát triển
- Tối ưu hóa mã lệnh và tăng khả năng tái sử dụng
### 1.2. High-Level Architecture
### UIUX
- Lớp giao diện người dùng (API, Web Interface)
- Triển khai theo nguyên tắc thiết kế hướng người dùng
- Tách biệt với logic nghiệp vụ
```mermaid
graph TD
Client[Web Client] --> HTTP[HTTP Transport Layer]
HTTP --> Handler[Request Handlers]
Handler --> Service[Business Services]
## U-Hierarchy
subgraph Internal Resources
Service --> User[User Resource]
Service --> Role[Role Resource]
end
Hệ thống phân cấp U là một cách tiếp cận duy nhất cho tổ chức mã:
subgraph Infrastructure
User --> DB[(PostgreSQL)]
Role --> DB
User --> Cache[(Redis)]
Service --> Logger[Logger]
end
### ubit
- Đơn vị nhỏ nhất của mã
- Ví dụ: một hàm, một constant, một type
- Mục đích đơn lẻ, dễ test
subgraph Helpers
Handler --> Config[Config Helper]
Service --> Feature[Feature Flags]
DB --> DBUtil[Database Utils]
end
```
### ubrick
- Tập hợp các ubit liên quan đến nhau
- Cung cấp một chức năng cụ thể
- Ví dụ: một package nhỏ, một nhóm hàm liên quan
**Component Responsibilities:**
### ublock
- Thành phần có thể hoạt động độc lập
- Bao gồm nhiều ubrick làm việc cùng nhau
- Ví dụ: một module hoặc service
1. **Transport Layer**
- HTTP request/response handling
- Route management
- Middleware (auth, logging, etc.)
- DTO validation
### ubundle
- Một tính năng hoàn chỉnh cho người dùng
- Kết hợp nhiều ublock để tạo ra trải nghiệm người dùng
- Ví dụ: một tính năng end-to-end
2. **Business Services**
- Core business logic implementation
- Transaction management
- Resource coordination
- Event handling
### Directory Structure
3. **Internal Resources**
- User management
- Role and permissions
- Domain logic encapsulation
starter-kit/
├── .gitea/
│ ├── workflows/
│ │ ├── ci.yml
│ │ └── docker.yml
│ ├── .hooks/
│ │ ├──pre-commit
│ │ └──prepare-commit-msg
│ └── commit-template.txt
├── cmd/
│ └── app/ # Hoặc 'server/', 'api/' - Entrypoint chính của ứng dụng
│ └── main.go
├── internal/
│ ├── resource/ # Lớp chứa các Aggregates/Entities (DDD)
│ │ └── example/ # Một module ví dụ rất cơ bản
│ │ ├── example_aggregate.go
│ │ ├── example_types.go
│ │ └── example_repository_interface.go # Interface cho repository
│ └── transaction/ # Lớp chứa các Use Cases/Application Services/Sagas (DDD)
│ │ └── example/ # Một module ví dụ rất cơ bản
│ │ └── example_transaction.go
│ ├── adapter/ # Lớp giao tiếp với các hệ thống bên ngoài hoặc hạ tầng
│ │ ├── persistence/ # Hoặc 'repository/', 'storage/' - Triển khai repositories
│ │ │ └── postgres/ # Ví dụ với PostgreSQL
│ │ │ ├── connection.go # Thiết lập kết nối DB
│ │ │ ├── example_postgres_repository.go # Triển khai repository cho example_aggregate
│ │ │ └── models.go # (Tùy chọn) GORM models hoặc struct cho DB mapping
│ │ |
│ │ └── externalapi/ # Giao tiếp với các dịch vụ bên ngoài
│ │ └── # example_service_client.go
│ ├── helper/ # Các thư viện, tiện ích dùng chung, không có business logic
│ │ ├── config/ # Load cấu hình (ví dụ: Gin)
│ │ │ └── load.go
│ │ ├── logger/ # Thiết lập logger (ví dụ: Logrus)
│ │ │ └── log.go
│ │ ├── validation/ # Tiện ích validation chung
│ │ │ └── common.go
│ │ ├── security/ # Tiện ích bảo mật (JWT, hashing)
│ │ │ ├── jwt_helper.go
│ │ │ └── password_helper.go
│ │ └── # ... (ví dụ: datetime, string_utils)
│ └── transport/ # Lớp giao tiếp với thế giới bên ngoài (ví dụ: HTTP)
│ └── http/ # Cụ thể cho HTTP transport
│ ├── handler/ # HTTP request handlers
│ │ ├── example_handler.go
│ │ ├── health_handler.go # Endpoint kiểm tra sức khỏe ứng dụng
│ │ └── middleware/ # HTTP middlewares (auth, logging, cors, recovery)
│ │ ├── auth_middleware.go
│ │ ├── request_logger_middleware.go
│ │ └── error_handling_middleware.go
│ ├── router.go # Định nghĩa các routes (ví dụ: sử dụng Gin, Chi)
│ └── dto/ # Data Transfer Objects cho request/response
│ ├── example_dto.go
│ └── common_dto.go
├── docs/ # Tài liệu của starter-kit
├── templates/ # Chứa các file cấu hình mẫu
│ ├── config.example.yaml # Đổi tên để rõ là file mẫu
│ └── .env.example # Các biến môi trường mẫu
├── migrations/ # Chứa các file SQL migration
│ └── 000001_init_schema.example.sql # Migration mẫu
├── api/ # (Tùy chọn) Định nghĩa API (ví dụ: OpenAPI/Swagger specs)
│ └── openapi.yaml
├── scripts/ # Các shell script tiện ích (nếu Makefile không đủ)
│ ├── # setup_env.sh
│ └── # run_checks.sh
├── Makefile # Các lệnh tiện ích (build, test, lint, run, docker, ...)
├── go.mod # Tên module nên là tên của starter-kit,
├── .gitignore
└── README.md # Hướng dẫn nhanh và tổng quan về starter-kit
4. **Infrastructure**
- PostgreSQL for persistent storage
- Redis for caching
- Structured logging
### Checklist cơ bản của vòng đời App
5. **Helper Utilities**
- Configuration management
- Database utilities
- Feature flag management
- Common helper functions
I. Thiết lập Cơ bản và Cấu trúc (Basic Setup & Structure)
## 2. Project Structure
[ ] Tách biệt Logic Khởi tạo:
Yêu cầu: main.go chỉ chứa hàm main() và các lệnh gọi ở mức cao nhất. Logic chi tiết cho việc khởi tạo từng thành phần (config, logger, server, DB) phải nằm trong các package/hàm riêng biệt (ví dụ: internal/common/config, internal/common/logger, internal/transport/http/server, internal/infrastructure/db).
Mục đích: Giữ main.go ngắn gọn, dễ đọc, dễ hiểu vai trò điều phối của nó.
[ ] Hàm main() rõ ràng:
Yêu cầu: Hàm main() nên thực hiện các bước khởi tạo một cách tuần tự, logic.
Mục đích: Dễ dàng theo dõi luồng khởi động của ứng dụng.
[ ] Xử lý lỗi khởi tạo nghiêm trọng:
Yêu cầu: Nếu một bước khởi tạo thiết yếu (ví dụ: load config, kết nối DB) thất bại, ứng dụng nên log lỗi rõ ràng và thoát (ví dụ: log.Fatalf hoặc logger.Fatal).
Mục đích: Tránh việc ứng dụng chạy trong trạng thái không ổn định hoặc không đầy đủ.
II. Quản lý Cấu hình (Configuration Management)
### 2.1. Directory Structure
[ ] Load Cấu hình:
Yêu cầu: Gọi một hàm/package chuyên biệt để đọc cấu hình từ các nguồn (file YAML/JSON/.env, biến môi trường).
Ví dụ: cfg, err := config.Load("configs/", ".env.example")
Mục đích: Tập trung logic load config, dễ dàng thay đổi nguồn hoặc định dạng config.
[ ] Validate Cấu hình Cơ bản (Đề xuất):
Yêu cầu (Đề xuất): Sau khi load, có một bước kiểm tra sơ bộ các giá trị cấu hình thiết yếu (ví dụ: port server có hợp lệ, thông tin kết nối DB có đủ).
Mục đích: Phát hiện lỗi cấu hình sớm.
III. Logging
```
zee/
├── cmd/ # Application entry points
│ └── app/ # Main application server
│
├── configs/ # Configuration files
│
├── docs/ # Documentation files
│
├── internal/ # Private application code
│ ├── adapter/ # External adapters
│ │ └── postgres/ # PostgreSQL adapter
│ ├── helper/ # Helper utilities
│ │ ├── config/ # Configuration helpers
│ │ ├── database/ # Database utilities
│ │ ├── feature/ # Feature flags
│ │ └── logger/ # Logging utilities
│ ├── pkg/ # Internal packages
│ │ └── lifecycle/ # Application lifecycle
│ ├── resource/ # Domain resources
│ │ ├── role/ # Role management
│ │ └── user/ # User management
│ ├── service/ # Business services
│ └── transport/ # Transport layer
│ └── http/ # HTTP handlers
│ ├── dto/ # Data transfer objects
│ ├── handler/ # Request handlers
│ └── middleware/ # HTTP middleware
│
├── migrations/ # Database migrations
│
└── templates/ # Template files
│ ├── interfaces/ # Interface adapters
│ │ ├── http/ # HTTP handlers
│ │ │ ├── v1/ # API v1 routes
│ │ │ └── middleware # HTTP middleware
│ │ └── repository/ # Repository implementations
│ │
│ └── pkg/ # Shared packages
│ ├── auth/ # Authentication
│ ├── logger/ # Logging
│ └── validator/ # Input validation
│
├── pkg/ # Public packages
│ ├── errors/ # Common errors
│ └── uuid/ # UUID utilities
│
├── migrations/ # Database migrations
├── web/ # Frontend assets
├── configs/ # Configuration files
├── scripts/ # Utility scripts
├── .github/ # GitHub workflows
├── docs/ # Documentation
├── go.mod # Go module definition
└── Makefile # Common tasks
```
[ ] Structured Logging với Logrus:
- Sử dụng Logrus cho structured logging với JSON format
- Hỗ trợ các log level: debug, info, warn, error
- Tích hợp request ID tracking cho HTTP requests
- Cấu hình logging được quản lý tập trung trong section `logger`
### 2.2. Structure Explanation
[ ] Middleware Logging:
- Tự động log các HTTP request với thông tin chi tiết:
- Request ID
- Method
- Path
- Status code
- Latency
- Client IP
- User agent
- **cmd/api**: Contains the application's entry point and server setup
- **internal/domain**: Core domain models and business logic (DDD)
- **internal/application**: Application services and use cases
- **internal/interfaces**: Adapters for external communication (HTTP, repositories)
- **internal/pkg**: Shared infrastructure code
- **pkg**: Public reusable packages
- **migrations**: Database schema migrations
- **web**: Frontend assets and templates
- **configs**: Configuration files for different environments
[ ] Error Handling và Context:
- Tích hợp error context vào logs
- Structured fields cho phép phân tích và tìm kiếm hiệu quả
- Theo dõi chuỗi lỗi với error wrapping
IV. Khởi tạo Dependencies Cơ sở hạ tầng (Infrastructure Dependencies)
## 3. Key Components
[ ] Khởi tạo Kết nối Database (nếu starter kit có sẵn):
Yêu cầu: Gọi một hàm/package để thiết lập kết nối tới DB (ví dụ: PostgreSQL) và quản lý connection pool.
Ví dụ: dbConn, err := database.New(cfg.DBConfig, appLogger)
Mục đích: Chuẩn bị sẵn sàng cho việc tương tác với DB.
[ ] Đóng Kết nối Database khi Shutdown:
Yêu cầu: Đảm bảo kết nối DB được đóng một cách an toàn khi ứng dụng tắt (sử dụng defer hoặc trong quá trình graceful shutdown).
Mục đích: Tránh rò rỉ tài nguyên.
V. Thiết lập Server (ví dụ: HTTP Server)
### 3.1. API Gateway
* **Description**: Single entry point for all client requests
* **Location**: `internal/interfaces/http`
* **Dependencies**: Application services, Authentication, Rate limiting
* **Responsibilities**:
- Request/response handling
- Authentication & Authorization
- Request validation
- Rate limiting
- CORS handling
[ ] Khởi tạo Router (từ package riêng):
Yêu cầu: Logic định nghĩa routes và gắn handlers phải nằm trong một package riêng (ví dụ: internal/transport/http/router). main.go chỉ khởi tạo nó.
Ví dụ: httpRouter := router.New(appLogger /*, dbConn, otherServices */)
Mục đích: Tách biệt rõ ràng logic routing và business.
[ ] Khởi tạo HTTP Server:
Yêu cầu: Tạo instance http.Server với các cấu hình cơ bản (địa chỉ, port, handler là router đã khởi tạo, có thể cả timeouts cơ bản).
[ ] Đăng ký Middleware Phi tính năng Cơ bản (thường trong package router hoặc server setup):
Yêu cầu: Đảm bảo các middleware thiết yếu như request logging, panic recovery, CORS (nếu cần) được áp dụng.
Mục đích: Tăng cường độ tin cậy và khả năng giám sát cho API.
[ ] Đăng ký Health Check Endpoint (trong router):
Yêu cầu: Cung cấp một endpoint (/healthz, /status) để kiểm tra tình trạng hoạt động của ứng dụng.
Mục đích: Hỗ trợ giám sát và tự động hóa vận hành.
VI. Quản lý Vòng đời Ứng dụng (Application Lifecycle Management)
### 3.2. User Management
* **Description**: Handles user registration, authentication, and profile management
* **Location**: `internal/domain/user`, `internal/application/commands/user`
* **Dependencies**: JWT, Password hashing, Email service
* **Key Features**:
- User registration with email verification
- JWT-based authentication
- Profile management
- Role-based access control
[ ] Chạy Server trong Goroutine riêng:
Yêu cầu: httpServer.ListenAndServe() (hoặc tương tự) được chạy trong một goroutine để không block hàm main().
[ ] Xử lý Graceful Shutdown:
Yêu cầu: Lắng nghe các tín hiệu OS (SIGINT, SIGTERM) để thực hiện shutdown một cách an toàn.
Bao gồm:
Tạo channel để nhận tín hiệu: quit := make(chan os.Signal, 1)
Đăng ký tín hiệu: signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
Block cho đến khi nhận tín hiệu: <-quit
Gọi httpServer.Shutdown(ctx) với một context có timeout.
Log các bước shutdown.
Mục đích: Đảm bảo ứng dụng hoàn thành các request đang xử lý, đóng kết nối an toàn, tránh mất dữ liệu.
### 3.3. Quiz Engine
* **Description**: Core quiz functionality
* **Location**: `internal/domain/quiz`, `internal/application/commands/quiz`
* **Dependencies**: Question repository, User repository
* **Features**:
- Question management
- Quiz session handling
- Timer management
- Answer validation
[ ] Xử lý Error và Log:
Yêu cầu: Tất cả các error từ các thành phần (DB, HTTP, middleware) nên được log rõ ràng, bao gồm thông tin context (ví dụ: request ID, method, URL).
Mục đích: Hỗ trợ debug và giám sát vấn đề khi xảy ra.
VII. Quản lý tài nguyên (Resource Management)
### 3.4. Result Processing
* **Description**: Handles quiz results and scoring
* **Location**: `internal/domain/result`, `internal/application/queries/result`
* **Dependencies**: Quiz repository, User repository
* **Features**:
- Score calculation
- Leaderboard generation
- Result caching
- Analytics
[ ] Đóng tài nguyên khi không cần thiết:
Yêu cầu: Đảm bảo tất cả các tài nguyên (connection, file, mutex, channel) được đóng hoặc giải phóng khi không còn sử dụng.
Mục đích: Tránh rò rỉ tài nguyên và đảm bảo hiệu quả sử dụng bộ nhớ.
## 4. Main Data Flows
### 4.1. User Registration Flow
```mermaid
sequenceDiagram
participant C as Client
participant A as API Gateway
participant U as User Service
participant D as Database
participant E as Email Service
C->>A: POST /api/v1/register
A->>U: RegisterUserCommand
U->>D: Begin Transaction
U->>D: Check if email exists
U->>D: Create user
U->>E: Send verification email
U->>D: Commit Transaction
U-->>A: User created
A-->>C: 201 Created
```
### 4.2. Quiz Submission Flow
```mermaid
sequenceDiagram
participant C as Client
participant A as API Gateway
participant Q as Quiz Service
participant R as Result Service
participant D as Database
participant K as Cache (Redis)
C->>A: POST /api/v1/quizzes/submit
A->>Q: SubmitQuizCommand
Q->>D: Load quiz session
Q->>Q: Validate answers
Q->>R: CalculateScoreCommand
R->>D: Save results
R->>K: Update leaderboard
R-->>Q: Score calculated
Q-->>A: Quiz result
A-->>C: 200 OK with result
```
## 5. Technology Stack
### 5.1. Backend
- **Language**: Go 1.24.3
- **Web Framework**: Gin-Gonic Router
- **ORM**: GORM
- **Migrations**: GORM Migrate
- **Validation**: go-playground/validator
- **Logging**: zap
- **Configuration**: viper
- **Testing**: testify, gomock
### 5.2. Frontend
- **HTMX** for dynamic UI updates
- **TailwindCSS** for styling
- **Alpine.js** for client-side interactions
- **HTMX Extensions** for advanced functionality
### 5.3. Infrastructure
- **Containerization**: Docker
- **Orchestration**: Docker Compose (local), Kubernetes (production)
- **Database**: PostgreSQL 14
- **Caching**: Redis
- **Storage**: AWS S3
- **CI/CD**: Gitea Actions
- **Monitoring**: Prometheus, Grafana
- **Logging**: ELK Stack
## 6. Deployment Architecture
### 6.1. Development Environment
- Local Docker Compose setup
- Hot-reload for development
- Development database with sample data
### 6.2. Production Environment
- Container orchestration with Kubernetes
- Auto-scaling based on load
- Multi-AZ deployment for high availability
- Automated backups and disaster recovery
## 7. Security Considerations
### 7.1. Authentication & Authorization
- JWT-based authentication
- Role-based access control (RBAC)
- Secure password hashing (bcrypt)
- Rate limiting
- CORS policy
### 7.2. Data Protection
- TLS 1.3 for all communications
- Sensitive data encryption at rest
- Regular security audits
- GDPR compliance
## 8. Performance Considerations
### 8.1. Caching Strategy
- Redis for frequently accessed data
- HTTP caching headers
- Database query result caching
### 8.2. Database Optimization
- Proper indexing
- Query optimization
- Connection pooling
- Read replicas for scaling reads
## 9. Monitoring & Observability
### 9.1. Metrics
- Request/response times
- Error rates
- Database query performance
- System resource usage
### 9.2. Logging
- Structured logging with correlation IDs
- Log levels (debug, info, warn, error)
- Centralized log management
### 9.3. Alerting
- Error rate thresholds
- Response time thresholds
- System resource alerts
- Business metrics alerts
## 10. Future Considerations
### 10.1. Scalability
- Sharding for database scaling
- Event sourcing for audit trail
- CQRS for read/write scaling
### 10.2. Features
- Real-time leaderboard updates
- Social sharing
- Offline quiz support
- Mobile app integration
---
*Last Updated: 2025-06-06*
*Document Version: A1*

89
docs/changelog.md
View File

@ -1,63 +1,38 @@
# Changelog
# GUIDE
This section logs changes and updates chronologically. Each entry follows the specified format providing a history of modifications.
# FORMAT
## Title:
[Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
[YYYY-MM-DD HH:MM] : [app_ver] : [Folder name] : [change description]
Tất cả những thay đổi đáng chú ý trong dự án sẽ được ghi lại ở đây.
---
# CONTENT
Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
và dự án này tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## Title:
ZEE Quiz Application Changelog
app_ver: 1.0.0
doc_ver: A1
## [Unreleased]
---
### Added
- **Logger Improvements**:
- Hỗ trợ phân biệt stdout/stderr cho các mức log khác nhau
- Tự động thêm thông tin người gọi (caller) vào log
- Hỗ trợ nhiều định dạng log (JSON, Text)
- Tự động thêm các trường mặc định vào mỗi log entry
- Tối ưu hiệu năng với buffer và sync.Pool
- Hỗ trợ log rotation thông qua các hooks
- Tài liệu chi tiết về cách sử dụng và cấu hình
- Thread-safe implementation
- Hỗ trợ context và request-scoped fields
- Tích hợp với cấu hình ứng dụng
2025-06-06 16:00 : 1.0.0 : docs : Updated architecture documentation with GORM and Gin-Gonic details
2025-06-06 15:30 : 1.0.0 : docs : Added comprehensive adapter documentation for all services
2025-06-06 14:45 : 1.0.0 : docs : Updated roadmap with detailed development phases and timelines
2025-06-06 14:00 : 1.0.0 : docs : Added screen documentation with UI/UX specifications
2025-06-06 13:30 : 1.0.0 : docs : Updated schema documentation with database structure
2025-06-06 13:00 : 1.0.0 : docs : Added technical specifications for core components
2025-06-06 12:30 : 1.0.0 : docs : Created initial architecture documentation
2025-06-06 12:00 : 1.0.0 : backend : Migrated from Chi to Gin-Gonic framework
2025-06-06 11:30 : 1.0.0 : backend : Switched from sqlx to GORM ORM
2025-06-06 11:00 : 1.0.0 : backend : Implemented authentication service with JWT
2025-06-06 10:30 : 1.0.0 : frontend : Initialized React application with TypeScript
2025-06-06 10:00 : 1.0.0 : infrastructure : Set up Docker and docker-compose for development
2025-06-06 09:30 : 1.0.0 : infrastructure : Configured CI/CD pipeline with GitHub Actions
2025-06-05 17:00 : 0.1.0 : project : Initial project setup with Go modules
### Changed
- **Logger Refactor**:
- Thay đổi cấu trúc package logger để dễ mở rộng
- Cải thiện hiệu suất với ít cấp phát bộ nhớ hơn
- Chuẩn hóa định dạng log đầu ra
- Cập nhật middleware HTTP để sử dụng logger mới
---
### Fixed
- **Logger**:
- Sửa lỗi race condition khi khởi tạo logger
- Đảm bảo tất cả log đều có đầy đủ context
- Cải thiện xử lý lỗi khi cấu hình không hợp lệ
### Changed
- Thay thế standard log package bằng Logrus trong toàn bộ ứng dụng
- Di chuyển cấu hình logging từ `app.log_level` sang section `logger` riêng biệt
- Cập nhật HTTP server để sử dụng structured logging
- Cải thiện validation cho database config với required_if conditions
- Nâng cấp cấu hình logger để hỗ trợ nhiều tùy chọn hơn
- Tối ưu hiệu năng của hệ thống logging
## [0.1.1] - 2025-05-14
### Added
- Triển khai module config với các chức năng:
- Đọc cấu hình từ file YAML
- Hỗ trợ biến môi trường
- Validation tự động các giá trị cấu hình
- Giá trị mặc định cho các tham số
- Thiết lập cấu trúc thư mục theo mô hình DDD (Domain-Driven Design)
- Cấu hình CI/CD với Gitea Workflows
- Cấu hình Docker cho môi trường development và production
- Tích hợp các Git hooks để đảm bảo chất lượng mã nguồn
## [0.1.0] - 2025-05-12
### Added
- Khởi tạo repository
- Tạo roadmap ban đầu
- Thiết lập kiến trúc hệ thống theo mô hình DDD
- Định nghĩa U-Hierarchy cho tổ chức mã nguồn
*Document Version: A1*
*Last Updated: 2025-06-06 16:00*

149
docs/cysec.md Normal file
View File

@ -0,0 +1,149 @@
# GUIDE
This document outlines the security framework and operational procedures for the system. It covers core security principles, mandatory technical controls, specific methods for preventing common attack vectors, access management configurations, step-by-step incident response plans, and a routine maintenance checklist to ensure ongoing security posture.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## 1. Core Principle
- [ ] [Security Rule]
## 2. Mandatory Controls
| Type | Minimum Requirement | Implement |
| -------- | ---------------------- | --------------------------------- |
| [Action] | [Security Requirement] | [Security Methods/Services/Tools] |
| ... | ... | ... |
## 3. Attack Prevention Matrix
| Attack Vector | Prevention Method | Code Snippet (1-line) | |
| ------------- | ---------------------- | --------------------- | --- |
| [Attack Type] | [Prevention Mechanism] | [Code/Query Example] | |
| ... | ... | ... | |
## 4. Access Management
```yaml
[Access API Permission]
```
## CI/CD Security
- [ ] [CI/CD Rule for Security]
## 6. Incident Response
[Step-by-Step Incident Repsone]
## 7. Weekly Maintenance Checklist
- [ ] [Maintenance action]
---
# CONTENT
## Title:
ZEE Quiz Application Security Framework
app_ver: 1.0.0
doc_ver: A1
## 1. Core Security Principles
- [X] **Least Privilege**: Minimal permissions for all system components
- [X] **Defense in Depth**: Multiple layers of security controls
- [X] **Secure by Default**: Secure configurations out-of-the-box
- [X] **Zero Trust**: Verify explicitly, assume breach
- [X] **Privacy by Design**: Data protection from the start
## 2. Mandatory Security Controls
| Type | Minimum Requirement | Implementation |
|------|---------------------|----------------|
| Authentication | Multi-factor for admin access | OAuth 2.0 + JWT |
| Authorization | Role-based access control | Casbin |
| Data Encryption | TLS 1.3 for all communications | Let's Encrypt |
| Input Validation | Strict type checking & sanitization | Go validator |
| Logging | Centralized structured logging | Zap + ELK Stack |
| Monitoring | Real-time security monitoring | Prometheus + Grafana |
| Secret Management | Secure storage of credentials | HashiCorp Vault |
| Dependencies | Regular security updates | Dependabot |
## 3. Attack Prevention Matrix
| Attack Vector | Prevention Method | Implementation |
|--------------|-------------------|----------------|
| SQL Injection | Parameterized queries | pgx driver |
| XSS | Context-aware escaping | html/template |
| CSRF | Token validation | gorilla/csrf |
| Brute Force | Rate limiting | Tollbooth |
| DDoS | WAF + Rate limiting | Cloudflare |
| Data Leakage | Field-level encryption | libsodium |
| Broken Auth | Secure session management | scs |
| Insecure Deserialization | Strict type checking | Go strict unmarshal |
## 4. Access Management
```yaml
roles:
admin:
endpoints:
- "GET|POST|PUT|DELETE /admin/**"
user:
endpoints:
- "GET /api/profile/**"
- "POST /api/quiz/**"
public:
endpoints:
- "GET /health"
- "POST /api/register"
- "GET /api/quiz/start"
```
## 5. CI/CD Security
- [X] **Code Scanning**: Static application security testing (SAST)
- [X] **Dependency Scanning**: OWASP Dependency-Check
- [X] **Container Scanning**: Trivy for container vulnerabilities
- [X] **Secrets Detection**: Gitleaks for exposed secrets
- [X] **Infrastructure as Code**: Terraform scanning with Checkov
## 6. Incident Response Plan
1. **Detection & Classification**
- Monitor security events and alerts
- Classify incident severity (Low, Medium, High, Critical)
2. **Containment**
- Isolate affected systems
- Preserve evidence
- Temporary mitigation measures
3. **Eradication**
- Identify root cause
- Apply security patches
- Remove malware/unauthorized access
4. **Recovery**
- Restore systems from clean backups
- Verify system integrity
- Monitor for recurrence
5. **Post-Mortem**
- Document incident details
- Identify improvements
- Update security controls
## 7. Weekly Security Maintenance
- [ ] Review and rotate API keys
- [ ] Update system packages
- [ ] Review security logs
- [ ] Backup verification
- [ ] Check for security advisories
- [ ] Review user access rights
- [ ] Test backup restoration
- [ ] Scan for vulnerabilities
## 8. Security Headers
```
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Content-Security-Policy: default-src 'self'
Strict-Transport-Security: max-age=31536000; includeSubDomains
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: camera=(), microphone=(), geolocation=()
```
## 9. Data Protection
- **At Rest**: AES-256 encryption for sensitive data
- **In Transit**: TLS 1.3 for all communications
- **In Use**: Field-level encryption for PII
- **Backup**: Encrypted backups with 30-day retention
## 10. Security Monitoring
- **Log Collection**: Centralized logging of all system events
- **SIEM Integration**: Real-time security event monitoring
- **Alerting**: Immediate notification for critical events
- **Audit Trail**: Immutable logging of all administrative actions

183
docs/docker_rule.md Normal file
View File

@ -0,0 +1,183 @@
# Docker Best Practices for ZEE Quiz Application
## 1. Multi-stage Builds
```dockerfile
# Builder stage
FROM golang:1.24.3-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o /zee-app
# Final stage
FROM alpine:3.18
WORKDIR /app
COPY --from=builder /zee-app /app/
# Add non-root user
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
USER appuser
# Health check
HEALTHCHECK --interval=30s --timeout=3s \
CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1
EXPOSE 8080
ENTRYPOINT ["/app/zee-app"]
```
## 2. Security Best Practices
- **Non-root User**: Always run containers as non-root user
- **Minimal Base Images**: Use `alpine` or `distroless` for smaller attack surface
- **Multi-stage Builds**: Reduce final image size and remove build tools
- **`.dockerignore`**: Exclude unnecessary files from build context
- **Image Scanning**: Use `trivy` or `docker scan` for vulnerability scanning
## 3. Docker Compose Configuration
```yaml
version: '3.8'
services:
app:
build:
context: .
target: production
ports:
- "8080:8080"
environment:
- DATABASE_URL=postgres://user:pass@db:5432/zeedb
depends_on:
db:
condition: service_healthy
deploy:
resources:
limits:
cpus: '1'
memory: 1G
healthcheck:
test: ["CMD", "wget", "--spider", "http://localhost:8080/health"]
interval: 30s
timeout: 10s
retries: 3
db:
image: postgres:14-alpine
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: pass
POSTGRES_DB: zeedb
volumes:
- postgres_data:/var/lib/postgresql/data
- ./migrations:/docker-entrypoint-initdb.d
healthcheck:
test: ["CMD-SHELL", "pg_isready -U user -d zeedb"]
interval: 5s
timeout: 5s
retries: 5
redis:
image: redis:7-alpine
command: redis-server --requirepass your_secure_password
volumes:
- redis_data:/data
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 5
volumes:
postgres_data:
redis_data:
```
## 4. Development vs Production
### Development
- Mount source code as volume for live reload
- Enable debug mode
- Include development tools
### Production
- Use multi-stage builds
- Remove debug tools
- Set appropriate resource limits
- Enable health checks
- Configure logging drivers
## 5. Environment Variables
```env
# Application
APP_ENV=production
PORT=8080
# Database
DB_HOST=db
DB_PORT=5432
DB_NAME=zeedb
DB_USER=user
DB_PASSWORD=pass
DB_SSLMODE=disable
# Redis
REDIS_ADDR=redis:6379
REDIS_PASSWORD=your_secure_password
# JWT
JWT_SECRET=your_jwt_secret_key
JWT_EXPIRATION=24h
```
## 6. Volume Management
- Use named volumes for persistent data
- Set appropriate volume permissions
- Backup volumes regularly
- Consider volume encryption for sensitive data
## 7. Network Configuration
- Use custom bridge networks
- Isolate services in dedicated networks
- Configure proper DNS resolution
- Set up network policies
## 8. Logging & Monitoring
- Configure log rotation
- Use structured logging
- Forward logs to centralized system
- Monitor container metrics
## 9. CI/CD Integration
```yaml
# .drone.yml
kind: pipeline
type: docker
name: build-and-push
steps:
- name: test
image: golang:1.24
commands:
- go test -v ./...
- name: build
image: plugins/docker
settings:
repo: your-registry/zee-app
tags: ${DRONE_COMMIT_SHA:0:8}
dockerfile: Dockerfile
target: production
when:
event: push
branch: main
```
## 10. Security Scanning
```bash
# Scan for vulnerabilities
docker scan zee-app
# Check for secrets in code
docker run --rm -v $(pwd):/src/ -v /var/run/docker.sock:/var/run/docker.sock zricethezav/gitleaks:latest detect --source=/src --report=/src/gitleaks.json
# Scan Dockerfile
docker run --rm -i hadolint/hadolint < Dockerfile

139
docs/general.md
View File

@ -1,79 +1,84 @@
# Giới thiệu chung
# GUIDE
This document provides a project overview, covering core information like the project name, a short description, its main purpose, value proposition, and target audience. It also lists key features, the core technologies employed, team members, and includes important links to relevant documentation, the source code repository, and the project management tool.
# FORMAT
## Title:
[Application/Website Name]
app_ver: 0.1.0
doc_ver: A1
### Short Description:
[Very brief (one-sentence) description of the application/website.]
### Core Purpose:
[Brief (1-2 sentences) description of the problem the application/website solves and the value it provides.]
### Target Audience:
[Brief description of the primary user group.]
## Key Features Overview:
- [Feature Name List]
## Core Technologies:
- [Technology Name List]
## Key Document References:
- [Name file List]: [Description]
## Reference Projects:
[Link or brief description of similar projects (if any)]
## Project Members:
- [Member Name List]: [Role]
## Source Code Repository:
[Link to the source code repository (if any)]
## Project Management Tool:
[Link to the project management tool (if any)]
## Tổng quan
- ULFlow Golang Starter Kit là một khung phát triển backend theo mô hình Domain-Driven Design (DDD)
- Được thiết kế để tạo ra các ứng dụng có thể bảo trì và mở rộng dễ dàng
- Mục tiêu: Cung cấp một cấu trúc dự án chuẩn, các thành phần cơ bản và công cụ phát triển hiệu quả
---
# CONTENT
## Nguyên tắc thiết kế
## Title: ZEE Quiz Application
app_ver: 1.0.0
doc_ver: A1
- **User-Centric**: Ưu tiên trải nghiệm người dùng, giảm thiểu sự phức tạp
- **Data-Oriented Programming (DOP)**: Thiết kế xoay quanh luồng dữ liệu và các biến đổi dữ liệu
- **Domain-Driven Design (DDD)**: Áp dụng các khái niệm cốt lõi (Bounded Context, Aggregates, Domain Events)
### Short Description:
An interactive quiz platform where users can discover their personality profile and participate in a lucky draw to win prizes.
## Tầm nhìn
- Tạo ra nền tảng phát triển linh hoạt, dễ mở rộng cho các dự án backend Golang
- Tích hợp các công nghệ hiện đại, best practices, và quy trình phát triển chuẩn
- Cung cấp môi trường phát triển thống nhất cho team
### Core Purpose:
To create an engaging microsite where users answer a series of questions to discover their "vibe" profile, with an opportunity to win prizes through a lucky draw, while collecting user data and promoting the C2 brand.
## Hướng dẫn cài đặt
### Target Audience:
- Primary: Young adults and professionals interested in personality quizzes
- Secondary: Marketing team for user engagement and brand promotion
### Yêu cầu hệ thống
- Go 1.23
- Docker và Docker Compose
- Git
## Key Features Overview:
- User registration and profile management
- Dynamic quiz with adaptive questions
- Personality profile generation
- Lucky draw with prize redemption
- Admin dashboard for content management
- Analytics and reporting
### Cài đặt
1. Clone repository
```bash
git clone [repo-url] my-project
cd my-project
```
## Core Technologies:
- Backend: Go 1.24.3 with DDD principles
- Database: PostgreSQL 14
- Frontend: HTMX
- Infrastructure: Docker, Docker Compose
- CI/CD: Gitea Actions
2. Thiết lập môi trường
```bash
cp .env.example .env
# Chỉnh sửa file .env theo nhu cầu
```
## Key Document References:
- [Architecture](architecture.md): System architecture and design decisions
- [API Documentation](api.md): Detailed API specifications
- [Deployment Guide](deployment.md): Setup and deployment instructions
- [Development Workflow](workflow.md): Development processes and guidelines
- [Security](cysec.md): Security policies and procedures
3. Khởi động dev server
```bash
make dev
```
## Reference Projects:
- ULFlow Golang Starter Kit: Base project structure
- C2 Brand Guidelines: Design and branding standards
## Cấu trúc thư mục
## Project Members:
- **Product Owner:** [Name]
- **Tech Lead:** [Name]
- **Backend Developers:** [Names]
- **Frontend Developers:** [Names]
- **QA Engineers:** [Names]
- **DevOps:** [Names]
Dự án được tổ chức theo cấu trúc DDD chuẩn, với các thành phần chính:
## Source Code Repository:
[ZEE Quiz Repository](https://gitea.tuvanwebsite.com/ulflow_phattt2901/zee-solution)
```
│── .gitea/ # Gitea workflows & hooks
│── cmd/ # Điểm vào của ứng dụng
│ └── app/ # Main application
│── internal/ # Mã nguồn chính của ứng dụng
│ │── domain/ # Các đối tượng nghiệp vụ cốt lõi
│ │ │── resource/ # Resource (Aggregates/Entities)
│ │ └── transaction/ # Transaction (Use Cases)
│ │── adapter/ # Giao tiếp với bên ngoài
│ │ │── persistence/ # Repository implementations
│ │ └── externalapi/ # External API clients
│ │── helper/ # Tiện ích chung
│ │ │── config/ # Configuration
│ │ │── logger/ # Logging
│ │ │── security/ # Authentication/Authorization
│ │ └── validation/ # Input validation
│ └── transport/ # Giao tiếp với client
│ └── http/ # HTTP handlers & middleware
│── docs/ # Tài liệu
│── templates/ # Các file mẫu
│── configs/ # File cấu hình
│── migrations/ # Database migrations
│── api/ # API definitions (OpenAPI/Swagger)
│── scripts/ # Các tiện ích
│── test/ # End-to-end tests
└── tools/ # Development tools
## Hỗ trợ và đóng góp
- Báo lỗi và feature request: Tạo issue trên repository
- Đóng góp: Tạo pull request theo quy trình được mô tả trong workflow.md
- Liên hệ: [email/contact-info]
## Project Management Tool:
[ZEE Project Board](https://gitea.tuvanwebsite.com/ulflow_phattt2901/zee-solution/issues)

198
docs/query.md Normal file
View File

@ -0,0 +1,198 @@
# GUIDE
This document catalogs key data queries using a standardized format. Each entry details the query's purpose, core logic, related database objects, full SQL code, important notes, and parameters (if applicable). The goal is to ensure clarity, facilitate understanding, and simplify usage and maintenance.
# FORMAT
## Title:
[Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## [Numerical order].[QUERY NAME]
### Main Functionality
[Briefly describe the core technical function the query performs. E.g., "Fetches unprocessed orders for VIP customers from the last month."]
### Key Logic/Steps
[List or briefly describe the main logical steps the query takes. Focus on complex or critical parts. E.g., 1. Filter VIP customers from the `Customers` table.]
### Related Objects
[List the main tables/views/functions used by the query.]
### Query (`sql` block)
```sql
[Full SQL query code here]
````
### Important Notes/Performance
[Note only particularly important points regarding logic, data, or performance issues/considerations]
### Parameters (if any)
- [Parameter Name] : [Data Type] - [Brief description of the parameter's role]
---
# CONTENT
## Title: ZEE Quiz Application
app_ver: 1.0.0
doc_ver: A1
## 1. User Authentication
### Main Functionality
Verifies user credentials and retrieves user profile data for authentication
### Key Logic/Steps
1. Check if user exists and is active
2. Verify password hash
3. Fetch user roles and permissions
4. Update last login timestamp
### Related Objects
- Tables: users, user_roles, roles, permissions
- Functions: verify_password_hash()
### Query
```sql
WITH user_data AS (
SELECT u.id, u.email, u.password_hash, u.status,
u.last_login_at, u.created_at,
array_agg(DISTINCT r.name) as roles,
array_agg(DISTINCT p.name) as permissions
FROM users u
LEFT JOIN user_roles ur ON u.id = ur.user_id
LEFT JOIN roles r ON ur.role_id = r.id
LEFT JOIN role_permissions rp ON r.id = rp.role_id
LEFT JOIN permissions p ON rp.permission_id = p.id
WHERE u.email = $1
GROUP BY u.id
)
UPDATE users
SET last_login_at = NOW()
FROM user_data
WHERE users.id = user_data.id
RETURNING user_data.*;
```
### Important Notes/Performance
- Uses a CTE for better readability and maintainability
- Indexes required on users(email), user_roles(user_id), role_permissions(role_id)
- Consider caching user permissions for 5 minutes
### Parameters
- $1 : TEXT - User's email address
## 2. Quiz Creation
### Main Functionality
Creates a new quiz with questions and answers
### Key Logic/Steps
1. Begin transaction
2. Insert quiz metadata
3. Insert questions
4. Insert answer options
5. Commit transaction
### Related Objects
- Tables: quizzes, questions, answers
- Triggers: update_quiz_stats
### Query
```sql
WITH new_quiz AS (
INSERT INTO quizzes (
title, description, category_id, creator_id,
time_limit, passing_score, is_public,
created_at, updated_at
) VALUES (
$1, $2, $3, $4, $5, $6, $7,
NOW(), NOW()
) RETURNING id
),
inserted_questions AS (
INSERT INTO questions (
quiz_id, question_text, question_type,
points, order_number
)
SELECT
(SELECT id FROM new_quiz),
q->>'text',
q->>'type',
(q->>'points')::integer,
row_number() OVER ()
FROM json_array_elements($8::json) q
RETURNING id, row_number() OVER ()
)
INSERT INTO answers (
question_id, answer_text, is_correct,
order_number
)
SELECT
q.id,
a->>'text',
(a->>'isCorrect')::boolean,
row_number() OVER (PARTITION BY q.id)
FROM inserted_questions q
CROSS JOIN json_array_elements(
(SELECT q->>'answers'
FROM json_array_elements($8::json) q
OFFSET q.row_number - 1
LIMIT 1
)::json
) a;
```
### Important Notes/Performance
- Transaction ensures data consistency
- JSON input allows flexible question/answer structure
- Trigger updates quiz statistics after question insertion
### Parameters
- $1 : TEXT - Quiz title
- $2 : TEXT - Quiz description
- $3 : UUID - Category ID
- $4 : UUID - Creator's user ID
- $5 : INTEGER - Time limit in minutes
- $6 : INTEGER - Passing score percentage
- $7 : BOOLEAN - Quiz visibility
- $8 : JSON - Questions and answers array
## 3. Quiz Results Analysis
### Main Functionality
Analyzes quiz attempt results and generates performance statistics
### Key Logic/Steps
1. Calculate overall scores
2. Identify correct/incorrect answers
3. Compute time spent per question
4. Generate performance metrics
### Related Objects
- Tables: quiz_attempts, attempt_answers, questions, answers
- Views: quiz_statistics
### Query
```sql
WITH attempt_stats AS (
SELECT
qa.id as attempt_id,
q.id as quiz_id,
q.title as quiz_title,
u.id as user_id,
u.email as user_email,
COUNT(aa.id) as total_questions,
SUM(CASE WHEN aa.answer_id = a.id AND a.is_correct THEN 1 ELSE 0 END) as correct_answers,
AVG(aa.time_spent) as avg_time_per_question,
qa.started_at,
qa.completed_at,
qa.score as final_score
FROM quiz_attempts qa
JOIN quizzes q ON qa.quiz_id = q.id
JOIN users u ON qa.user_id = u.id
JOIN attempt_answers aa ON qa.id = aa.attempt_id
JOIN answers a ON aa.answer_id = a.id
WHERE qa.completed_at >= NOW() - INTERVAL '30 days'
GROUP BY qa.id, q.id, q.title, u.id, u.email
)
SELECT
quiz_id,
quiz_title,
COUNT(DISTINCT user_id) as unique_participants,
AVG(final_score) as average_score,
MIN(final_score) as lowest_score,
MAX(final_score) as highest_score,
AVG(correct_answers::float / total_questions) * 100 as average_accuracy,
AVG(avg_time_per_question) as average_question_time,
AVG(EXTRACT(EPOCH FROM (completed_at - started_at))) as average_completion_time
FROM attempt_stats
GROUP BY quiz_id, quiz_title
ORDER BY average_score DESC;
```
### Important Notes/Performance
- Heavy aggregation query - consider materialized view
- Add indexes on quiz_attempts(completed_at)
- Partitioning by date range for large datasets
### Parameters
None - Query uses fixed 30-day window
---
*Last Updated: 2025-06-06*
*Next Review: 2025-07-01*

80
docs/review.md
View File

@ -1,80 +0,0 @@
🚀 Cải Thiện Luồng Xác Thực Cho Project Starter-Kit
Một Starter-kit chất lượng cần có hệ thống xác thực được xây dựng trên các nguyên tắc bảo mật và thực hành tốt nhất. Dưới đây là những cải thiện quan trọng:
1. Bảo Mật Refresh Token (RT) Phía Client – Ưu Tiên Hàng Đầu
Vấn đề cốt lõi: Lưu RT trong localStorage hoặc sessionStorage khiến chúng dễ bị tấn công XSS.
Giải pháp cho Starter-kit:
Sử dụng HttpOnly Cookies cho Refresh Token:
Bắt buộc: Starter-kit NÊN mặc định hoặc hướng dẫn rõ ràng việc sử dụng cookie HttpOnly để lưu RT. Điều này ngăn JavaScript phía client truy cập RT.
Access Token (AT) có thể được lưu trong bộ nhớ JavaScript (an toàn hơn localStorage cho AT có đời sống ngắn) hoặc sessionStorage nếu cần thiết cho SPA.
Thiết lập cờ Secure và SameSite cho Cookie:
Secure: Đảm bảo cookie chỉ được gửi qua HTTPS.
SameSite=Strict (hoặc SameSite=Lax): Giúp chống lại tấn công CSRF. Starter-kit NÊN có cấu hình này.
2. Quản Lý Refresh Token Phía Server – Đảm Bảo An Toàn
Thực hành tốt đã có: Refresh Token Rotation (xoay vòng RT khi sử dụng) là rất tốt.
Cải thiện cho Starter-kit:
Vô hiệu hóa RT cũ NGAY LẬP TỨC khi xoay vòng: Đảm bảo RT đã sử dụng không còn giá trị.
Thu hồi RT khi Logout: Endpoint /api/v1/auth/logout PHẢI xóa hoặc đánh dấu RT là đã thu hồi trong cơ sở dữ liệu. Chỉ xóa ở client là không đủ.
(Khuyến nghị cho Starter-kit nâng cao): Cân nhắc cơ chế phát hiện việc sử dụng RT đã bị đánh cắp (ví dụ: nếu một RT cũ được dùng lại sau khi đã xoay vòng, hãy thu hồi tất cả RT của user đó).
3. Tăng Cường Quy Trình Đăng Ký – Nền Tảng Người Dùng
Cải thiện cho Starter-kit:
Chính Sách Mật Khẩu Tối Thiểu:
Yêu cầu độ dài mật khẩu tối thiểu (ví dụ: 8 hoặc 10 ký tự). Starter-kit NÊN có điều này.
(Tùy chọn): Khuyến khích hoặc yêu cầu kết hợp chữ hoa, chữ thường, số, ký tự đặc biệt.
Xác Thực Email (Khuyến Nghị Mạnh Mẽ):
Starter-kit NÊN bao gồm module hoặc hướng dẫn tích hợp quy trình gửi email xác thực để kích hoạt tài khoản. Điều này giúp đảm bảo email hợp lệ và là kênh liên lạc quan trọng.
4. Bảo Vệ Chống Tấn Công Đăng Nhập – Lớp Phòng Thủ Cơ Bản
Cải thiện cho Starter-kit:
Rate Limiting cho Endpoint Đăng Nhập: Áp dụng giới hạn số lần thử đăng nhập thất bại (/api/v1/auth/login) dựa trên IP hoặc username/email.
Thông Báo Lỗi Chung Chung: Tránh các thông báo lỗi tiết lộ thông tin (ví dụ: "Username không tồn tại" hoặc "Sai mật khẩu"). Thay vào đó, sử dụng thông báo chung như "Tên đăng nhập hoặc mật khẩu không chính xác."
5. Thực Hành Tốt Nhất với JWT – Cốt Lõi Của Xác Thực
Cải thiện cho Starter-kit:
Quản Lý Secret Key An Toàn:
Hướng dẫn lưu trữ JWT secret key trong biến môi trường (environment variables).
Tuyệt đối KHÔNG hardcode secret key trong mã nguồn.
Sử Dụng Thuật Toán Ký Mạnh:
Mặc định sử dụng thuật toán đối xứng mạnh như HS256.
Khuyến nghị và cung cấp tùy chọn cho thuật toán bất đối xứng như RS256 (yêu cầu quản lý cặp public/private key) cho các hệ thống phức tạp hơn.
Giữ Payload của Access Token Nhỏ Gọn:
Chỉ chứa thông tin cần thiết nhất (ví dụ: userId, roles).
Cân nhắc thêm iss (issuer) và aud (audience) để tăng cường xác minh token.
6. Xử Lý Lỗi và Ghi Log (Logging) An Toàn
Cải thiện cho Starter-kit:
Không Ghi Log Thông Tin Nhạy Cảm: Tuyệt đối KHÔNG ghi log Access Token, Refresh Token, hoặc mật khẩu dưới bất kỳ hình thức nào.
Ghi Log Sự Kiện An Ninh: Hướng dẫn hoặc cung cấp cơ chế ghi log các sự kiện quan trọng (đăng nhập thành công/thất bại, yêu cầu làm mới token, thay đổi mật khẩu) một cách an toàn, không kèm dữ liệu nhạy cảm, để phục vụ việc giám sát và điều tra.
Bằng cách tích hợp những cải tiến này, Starter-kit của bạn sẽ cung cấp một điểm khởi đầu vững chắc và an toàn hơn cho các nhà phát triển.

212
docs/roadmap.md
View File

@ -1,98 +1,144 @@
# Roadmap phát triển
# GUIDE
This document outlines the project roadmap, broken down into distinct phases. Each phase contains specific milestones or features, further detailed by individual tasks. The status of each task (pending or completed) and its completion date are tracked to monitor progress effectively.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## Phase [Numerical Order] : [Pharse Name]
## Roadmap cơ bản
- [x] Read Config from env file
- [x] HTTP Server with gin framework
- [x] JWT Authentication
- [x] Đăng ký người dùng
- [x] Đăng nhập với JWT
- [x] Refresh token
- [x] Xác thực token với middleware
- [x] Phân quyền cơ bản
- [x] Database with GORM + Postgres
- [ ] Health Check
- [ ] Unit Test with testify (Template)
- [ ] CI/CD with Gitea for Dev Team
- [ ] Build and Deploy with Docker + Docker Compose on Local
### [Milestone/Feature Name]
[Brief description of the milestone/feature]
* **Tasks:**
* [ ] [Task 1 Description] (Completed: [YYYY-MM-DD])
* [x] [Task 2 Description] (Completed: [YYYY-MM-DD])
* [ ] [Task 3 Description] (Completed: [YYYY-MM-DD])
* [ ] [Task 4 Description] (Completed: [YYYY-MM-DD])
## Giai đoạn 1: Cơ sở hạ tầng cơ bản
- [x] Thiết lập cấu trúc dự án theo mô hình DDD
- [x] Cấu hình cơ bản: env, logging, error handling
- [x] Cấu hình Docker và Docker Compose
- [x] HTTP server với Gin
- [x] Database setup với GORM và Postgres
- [ ] Health check API endpoints
- Timeline: Q2/2025
---
# CONTENT
## Title: ZEE Quiz Application - Development Roadmap
app_ver: 1.0.0
doc_ver: A1
## Giai đoạn 2: Bảo mật và xác thực (Q2/2025)
## Phase 1: Foundation & Core Features (Weeks 1-4)
### 1. Xác thực và Ủy quyền
- [x] **JWT Authentication**
- [x] Đăng ký/Đăng nhập cơ bản
- [x] Refresh token
- [x] Xác thực token với middleware
- [x] Xử lý hết hạn token
### Authentication & User Management
Secure user authentication and profile management system
* **Tasks:**
* [x] User registration and login (Completed: 2025-06-01)
* [x] Email verification (Completed: 2025-06-03)
* [x] Password reset functionality (Completed: 2025-06-04)
* [ ] User profile management (Target: 2025-06-10)
* [ ] Role-based access control (Target: 2025-06-12)
### Quiz Creation & Management
Core functionality for creating and managing quizzes
* **Tasks:**
* [x] Database schema design (Completed: 2025-05-28)
* [x] Quiz CRUD operations (Completed: 2025-06-02)
* [ ] Question types implementation (Target: 2025-06-15)
* [ ] Quiz publishing workflow (Target: 2025-06-18)
* [ ] Quiz categories and tags (Target: 2025-06-20)
- [x] **Phân quyền cơ bản**
- [x] Phân quyền theo role
- [ ] Quản lý role và permission
- [ ] Phân quyền chi tiết đến từng endpoint
- [ ] API quản lý người dùng và phân quyền
## Phase 2: User Experience & Engagement (Weeks 5-8)
### 2. Bảo mật Ứng dụng
- [ ] **API Security**
- [ ] API rate limiting (throttling)
- [ ] Request validation và sanitization
- [ ] Chống tấn công DDoS cơ bản
- [ ] API versioning
### Quiz Taking Experience
Smooth and interactive quiz taking interface
* **Tasks:**
* [ ] Question navigation (Target: 2025-06-25)
* [ ] Timer functionality (Target: 2025-06-27)
* [ ] Progress tracking (Target: 2025-06-29)
* [ ] Save & resume feature (Target: 2025-07-02)
* [ ] Offline support (Target: 2025-07-05)
- [ ] **Security Headers**
- [x] CORS configuration
- [ ] Security headers (CSP, HSTS, X-Content-Type, X-Frame-Options)
- [ ] Content Security Policy (CSP) tùy chỉnh
- [ ] XSS protection
### Results & Analytics
Comprehensive results and performance tracking
* **Tasks:**
* [ ] Score calculation (Target: 2025-07-08)
* [ ] Performance analytics (Target: 2025-07-12)
* [ ] Results sharing (Target: 2025-07-15)
* [ ] Certificate generation (Target: 2025-07-18)
### 3. Theo dõi và Giám sát
- [ ] **Audit Logging**
- [ ] Ghi log các hoạt động quan trọng
- [ ] Theo dõi đăng nhập thất bại
- [ ] Cảnh báo bảo mật
## Phase 3: Advanced Features (Weeks 9-12)
- [ ] **Monitoring**
- [ ] Tích hợp Prometheus
- [ ] Dashboard giám sát
- [ ] Cảnh báo bất thường
### Social Features
Community and sharing capabilities
* **Tasks:**
* [ ] User profiles (Target: 2025-07-22)
* [ ] Leaderboards (Target: 2025-07-25)
* [ ] Quiz sharing (Target: 2025-07-28)
* [ ] Comments and ratings (Target: 2025-07-31)
### 4. Cải thiện Hiệu suất
- [ ] **Tối ưu hóa**
- [ ] Redis cho caching
- [ ] Tối ưu truy vấn database
- [ ] Compression response
### Advanced Quiz Types
Support for various quiz formats
* **Tasks:**
* [ ] Matching questions (Target: 2025-08-05)
* [ ] Drag and drop (Target: 2025-08-08)
* [ ] Image-based questions (Target: 2025-08-12)
* [ ] Audio/Video questions (Target: 2025-08-15)
### Timeline
- Tuần 1-2: Hoàn thiện xác thực & phân quyền
- Tuần 3-4: Triển khai bảo mật API và headers
- Tuần 5-6: Hoàn thiện audit logging và monitoring
- Tuần 7-8: Tối ưu hiệu suất và kiểm thử bảo mật
## Phase 4: Polish & Optimization (Weeks 13-16)
## Giai đoạn 3: Tự động hóa
- [ ] Unit Test templates và mocks
- [ ] CI/CD với Gitea
- [ ] Automated deployment
- [ ] Linting và code quality checks
- Timeline: Q3/2025
### Performance & Security
Application optimization and security hardening
* **Tasks:**
* [ ] Performance audit (Target: 2025-08-20)
* [ ] Security audit (Target: 2025-08-22)
* [ ] Database optimization (Target: 2025-08-25)
* [ ] Caching implementation (Target: 2025-08-28)
## Giai đoạn 4: Mở rộng tính năng
- [x] Go Feature Flag implementation
- [ ] Notification system
- [ ] Background job processing
- [ ] API documentation
- Timeline: Q3/2025
### User Experience Refinements
Enhancements based on user feedback
* **Tasks:**
* [ ] UI/UX improvements (Target: 2025-09-01)
* [ ] Accessibility enhancements (Target: 2025-09-05)
* [ ] Mobile responsiveness (Target: 2025-09-08)
* [ ] Loading state optimization (Target: 2025-09-12)
## Giai đoạn 5: Production readiness
- [x] Performance optimization
- [ ] Monitoring và observability
- [ ] Backup và disaster recovery
- [ ] Security hardening
- Timeline: Q4/2025
## Phase 5: Launch & Growth (Week 17+)
### Beta Testing & Launch
Preparation for public release
* **Tasks:**
* [ ] Closed beta testing (Target: 2025-09-15)
* [ ] Bug fixes and improvements (Target: 2025-09-22)
* [ ] Public beta launch (Target: 2025-09-29)
* [ ] Official v1.0 release (Target: 2025-10-06)
### Post-Launch Features
Future enhancements and scaling
* **Tasks:**
* [ ] User feedback system (Target: 2025-10-15)
* [ ] Advanced analytics dashboard (Target: 2025-10-22)
* [ ] API for third-party integration (Target: 2025-10-29)
* [ ] Mobile app development (Target: 2025-11-15)
## Key Performance Indicators (KPIs)
- **User Acquisition**: 1,000 registered users within first month
- **Engagement**: 60% of users return within a week
- **Completion Rate**: 75% quiz completion rate
- **Performance**: <2s page load time, 99.9% uptime
- **Satisfaction**: 4.5/5 average user rating
## Dependencies & Risks
- **Dependencies**:
- Third-party authentication services
- Cloud hosting infrastructure
- Payment gateway integration (for future premium features)
- **Risks**:
- User adoption lower than expected
- Performance issues at scale
- Security vulnerabilities
- Browser/device compatibility issues
## Future Considerations
- AI-powered question generation
- Virtual proctoring for certifications
- Integration with learning management systems
- Multi-language support
- Gamification elements (badges, achievements)
---
*Last Updated: 2025-06-06*
*Next Review: 2025-06-08*

244
docs/schema.md Normal file
View File

@ -0,0 +1,244 @@
# ZEE Quiz Application - Database Schema
app_ver: 1.0.0
doc_ver: A1
## Database Schema
### 1. Primary Database (PostgreSQL 14)
* **DB Type:** Relational
* **Technology:** PostgreSQL 14
* **Purpose:** Primary data store for all application data
* **Connection String:** `postgresql://user:password@host:5432/zee_quiz`
#### Tables
##### 1.1. users
```sql
CREATE TABLE users (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
email VARCHAR(255) UNIQUE NOT NULL,
password_hash VARCHAR(255) NOT NULL,
full_name VARCHAR(255) NOT NULL,
role VARCHAR(50) NOT NULL DEFAULT 'user',
is_active BOOLEAN DEFAULT true,
last_login_at TIMESTAMP WITH TIME ZONE,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_users_email ON users(email);
CREATE INDEX idx_users_role ON users(role);
```
##### 1.2. profiles
```sql
CREATE TABLE profiles (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
user_id UUID REFERENCES users(id) ON DELETE CASCADE,
date_of_birth DATE NOT NULL,
gender VARCHAR(20) NOT NULL,
preferred_gender VARCHAR(20) NOT NULL,
phone_number VARCHAR(20),
facebook_link VARCHAR(255),
location VARCHAR(100),
team VARCHAR(50),
hobbies TEXT[],
things_not_tried TEXT,
hopes_for_partner TEXT,
dealbreakers TEXT,
message_to_partner TEXT,
zodiac_sign VARCHAR(20),
access_code VARCHAR(20) UNIQUE,
personal_link VARCHAR(255),
is_lucky_winner BOOLEAN DEFAULT false,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_profiles_user_id ON profiles(user_id);
CREATE INDEX idx_profiles_access_code ON profiles(access_code);
```
##### 1.3. photos
```sql
CREATE TABLE photos (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
profile_id UUID REFERENCES profiles(id) ON DELETE CASCADE,
url VARCHAR(512) NOT NULL,
is_primary BOOLEAN DEFAULT false,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_photos_profile_id ON photos(profile_id);
```
##### 1.4. quizzes
```sql
CREATE TABLE quizzes (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
title VARCHAR(255) NOT NULL,
description TEXT,
start_time TIMESTAMP WITH TIME ZONE NOT NULL,
end_time TIMESTAMP WITH TIME ZONE NOT NULL,
time_limit_seconds INT DEFAULT 300, -- 5 minutes
is_active BOOLEAN DEFAULT true,
created_by UUID REFERENCES users(id),
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP,
updated_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_quizzes_active ON quizzes(is_active, start_time, end_time);
```
##### 1.5. questions
```sql
CREATE TABLE questions (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
quiz_id UUID REFERENCES quizzes(id) ON DELETE CASCADE,
question_text TEXT NOT NULL,
question_type VARCHAR(50) NOT NULL, -- multiple_choice, true_false, short_answer
options JSONB,
correct_answer TEXT,
points INT DEFAULT 1,
display_order INT NOT NULL,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_questions_quiz_id ON questions(quiz_id);
```
##### 1.6. user_answers
```sql
CREATE TABLE user_answers (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
user_id UUID REFERENCES users(id) ON DELETE CASCADE,
quiz_id UUID REFERENCES quizzes(id) ON DELETE CASCADE,
question_id UUID REFERENCES questions(id) ON DELETE CASCADE,
answer_text TEXT,
is_correct BOOLEAN,
points_earned INT DEFAULT 0,
time_taken_seconds INT,
created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
-- Indexes
CREATE INDEX idx_user_answers_user_quiz ON user_answers(user_id, quiz_id);
CREATE INDEX idx_user_answers_question ON user_answers(question_id);
```
### 2. Cache (Redis 7)
* **DB Type:** Key-Value
* **Technology:** Redis 7
* **Purpose:** Caching, rate limiting, and session storage
* **Connection String:** `redis://:password@host:6379/0`
#### Key Patterns
- `user:sessions:{session_id}` - User session data
- `quiz:leaderboard:{quiz_id}` - Sorted set for quiz leaderboard
- `rate_limit:{ip_address}` - Rate limiting counters
- `user:profile:{user_id}` - Cached user profile data
- `quiz:active` - Set of active quiz IDs
### 3. File Storage (AWS S3)
* **DB Type:** Object Storage
* **Technology:** AWS S3
* **Purpose:** Storing user-uploaded files (profile photos, quiz images)
* **Bucket Name:** `zee-quiz-{environment}`
#### Directory Structure
```
zquiz/
├── profiles/
│ └── {user_id}/
│ ├── {photo_id}.jpg
│ └── {photo_id}_thumbnail.jpg
└── quizzes/
└── {quiz_id}/
└── {question_id}.{ext}
```
## Data Structures
### 1. User Session
```go
type UserSession struct {
ID string `json:"id"`
UserID string `json:"user_id"`
Email string `json:"email"`
Role string `json:"role"`
IPAddress string `json:"ip_address"`
UserAgent string `json:"user_agent"`
LastActivity time.Time `json:"last_activity"`
ExpiresAt time.Time `json:"expires_at"`
}
```
### 2. Quiz Question
```go
type Question struct {
ID string `json:"id"`
QuizID string `json:"quiz_id"`
QuestionText string `json:"question_text"`
QuestionType string `json:"question_type"` // multiple_choice, true_false, short_answer
Options []string `json:"options,omitempty"`
CorrectAnswer string `json:"correct_answer,omitempty"`
Points int `json:"points"`
DisplayOrder int `json:"display_order"`
MediaURL string `json:"media_url,omitempty"`
CreatedAt time.Time `json:"created_at"`
}
```
### 3. Quiz Result
```go
type QuizResult struct {
UserID string `json:"user_id"`
QuizID string `json:"quiz_id"`
TotalQuestions int `json:"total_questions"`
CorrectAnswers int `json:"correct_answers"`
TotalPoints int `json:"total_points"`
Score float64 `json:"score"` // Percentage
TimeCompleted time.Time `json:"time_completed"`
Rank int `json:"rank,omitempty"`
}
```
## Database Migrations
### Initial Migration (0001_initial.up.sql)
```sql
-- This file is auto-generated and managed by the golang-migrate tool
-- It contains all the initial table creation statements
-- Enable UUID extension
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-- Create users table
-- (Include all table creation SQL from above)
```
## Performance Considerations
### Indexing Strategy
- All foreign keys are indexed
- Frequently queried columns have appropriate indexes
- Composite indexes for common query patterns
### Partitioning
- User answers table is partitioned by `quiz_id` for large-scale deployments
- Old quiz data can be archived to cold storage
### Caching Strategy
- User sessions and active quiz data are cached in Redis
- Leaderboards are maintained in Redis sorted sets
- Profile data is cached with TTL
---
*Document Version: A1*
*Last Updated: 2025-06-06*

125
docs/screen.md Normal file
View File

@ -0,0 +1,125 @@
# GUIDE
This document details the User Interface (UI) design specifications primarily focuses on the visual and interactive elements, referencing the core design principles, linking to design files (e.g., Figma), outlining design system usage, and providing a screen-by-screen breakdown of UI components, their properties, and behaviors.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## CORE PRINCIPLES
[Design Principles]
Design: [Link Figma/Design File]
## Design System
[Category (Color, Typography, Space, Icon)] : [Rules]
## Screen
### [Numerical order].[Screen Name]
#### Purpose
[Description about screen]
#### Component
#### Component
| Content | Element | Logic | Main Event | Animation |
| -------------------- | ------------ | ---------------- | ---------- | ----------- |
| [Content Desciption] | [UI Element] | [Business Logic] | [Event] | [Animation] |
| ... | ... | ... | ... | ... |
#### Flow
- In: [from Screens]
- Out: [to Screen]
#### Connect
[API endpoint]
---
# CONTENT
## Title: ZEE Quiz Application
app_ver: 1.0.0
doc_ver: A1
## Design System
### Color
- Primary: #4F46E5 (Indigo-600)
- Secondary: #10B981 (Emerald-500)
- Error: #EF4444 (Red-500)
- Background: #FFFFFF
- Text: #111827 (Gray-900)
### Typography
- Family: 'Inter', system-ui
- Scale:
- H1: 3rem/48px
- H2: 2.25rem/36px
- Body: 1rem/16px
- Small: 0.875rem/14px
### Space
- Base: 4px
- Scale: 4, 8, 16, 24, 32, 48
### Icon
- Source: Heroicons
- Size: 20x20px
## Screen
### 1. Authentication
#### Purpose
Handle user login and registration
#### Component
| Content | Element | Logic | Main Event | Animation |
|---------|----------|--------|------------|------------|
| Login Form | Form | Validate credentials | onSubmit | Fade in |
| Email | Input | Required, email format | onChange | None |
| Password | Input | Required, min 8 chars | onChange | None |
| Submit | Button | Enable if form valid | onClick | Scale |
#### Flow
- In: Landing, Register
- Out: Dashboard
#### Connect
/api/auth/login
### 2. Dashboard
#### Purpose
Main user interface showing quizzes and stats
#### Component
| Content | Element | Logic | Main Event | Animation |
|---------|----------|--------|------------|------------|
| Quiz List | Grid | Fetch active quizzes | onLoad | Fade in |
| Stats | Cards | Calculate user stats | onLoad | Slide up |
| Quick Actions | Buttons | Role-based access | onClick | Scale |
#### Flow
- In: Auth, Quiz Complete
- Out: Quiz, Profile
#### Connect
/api/dashboard
### 3. Quiz Taking
#### Purpose
Interface for attempting quizzes
#### Component
| Content | Element | Logic | Main Event | Animation |
|---------|----------|--------|------------|------------|
| Question | Card | Load question data | onNext | Slide |
| Timer | Display | Countdown timer | onTick | Pulse |
| Options | Radio Group | Single selection | onChange | Scale |
| Navigation | Buttons | Question flow | onClick | Slide |
#### Flow
- In: Dashboard, Quiz List
- Out: Results
#### Connect
/api/quiz/{id}
### 4. Results
#### Purpose
Show quiz completion results
#### Component
| Content | Element | Logic | Main Event | Animation |
|---------|----------|--------|------------|------------|
| Score | Display | Calculate final score | onLoad | Count up |
| Review | List | Show correct answers | onClick | Fade in |
| Share | Button | Generate share link | onClick | Scale |
#### Flow
- In: Quiz Taking
- Out: Dashboard
#### Connect
/api/quiz/{id}/results
---
*Last Updated: 2025-06-06*
*Next Review: 2025-07-01*

136
docs/secrets.md
View File

@ -1,136 +0,0 @@
# CI/CD Workflows
ULFlow Starter Kit sử dụng Gitea Actions để tự động hóa quy trình CI/CD. Tài liệu này mô tả các workflow được cấu hình và các biến cần thiết.
## Tổng quan về quy trình
Quy trình CI/CD được thiết kế để hoạt động như sau:
1. **CI Pipeline** chạy trên tất cả các nhánh ngoại trừ `main`
2. **Docker Build** chạy khi đánh tag hoặc sau khi merge vào `main`
3. **Deploy to VPS** chỉ chạy khi đánh tag phiên bản (format `v*`)
## Workflow Files
### 1. CI Pipeline (`.gitea/workflows/ci.yml`)
CI Pipeline chạy trên tất cả các nhánh ngoại trừ `main` và bao gồm các job:
- **Lint**: Kiểm tra chất lượng mã với golangci-lint
- **Security Scan**: Quét lỗ hổng bảo mật với govulncheck
- **Test**: Chạy unit tests và tạo báo cáo coverage
- **Build**: Build ứng dụng và tạo artifact
- **Notify**: Thông báo kết quả
### 2. Docker Build & Deploy (`.gitea/workflows/docker.yml`)
Workflow này chạy khi:
- Đánh tag phiên bản (format `v*`)
- Sau khi CI Pipeline thành công trên nhánh `main`
Bao gồm các job:
- **Docker Build**: Build và push Docker image lên Gitea Container Registry
- **Deploy to VPS**: Triển khai ứng dụng lên VPS (chỉ khi đánh tag)
## Cấu hình Secrets
Để các workflow hoạt động đúng, bạn cần cấu hình các secrets sau trong Gitea:
### Secrets cho Runner
| Secret | Mô tả | Mặc định |
|--------|-------|----------|
| `RUNNER_LABEL` | Label của runner cho các job CI | `ubuntu-latest` |
| `DEPLOY_RUNNER` | Label của runner cho job deploy | `ubuntu-latest` |
### Secrets cho Docker Registry
| Secret | Mô tả | Bắt buộc |
|--------|-------|----------|
| `REGISTRY_URL` | URL của Gitea Container Registry | ✅ |
| `REGISTRY_USERNAME` | Username để đăng nhập vào registry | ✅ |
| `REGISTRY_PASSWORD` | Password để đăng nhập vào registry | ✅ |
| `REPOSITORY_PATH` | Đường dẫn repository trong registry | ✅ |
### Secrets cho Deployment
| Secret | Mô tả | Mặc định |
|--------|-------|----------|
| `CONTAINER_NAME` | Tên container | `ulflow-api-container` |
| `DOCKER_NETWORK` | Tên network Docker | `ulflow-network` |
| `APP_PORT` | Port để expose | `3000` |
| `APP_ENV` | Môi trường ứng dụng | `production` |
| `CONTAINER_MEMORY` | Giới hạn bộ nhớ | `1g` |
| `CONTAINER_CPU` | Giới hạn CPU | `1` |
| `HEALTH_CMD` | Command kiểm tra health | `curl -f http://localhost:3000/health || exit 1` |
| `HEALTH_INTERVAL` | Khoảng thời gian kiểm tra health | `30s` |
### Secrets cho Database
| Secret | Mô tả | Bắt buộc |
|--------|-------|----------|
| `DB_HOST` | Hostname của database | ✅ |
| `DB_USER` | Username database | ✅ |
| `DB_PASSWORD` | Password database | ✅ |
| `DB_NAME` | Tên database | ✅ |
### Secrets cho Security
| Secret | Mô tả | Bắt buộc |
|--------|-------|----------|
| `JWT_SECRET_KEY` | Secret key cho JWT | ✅ |
| `REFRESH_TOKEN_SECRET` | Secret key cho refresh token | ✅ |
| `API_KEY` | API key | ✅ |
| `ENCRYPTION_KEY` | Key mã hóa dữ liệu | ✅ |
## Cấu hình Gitea
### Tạo Secrets trong Gitea
1. Truy cập repository trong Gitea
2. Vào **Settings > Secrets**
3. Thêm từng secret với tên và giá trị tương ứng
### Cấu hình Runner
1. Đảm bảo Gitea Runner đã được cài đặt và kết nối với Gitea
2. Nếu sử dụng custom runner, cập nhật `RUNNER_LABEL` và `DEPLOY_RUNNER` tương ứng
## Ví dụ quy trình làm việc
1. **Phát triển tính năng:**
```bash
git checkout -b feat/new-feature
# Làm việc và commit
git push origin feat/new-feature
```
→ CI Pipeline tự động chạy
2. **Merge vào main:**
- Tạo Pull Request từ `feat/new-feature` vào `main`
- Sau khi merge, Docker Build tự động chạy
3. **Release phiên bản:**
```bash
git tag v1.0.0
git push origin v1.0.0
```
→ Docker Build và Deploy tự động chạy
## Troubleshooting
### Workflow không chạy
- Kiểm tra Gitea Runner đã được cấu hình đúng
- Kiểm tra quyền của repository và runner
### Docker Build thất bại
- Kiểm tra thông tin đăng nhập registry
- Kiểm tra quyền truy cập vào registry
### Deploy thất bại
- Kiểm tra kết nối đến VPS
- Kiểm tra Docker đã được cài đặt trên VPS
- Kiểm tra các biến môi trường đã được cấu hình đúng

32
docs/session_20240524.md
View File

@ -1,32 +0,0 @@
# Tóm tắt phiên làm việc - 24/05/2025
## Các file đang mở
1. `docs/roadmap.md` - Đang xem mục tiêu phát triển
2. `configs/config.yaml` - File cấu hình ứng dụng
3. `docs/review.md` - Đang xem phần đánh giá code
## Các thay đổi chính trong phiên
### 1. Cập nhật Roadmap
- Đánh dấu hoàn thành các mục JWT Authentication
- Cập nhật chi tiết Giai đoạn 2 (Bảo mật và xác thực)
- Thêm timeline chi tiết cho từng tuần
### 2. Giải thích luồng xác thực
- Đã giải thích chi tiết về luồng JWT authentication
- Mô tả các endpoint chính và cách hoạt động
- Giải thích về bảo mật token và xử lý lỗi
### 3. Các lệnh đã sử dụng
- `/heyy` - Thảo luận về các bước tiếp theo
- `/yys` - Thử lưu trạng thái (không khả dụng)
## Công việc đang thực hiện
- Đang xem xét phần đánh giá code liên quan đến xử lý lỗi khởi động service
## Ghi chú
- Cần hoàn thiện phần Health Check API
- Cần triển khai API rate limiting và security headers
---
*Tự động tạo lúc: 2025-05-24 12:26*

275
docs/spec.md
View File

@ -1,130 +1,161 @@
# Thông số kỹ thuật
# GUIDE
This document provides detailed functional specifications for key components. It outlines the purpose, inputs, outputs, logic, and error handling for specific functions within designated files. Additionally, it visualizes and explains the overall sequence of operations for major user flows or processes using sequence diagrams. This serves as a technical reference for understanding the implementation details and interactions within the application.
# FORMAT
## Title: [Application/Website Name]
app_ver: [app_ver]
doc_ver: [doc_ver]
## Specifications
### [Numerical order].[File Name]
### [Numerical order].[Function Name]
#### Input
[Parameters] : [Description and format]
#### Output
[Return Value/Object] : [Description and format]
#### Description
[Brief description of the function's purpose within the file]
#### Logic
[Detailed description of the processing logic; consider using numbered steps or pseudocode for clarity. Description of any side effects if any (e.g., database updates, external API calls)]
#### Error Handling:
[Description of how errors are detected and handled]
## Tech Stack
- **Golang 1.23.6**: Ngôn ngữ chính dùng phát triển backend
- **Docker + Docker Compose**: Containerization và orchestration
- **Air Tomb v1.49.0**: Hot reload cho phát triển
- **Gitea v1.21.0+**: Server, Runner, Action, Secret Manager, Registry Image
- **PostgreSQL 15+**: Cơ sở dữ liệu quan hệ
- **Ansible 2.14+**: Tự động hóa quy trình triển khai
- **Go Feature Flag v1.9.0+**: Quản lý tính năng
---
# CONTENT
## Yêu cầu hệ thống
- Go 1.23.6+
- Docker Engine 24.0.0+
- Docker Compose v2.20.0+
- Git 2.40.0+
- PostgreSQL 15.0+
- Make (cho các tác vụ phát triển)
## Title: ZEE Quiz Application
app_ver: 1.0.0
doc_ver: A1
## Thư viện và frameworks chính
### Web Framework
- **Gin v1.10.0**: HTTP framework nhẹ, hiệu suất cao
- Middleware hỗ trợ: CORS, JWT, Rate limiting
- Tích hợp sẵn validator
### Database
- **GORM v1.26.1**: ORM cho Go
- Hỗ trợ nhiều database: PostgreSQL, MySQL, SQLite
- Migration tools tích hợp
- Connection pooling và retry mechanisms
### Authentication & Security
- **JWT (JSON Web Tokens)**
- **UUID v1.6.0**: Định danh duy nhất
- **bcrypt**: Mã hóa mật khẩu
### Configuration
- **Viper v1.17.0**: Quản lý cấu hình linh hoạt
- Hỗ trợ nhiều định dạng (JSON, YAML, TOML, ENV)
- Tích hợp với biến môi trường
### Logging
- **Logrus v1.9.3**: Thư viện logging cấu trúc
```yaml
logger:
level: "info" # debug, info, warn, error, fatal, panic
format: "json" # json hoặc text
enable_caller: true # Hiển thị thông tin người gọi
```
- Hỗ trợ nhiều mức độ log
- Tích hợp với các hệ thống log tập trung
- JSON format cho dễ phân tích
### Testing
- **Testify v1.10.0**: Framework testing cho Go
- Assertions mạnh mẽ
- Mock generation
- Test suites
- **go-sqlmock v1.5.0+**: Mock database
- **testcontainers-go**: Integration testing
### Monitoring & Observability
- **Prometheus**: Metrics collection
- **OpenTelemetry**: Distributed tracing
- **Health check endpoints**
- **Pprof**: Profiling
### Development Tools
- **GolangCI-Lint**: Static code analysis
- **Air Tomb**: Hot reload
- **Go Mod**: Quản lý dependencies
- **Makefile**: Tự động hóa tác vụ
## Cấu hình môi trường
### Development
- Hot reload với Air Tomb
- Local Docker environment
- Sample data và fixtures
### Testing
- CI/CD với Gitea Actions
- Automated test suites
- Lint và code quality checks
### Staging
- Triển khai tự động
- Môi trường gần với production
- Performance testing
### Production
- High availability setup
- Backup và disaster recovery
- Security hardening
## Quản lý cấu hình
ULFlow Starter Kit sử dụng một hệ thống cấu hình linh hoạt dựa trên Viper:
### Đặc điểm
- Đọc cấu hình từ nhiều nguồn (file, biến môi trường)
- Xác thực tự động các giá trị
- Giá trị mặc định thông minh
- Cấu trúc mạnh (strongly typed configuration)
### Sử dụng
## Specifications
### 1. auth/service.go
### 1.1. AuthenticateUser
#### Input
- credentials : AuthCredentials
```go
// Khởi tạo config loader
configLoader := config.NewConfigLoader()
// Load cấu hình
cfg, err := configLoader.Load()
if err != nil {
log.Fatalf("Failed to load configuration: %v", err)
type AuthCredentials struct {
Email string `json:"email"`
Password string `json:"password"`
}
// Truy cập cấu hình
appName := cfg.App.Name
dbHost := cfg.Database.Host
```
#### Output
- AuthResponse : Authentication result with token
```go
type AuthResponse struct {
Token string `json:"token"`
RefreshToken string `json:"refresh_token"`
ExpiresAt time.Time `json:"expires_at"`
User UserInfo `json:"user"`
}
```
#### Description
Authenticate user credentials and generate JWT token for authorized access
#### Logic
1. Validate email format and password length
2. Hash password using bcrypt
3. Query user from database by email
4. Compare password hashes
5. Generate JWT token with user claims
6. Create refresh token and store in Redis
7. Update last login timestamp
8. Return tokens and user info
#### Error Handling
- Invalid email format: Return 400 Bad Request
- User not found: Return 401 Unauthorized
- Invalid password: Return 401 Unauthorized
- Database error: Return 500 Internal Server Error
## Các tệp cấu hình
- `.env.example`: Template biến môi trường
- `configs/config.yaml`: Cấu hình ứng dụng trong môi trường dev
- `templates/config.example.yaml`: Template cấu hình ứng dụng
- `docker-compose.yml`: Cấu hình container
- `go.mod`, `go.sum`: Quản lý dependencies
### 2. quiz/service.go
### 2.1. CreateQuiz
#### Input
- quizData : QuizCreationRequest
```go
type QuizCreationRequest struct {
Title string `json:"title"`
Description string `json:"description"`
TimeLimit int `json:"time_limit"`
Questions []QuestionDTO `json:"questions"`
}
```
#### Output
- QuizResponse : Created quiz details
```go
type QuizResponse struct {
ID string `json:"id"`
Title string `json:"title"`
Description string `json:"description"`
CreatedAt time.Time `json:"created_at"`
Questions int `json:"question_count"`
}
```
#### Description
Create a new quiz with questions and answers in the database
#### Logic
1. Validate quiz data (title, time limit, questions)
2. Begin database transaction
3. Create quiz record
4. For each question:
- Create question record
- Create answer options
- Link correct answer
5. Commit transaction
6. Return quiz details
#### Error Handling
- Invalid quiz data: Return 400 Bad Request
- Transaction failure: Rollback and return 500
- Duplicate quiz title: Return 409 Conflict
### 3. quiz/service.go
### 3.1. SubmitQuizAttempt
#### Input
- attemptData : QuizAttemptSubmission
```go
type QuizAttemptSubmission struct {
QuizID string `json:"quiz_id"`
UserID string `json:"user_id"`
StartedAt time.Time `json:"started_at"`
Answers map[string]string `json:"answers"`
TimeSpent int `json:"time_spent"`
}
```
#### Output
- AttemptResult : Quiz attempt results
```go
type AttemptResult struct {
Score float64 `json:"score"`
CorrectCount int `json:"correct_count"`
TotalCount int `json:"total_count"`
TimeTaken int `json:"time_taken"`
CompletedAt time.Time `json:"completed_at"`
Feedback []Answer `json:"feedback"`
}
```
#### Description
Process a quiz attempt submission and calculate results
#### Logic
1. Validate attempt data
2. Check time limit compliance
3. Load correct answers from database
4. Calculate score:
- Compare submitted answers with correct ones
- Apply scoring rules
- Calculate percentage
5. Store attempt results
6. Generate detailed feedback
7. Update user statistics
#### Error Handling
- Invalid quiz/user ID: Return 400 Bad Request
- Time limit exceeded: Return 400 Bad Request
- Quiz not found: Return 404 Not Found
- Database error: Return 500 Internal Server Error
---
*Last Updated: 2025-06-06*
*Next Review: 2025-07-01*## Overall Flow:
### [Numerical order].[Flow Name (e.g., Goal Creation Flow)]
```
[mermaid sequenceDiagram]
```
[Explanation of the diagram]
---
# CONTENT

119
docs/testing.md
View File

@ -1,119 +0,0 @@
# Testing
## Tổng quan
Testing là một phần quan trọng trong quy trình phát triển, đảm bảo chất lượng mã nguồn và giảm thiểu bugs. Dự án này sử dụng các công cụ và phương pháp testing tiêu chuẩn trong Golang.
## Unit Testing
### Công cụ sử dụng
- Testify: Framework unit testing cho Go
- Table-driven tests: Thiết kế test cases linh hoạt
- Mocking: Giả lập dependencies
### Quy ước và cấu trúc
- Mỗi package cần có file `*_test.go` tương ứng
- Các test functions có format `Test{FunctionName}`
- Test cases nên bao gồm cả happy path và error cases
- Coverage yêu cầu tối thiểu: 80%
- Sử dụng t.Run() để chạy các subtest
### Mẫu Unit Test
```go
// user_service_test.go
package user
import (
"testing"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/mock"
)
// Mocking repository
type MockUserRepository struct {
mock.Mock
}
func (m *MockUserRepository) FindByID(id string) (*User, error) {
args := m.Called(id)
if args.Get(0) == nil {
return nil, args.Error(1)
}
return args.Get(0).(*User), args.Error(1)
}
func TestGetUser(t *testing.T) {
// Test cases
testCases := []struct {
name string
userID string
mockUser *User
mockError error
expectedUser *User
expectedError error
}{
{
name: "successful_get",
userID: "123",
mockUser: &User{ID: "123", Name: "Test User"},
mockError: nil,
expectedUser: &User{ID: "123", Name: "Test User"},
expectedError: nil,
},
{
name: "user_not_found",
userID: "456",
mockUser: nil,
mockError: ErrUserNotFound,
expectedUser: nil,
expectedError: ErrUserNotFound,
},
}
for _, tc := range testCases {
t.Run(tc.name, func(t *testing.T) {
// Setup mock
mockRepo := new(MockUserRepository)
mockRepo.On("FindByID", tc.userID).Return(tc.mockUser, tc.mockError)
// Create service with mock dependency
service := NewUserService(mockRepo)
// Call the method
user, err := service.GetUser(tc.userID)
// Assert results
assert.Equal(t, tc.expectedUser, user)
assert.Equal(t, tc.expectedError, err)
// Verify expectations
mockRepo.AssertExpectations(t)
})
}
}
```
## Integration Testing
### Approach
- Test containers: Chạy dependent services (database, caching, etc) trong Docker containers
- API testing: Kiểm tra endpoints và responses
- DB testing: Kiểm tra queries và migrations
### Setup và Teardown
- Sử dụng `TestMain` để setup và teardown test environment
- Cấu hình Docker containers cho testing
- Cleanup sau khi chạy tests
## E2E Testing
- API black-box testing
- Sequence testing cho business flows
- Performance testing
## CI/CD Integration
- Chạy tests trên mỗi commit và PR
- Lưu test results và coverage
- Chỉ merge khi tests pass
## Best Practices
1. **Write tests first (TDD approach)**
2. **Keep tests independent và idempotent**
3. **Sử dụng fixtures cho test data**
4. **Tránh hard-coding external dependencies**
5. **Tách common test code thành helper functions**

174
docs/unit-testing.md
View File

@ -1,174 +0,0 @@
# Tài liệu Unit Testing
## Mục lục
1. [Giới thiệu](#giới-thiệu)
2. [Cấu trúc thư mục test](#cấu-trúc-thư-mục-test)
3. [Các loại test case](#các-loại-test-case)
- [Auth Middleware](#auth-middleware)
- [CORS Middleware](#cors-middleware)
- [Rate Limiting](#rate-limiting)
- [Security Config](#security-config)
4. [Cách chạy test](#cách-chạy-test)
5. [Best Practices](#best-practices)
## Giới thiệu
Tài liệu này mô tả các test case đã được triển khai trong dự án, giúp đảm bảo chất lượng và độ tin cậy của mã nguồn.
## Cấu trúc thư mục test
```
internal/
transport/
http/
middleware/
auth_test.go # Test xác thực và phân quyền
middleware_test.go # Test CORS và rate limiting
handler/
health_handler_test.go # Test health check endpoints
service/
auth_service_test.go # Test service xác thực
```
## Các loại test case
### Auth Middleware
#### Xác thực người dùng
1. **TestNewAuthMiddleware**
- Mục đích: Kiểm tra khởi tạo AuthMiddleware
- Input: AuthService
- Expected: Trả về instance AuthMiddleware
2. **TestAuthenticate_Success**
- Mục đích: Xác thực thành công với token hợp lệ
- Input: Header Authorization với token hợp lệ
- Expected: Trả về status 200 và lưu thông tin user vào context
3. **TestAuthenticate_NoAuthHeader**
- Mục đích: Không có header Authorization
- Input: Request không có header Authorization
- Expected: Trả về lỗi 401 Unauthorized
4. **TestAuthenticate_InvalidTokenFormat**
- Mục đích: Kiểm tra định dạng token không hợp lệ
- Input:
- Token không có "Bearer" prefix
- Token rỗng sau "Bearer"
- Expected: Trả về lỗi 401 Unauthorized
5. **TestAuthenticate_InvalidToken**
- Mục đích: Token không hợp lệ hoặc hết hạn
- Input: Token không hợp lệ
- Expected: Trả về lỗi 401 Unauthorized
#### Phân quyền (RBAC)
1. **TestRequireRole_Success**
- Mục đích: Người dùng có role yêu cầu
- Input: User có role phù hợp
- Expected: Cho phép truy cập
2. **TestRequireRole_Unauthenticated**
- Mục đích: Chưa xác thực
- Input: Không có thông tin xác thực
- Expected: Trả về lỗi 401 Unauthorized
3. **TestRequireRole_Forbidden**
- Mục đích: Không có quyền truy cập
- Input: User không có role yêu cầu
- Expected: Trả về lỗi 403 Forbidden
#### Helper Functions
1. **TestGetUserFromContext**
- Mục đích: Lấy thông tin user từ context
- Input: Context có chứa user
- Expected: Trả về thông tin user
2. **TestGetUserFromContext_NotFound**
- Mục đích: Không tìm thấy user trong context
- Input: Context không có user
- Expected: Trả về lỗi
3. **TestGetUserIDFromContext**
- Mục đích: Lấy user ID từ context
- Input: Context có chứa user
- Expected: Trả về user ID
4. **TestGetUserIDFromContext_InvalidType**
- Mục đích: Kiểm tra lỗi khi kiểu dữ liệu không hợp lệ
- Input: Context có giá trị không phải kiểu *Claims
- Expected: Trả về lỗi
### CORS Middleware
1. **TestDefaultCORSConfig**
- Mục đích: Kiểm tra cấu hình CORS mặc định
- Expected: Cấu hình mặc định cho phép tất cả origins
2. **TestCORS**
- Mục đích: Kiểm tra hành vi CORS
- Các trường hợp:
- Cho phép tất cả origins
- Chỉ cho phép origin cụ thể
- Xử lý preflight request
### Rate Limiting
1. **TestDefaultRateLimiterConfig**
- Mục đích: Kiểm tra cấu hình rate limiter mặc định
- Expected: Giới hạn mặc định được áp dụng
2. **TestRateLimit**
- Mục đích: Kiểm tra hoạt động của rate limiter
- Expected: Chặn request khi vượt quá giới hạn
### Security Config
1. **TestSecurityConfig**
- Mục đích: Kiểm tra cấu hình bảo mật
- Các trường hợp:
- Cấu hình mặc định
- Áp dụng cấu hình cho router
## Cách chạy test
### Chạy tất cả test
```bash
go test ./...
```
### Chạy test với coverage
```bash
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out
```
### Chạy test cụ thể
```bash
go test -run ^TestName$
```
## Best Practices
1. **Đặt tên test rõ ràng**
- Sử dụng cấu trúc: `Test[FunctionName]_[Scenario]`
- Ví dụ: `TestAuthenticate_InvalidToken`
2. **Mỗi test một trường hợp**
- Mỗi test function chỉ kiểm tra một trường hợp cụ thể
- Sử dụng subtests cho các test case liên quan
3. **Kiểm tra cả trường hợp lỗi**
- Kiểm tra cả các trường hợp thành công và thất bại
- Đảm bảo có thông báo lỗi rõ ràng
4. **Sử dụng mock cho các phụ thuộc**
- Sử dụng thư viện `testify/mock` để tạo mock
- Đảm bảo test độc lập với các thành phần bên ngoài
5. **Kiểm tra biên**
- Kiểm tra các giá trị biên và trường hợp đặc biệt
- Ví dụ: empty string, nil, giá trị âm, v.v.
6. **Giữ test đơn giản**
- Test cần dễ hiểu và dễ bảo trì
- Tránh logic phức tạp trong test
7. **Đảm bảo test chạy nhanh**
- Tránh I/O không cần thiết
- Sử dụng `t.Parallel()` cho các test độc lập

57
docs/ux.md
View File

@ -1,57 +0,0 @@
# Thiết kế trải nghiệm người dùng
## Nguyên tắc thiết kế API
### API Design
- RESTful APIs là mặc định
- Sử dụng HTTP verbs phù hợp (GET, POST, PUT, DELETE)
- Định dạng URL: `/api/v{version}/{resource}/{id}`
- Versions được chỉ định trong URL path
- Query parameters cho filtering, sorting, pagination
### Responses
- Sử dụng HTTP status codes một cách nhất quán
- Cấu trúc JSON responses:
```json
{
"status": "success",
"data": { ... },
"meta": { "pagination": { ... } }
}
```
- Cấu trúc error responses:
```json
{
"status": "error",
"error": {
"code": "ERROR_CODE",
"message": "Human readable message",
"details": { ... }
}
}
```
### Authentication
- Bearer token trong Authorization header
- API key cho các dịch vụ được tin cậy
- OAuth 2.0 cho third-party applications
## Documentation
- OpenAPI/Swagger spec được tự động sinh
- API documentation tích hợp với code
- Ví dụ request/response cho mọi endpoint
## Rate Limiting
- Rate limits dựa trên IP hoặc user
- Headers thông báo limits và remaining requests
- Graceful handling khi vượt giới hạn
## Monitoring
- Tracking API usage và performance
- User behavior analytics
- Error tracking và alerting
## Testing
- End-to-end API testing
- Performance và load testing
- Security testing

84
docs/workflow.md
View File

@ -1,84 +0,0 @@
# Quy trình phát triển
## Branch Strategy
- Trunk-Based Development là phương pháp quản lý nhánh trong Git, nơi tất cả thay đổi được tích hợp thường xuyên vào nhánh chính (`main`), còn gọi là "trunk".
- Tên nhánh trùng với tiêu chuẩn của Git Commit Message
- `feat`: Tạo tính năng mới
- `fix`: Sửa lỗi
- `docs`: Thay đổi tài liệu
- `style`: Thay đổi không ảnh hưởng đến logic
- `refactor`: Refactor code
- `test`: Thêm hoặc sửa test
- `chore`: Thay đổi cấu hình hoặc các task không liên quan đến code
## Quy trình làm việc
### 1. Khởi tạo công việc
- Tạo issue mô tả công việc cần thực hiện
- Gán assignee và labels phù hợp
- Ước lượng effort và deadline
### 2. Phát triển
- Tạo nhánh từ `main` với quy ước đặt tên:
```
<type>/<issue-number>-<short-description>
```
Ví dụ: `feat/123-user-authentication`
- Thực hiện thay đổi, tuân thủ coding standards
- Commit thường xuyên với commit message rõ ràng
```
<type>(<scope>): <subject>
```
Ví dụ: `feat(auth): implement JWT token validation`
### 3. Kiểm thử
- Viết unit tests cho mọi thay đổi
- Đảm bảo test coverage đạt yêu cầu
- Chạy linting và static code analysis
### 4. Review
- Tạo pull request (PR) vào nhánh `main`
- Mô tả chi tiết các thay đổi
- Request review từ ít nhất 1 team member
- Khi được approve, resolve tất cả comments
### 5. Triển khai
- Merge PR vào `main` (squash và fast-forward)
- CI/CD pipeline sẽ tự động build và deploy
- Theo dõi logs và metrics sau khi deploy
## Gitea Workflow
### Gitea Actions
- Cấu hình trong `.gitea/workflows/`
- Định nghĩa các jobs: build, test, lint, deploy
- Trigger dựa trên events: push, PR, tag
### Gitea Secrets
- Sử dụng Secret Manager để lưu trữ credentials
- Truy cập secrets trong workflows
### Gitea Registry
- Build và push Docker images
- Versioning theo semantic versioning
## Conventions
### Commit Messages
- Format: `<type>(<scope>): <subject>`
- Types: feat, fix, docs, style, refactor, test, chore
- Scope: module/component tương ứng
- Subject: mô tả ngắn gọn, rõ ràng
### Versioning
- Theo Semantic Versioning: MAJOR.MINOR.PATCH
- MAJOR: breaking changes
- MINOR: backwards-compatible features
- PATCH: backwards-compatible bug fixes
### Release Process
- Tạo tag với version mới
- Cập nhật changelog
- Deploy lên môi trường production

59
go.mod
View File

@ -1,75 +1,70 @@
module starter-kit
module zee
go 1.23.6
go 1.24.3
require (
github.com/DATA-DOG/go-sqlmock v1.5.2
github.com/gin-gonic/gin v1.10.0
github.com/go-playground/validator/v10 v10.20.0
github.com/gin-gonic/gin v1.10.1
github.com/go-playground/validator/v10 v10.26.0
github.com/golang-jwt/jwt/v5 v5.2.2
github.com/joho/godotenv v1.5.1
github.com/mitchellh/mapstructure v1.5.0
github.com/sirupsen/logrus v1.9.3
github.com/spf13/viper v1.17.0
github.com/spf13/viper v1.20.1
github.com/stretchr/testify v1.10.0
go.uber.org/multierr v1.11.0
golang.org/x/crypto v0.38.0
gopkg.in/tomb.v2 v2.0.0-20161208151619-d5d1b5820637
gorm.io/driver/mysql v1.5.7
gorm.io/driver/postgres v1.5.11
gorm.io/driver/sqlite v1.5.7
gorm.io/gorm v1.26.1
gorm.io/driver/mysql v1.6.0
gorm.io/driver/postgres v1.6.0
gorm.io/driver/sqlite v1.6.0
gorm.io/gorm v1.30.0
)
require (
filippo.io/edwards25519 v1.1.0 // indirect
github.com/bytedance/sonic v1.11.6 // indirect
github.com/bytedance/sonic/loader v0.1.1 // indirect
github.com/cloudwego/base64x v0.1.4 // indirect
github.com/cloudwego/iasm v0.2.0 // indirect
github.com/bytedance/sonic v1.13.3 // indirect
github.com/bytedance/sonic/loader v0.2.4 // indirect
github.com/cloudwego/base64x v0.1.5 // indirect
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gabriel-vasile/mimetype v1.4.3 // indirect
github.com/gin-contrib/sse v0.1.0 // indirect
github.com/fsnotify/fsnotify v1.9.0 // indirect
github.com/gabriel-vasile/mimetype v1.4.9 // indirect
github.com/gin-contrib/sse v1.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-sql-driver/mysql v1.9.2 // indirect
github.com/goccy/go-json v0.10.2 // indirect
github.com/go-viper/mapstructure/v2 v2.2.1 // indirect
github.com/goccy/go-json v0.10.5 // indirect
github.com/google/go-cmp v0.7.0 // indirect
github.com/hashicorp/hcl v1.0.0 // indirect
github.com/jackc/pgpassfile v1.0.0 // indirect
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
github.com/jackc/pgx/v5 v5.7.4 // indirect
github.com/jackc/pgx/v5 v5.7.5 // indirect
github.com/jackc/puddle/v2 v2.2.2 // indirect
github.com/jinzhu/inflection v1.0.0 // indirect
github.com/jinzhu/now v1.1.5 // indirect
github.com/json-iterator/go v1.1.12 // indirect
github.com/klauspost/cpuid/v2 v2.2.7 // indirect
github.com/klauspost/cpuid/v2 v2.2.10 // indirect
github.com/leodido/go-urn v1.4.0 // indirect
github.com/magiconair/properties v1.8.9 // indirect
github.com/mattn/go-isatty v0.0.20 // indirect
github.com/mattn/go-sqlite3 v1.14.28 // indirect
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
github.com/modern-go/reflect2 v1.0.2 // indirect
github.com/pelletier/go-toml/v2 v2.2.2 // indirect
github.com/pelletier/go-toml/v2 v2.2.4 // indirect
github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
github.com/sagikazarmark/locafero v0.3.0 // indirect
github.com/sagikazarmark/slog-shim v0.1.0 // indirect
github.com/sagikazarmark/locafero v0.9.0 // indirect
github.com/sourcegraph/conc v0.3.0 // indirect
github.com/spf13/afero v1.10.0 // indirect
github.com/spf13/cast v1.5.1 // indirect
github.com/spf13/afero v1.14.0 // indirect
github.com/spf13/cast v1.9.2 // indirect
github.com/spf13/pflag v1.0.6 // indirect
github.com/stretchr/objx v0.5.2 // indirect
github.com/subosito/gotenv v1.6.0 // indirect
github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
github.com/ugorji/go/codec v1.2.12 // indirect
golang.org/x/arch v0.8.0 // indirect
golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6 // indirect
golang.org/x/net v0.39.0 // indirect
golang.org/x/sync v0.14.0 // indirect
github.com/ugorji/go/codec v1.2.14 // indirect
golang.org/x/arch v0.18.0 // indirect
golang.org/x/net v0.40.0 // indirect
golang.org/x/sync v0.15.0 // indirect
golang.org/x/sys v0.33.0 // indirect
golang.org/x/text v0.25.0 // indirect
google.golang.org/protobuf v1.36.6 // indirect
gopkg.in/ini.v1 v1.67.0 // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
)

547
go.sum
View File

@ -1,170 +1,54 @@
cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw=
cloud.google.com/go v0.38.0/go.mod h1:990N+gfupTy94rShfmMCWGDn0LpTmnzTp2qbd1dvSRU=
cloud.google.com/go v0.44.1/go.mod h1:iSa0KzasP4Uvy3f1mN/7PiObzGgflwredwwASm/v6AU=
cloud.google.com/go v0.44.2/go.mod h1:60680Gw3Yr4ikxnPRS/oxxkBccT6SA1yMk63TGekxKY=
cloud.google.com/go v0.44.3/go.mod h1:60680Gw3Yr4ikxnPRS/oxxkBccT6SA1yMk63TGekxKY=
cloud.google.com/go v0.45.1/go.mod h1:RpBamKRgapWJb87xiFSdk4g1CME7QZg3uwTez+TSTjc=
cloud.google.com/go v0.46.3/go.mod h1:a6bKKbmY7er1mI7TEI4lsAkts/mkhTSZK8w33B4RAg0=
cloud.google.com/go v0.50.0/go.mod h1:r9sluTvynVuxRIOHXQEHMFffphuXHOMZMycpNR5e6To=
cloud.google.com/go v0.52.0/go.mod h1:pXajvRH/6o3+F9jDHZWQ5PbGhn+o8w9qiu/CffaVdO4=
cloud.google.com/go v0.53.0/go.mod h1:fp/UouUEsRkN6ryDKNW/Upv/JBKnv6WDthjR6+vze6M=
cloud.google.com/go v0.54.0/go.mod h1:1rq2OEkV3YMf6n/9ZvGWI3GWw0VoqH/1x2nd8Is/bPc=
cloud.google.com/go v0.56.0/go.mod h1:jr7tqZxxKOVYizybht9+26Z/gUq7tiRzu+ACVAMbKVk=
cloud.google.com/go v0.57.0/go.mod h1:oXiQ6Rzq3RAkkY7N6t3TcE6jE+CIBBbA36lwQ1JyzZs=
cloud.google.com/go v0.62.0/go.mod h1:jmCYTdRCQuc1PHIIJ/maLInMho30T/Y0M4hTdTShOYc=
cloud.google.com/go v0.65.0/go.mod h1:O5N8zS7uWy9vkA9vayVHs65eM1ubvY4h553ofrNHObY=
cloud.google.com/go v0.72.0/go.mod h1:M+5Vjvlc2wnp6tjzE102Dw08nGShTscUx2nZMufOKPI=
cloud.google.com/go v0.74.0/go.mod h1:VV1xSbzvo+9QJOxLDaJfTjx5e+MePCpCWwvftOeQmWk=
cloud.google.com/go v0.75.0/go.mod h1:VGuuCn7PG0dwsd5XPVm2Mm3wlh3EL55/79EKB6hlPTY=
cloud.google.com/go/bigquery v1.0.1/go.mod h1:i/xbL2UlR5RvWAURpBYZTtm/cXjCha9lbfbpx4poX+o=
cloud.google.com/go/bigquery v1.3.0/go.mod h1:PjpwJnslEMmckchkHFfq+HTD2DmtT67aNFKH1/VBDHE=
cloud.google.com/go/bigquery v1.4.0/go.mod h1:S8dzgnTigyfTmLBfrtrhyYhwRxG72rYxvftPBK2Dvzc=
cloud.google.com/go/bigquery v1.5.0/go.mod h1:snEHRnqQbz117VIFhE8bmtwIDY80NLUZUMb4Nv6dBIg=
cloud.google.com/go/bigquery v1.7.0/go.mod h1://okPTzCYNXSlb24MZs83e2Do+h+VXtc4gLoIoXIAPc=
cloud.google.com/go/bigquery v1.8.0/go.mod h1:J5hqkt3O0uAFnINi6JXValWIb1v0goeZM77hZzJN/fQ=
cloud.google.com/go/datastore v1.0.0/go.mod h1:LXYbyblFSglQ5pkeyhO+Qmw7ukd3C+pD7TKLgZqpHYE=
cloud.google.com/go/datastore v1.1.0/go.mod h1:umbIZjpQpHh4hmRpGhH4tLFup+FVzqBi1b3c64qFpCk=
cloud.google.com/go/pubsub v1.0.1/go.mod h1:R0Gpsv3s54REJCy4fxDixWD93lHJMoZTyQ2kNxGRt3I=
cloud.google.com/go/pubsub v1.1.0/go.mod h1:EwwdRX2sKPjnvnqCa270oGRyludottCI76h+R3AArQw=
cloud.google.com/go/pubsub v1.2.0/go.mod h1:jhfEVHT8odbXTkndysNHCcx0awwzvfOlguIAii9o8iA=
cloud.google.com/go/pubsub v1.3.1/go.mod h1:i+ucay31+CNRpDW4Lu78I4xXG+O1r/MAHgjpRVR+TSU=
cloud.google.com/go/storage v1.0.0/go.mod h1:IhtSnM/ZTZV8YYJWCY8RULGVqBDmpoyjwiyrjsg+URw=
cloud.google.com/go/storage v1.5.0/go.mod h1:tpKbwo567HUNpVclU5sGELwQWBDZ8gh0ZeosJ0Rtdos=
cloud.google.com/go/storage v1.6.0/go.mod h1:N7U0C8pVQ/+NIKOBQyamJIeKQKkZ+mxpohlUTyfDhBk=
cloud.google.com/go/storage v1.8.0/go.mod h1:Wv1Oy7z6Yz3DshWRJFhqM/UCfaWIRTdp0RXyy7KQOVs=
cloud.google.com/go/storage v1.10.0/go.mod h1:FLPqc6j+Ki4BU591ie1oL6qBQGu2Bl/tZ9ullr3+Kg0=
cloud.google.com/go/storage v1.14.0/go.mod h1:GrKmX003DSIwi9o29oFT7YDnHYwZoctc3fOKtUw0Xmo=
dmitri.shuralyov.com/gpu/mtl v0.0.0-20190408044501-666a987793e9/go.mod h1:H6x//7gZCb22OMCxBHrMx7a5I7Hp++hsVxbQ4BYO7hU=
filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA=
filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4=
github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
github.com/BurntSushi/xgb v0.0.0-20160522181843-27f122750802/go.mod h1:IVnqGOEym/WlBOVXweHU+Q+/VP0lqqI8lqeDx9IjBqo=
github.com/DATA-DOG/go-sqlmock v1.5.2 h1:OcvFkGmslmlZibjAjaHm3L//6LiuBgolP7OputlJIzU=
github.com/DATA-DOG/go-sqlmock v1.5.2/go.mod h1:88MAG/4G7SMwSE3CeA0ZKzrT5CiOU3OJ+JlNzwDqpNU=
github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
github.com/bytedance/sonic v1.13.3 h1:MS8gmaH16Gtirygw7jV91pDCN33NyMrPbN7qiYhEsF0=
github.com/bytedance/sonic v1.13.3/go.mod h1:o68xyaF9u2gvVBuGHPlUVCy+ZfmNNO5ETf1+KgkJhz4=
github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU=
github.com/chzyer/logex v1.1.10/go.mod h1:+Ywpsq7O8HXn0nuIou7OrIPyXbp3wmkHB+jjWRnGsAI=
github.com/chzyer/readline v0.0.0-20180603132655-2972be24d48e/go.mod h1:nSuG5e5PlCu98SY8svDHJxuZscDgtXS6KTTbou5AhLI=
github.com/chzyer/test v0.0.0-20180213035817-a1ea475d72b1/go.mod h1:Q3SI9o4m/ZMnBNeIyt5eFwwo7qiLfzFZmjNmxjkiQlU=
github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw=
github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
github.com/bytedance/sonic/loader v0.2.4 h1:ZWCw4stuXUsn1/+zQDqeE7JKP+QO47tz7QCNan80NzY=
github.com/bytedance/sonic/loader v0.2.4/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
github.com/cloudwego/base64x v0.1.5 h1:XPciSp1xaq2VCSt6lF0phncD4koWyULpl5bUxbfCyP4=
github.com/cloudwego/base64x v0.1.5/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc=
github.com/cncf/udpa/go v0.0.0-20200629203442-efcf912fb354/go.mod h1:WmhPx2Nbnhtbo57+VJT5O0JRkEi1Wbu0z5j0R8u5Hbk=
github.com/cncf/udpa/go v0.0.0-20201120205902-5459f2c99403/go.mod h1:WmhPx2Nbnhtbo57+VJT5O0JRkEi1Wbu0z5j0R8u5Hbk=
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4=
github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4=
github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98=
github.com/envoyproxy/go-control-plane v0.9.7/go.mod h1:cwu0lG7PUMfa9snN8LXBig5ynNVH9qI8YYLbd1fK2po=
github.com/envoyproxy/go-control-plane v0.9.9-0.20201210154907-fd9021fe5dad/go.mod h1:cXg6YxExXjJnVBQHBLXeUAgxn2UodCpnH306RInaBQk=
github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c=
github.com/frankban/quicktest v1.14.4 h1:g2rn0vABPOOXmZUj+vbmUp0lPoXEMuhTpIluN0XL9UY=
github.com/frankban/quicktest v1.14.4/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
github.com/go-gl/glfw v0.0.0-20190409004039-e6da0acd62b1/go.mod h1:vR7hzQXu2zJy9AVAgeJqvqgH9Q5CA+iKCZ2gyEVpxRU=
github.com/go-gl/glfw/v3.3/glfw v0.0.0-20191125211704-12ad95a8df72/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8=
github.com/go-gl/glfw/v3.3/glfw v0.0.0-20200222043503-6f7a984d4dc4/go.mod h1:tQ2UAYgL5IevRw8kRxooKSPJfGvJ9fJQFa0TUsXzTg8=
github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=
github.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
github.com/gabriel-vasile/mimetype v1.4.9 h1:5k+WDwEsD9eTLL8Tz3L0VnmVh9QxGjRmjBvAG7U/oYY=
github.com/gabriel-vasile/mimetype v1.4.9/go.mod h1:WnSQhFKJuBlRyLiKohA/2DtIlPFAbguNaG7QCHcyGok=
github.com/gin-contrib/sse v1.1.0 h1:n0w2GMuUpWDVp7qSpvze6fAu9iRxJY4Hmj6AmBOU05w=
github.com/gin-contrib/sse v1.1.0/go.mod h1:hxRZ5gVpWMT7Z0B0gSNYqqsSCNIJMjzvm6fqCz9vjwM=
github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ=
github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
github.com/go-sql-driver/mysql v1.7.0/go.mod h1:OXbVy3sEdcQ2Doequ6Z5BW6fXNQTmx+9S1MCJN5yJMI=
github.com/go-playground/validator/v10 v10.26.0 h1:SP05Nqhjcvz81uJaRfEV0YBSSSGMc/iMaVtFbr3Sw2k=
github.com/go-playground/validator/v10 v10.26.0/go.mod h1:I5QpIEbmr8On7W0TktmJAumgzX4CA1XNl4ZmDuVHKKo=
github.com/go-sql-driver/mysql v1.9.2 h1:4cNKDYQ1I84SXslGddlsrMhc8k4LeDVj6Ad6WRjiHuU=
github.com/go-sql-driver/mysql v1.9.2/go.mod h1:qn46aNg1333BRMNU69Lq93t8du/dwxI64Gl8i5p1WMU=
github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss=
github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
github.com/golang-jwt/jwt/v5 v5.2.2 h1:Rl4B7itRWVtYIHFrSNd7vhTiz9UpLdi6gZhZ3wEeDy8=
github.com/golang-jwt/jwt/v5 v5.2.2/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk=
github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q=
github.com/golang/groupcache v0.0.0-20190702054246-869f871628b6/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
github.com/golang/groupcache v0.0.0-20191227052852-215e87163ea7/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A=
github.com/golang/mock v1.2.0/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A=
github.com/golang/mock v1.3.1/go.mod h1:sBzyDLLjw3U8JLTeZvSv8jJB+tU5PVekmnlKIyFUx0Y=
github.com/golang/mock v1.4.0/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw=
github.com/golang/mock v1.4.1/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw=
github.com/golang/mock v1.4.3/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw=
github.com/golang/mock v1.4.4/go.mod h1:l3mdAwkq5BuhzHwde/uurv3sEJeZMXNpwsxVWU71h+4=
github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw=
github.com/golang/protobuf v1.3.4/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw=
github.com/golang/protobuf v1.3.5/go.mod h1:6O5/vntMXwX2lRkT1hjjk0nAC1IDOTvTlVgjlRvqsdk=
github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8=
github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA=
github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs=
github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w=
github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0=
github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8=
github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI=
github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI=
github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ=
github.com/google/btree v1.0.0/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ=
github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M=
github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.4.1/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.5.1/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.5.4/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
github.com/google/martian v2.1.0+incompatible/go.mod h1:9I4somxYTbIHy5NJKHRl3wXiIaQGbYVAs8BPL6v8lEs=
github.com/google/martian/v3 v3.0.0/go.mod h1:y5Zk1BBys9G+gd6Jrk0W3cC1+ELVxBWuIGO+w/tUAp0=
github.com/google/martian/v3 v3.1.0/go.mod h1:y5Zk1BBys9G+gd6Jrk0W3cC1+ELVxBWuIGO+w/tUAp0=
github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc=
github.com/google/pprof v0.0.0-20190515194954-54271f7e092f/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc=
github.com/google/pprof v0.0.0-20191218002539-d4f498aebedc/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
github.com/google/pprof v0.0.0-20200212024743-f11f1df84d12/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
github.com/google/pprof v0.0.0-20200229191704-1ebb73c60ed3/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
github.com/google/pprof v0.0.0-20200430221834-fc25d7d30c6d/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
github.com/google/pprof v0.0.0-20200708004538-1a94d8640e99/go.mod h1:ZgVRPoUq/hfqzAqh7sHMqb3I9Rq5C59dIz2SbBwJ4eM=
github.com/google/pprof v0.0.0-20201023163331-3e6fc7fc9c4c/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
github.com/google/pprof v0.0.0-20201203190320-1bf35d6f28c2/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
github.com/google/pprof v0.0.0-20201218002935-b9804c9f04c2/go.mod h1:kpwsk12EmLew5upagYY7GY0pfYCcupk39gWOCRROcvE=
github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI=
github.com/google/uuid v1.1.2/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+vpHVxEJEs9eg=
github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk=
github.com/googleapis/google-cloud-go-testing v0.0.0-20200911160855-bcd43fbb19e8/go.mod h1:dvDLG8qkwmyD9a/MJJN3XJcT3xFxOKAvTZGvuZmac9g=
github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
github.com/hashicorp/hcl v1.0.0 h1:0Anlzjpi4vEasTeNFn2mLJgTSwt0+6sfsiTG8qcWGx4=
github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ=
github.com/ianlancetaylor/demangle v0.0.0-20181102032728-5e5cf60278f6/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc=
github.com/ianlancetaylor/demangle v0.0.0-20200824232613-28f6c0f3b639/go.mod h1:aSSvb/t6k1mPoxDqO4vJh6VOCGPwU4O0C2/Eqndh1Sc=
github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
github.com/jackc/pgx/v5 v5.7.4 h1:9wKznZrhWa2QiHL+NjTSPP6yjl3451BX3imWDnokYlg=
github.com/jackc/pgx/v5 v5.7.4/go.mod h1:ncY89UGWxg82EykZUwSpUKEfccBGGYq1xjrOpsbsfGQ=
github.com/jackc/pgx/v5 v5.7.5 h1:JHGfMnQY+IEtGM63d+NGMjoRpysB2JBwDr5fsngwmJs=
github.com/jackc/pgx/v5 v5.7.5/go.mod h1:aruU7o91Tc2q2cFp5h4uP3f6ztExVpyVv88Xl/8Vl8M=
github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
github.com/jinzhu/inflection v1.0.0 h1:K317FqzuhWc8YvSVlFMCCUb36O/S9MCKRDI7QkRKD/E=
@ -175,26 +59,17 @@ github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=
github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
github.com/jstemmer/go-junit-report v0.0.0-20190106144839-af01ea7f8024/go.mod h1:6v2b51hI/fHJwM22ozAgKL4VKDeJcHhJFhtBdhmNjmU=
github.com/jstemmer/go-junit-report v0.9.1/go.mod h1:Brl9GWCQeLvo8nXZwPNNblvFj/XSXhF0NWZEnDohbsk=
github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
github.com/kisielk/sqlstruct v0.0.0-20201105191214-5f3e10d3ab46/go.mod h1:yyMNCyc/Ib3bDTKd379tNMpB/7/H5TjM2Y9QJ5THLbE=
github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
github.com/kr/fs v0.1.0/go.mod h1:FFnZGqtBN9Gxj7eW1uZ42v5BccTP0vu6NEaFoC2HwRg=
github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
github.com/magiconair/properties v1.8.9 h1:nWcCbLq1N2v/cpNsy5WvQ37Fb+YElfq20WJ/a8RkpQM=
github.com/magiconair/properties v1.8.9/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0=
github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
github.com/mattn/go-sqlite3 v1.14.28 h1:ThEiQrnbtumT+QMknw63Befp/ce/nUPgBPMlRFEum7A=
@ -206,395 +81,77 @@ github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w
github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
github.com/pkg/sftp v1.13.1/go.mod h1:3HaPG6Dq1ILlpPZRO0HVMrsydcdLt6HRDccSgb87qRg=
github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA=
github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4=
github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8=
github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
github.com/sagikazarmark/locafero v0.3.0 h1:zT7VEGWC2DTflmccN/5T1etyKvxSxpHsjb9cJvm4SvQ=
github.com/sagikazarmark/locafero v0.3.0/go.mod h1:w+v7UsPNFwzF1cHuOajOOzoq4U7v/ig1mpRjqV+Bu1U=
github.com/sagikazarmark/slog-shim v0.1.0 h1:diDBnUNK9N/354PgrxMywXnAwEr1QZcOr6gto+ugjYE=
github.com/sagikazarmark/slog-shim v0.1.0/go.mod h1:SrcSrq8aKtyuqEI1uvTDTK1arOWRIczQRv+GVI1AkeQ=
github.com/sagikazarmark/locafero v0.9.0 h1:GbgQGNtTrEmddYDSAH9QLRyfAHY12md+8YFTqyMTC9k=
github.com/sagikazarmark/locafero v0.9.0/go.mod h1:UBUyz37V+EdMS3hDF3QWIiVr/2dPrx49OMO0Bn0hJqk=
github.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ=
github.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ=
github.com/sourcegraph/conc v0.3.0 h1:OQTbbt6P72L20UqAkXXuLOj79LfEanQ+YQFNpLA9ySo=
github.com/sourcegraph/conc v0.3.0/go.mod h1:Sdozi7LEKbFPqYX2/J+iBAM6HpqSLTASQIKqDmF7Mt0=
github.com/spf13/afero v1.10.0 h1:EaGW2JJh15aKOejeuJ+wpFSHnbd7GE6Wvp3TsNhb6LY=
github.com/spf13/afero v1.10.0/go.mod h1:UBogFpq8E9Hx+xc5CNTTEpTnuHVmXDwZcZcE1eb/UhQ=
github.com/spf13/cast v1.5.1 h1:R+kOtfhWQE6TVQzY+4D7wJLBgkdVasCEFxSUBYBYIlA=
github.com/spf13/cast v1.5.1/go.mod h1:b9PdjNptOpzXr7Rq1q9gJML/2cdGQAo69NKzQ10KN48=
github.com/spf13/afero v1.14.0 h1:9tH6MapGnn/j0eb0yIXiLjERO8RB6xIVZRDCX7PtqWA=
github.com/spf13/afero v1.14.0/go.mod h1:acJQ8t0ohCGuMN3O+Pv0V0hgMxNYDlvdk+VTfyZmbYo=
github.com/spf13/cast v1.9.2 h1:SsGfm7M8QOFtEzumm7UZrZdLLquNdzFYfIbEXntcFbE=
github.com/spf13/cast v1.9.2/go.mod h1:jNfB8QC9IA6ZuY2ZjDp0KtFO2LZZlg4S/7bzP6qqeHo=
github.com/spf13/pflag v1.0.6 h1:jFzHGLGAlb3ruxLB8MhbI6A8+AQX/2eW4qeyNZXNp2o=
github.com/spf13/pflag v1.0.6/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
github.com/spf13/viper v1.17.0 h1:I5txKw7MJasPL/BrfkbA0Jyo/oELqVmux4pR/UxOMfI=
github.com/spf13/viper v1.17.0/go.mod h1:BmMMMLQXSbcHK6KAOiFLz0l5JHrU89OdIRHvsk0+yVI=
github.com/spf13/viper v1.20.1 h1:ZMi+z/lvLyPSCoNtFCpqjy0S4kPbirhpTMwl8BkW9X4=
github.com/spf13/viper v1.20.1/go.mod h1:P9Mdzt1zoHIG8m2eZQinpiBjo6kCmZSKBClNNqjJvu4=
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
github.com/yuin/goldmark v1.1.25/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
github.com/yuin/goldmark v1.1.32/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
go.opencensus.io v0.21.0/go.mod h1:mSImk1erAIZhrmZN+AvHh14ztQfjbGwt4TtuofqLduU=
go.opencensus.io v0.22.0/go.mod h1:+kGneAE2xo2IficOXnaByMWTGM9T73dGwxeWcUqIpI8=
go.opencensus.io v0.22.2/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw=
go.opencensus.io v0.22.3/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw=
go.opencensus.io v0.22.4/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw=
go.opencensus.io v0.22.5/go.mod h1:5pWMHQbX5EPX2/62yrJeAkowc+lfs/XD7Uxpq3pI6kk=
github.com/ugorji/go/codec v1.2.14 h1:yOQvXCBc3Ij46LRkRoh4Yd5qK6LVOgi0bYOXfb7ifjw=
github.com/ugorji/go/codec v1.2.14/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
golang.org/x/crypto v0.0.0-20190605123033-f99c8df09eb5/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
golang.org/x/crypto v0.0.0-20210421170649-83a5a9bb288b/go.mod h1:T9bdIzuCu7OtxOm1hfPfRQxPLYneinmdGuTeoZ9dtd4=
golang.org/x/crypto v0.0.0-20220722155217-630584e8d5aa/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
golang.org/x/arch v0.18.0 h1:WN9poc33zL4AzGxqf8VtpKUnGvMi8O9lhNyBMF/85qc=
golang.org/x/arch v0.18.0/go.mod h1:bdwinDaKcfZUGpH09BB7ZmOfhalA8lQdzl62l8gGWsk=
golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8=
golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw=
golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
golang.org/x/exp v0.0.0-20190306152737-a1d7652674e8/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA=
golang.org/x/exp v0.0.0-20190510132918-efd6b22b2522/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8=
golang.org/x/exp v0.0.0-20190829153037-c13cbed26979/go.mod h1:86+5VVa7VpoJ4kLfm080zCjGlMRFzhUhsZKEZO7MGek=
golang.org/x/exp v0.0.0-20191030013958-a1ab85dbe136/go.mod h1:JXzH8nQsPlswgeRAPE3MuO9GYsAcnJvJ4vnMwN/5qkY=
golang.org/x/exp v0.0.0-20191129062945-2f5052295587/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4=
golang.org/x/exp v0.0.0-20191227195350-da58074b4299/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4=
golang.org/x/exp v0.0.0-20200119233911-0405dc783f0a/go.mod h1:2RIsYlXP63K8oxa1u096TMicItID8zy7Y6sNkU49FU4=
golang.org/x/exp v0.0.0-20200207192155-f17229e696bd/go.mod h1:J/WKrq2StrnmMY6+EHIKF9dgMWnmCNThgcyBT1FY9mM=
golang.org/x/exp v0.0.0-20200224162631-6cc2880d07d6/go.mod h1:3jZMyOhIsHpP37uCMkUooju7aAi5cS1Q23tOzKc+0MU=
golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6 h1:y5zboxd6LQAqYIhHnB48p0ByQ/GnQx2BE33L8BOHQkI=
golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6/go.mod h1:U6Lno4MTRCDY+Ba7aCcauB9T60gsv5s4ralQzP72ZoQ=
golang.org/x/image v0.0.0-20190227222117-0694c2d4d067/go.mod h1:kZ7UVZpmo3dzQBMxlp+ypCbDeSB+sBbTgSJuh5dn5js=
golang.org/x/image v0.0.0-20190802002840-cff245a6509b/go.mod h1:FeLwcggjj3mMvU+oOTbSwawSJRM1uh48EjtB4UJZlP0=
golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE=
golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU=
golang.org/x/lint v0.0.0-20190301231843-5614ed5bae6f/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE=
golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/lint v0.0.0-20190409202823-959b441ac422/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/lint v0.0.0-20190909230951-414d861bb4ac/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc=
golang.org/x/lint v0.0.0-20191125180803-fdd1cda4f05f/go.mod h1:5qLYkcX4OjUUV8bRuDixDT3tpyyb+LUpUlRWLxfhWrs=
golang.org/x/lint v0.0.0-20200130185559-910be7a94367/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY=
golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY=
golang.org/x/lint v0.0.0-20201208152925-83fdc39ff7b5/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY=
golang.org/x/mobile v0.0.0-20190312151609-d3739f865fa6/go.mod h1:z+o9i4GpDbdi3rU15maQ/Ox0txvL9dWGYEHz965HBQE=
golang.org/x/mobile v0.0.0-20190719004257-d2bd2a29d028/go.mod h1:E/iHnbuqvinMTCcRqshq8CkpyQDoeVncDDYHnLhea+o=
golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc=
golang.org/x/mod v0.1.0/go.mod h1:0QHyrYULN0/3qlju5TqG8bIK38QM8yzMo5ekMj3DlcY=
golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg=
golang.org/x/mod v0.1.1-0.20191107180719-034126e5016b/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg=
golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
golang.org/x/mod v0.4.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
golang.org/x/mod v0.4.1/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20190108225652-1e06a53dbb7e/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/net v0.0.0-20190501004415-9ce7a6920f09/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/net v0.0.0-20190503192946-f4e77d36d62c/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
golang.org/x/net v0.0.0-20190603091049-60506f45cf65/go.mod h1:HSz+uSET+XFnRR8LxR5pz3Of3rY3CfYBVs4xY44aLks=
golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20190628185345-da137c7871d7/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20190724013045-ca1201d0de80/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20191209160850-c0dbc17a3553/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200114155413-6afb5195e5aa/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200202094626-16171245cfb2/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200222125558-5a598a2470a0/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200301022130-244492dfa37a/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
golang.org/x/net v0.0.0-20200324143707-d3edc9973b7e/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
golang.org/x/net v0.0.0-20200501053045-e0ff5e5a1de5/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
golang.org/x/net v0.0.0-20200506145744-7e3656a0809f/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
golang.org/x/net v0.0.0-20200513185701-a91f0712d120/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
golang.org/x/net v0.0.0-20200520182314-0ba52f642ac2/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A=
golang.org/x/net v0.0.0-20200625001655-4c5254603344/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA=
golang.org/x/net v0.0.0-20200707034311-ab3426394381/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA=
golang.org/x/net v0.0.0-20200822124328-c89045814202/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA=
golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
golang.org/x/net v0.0.0-20201031054903-ff519b6c9102/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
golang.org/x/net v0.0.0-20201209123823-ac852fbbde11/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
golang.org/x/net v0.0.0-20201224014010-6772e930b67b/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
golang.org/x/net v0.39.0 h1:ZCu7HMWDxpXpaiKdhzIfaltL9Lp31x/3fCP11bc6/fY=
golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E=
golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U=
golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
golang.org/x/oauth2 v0.0.0-20191202225959-858c2ad4c8b6/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
golang.org/x/oauth2 v0.0.0-20200107190931-bf48bf16ab8d/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw=
golang.org/x/oauth2 v0.0.0-20200902213428-5d25da1a8d43/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A=
golang.org/x/oauth2 v0.0.0-20201109201403-9fd604954f58/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A=
golang.org/x/oauth2 v0.0.0-20201208152858-08078c50e5b5/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A=
golang.org/x/oauth2 v0.0.0-20210218202405-ba52d332ba99/go.mod h1:KelEdhl1UZF7XfJ4dDtk6s++YSgaE7mD/BuKKDLBl4A=
golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20190227155943-e225da77a7e6/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20200317015054-43a5402ce75a/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20200625203802-6e8e738ad208/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.0.0-20201207232520-09787c993a3a/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
golang.org/x/sync v0.14.0 h1:woo0S4Yywslg6hp4eUFjTVOyKt0RookbpAHG4c1HmhQ=
golang.org/x/sync v0.14.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190502145724-3ef323f4f1fd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190507160741-ecd444e8653b/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190606165138-5da285871e9c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190624142023-c5567b49c5d0/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20190726091711-fc99dfbffb4e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20191001151750-bb3f8db39f24/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20191204072324-ce4227a45e2e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20191228213918-04cbcbbfeed8/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200113162924-86b910548bc1/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200122134326-e047566fdf82/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200202164722-d101bd2416d5/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200212091648-12a6c2dcc1e4/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200302150141-5c8b2ff67527/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200331124033-c3d80250170d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200501052902-10377860bb8e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200511232937-7e40ca221e25/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200515095857-1151b9dac4a9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200523222454-059865788121/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200803210538-64077c9b5642/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200905004654-be1d3432aa8f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20201201145000-ef89a241ccb3/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210104204734-6f8348627aad/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210119212857-b64e53b001e4/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210225134936-a50acf3fe073/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210423185535-09eb48e85fd7/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY=
golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds=
golang.org/x/sync v0.15.0 h1:KWH3jNZsfyT6xfAfKiz6MRNmd46ByHDYaZ7KSkCtdW8=
golang.org/x/sync v0.15.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
golang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw=
golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
golang.org/x/text v0.3.4/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
golang.org/x/text v0.25.0 h1:qVyWApTSYLk/drJRO5mDlNYskwQznZmkpV2c8q9zls4=
golang.org/x/text v0.25.0/go.mod h1:WEdwpYrmk1qmdHvhkSTNPm3app7v4rsT8F2UD6+VHIA=
golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ=
golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY=
golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
golang.org/x/tools v0.0.0-20190312151545-0bb0c0a6e846/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
golang.org/x/tools v0.0.0-20190312170243-e65039ee4138/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs=
golang.org/x/tools v0.0.0-20190425150028-36563e24a262/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
golang.org/x/tools v0.0.0-20190506145303-2d16b83fe98c/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q=
golang.org/x/tools v0.0.0-20190606124116-d0a3d012864b/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc=
golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc=
golang.org/x/tools v0.0.0-20190628153133-6cdbf07be9d0/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc=
golang.org/x/tools v0.0.0-20190816200558-6889da9d5479/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20190911174233-4f2ddba30aff/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191012152004-8de300cfc20a/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191113191852-77e3bb0ad9e7/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191115202509-3a792d9c32b2/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191125144606-a911d9008d1f/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191130070609-6e064ea0cf2d/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
golang.org/x/tools v0.0.0-20191216173652-a0e659d51361/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20191227053925-7b8e75db28f4/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200117161641-43d50277825c/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200122220014-bf1340f18c4a/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200204074204-1cc6d1ef6c74/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200207183749-b753a1ba74fa/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200212150539-ea181f53ac56/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200224181240-023911ca70b2/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200227222343-706bc42d1f0d/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
golang.org/x/tools v0.0.0-20200304193943-95d2e580d8eb/go.mod h1:o4KQGtdN14AW+yjsvvwRTJJuXz8XRtIHtEnmAXLyFUw=
golang.org/x/tools v0.0.0-20200312045724-11d5b4c81c7d/go.mod h1:o4KQGtdN14AW+yjsvvwRTJJuXz8XRtIHtEnmAXLyFUw=
golang.org/x/tools v0.0.0-20200331025713-a30bf2db82d4/go.mod h1:Sl4aGygMT6LrqrWclx+PTx3U+LnKx/seiNR+3G19Ar8=
golang.org/x/tools v0.0.0-20200501065659-ab2804fb9c9d/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
golang.org/x/tools v0.0.0-20200512131952-2bc93b1c0c88/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
golang.org/x/tools v0.0.0-20200515010526-7d3b6ebf133d/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
golang.org/x/tools v0.0.0-20200618134242-20370b0cb4b2/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
golang.org/x/tools v0.0.0-20200729194436-6467de6f59a7/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA=
golang.org/x/tools v0.0.0-20200804011535-6c149bb5ef0d/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA=
golang.org/x/tools v0.0.0-20200825202427-b303f430e36d/go.mod h1:njjCfa9FT2d7l9Bc6FUM5FLjQPp3cFF28FI3qnDFljA=
golang.org/x/tools v0.0.0-20200904185747-39188db58858/go.mod h1:Cj7w3i3Rnn0Xh82ur9kSqwfTHTeVxaDqrfMjpcNT6bE=
golang.org/x/tools v0.0.0-20201110124207-079ba7bd75cd/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
golang.org/x/tools v0.0.0-20201201161351-ac6f37ff4c2a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
golang.org/x/tools v0.0.0-20201208233053-a543418bbed2/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
golang.org/x/tools v0.0.0-20210105154028-b0ab187a4818/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
golang.org/x/tools v0.0.0-20210108195828-e2f9c7f1fc8e/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
golang.org/x/tools v0.1.0/go.mod h1:xkSsbof2nBLbhDlRMhhhyNLN/zl3eTqcnHD5viDpcZ0=
golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
google.golang.org/api v0.4.0/go.mod h1:8k5glujaEP+g9n7WNsDg8QP6cUVNI86fCNMcbazEtwE=
google.golang.org/api v0.7.0/go.mod h1:WtwebWUNSVBH/HAw79HIFXZNqEvBhG+Ra+ax0hx3E3M=
google.golang.org/api v0.8.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg=
google.golang.org/api v0.9.0/go.mod h1:o4eAsZoiT+ibD93RtjEohWalFOjRDx6CVaqeizhEnKg=
google.golang.org/api v0.13.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI=
google.golang.org/api v0.14.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI=
google.golang.org/api v0.15.0/go.mod h1:iLdEw5Ide6rF15KTC1Kkl0iskquN2gFfn9o9XIsbkAI=
google.golang.org/api v0.17.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE=
google.golang.org/api v0.18.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE=
google.golang.org/api v0.19.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE=
google.golang.org/api v0.20.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE=
google.golang.org/api v0.22.0/go.mod h1:BwFmGc8tA3vsd7r/7kR8DY7iEEGSU04BFxCo5jP/sfE=
google.golang.org/api v0.24.0/go.mod h1:lIXQywCXRcnZPGlsd8NbLnOjtAoL6em04bJ9+z0MncE=
google.golang.org/api v0.28.0/go.mod h1:lIXQywCXRcnZPGlsd8NbLnOjtAoL6em04bJ9+z0MncE=
google.golang.org/api v0.29.0/go.mod h1:Lcubydp8VUV7KeIHD9z2Bys/sm/vGKnG1UHuDBSrHWM=
google.golang.org/api v0.30.0/go.mod h1:QGmEvQ87FHZNiUVJkT14jQNYJ4ZJjdRF23ZXz5138Fc=
google.golang.org/api v0.35.0/go.mod h1:/XrVsuzM0rZmrsbjJutiuftIzeuTQcEeaYcSk/mQ1dg=
google.golang.org/api v0.36.0/go.mod h1:+z5ficQTmoYpPn8LCUNVpK5I7hwkpjbcgqA7I34qYtE=
google.golang.org/api v0.40.0/go.mod h1:fYKFpnQN0DsDSKRVRcQSDQNtqWPfM9i+zNPxepjRCQ8=
google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM=
google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4=
google.golang.org/appengine v1.6.1/go.mod h1:i06prIuMbXzDqacNJfV5OdTW448YApPu5ww/cMBSeb0=
google.golang.org/appengine v1.6.5/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc=
google.golang.org/appengine v1.6.6/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc=
google.golang.org/appengine v1.6.7/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc=
google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc=
google.golang.org/genproto v0.0.0-20190307195333-5fe7a883aa19/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190418145605-e7d98fc518a7/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190425155659-357c62f0e4bb/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190502173448-54afdca5d873/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE=
google.golang.org/genproto v0.0.0-20190801165951-fa694d86fc64/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc=
google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc=
google.golang.org/genproto v0.0.0-20190911173649-1774047e7e51/go.mod h1:IbNlFCBrqXvoKpeg0TB2l7cyZUmoaFKYIwrEpbDKLA8=
google.golang.org/genproto v0.0.0-20191108220845-16a3f7862a1a/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20191115194625-c23dd37a84c9/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20191216164720-4f79533eabd1/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20191230161307-f3c370f40bfb/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20200115191322-ca5a22157cba/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20200122232147-0452cf42e150/go.mod h1:n3cpQtvxv34hfy77yVDNjmbRyujviMdxYliBSkLhpCc=
google.golang.org/genproto v0.0.0-20200204135345-fa8e72b47b90/go.mod h1:GmwEX6Z4W5gMy59cAlVYjN9JhxgbQH6Gn+gFDQe2lzA=
google.golang.org/genproto v0.0.0-20200212174721-66ed5ce911ce/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200224152610-e50cd9704f63/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200228133532-8c2c7df3a383/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200305110556-506484158171/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200312145019-da6875a35672/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200331122359-1ee6d9798940/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200430143042-b979b6f78d84/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200511104702-f5ebc3bea380/go.mod h1:55QSHmfGQM9UVYDPBsyGGes0y52j32PQ3BqQfXhyH3c=
google.golang.org/genproto v0.0.0-20200515170657-fc4c6c6a6587/go.mod h1:YsZOwe1myG/8QRHRsmBRE1LrgQY60beZKjly0O1fX9U=
google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo=
google.golang.org/genproto v0.0.0-20200618031413-b414f8b61790/go.mod h1:jDfRM7FcilCzHH/e9qn6dsT145K34l5v+OpcnNgKAAA=
google.golang.org/genproto v0.0.0-20200729003335-053ba62fc06f/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20200804131852-c06518451d9c/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20200825200019-8632dd797987/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20200904004341-0bd0a958aa1d/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20201109203340-2640f1f9cdfb/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20201201144952-b05cb90ed32e/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20201210142538-e3217bee35cc/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20201214200347-8c77b98c765d/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20210108203827-ffc7fda8c3d7/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/genproto v0.0.0-20210226172003-ab064af71705/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no=
google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c=
google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38=
google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM=
google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg=
google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY=
google.golang.org/grpc v1.26.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk=
google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk=
google.golang.org/grpc v1.27.1/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk=
google.golang.org/grpc v1.28.0/go.mod h1:rpkK4SK4GF4Ach/+MFLZUBavHOvF2JJB5uozKKal+60=
google.golang.org/grpc v1.29.1/go.mod h1:itym6AZVZYACWQqET3MqgPpjcuV5QH3BxFS3IjizoKk=
google.golang.org/grpc v1.30.0/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak=
google.golang.org/grpc v1.31.0/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak=
google.golang.org/grpc v1.31.1/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak=
google.golang.org/grpc v1.33.2/go.mod h1:JMHMWHQWaTccqQQlmk3MJZS+GWXOdAesneDmEnv2fbc=
google.golang.org/grpc v1.34.0/go.mod h1:WotjhfgOW/POjDeRt8vscBtXq+2VjORFy659qA51WJ8=
google.golang.org/grpc v1.35.0/go.mod h1:qjiiYl8FncCW8feJPdyg3v6XW24KsRHe+dy9BAGRRjU=
google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8=
google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0=
google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM=
google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE=
google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo=
google.golang.org/protobuf v1.22.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU=
google.golang.org/protobuf v1.24.0/go.mod h1:r/3tXBNzIEhYS9I1OUVjXDlt8tc493IdKGjtUeSXeh4=
google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c=
google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY=
google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI=
gopkg.in/ini.v1 v1.67.0 h1:Dgnx+6+nfE+IfzjUEISNeydPJh9AXNNsWbGP9KzCsOA=
gopkg.in/ini.v1 v1.67.0/go.mod h1:pNLf8WUiyNEtQjuu5G5vTm06TEv9tsIgeAvK8hOrP4k=
gopkg.in/tomb.v2 v2.0.0-20161208151619-d5d1b5820637 h1:yiW+nvdHb9LVqSHQBXfZCieqV4fzYhNBql77zY0ykqs=
gopkg.in/tomb.v2 v2.0.0-20161208151619-d5d1b5820637/go.mod h1:BHsqpu/nsuzkT5BpiH1EMZPLyqSMM8JbIavyFACoFNk=
gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
gorm.io/driver/mysql v1.5.7 h1:MndhOPYOfEp2rHKgkZIhJ16eVUIRf2HmzgoPmh7FCWo=
gorm.io/driver/mysql v1.5.7/go.mod h1:sEtPWMiqiN1N1cMXoXmBbd8C6/l+TESwriotuRRpkDM=
gorm.io/driver/postgres v1.5.11 h1:ubBVAfbKEUld/twyKZ0IYn9rSQh448EdelLYk9Mv314=
gorm.io/driver/postgres v1.5.11/go.mod h1:DX3GReXH+3FPWGrrgffdvCk3DQ1dwDPdmbenSkweRGI=
gorm.io/driver/sqlite v1.5.7 h1:8NvsrhP0ifM7LX9G4zPB97NwovUakUxc+2V2uuf3Z1I=
gorm.io/driver/sqlite v1.5.7/go.mod h1:U+J8craQU6Fzkcvu8oLeAQmi50TkwPEhHDEjQZXDah4=
gorm.io/gorm v1.25.7/go.mod h1:hbnx/Oo0ChWMn1BIhpy1oYozzpM15i4YPuHDmfYtwg8=
gorm.io/gorm v1.26.1 h1:ghB2gUI9FkS46luZtn6DLZ0f6ooBJ5IbVej2ENFDjRw=
gorm.io/gorm v1.26.1/go.mod h1:8Z33v652h4//uMA76KjeDH8mJXPm1QNCYrMeatR0DOE=
honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190106161140-3f1c8253044a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190418001031-e561f6794a2a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4=
honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg=
honnef.co/go/tools v0.0.1-2020.1.3/go.mod h1:X/FiERA/W4tHapMX5mGpAtMSVEeEUOyHaw9vFzvIQ3k=
honnef.co/go/tools v0.0.1-2020.1.4/go.mod h1:X/FiERA/W4tHapMX5mGpAtMSVEeEUOyHaw9vFzvIQ3k=
gorm.io/driver/mysql v1.6.0 h1:eNbLmNTpPpTOVZi8MMxCi2aaIm0ZpInbORNXDwyLGvg=
gorm.io/driver/mysql v1.6.0/go.mod h1:D/oCC2GWK3M/dqoLxnOlaNKmXz8WNTfcS9y5ovaSqKo=
gorm.io/driver/postgres v1.6.0 h1:2dxzU8xJ+ivvqTRph34QX+WrRaJlmfyPqXmoGVjMBa4=
gorm.io/driver/postgres v1.6.0/go.mod h1:vUw0mrGgrTK+uPHEhAdV4sfFELrByKVGnaVRkXDhtWo=
gorm.io/driver/sqlite v1.6.0 h1:WHRRrIiulaPiPFmDcod6prc4l2VGVWHz80KspNsxSfQ=
gorm.io/driver/sqlite v1.6.0/go.mod h1:AO9V1qIQddBESngQUKWL9yoH93HIeA1X6V633rBwyT8=
gorm.io/gorm v1.30.0 h1:qbT5aPv1UH8gI99OsRlvDToLxW5zR7FzS9acZDOZcgs=
gorm.io/gorm v1.30.0/go.mod h1:8Z33v652h4//uMA76KjeDH8mJXPm1QNCYrMeatR0DOE=
nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
rsc.io/binaryregexp v0.2.0/go.mod h1:qTv7/COck+e2FymRvadv62gMdZztPaShugOCi3I+8D8=
rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=
rsc.io/quote/v3 v3.1.0/go.mod h1:yEA65RcK8LyAZtP9Kv3t0HmxON59tX3rD+tICJqUlj0=
rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA=

4
internal/adapter/persistence/role_repository.go → internal/adapter/postgres/role_repository.go
View File

@ -1,9 +1,9 @@
package persistence
package postgres
import (
"context"
"errors"
"starter-kit/internal/domain/role"
"zee/internal/resource/role"
"gorm.io/gorm"
)

6
internal/adapter/persistence/user_repository.go → internal/adapter/postgres/user_repository.go
View File

@ -1,10 +1,10 @@
package persistence
package postgres
import (
"context"
"errors"
"starter-kit/internal/domain/role"
"starter-kit/internal/domain/user"
"zee/internal/resource/role"
"zee/internal/resource/user"
"gorm.io/gorm"
)

4
internal/helper/database/database.go
View File

@ -7,8 +7,8 @@ import (
"sync"
"time"
"starter-kit/internal/helper/config"
"starter-kit/internal/helper/logger"
"zee/internal/helper/config"
"zee/internal/helper/logger"
"github.com/sirupsen/logrus"
"gorm.io/driver/mysql"

2
internal/helper/logger/README.md
View File

@ -16,7 +16,7 @@ A structured, high-performance logging package built on top of Logrus with the f
## Installation
```go
import "starter-kit/internal/helper/logger"
import "zee/internal/helper/logger"
```
## Basic Usage

2
internal/helper/logger/logger.go
View File

@ -19,7 +19,7 @@ var (
logMutex sync.RWMutex
// defaultFields are included in every log entry
defaultFields = logrus.Fields{
"app_name": "starter-kit",
"app_name": "zee",
"env": os.Getenv("APP_ENV"),
}
)

6
internal/helper/logger/logger_test.go
View File

@ -174,7 +174,6 @@ func TestLogger_CallerInfo(t *testing.T) {
Info("test caller")
})
var data map[string]interface{}
err := json.Unmarshal([]byte(output), &data)
require.NoError(t, err)
@ -214,22 +213,19 @@ func TestLogger_DefaultFields(t *testing.T) {
EnableCaller: true,
})
// Replace the output writer with our buffer
log.SetOutput(&buf)
// Log a test message
Info("test default fields")
// Parse the JSON output
var data map[string]interface{}
err := json.Unmarshal(buf.Bytes(), &data)
require.NoError(t, err, "Failed to unmarshal log output")
// Check that default fields are included
assert.Equal(t, "starter-kit", data["app_name"], "app_name should be set in default fields")
assert.Equal(t, "zee", data["app_name"], "app_name should be set in default fields")
// The env field might be empty in test environment, which is fine
// as long as the field exists in the log entry
_, envExists := data["env"]

2
internal/pkg/lifecycle/lifecycle.go
View File

@ -12,7 +12,7 @@ import (
"go.uber.org/multierr"
"gopkg.in/tomb.v2"
"starter-kit/internal/helper/logger"
"zee/internal/helper/logger"
)
// Lifecycle manages the application lifecycle

0
internal/domain/role/repository.go → internal/resource/role/repository.go
View File

0
internal/domain/role/role.go → internal/resource/role/role.go
View File

0
internal/domain/user/repository.go → internal/resource/user/repository.go
View File

2
internal/domain/user/user.go → internal/resource/user/user.go
View File

@ -3,7 +3,7 @@ package user
import (
"time"
"starter-kit/internal/domain/role"
"zee/internal/resource/role"
)
// User đại diện cho một người dùng trong hệ thống

7
internal/service/auth_service.go
View File

@ -9,11 +9,12 @@ import (
"fmt"
"time"
"zee/internal/resource/role"
"zee/internal/resource/user"
"github.com/golang-jwt/jwt/v5"
"golang.org/x/crypto/bcrypt"
"gorm.io/gorm" // Added gorm import
"starter-kit/internal/domain/role"
"starter-kit/internal/domain/user"
)
// AuthService xử lý các tác vụ liên quan đến xác thực
@ -211,7 +212,7 @@ func (s *authService) generateToken(user *user.User) (string, error) {
ExpiresAt: jwt.NewNumericDate(expirationTime),
IssuedAt: jwt.NewNumericDate(time.Now()),
NotBefore: jwt.NewNumericDate(time.Now()),
Issuer: "ulflow-starter-kit",
Issuer: "ulflow-zee",
},
}

9
internal/service/auth_service_test.go
View File

@ -5,13 +5,14 @@ import (
"testing"
"time"
"zee/internal/resource/role"
"zee/internal/resource/user"
"zee/internal/service"
"github.com/golang-jwt/jwt/v5"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/mock"
"golang.org/x/crypto/bcrypt"
"starter-kit/internal/domain/role"
"starter-kit/internal/domain/user"
"starter-kit/internal/service"
)
// MockUserRepo là mock cho user.Repository
@ -152,7 +153,6 @@ func TestAuthService_Register(t *testing.T) {
mu.On("Create", mock.Anything, mock.AnythingOfType("*user.User")).
Return(nil)
// Mock GetByID - return created user
mu.On("GetByID", mock.Anything, mock.Anything).
Return(&user.User{
@ -265,7 +265,6 @@ func TestAuthService_Login(t *testing.T) {
time.Hour,
)
// Call method
_, _, err := svc.Login(context.Background(), tt.username, tt.password)

4
internal/transport/http/dto/user_dto.go
View File

@ -3,8 +3,8 @@ package dto
import (
"time"
"starter-kit/internal/domain/role"
"starter-kit/internal/domain/user"
"zee/internal/resource/role"
"zee/internal/resource/user"
)
// RegisterRequest định dạng dữ liệu đăng ký người dùng mới

5
internal/transport/http/handler/auth_handler.go
View File

@ -5,9 +5,10 @@ import (
"strings"
"time"
"zee/internal/service"
"zee/internal/transport/http/dto"
"github.com/gin-gonic/gin"
"starter-kit/internal/service"
"starter-kit/internal/transport/http/dto"
)
type AuthHandler struct {

14
internal/transport/http/handler/auth_register_test.go
View File

@ -10,11 +10,11 @@ import (
"testing"
"time"
"starter-kit/internal/adapter/persistence"
"starter-kit/internal/domain/role"
"starter-kit/internal/domain/user"
"starter-kit/internal/service"
"starter-kit/internal/transport/http/dto"
"zee/internal/adapter/postgres"
"zee/internal/resource/role"
"zee/internal/resource/user"
"zee/internal/service"
"zee/internal/transport/http/dto"
"github.com/DATA-DOG/go-sqlmock"
"github.com/gin-gonic/gin"
@ -76,8 +76,8 @@ func TestRegisterHandler(t *testing.T) {
}
// Tạo repositories thật sẽ kết nối với mock DB
realUserRepo := persistence.NewUserRepository(gormDB)
roleRepo := persistence.NewRoleRepository(gormDB)
realUserRepo := postgres.NewUserRepository(gormDB)
roleRepo := postgres.NewRoleRepository(gormDB)
// Tạo mock repository với đầy đủ các phương thức cần thiết
mockedUserRepo := &mockUserRepo{

3
internal/transport/http/handler/health_handler.go
View File

@ -4,8 +4,9 @@ import (
"net/http"
"time"
"zee/internal/helper/config"
"github.com/gin-gonic/gin"
"starter-kit/internal/helper/config"
)
// HealthHandler xử lý các endpoint liên quan đến sức khỏe hệ thống

9
internal/transport/http/handler/health_handler_test.go
View File

@ -9,10 +9,10 @@ import (
"github.com/gin-gonic/gin"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"github.com/stretchr/testify/mock"
"github.com/stretchr/testify/require"
"starter-kit/internal/helper/config"
"zee/internal/helper/config"
)
// MockConfig is a mock of config.Config
@ -110,13 +110,11 @@ func TestHealthCheck(t *testing.T) {
// Setup mock expectations
mockCfg.On("GetAppConfig").Return(&mockCfg.App)
// Create handler with mock config
handler := NewHealthHandler(&config.Config{
App: *mockCfg.GetAppConfig(),
})
// Create a new request
req := httptest.NewRequest("GET", "/health", nil)
@ -130,7 +128,6 @@ func TestHealthCheck(t *testing.T) {
// Serve the request
r.ServeHTTP(w, req)
// Assert the status code
assert.Equal(t, tt.expectedCode, w.Code)
@ -233,7 +230,6 @@ func TestPing(t *testing.T) {
// Setup mock expectations
mockCfg.On("GetAppConfig").Return(&mockCfg.App)
// Create handler with mock config
handler := NewHealthHandler(&config.Config{
App: *mockCfg.GetAppConfig(),
@ -252,7 +248,6 @@ func TestPing(t *testing.T) {
// Serve the request
r.ServeHTTP(w, req)
// Assert the status code
assert.Equal(t, tt.expectedCode, w.Code)

3
internal/transport/http/middleware/auth.go
View File

@ -5,8 +5,9 @@ import (
"net/http"
"strings"
"zee/internal/service"
"github.com/gin-gonic/gin"
"starter-kit/internal/service"
)
const (

7
internal/transport/http/middleware/auth_test.go
View File

@ -9,13 +9,14 @@ import (
"testing"
"time"
"zee/internal/resource/user"
"zee/internal/service"
"zee/internal/transport/http/middleware"
"github.com/gin-gonic/gin"
"github.com/golang-jwt/jwt/v5"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/mock"
"starter-kit/internal/domain/user"
"starter-kit/internal/service"
"starter-kit/internal/transport/http/middleware"
)
// MockAuthService is a mock implementation of AuthService

5
internal/transport/http/middleware/middleware_test.go
View File

@ -5,9 +5,10 @@ import (
"net/http/httptest"
"testing"
"zee/internal/transport/http/middleware"
"github.com/gin-gonic/gin"
"github.com/stretchr/testify/assert"
"starter-kit/internal/transport/http/middleware"
)
// Helper function to perform a test request
@ -78,7 +79,6 @@ func TestCORS(t *testing.T) {
c.JSON(http.StatusOK, gin.H{"status": "ok"})
})
// Create a test request
req, _ := http.NewRequest("GET", "/test", nil)
for k, v := range tt.headers {
@ -91,7 +91,6 @@ func TestCORS(t *testing.T) {
// Check status code
assert.Equal(t, tt.expectedStatus, w.Code)
// For non-preflight requests, check CORS headers
if req.Method != "OPTIONS" {
assert.Equal(t, tt.expectedAllowOrigin, w.Header().Get("Access-Control-Allow-Origin"))

14
internal/transport/http/router.go
View File

@ -1,12 +1,12 @@
package http
import (
"starter-kit/internal/adapter/persistence"
"starter-kit/internal/helper/config"
"starter-kit/internal/service"
"starter-kit/internal/transport/http/handler"
"starter-kit/internal/transport/http/middleware"
"time"
"zee/internal/adapter/postgres"
"zee/internal/helper/config"
"zee/internal/service"
"zee/internal/transport/http/handler"
"zee/internal/transport/http/middleware"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
@ -32,8 +32,8 @@ func SetupRouter(cfg *config.Config, db *gorm.DB) *gin.Engine {
securityCfg.Apply(router)
// Khởi tạo repositories
userRepo := persistence.NewUserRepository(db)
roleRepo := persistence.NewRoleRepository(db)
userRepo := postgres.NewUserRepository(db)
roleRepo := postgres.NewRoleRepository(db)
// Get JWT configuration from config
jwtSecret := "your-secret-key" // Default fallback

5
internal/transport/http/server.go
View File

@ -8,10 +8,11 @@ import (
"net/http"
"time"
"zee/internal/helper/config"
"zee/internal/helper/logger"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
"starter-kit/internal/helper/config"
"starter-kit/internal/helper/logger"
)
// ErrServerClosed is returned by the Server's Start method after a call to Shutdown

2
templates/.env.example
View File

@ -28,5 +28,5 @@ JWT_SECRET="your-32-byte-base64-encoded-secret-key-here"
JWT_ACCESS_TOKEN_EXPIRE=15
JWT_REFRESH_TOKEN_EXPIRE=30
JWT_ALGORITHM="HS256"
JWT_ISSUER="ulflow-starter-kit"
JWT_ISSUER="ulflow-zee"
JWT_AUDIENCE="ulflow-web"