feat: add basic app

internal/server/server.go

@@ -0,0 +1,114 @@
+package server
+
+import (
+	"context"
+	"errors"
+	"github.com/go-chi/chi/v5"
+	"github.com/go-chi/chi/v5/middleware"
+	oapimiddleware "github.com/oapi-codegen/nethttp-middleware"
+	"gitlab.mareshq.com/hq/backoffice/backoffice-api/internal/training"
+	"log"
+	"net/http"
+	"time"
+)
+
+type Server struct {
+	logger   *log.Logger
+	hostname string
+
+	trainingRepository training.Repository
+
+	router *chi.Mux
+	srv    *http.Server
+	tls    *TLS
+}
+
+type TLS struct {
+	CertFile string
+	KeyFile  string
+}
+
+func NewServer(hostname string, logger *log.Logger, trainingRepository training.Repository) *Server {
+	return &Server{
+		logger:             logger,
+		hostname:           hostname,
+		trainingRepository: trainingRepository,
+		router:             chi.NewRouter(),
+		tls:                nil,
+	}
+}
+
+func NewServerWithTLS(hostname string, tls *TLS, logger *log.Logger, trainingRepository training.Repository) *Server {
+	s := NewServer(hostname, logger, trainingRepository)
+	s.tls = tls
+	return s
+}
+
+func (s *Server) Run(ctx context.Context) error {
+	swagger, err := GetSwagger()
+	if err != nil {
+		return err
+	}
+
+	// Clear out the servers array in the swagger spec, that skips validating
+	// that server names match. We don't know how this thing will be run.
+	swagger.Servers = nil
+
+	s.router.Use(middleware.Logger)
+	// middleware.Recoverer recovers from panics, logs the panic (and a stack trace),
+	s.router.Use(middleware.Recoverer)
+	// we trust headers, since we are running on Kubernetes with Ingress Controller (Ingress-NGINX)
+	// and behind an L4 load balancer (on Hetzner Cloud)
+	s.router.Use(middleware.RealIP)
+	// middleware.RequestID generates a request ID and adds it to request context
+	// if the request has an `X-Request-ID` header, it will use that as the request ID
+	s.router.Use(middleware.RequestID)
+	s.router.Use(middleware.Timeout(10 * time.Second))
+	s.router.Use(oapimiddleware.OapiRequestValidator(swagger))
+
+	// create handler
+	h := NewStrictHandler(s, nil)
+
+	// register endpoints
+	HandlerFromMux(h, s.router)
+
+	s.srv = &http.Server{
+		Addr:    ":8080", // TODO: make port configurable
+		Handler: s.router,
+	}
+
+	go func() {
+		var err error
+		if s.tls != nil {
+			s.logger.Printf("Starting HTTPS server on: %s\n", s.srv.Addr)
+			err = s.srv.ListenAndServeTLS(s.tls.CertFile, s.tls.KeyFile)
+		} else {
+			s.logger.Printf("Starting HTTP server on: %s\n", s.srv.Addr)
+			err = s.srv.ListenAndServe()
+		}
+		// suppress the error if the server was closed gracefully
+		if err != nil && !errors.Is(err, http.ErrServerClosed) {
+			s.logger.Printf("error: %v\n", err)
+		}
+	}()
+
+	// wait for the context to be done
+	// context done means the server is shutting down
+	<-ctx.Done()
+
+	// TODO: make graceful shutdown period configurable
+	timeout := 10 * time.Second
+	timeoutCtx, cancel := context.WithTimeout(context.Background(), timeout)
+	defer cancel()
+
+	s.logger.Printf("Shutting down server in %s seconds\n", timeout.String())
+	err = s.srv.Shutdown(timeoutCtx)
+	// suppress the error if the server was closed gracefully
+	if err != nil && !errors.Is(err, http.ErrServerClosed) {
+		return err
+	}
+
+	s.logger.Println("Server shutdown successfully")
+
+	return nil
+}

internal/server/training.go

@@ -0,0 +1,167 @@
+package server
+
+import (
+	"context"
+	"github.com/shopspring/decimal"
+	"gitlab.mareshq.com/hq/backoffice/backoffice-api/internal/training"
+)
+
+func (s *Server) CreateTraining(ctx context.Context, req CreateTrainingRequestObject) (CreateTrainingResponseObject, error) {
+
+	pricing := make([]training.Price, len(req.Body.Training.Pricing))
+	for i, p := range req.Body.Training.Pricing {
+		amount, err := decimal.NewFromString(p.Amount)
+		if err != nil {
+			return CreateTraining400ApplicationProblemPlusJSONResponse{
+				InvalidInputErrorApplicationProblemPlusJSONResponse{
+					Title:    "Invalid amount",
+					Detail:   err.Error(),
+					Instance: s.hostname,
+				},
+			}, nil
+		}
+
+		pricing[i] = training.Price{
+			Currency: p.Currency,
+			Amount:   amount,
+			Type:     training.PriceType(p.Type),
+		}
+	}
+
+	newTr := training.NewTraining(req.Body.Training.Name, req.Body.Training.Days, pricing)
+
+	err := s.trainingRepository.Create(ctx, newTr)
+	if err != nil {
+		// returning response and nil as error
+		// since we suppress the error in code here and return an error response instead
+		return CreateTraining500ApplicationProblemPlusJSONResponse{
+			InternalErrorApplicationProblemPlusJSONResponse{
+				Title:    "Internal Server Error",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	tr := trainingToAPITraining(newTr)
+	return CreateTraining201JSONResponse{
+		CreateTrainingResponseJSONResponse(tr),
+	}, nil
+}
+
+func (s *Server) GetTrainingByID(ctx context.Context, req GetTrainingByIDRequestObject) (GetTrainingByIDResponseObject, error) {
+	tr, err := s.trainingRepository.FindByID(ctx, req.TrainingID)
+	if err != nil {
+		return GetTrainingByID404ApplicationProblemPlusJSONResponse{
+			// returning response and nil as error
+			// since we suppress the error in code here and return an error response instead
+			NotFoundErrorApplicationProblemPlusJSONResponse{
+				Title:    "Not Found Training by ID",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	trAPI := trainingToAPITraining(tr)
+	return GetTrainingByID200JSONResponse{
+		GetTrainingResponseJSONResponse(trAPI),
+	}, nil
+}
+
+func (s *Server) ListTrainings(ctx context.Context, _ ListTrainingsRequestObject) (ListTrainingsResponseObject, error) {
+	trs, err := s.trainingRepository.FindAll(ctx)
+	if err != nil {
+		return ListTrainings500ApplicationProblemPlusJSONResponse{
+			// returning response and nil as error
+			// since we suppress the error in code here and return an error response instead
+			InternalErrorApplicationProblemPlusJSONResponse{
+				Title:    "Internal Server Error",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	var trAPIs []Training
+	for _, tr := range trs {
+		trAPIs = append(trAPIs, trainingToAPITraining(&tr))
+	}
+
+	return ListTrainings200JSONResponse{
+		ListTrainingsResponseJSONResponse{
+			Trainings: &trAPIs,
+		},
+	}, nil
+}
+
+func (s *Server) PublishTraining(ctx context.Context, req PublishTrainingRequestObject) (PublishTrainingResponseObject, error) {
+	err := s.trainingRepository.Publish(ctx, req.TrainingID)
+	if err != nil {
+		return PublishTraining500ApplicationProblemPlusJSONResponse{
+			// returning response and nil as error
+			// since we suppress the error in code here and return an error response instead
+			InternalErrorApplicationProblemPlusJSONResponse{
+				Title:    "Internal Server Error",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	return PublishTraining204Response{}, nil
+}
+
+func (s *Server) UnpublishTraining(ctx context.Context, req UnpublishTrainingRequestObject) (UnpublishTrainingResponseObject, error) {
+	err := s.trainingRepository.Unpublish(ctx, req.TrainingID)
+	if err != nil {
+		return UnpublishTraining500ApplicationProblemPlusJSONResponse{
+			// returning response and nil as error
+			// since we suppress the error in code here and return an error response instead
+			InternalErrorApplicationProblemPlusJSONResponse{
+				Title:    "Internal Server Error",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	return UnpublishTraining204Response{}, nil
+}
+
+func (s *Server) RetireTraining(ctx context.Context, req RetireTrainingRequestObject) (RetireTrainingResponseObject, error) {
+	err := s.trainingRepository.Retire(ctx, req.TrainingID)
+	if err != nil {
+		return RetireTraining500ApplicationProblemPlusJSONResponse{
+			// returning response and nil as error
+			// since we suppress the error in code here and return an error response instead
+			InternalErrorApplicationProblemPlusJSONResponse{
+				Title:    "Internal Server Error",
+				Detail:   err.Error(),
+				Instance: s.hostname,
+			},
+		}, nil
+	}
+
+	return RetireTraining204Response{}, nil
+}
+
+func trainingToAPITraining(t *training.Training) Training {
+	tPricing := t.Pricing()
+	pricing := make([]TrainingPrice, len(tPricing))
+	for i, p := range tPricing {
+		pricing[i] = TrainingPrice{
+			Currency: p.Currency,
+			Amount:   p.Amount.String(),
+			Type:     TrainingPriceType(p.Type),
+		}
+	}
+	return Training{
+		Id:        t.ID(),
+		Name:      t.Name(),
+		Days:      t.Days(),
+		Published: t.Published(),
+		Retired:   t.Retired(),
+		Pricing:   pricing,
+	}
+}