Documentation
¶
Index ¶
- func CustomHTTPErrorHandler(err error, c echo.Context)
- func FormatValidationError(err error) string
- func NewBadRequestError(message string) error
- func NewInternalServerError(message string) error
- func NewNotFoundError(message string) error
- func NewSuccessResponse(c echo.Context) error
- func NewUnauthorizedError(message string) error
- func ValidateRequest(req interface{}) error
- type SystemHandler
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CustomHTTPErrorHandler ¶ added in v1.0.1
CustomHTTPErrorHandler 커스텀 HTTP 에러 핸들러입니다. 모든 HTTP 에러를 표준 ErrorResponse 형식으로 반환합니다.
func FormatValidationError ¶ added in v1.0.1
FormatValidationError validator 에러를 사용자 친화적인 한글 메시지로 변환합니다. 여러 검증 에러가 있을 경우 첫 번째 에러만 반환합니다.
func NewBadRequestError ¶ added in v1.0.1
NewBadRequestError 400 Bad Request 에러를 생성합니다
func NewInternalServerError ¶ added in v1.0.1
NewInternalServerError 500 Internal Server Error 에러를 생성합니다
func NewNotFoundError ¶ added in v1.0.1
NewNotFoundError 404 Not Found 에러를 생성합니다
func NewSuccessResponse ¶ added in v1.0.1
NewSuccessResponse 표준화된 성공 응답을 생성합니다
func NewUnauthorizedError ¶ added in v1.0.1
NewUnauthorizedError 401 Unauthorized 에러를 생성합니다
func ValidateRequest ¶ added in v1.0.1
func ValidateRequest(req interface{}) error
ValidateRequest 구조체의 validation tag를 기반으로 검증을 수행합니다. 검증 실패 시 첫 번째 에러를 반환합니다.
Types ¶
type SystemHandler ¶ added in v1.0.1
type SystemHandler struct {
// contains filtered or unexported fields
}
SystemHandler 시스템 관련 요청(헬스체크, 버전 등)을 처리하는 핸들러입니다.
func NewSystemHandler ¶ added in v1.0.1
func NewSystemHandler(notificationSender notification.Sender, buildInfo common.BuildInfo) *SystemHandler
NewSystemHandler SystemHandler 인스턴스를 생성합니다.
func (*SystemHandler) HealthCheckHandler ¶ added in v1.0.1
func (h *SystemHandler) HealthCheckHandler(c echo.Context) error
HealthCheckHandler godoc @Summary 서버 상태 확인 @Description 서버가 정상적으로 동작하는지 확인합니다. @Description @Description 이 엔드포인트는 인증 없이 호출할 수 있으며, 모니터링 시스템에서 서버 상태를 확인하는 데 사용됩니다. @Description @Description ## 응답 필드 @Description - status: 전체 서버 상태 (healthy, unhealthy) @Description - uptime: 서버 가동 시간 (초) @Description - dependencies: 의존성 서비스 상태 (notification_service 등) @Tags System @Produce json @Success 200 {object} response.HealthResponse "서버 정상" @Failure 500 {object} response.ErrorResponse "서버 내부 오류" @Router /health [get]
func (*SystemHandler) VersionHandler ¶ added in v1.0.1
func (h *SystemHandler) VersionHandler(c echo.Context) error
VersionHandler godoc @Summary 서버 버전 정보 @Description 서버의 빌드 정보를 반환합니다. @Description @Description Git 커밋 해시, 빌드 날짜, 빌드 번호, Go 버전 등의 정보를 제공합니다. @Description 이 정보는 디버깅 및 버전 확인에 유용합니다. @Tags System @Produce json @Success 200 {object} response.VersionResponse "버전 정보" @Failure 500 {object} response.ErrorResponse "서버 내부 오류" @Router /version [get]