feat (kfr): base crud + validation&verification done, no rules set yet

internal/domain/main-entities/kfr/dto.go

@@ -9,12 +9,13 @@ import (
 	ee "simrs-vx/internal/domain/main-entities/encounter"
 
 	pa "simrs-vx/internal/lib/auth"
+
+	pu "simrs-vx/pkg/use-case-helper"
 )
 
 type CreateDto struct {
 	Encounter_Id          *uint                   `json:"encounter_id"`
 	CreatedBy_Employee_Id *uint                   `json:"createdBy_employee_id"`
-	Value                 *string                 `json:"value"`
 	Type                  ere.KFRTypeCode         `json:"type" gorm:"size:15"`
 	Subjective            string                  `json:"subjective"`
 	Objective             string                  `json:"objective"`
@@ -25,7 +26,7 @@ type CreateDto struct {
 	Frequency             *uint                   `json:"frequency"`
 	IntervalUnit_Code     *erc.TimeUnitCode       `json:"intervalUnit_code" gorm:"size:10"`
 	FollowUpType          ere.KFRFollowUpTypeCode `json:"followUpType" gorm:"size:10"`
-	FollowUpNote          string                  `json:"dischargePlanning"`
+	FollowUpNote          string                  `json:"followUpNote"`
 	Status_Code           erc.DataVerifiedCode    `json:"status_code" gorm:"not null;size:10"`
 
 	pa.AuthInfo
@@ -81,7 +82,7 @@ type ResponseDto struct {
 	Frequency             *uint                   `json:"frequency"`
 	IntervalUnit_Code     *erc.TimeUnitCode       `json:"intervalUnit_code" gorm:"size:10"`
 	FollowUpType          ere.KFRFollowUpTypeCode `json:"followUpType" gorm:"size:10"`
-	FollowUpNote          string                  `json:"dischargePlanning"`
+	FollowUpNote          string                  `json:"followUpNote"`
 	Status_Code           erc.DataVerifiedCode    `json:"status_code" gorm:"not null;size:10"`
 }
 
@@ -115,3 +116,11 @@ func ToResponseList(data []KFR) []ResponseDto {
 	}
 	return resp
 }
+
+func (c CreateDto) IsCorrectType() bool {
+	return pu.Contains([]ere.KFRTypeCode{ere.KFRAssessment, ere.KFRTherapy, ere.KFRReAssessment}, c.Type)
+}
+
+func (c CreateDto) IsCorrectFollowUpType() bool {
+	return pu.Contains([]ere.KFRFollowUpTypeCode{ere.KFUTCEva, ere.KFUTCRef, ere.KFUTCFin}, c.FollowUpType)
+}

internal/domain/main-entities/kfr/entitiy.go

@@ -25,6 +25,18 @@ type KFR struct {
 	Frequency             *uint                   `json:"frequency"`
 	IntervalUnit_Code     *erc.TimeUnitCode       `json:"intervalUnit_code" gorm:"size:10"`
 	FollowUpType          ere.KFRFollowUpTypeCode `json:"followUpType" gorm:"size:10"`
-	FollowUpNote          string                  `json:"dischargePlanning"`
+	FollowUpNote          string                  `json:"followUpNote"`
 	Status_Code           erc.DataVerifiedCode    `json:"status_code" gorm:"not null;size:10"`
 }
+
+func (d KFR) IsNew() bool {
+	return d.Status_Code == erc.DVCNew
+}
+
+func (d KFR) IsVerified() bool {
+	return d.Status_Code == erc.DVCVerified
+}
+
+func (d KFR) IsValidated() bool {
+	return d.Status_Code == erc.DVCValidated
+}

internal/interface/main-handler/kfr/handler.go

@@ -0,0 +1,146 @@
+package kfr
+
+import (
+	"net/http"
+
+	d "github.com/karincake/dodol"
+	rw "github.com/karincake/risoles"
+	sf "github.com/karincake/semprit"
+
+	// ua "github.com/karincake/tumpeng/auth/svc"
+
+	e "simrs-vx/internal/domain/main-entities/kfr"
+	u "simrs-vx/internal/use-case/main-use-case/kfr"
+
+	erc "simrs-vx/internal/domain/references/common"
+
+	pa "simrs-vx/internal/lib/auth"
+)
+
+func Create(w http.ResponseWriter, r *http.Request) {
+	authInfo, err := pa.GetAuthInfo(r)
+	if err != nil {
+		rw.WriteJSON(w, http.StatusUnauthorized, d.IS{"message": err.Error()}, nil)
+	}
+	dto := e.CreateDto{}
+	if res := rw.ValidateStructByIOR(w, r.Body, &dto); !res {
+		return
+	}
+
+	if !dto.IsCorrectType() {
+		rw.WriteJSON(w, http.StatusBadRequest, d.IS{"message": "invalid kfr type"}, nil)
+		return
+	}
+
+	if !dto.IsCorrectFollowUpType() {
+		rw.WriteJSON(w, http.StatusBadRequest, d.IS{"message": "invalid kfr followUpType"}, nil)
+		return
+	}
+
+	dto.AuthInfo = *authInfo
+	res, err := u.Create(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func GetList(w http.ResponseWriter, r *http.Request) {
+	dto := e.ReadListDto{}
+	sf.UrlQueryParam(&dto, *r.URL)
+	res, err := u.ReadList(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func GetDetail(w http.ResponseWriter, r *http.Request) {
+	id := rw.ValidateInt(w, "id", r.PathValue("id"))
+	if id <= 0 {
+		return
+	}
+	dto := e.ReadDetailDto{}
+	sf.UrlQueryParam(&dto, *r.URL)
+	dto.Id = uint(id)
+	res, err := u.ReadDetail(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func Update(w http.ResponseWriter, r *http.Request) {
+	authInfo, err := pa.GetAuthInfo(r)
+	if err != nil {
+		rw.WriteJSON(w, http.StatusUnauthorized, d.IS{"message": err.Error()}, nil)
+	}
+	id := rw.ValidateInt(w, "id", r.PathValue("id"))
+	if id <= 0 {
+		return
+	}
+
+	dto := e.UpdateDto{}
+	if res := rw.ValidateStructByIOR(w, r.Body, &dto); !res {
+		return
+	}
+
+	if !dto.IsCorrectType() {
+		rw.WriteJSON(w, http.StatusBadRequest, d.IS{"message": "invalid kfr type"}, nil)
+		return
+	}
+
+	if !dto.IsCorrectFollowUpType() {
+		rw.WriteJSON(w, http.StatusBadRequest, d.IS{"message": "invalid kfr followUpType"}, nil)
+		return
+	}
+
+	dto.Id = uint(id)
+	dto.AuthInfo = *authInfo
+	res, err := u.Update(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func Delete(w http.ResponseWriter, r *http.Request) {
+	authInfo, err := pa.GetAuthInfo(r)
+	if err != nil {
+		rw.WriteJSON(w, http.StatusUnauthorized, d.IS{"message": err.Error()}, nil)
+	}
+	id := rw.ValidateInt(w, "id", r.PathValue("id"))
+	if id <= 0 {
+		return
+	}
+
+	dto := e.DeleteDto{}
+	dto.Id = uint(id)
+	dto.AuthInfo = *authInfo
+	res, err := u.Delete(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func Verify(w http.ResponseWriter, r *http.Request) {
+	authInfo, err := pa.GetAuthInfo(r)
+	if err != nil {
+		rw.WriteJSON(w, http.StatusUnauthorized, d.IS{"message": err.Error()}, nil)
+	}
+	id := rw.ValidateInt(w, "id", r.PathValue("id"))
+	if id <= 0 {
+		return
+	}
+
+	dto := e.UpdateDto{}
+	dto.Id = uint(id)
+	dto.Status_Code = erc.DVCVerified
+	dto.AuthInfo = *authInfo
+	res, err := u.UpdateStatusCode(dto)
+	rw.DataResponse(w, res, err)
+}
+
+func Validate(w http.ResponseWriter, r *http.Request) {
+	authInfo, err := pa.GetAuthInfo(r)
+	if err != nil {
+		rw.WriteJSON(w, http.StatusUnauthorized, d.IS{"message": err.Error()}, nil)
+	}
+	id := rw.ValidateInt(w, "id", r.PathValue("id"))
+	if id <= 0 {
+		return
+	}
+
+	dto := e.UpdateDto{}
+	dto.Id = uint(id)
+	dto.Status_Code = erc.DVCValidated
+	dto.AuthInfo = *authInfo
+	res, err := u.UpdateStatusCode(dto)
+	rw.DataResponse(w, res, err)
+}

internal/interface/main-handler/main-handler.go

@@ -19,6 +19,7 @@ import (
 	generalconsent "simrs-vx/internal/interface/main-handler/general-consent"
 	generatefile "simrs-vx/internal/interface/main-handler/generate-file"
 	internalreference "simrs-vx/internal/interface/main-handler/internal-reference"
+	kfr "simrs-vx/internal/interface/main-handler/kfr"
 	materialorder "simrs-vx/internal/interface/main-handler/material-order"
 	materialorderitem "simrs-vx/internal/interface/main-handler/material-order-item"
 	mcuorder "simrs-vx/internal/interface/main-handler/mcu-order"
@@ -347,6 +348,15 @@ func SetRoutes() http.Handler {
 		"GET /":     screening.O.GetList,
 		"GET /{id}": screening.O.GetDetail,
 	})
+	hk.GroupRoutes("/v1/kfr", r, auth.GuardMW, hk.MapHandlerFunc{
+		"POST /":               kfr.Create,
+		"GET /":                kfr.GetList,
+		"GET /{id}":            kfr.GetDetail,
+		"PATCH /{id}":          kfr.Update,
+		"DELETE /{id}":         kfr.Delete,
+		"PATCH /{id}/verify":   kfr.Verify,
+		"PATCH /{id}/validate": kfr.Validate,
+	})
 	/******************** actor ********************/
 	hc.RegCrud(r, "/v1/person", person.O)
 	hc.RegCrud(r, "/v1/person-address", personaddress.O)

internal/use-case/main-use-case/kfr/case.go

@@ -0,0 +1,397 @@
+package kfr
+
+import (
+	"errors"
+	"strconv"
+
+	erc "simrs-vx/internal/domain/references/common"
+
+	// main entities
+	ee "simrs-vx/internal/domain/main-entities/encounter"
+	e "simrs-vx/internal/domain/main-entities/kfr"
+
+	ue "simrs-vx/internal/use-case/main-use-case/encounter"
+
+	pl "simrs-vx/pkg/logger"
+	pu "simrs-vx/pkg/use-case-helper"
+
+	dg "github.com/karincake/apem/db-gorm-pg"
+	d "github.com/karincake/dodol"
+	"gorm.io/gorm"
+)
+
+const source = "kfr"
+
+func Create(input e.CreateDto) (*d.Data, error) {
+	data := e.KFR{}
+
+	event := pl.Event{
+		Feature: "Create",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "create")
+
+	err := dg.I.Transaction(func(tx *gorm.DB) error {
+		if !input.AuthInfo.IsDoctor() {
+			return errors.New("user is not a doctor")
+		}
+
+		mwRunner := newMiddlewareRunner(&event, tx)
+		mwRunner.setMwType(pu.MWTPre)
+		// Run pre-middleware
+		if err := mwRunner.RunCreateMiddleware(createPreMw, &input, &data); err != nil {
+			return err
+		}
+
+		// check if encounter is done
+		if ue.IsDone(*input.Encounter_Id, &event, tx) {
+			return errors.New("encounter is already done")
+		}
+
+		if input.AuthInfo.Employee_Id == nil {
+			return errors.New("user is not an employee")
+		}
+
+		input.CreatedBy_Employee_Id = input.AuthInfo.Employee_Id
+
+		if resData, err := CreateData(input, &event, tx); err != nil {
+			return err
+		} else {
+			data = *resData
+		}
+
+		mwRunner.setMwType(pu.MWTPost)
+		// Run post-middleware
+		if err := mwRunner.RunCreateMiddleware(createPostMw, &input, &data); err != nil {
+			return err
+		}
+
+		pl.SetLogInfo(&event, nil, "complete")
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.II{
+			"source":    source,
+			"structure": "single-data",
+			"status":    "created",
+		},
+		Data: data.ToResponse(),
+	}, nil
+}
+
+func ReadList(input e.ReadListDto) (*d.Data, error) {
+	var data *e.KFR
+	var dataList []e.KFR
+	var metaList *e.MetaDto
+	var err error
+
+	event := pl.Event{
+		Feature: "ReadList",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "readList")
+
+	err = dg.I.Transaction(func(tx *gorm.DB) error {
+		mwRunner := newMiddlewareRunner(&event, tx)
+		mwRunner.setMwType(pu.MWTPre)
+		// Run pre-middleware
+		if err := mwRunner.RunReadListMiddleware(readListPreMw, &input, data); err != nil {
+			return err
+		}
+
+		if dataList, metaList, err = ReadListData(input, &event, tx); err != nil {
+			return err
+		}
+
+		mwRunner.setMwType(pu.MWTPost)
+		// Run post-middleware
+		if err := mwRunner.RunReadListMiddleware(readListPostMw, &input, data); err != nil {
+			return err
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.IS{
+			"source":              source,
+			"structure":           "list-data",
+			"status":              "fetched",
+			"page_number":         strconv.Itoa(metaList.PageNumber),
+			"page_size":           strconv.Itoa(metaList.PageSize),
+			"record_totalCount":   strconv.Itoa(metaList.Count),
+			"record_currentCount": strconv.Itoa(len(dataList)),
+		},
+		Data: e.ToResponseList(dataList),
+	}, nil
+}
+
+func ReadDetail(input e.ReadDetailDto) (*d.Data, error) {
+	var data *e.KFR
+	var err error
+
+	event := pl.Event{
+		Feature: "ReadDetail",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "readDetail")
+
+	err = dg.I.Transaction(func(tx *gorm.DB) error {
+		mwRunner := newMiddlewareRunner(&event, tx)
+		mwRunner.setMwType(pu.MWTPre)
+		// Run pre-middleware
+		if err := mwRunner.RunReadDetailMiddleware(readDetailPreMw, &input, data); err != nil {
+			return err
+		}
+
+		if data, err = ReadDetailData(input, &event, tx); err != nil {
+			return err
+		}
+
+		mwRunner.setMwType(pu.MWTPost)
+		// Run post-middleware
+		if err := mwRunner.RunReadDetailMiddleware(readDetailPostMw, &input, data); err != nil {
+			return err
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.IS{
+			"source":    source,
+			"structure": "single-data",
+			"status":    "fetched",
+		},
+		Data: data.ToResponse(),
+	}, nil
+}
+
+func Update(input e.UpdateDto) (*d.Data, error) {
+	rdDto := e.ReadDetailDto{Id: input.Id}
+	var data *e.KFR
+	var err error
+
+	event := pl.Event{
+		Feature: "Update",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "update")
+
+	err = dg.I.Transaction(func(tx *gorm.DB) error {
+		if !input.AuthInfo.IsDoctor() {
+			return errors.New("user is not a doctor")
+		}
+
+		pl.SetLogInfo(&event, rdDto, "started", "DBReadDetail")
+		if data, err = ReadDetailData(rdDto, &event, tx); err != nil {
+			return err
+		}
+
+		mwRunner := newMiddlewareRunner(&event, tx)
+		mwRunner.setMwType(pu.MWTPre)
+		// Run pre-middleware
+		if err := mwRunner.RunUpdateMiddleware(readDetailPreMw, &rdDto, data); err != nil {
+			return err
+		}
+
+		// check if encounter is done
+		if ue.IsDone(*input.Encounter_Id, &event, tx) {
+			return errors.New("encounter is already done")
+		}
+
+		if err := UpdateData(input, data, &event, tx); err != nil {
+			return err
+		}
+
+		// Get Updated Data
+		if data, err = ReadDetailData(rdDto, &event, tx); err != nil {
+			return err
+		}
+
+		pl.SetLogInfo(&event, nil, "complete")
+
+		mwRunner.setMwType(pu.MWTPost)
+		// Run post-middleware
+		if err := mwRunner.RunUpdateMiddleware(readDetailPostMw, &rdDto, data); err != nil {
+			return err
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.IS{
+			"source":    source,
+			"structure": "single-data",
+			"status":    "updated",
+		},
+		Data: data.ToResponse(),
+	}, nil
+
+}
+
+func Delete(input e.DeleteDto) (*d.Data, error) {
+	rdDto := e.ReadDetailDto{Id: uint(input.Id)}
+	var data *e.KFR
+	var err error
+
+	event := pl.Event{
+		Feature: "Delete",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "delete")
+
+	err = dg.I.Transaction(func(tx *gorm.DB) error {
+		if !input.AuthInfo.IsDoctor() {
+			return errors.New("user is not a doctor")
+		}
+
+		pl.SetLogInfo(&event, rdDto, "started", "DBReadDetail")
+		if data, err = ReadDetailData(rdDto, &event, tx); err != nil {
+			return err
+		}
+
+		mwRunner := newMiddlewareRunner(&event, tx)
+		mwRunner.setMwType(pu.MWTPre)
+		// Run pre-middleware
+		if err := mwRunner.RunDeleteMiddleware(readDetailPreMw, &rdDto, data); err != nil {
+			return err
+		}
+
+		if err := DeleteData(data, &event, tx); err != nil {
+			return err
+		}
+
+		mwRunner.setMwType(pu.MWTPost)
+		// Run post-middleware
+		if err := mwRunner.RunDeleteMiddleware(readDetailPostMw, &rdDto, data); err != nil {
+			return err
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.IS{
+			"source":    source,
+			"structure": "single-data",
+			"status":    "deleted",
+		},
+		Data: data.ToResponse(),
+	}, nil
+
+}
+
+func UpdateStatusCode(input e.UpdateDto) (*d.Data, error) {
+	rdDto := e.ReadDetailDto{Id: input.Id}
+	var data *e.KFR
+	var err error
+
+	event := pl.Event{
+		Feature: "UpdateStatusCode",
+		Source:  source,
+	}
+
+	// Start log
+	pl.SetLogInfo(&event, input, "started", "updateStatusCode")
+
+	err = dg.I.Transaction(func(tx *gorm.DB) error {
+		if !input.AuthInfo.IsDoctor() {
+			return errors.New("user is not a doctor")
+		}
+
+		pl.SetLogInfo(&event, rdDto, "started", "DBReadDetail")
+		if data, err = ReadDetailData(rdDto, &event, tx); err != nil {
+			return err
+		}
+
+		enc, err := ue.ReadDetailData(ee.ReadDetailDto{Id: *data.Encounter_Id}, &event, tx)
+		if err != nil {
+			return err
+		}
+
+		// check if encounter is done
+		if enc.IsDone() {
+			return errors.New("encounter is already done")
+		}
+
+		switch input.Status_Code {
+		case erc.DVCValidated:
+			if data.IsNew() {
+				return errors.New("resume need to be verified first")
+			}
+			if data.IsValidated() {
+				return errors.New("resume already validated")
+			}
+			if !enc.IsSameResponsibleDoctor(input.AuthInfo.Doctor_Code) {
+				return errors.New("validation doctor is not the same as encounter responsible doctor")
+			}
+
+			data.Status_Code = erc.DVCValidated
+			err = tx.Save(&data).Error
+			if err != nil {
+				return err
+			}
+		case erc.DVCVerified:
+			if data.IsValidated() {
+				return errors.New("resume already validated")
+			}
+			if data.IsVerified() {
+				return errors.New("resume already verified")
+			}
+			data.Status_Code = erc.DVCVerified
+			err = tx.Save(&data).Error
+			if err != nil {
+				return err
+			}
+		}
+
+		return nil
+	})
+
+	if err != nil {
+		return nil, err
+	}
+
+	return &d.Data{
+		Meta: d.IS{
+			"source":    source,
+			"structure": "single-data",
+			"status":    "updated",
+		},
+		Data: data.ToResponse(),
+	}, nil
+}

internal/use-case/main-use-case/kfr/helper.go

@@ -0,0 +1,36 @@
+/*
+DESCRIPTION:
+Any functions that are used internally by the use-case
+*/
+package kfr
+
+import (
+	e "simrs-vx/internal/domain/main-entities/kfr"
+
+	erc "simrs-vx/internal/domain/references/common"
+)
+
+func setData[T *e.CreateDto | *e.UpdateDto](input T, data *e.KFR) {
+	var inputSrc *e.CreateDto
+	if inputT, ok := any(input).(*e.CreateDto); ok {
+		inputSrc = inputT
+		data.Status_Code = erc.DVCNew
+	} else {
+		inputTemp := any(input).(*e.UpdateDto)
+		inputSrc = &inputTemp.CreateDto
+	}
+
+	data.Encounter_Id = inputSrc.Encounter_Id
+	data.CreatedBy_Employee_Id = inputSrc.CreatedBy_Employee_Id
+	data.Type = inputSrc.Type
+	data.Subjective = inputSrc.Subjective
+	data.Objective = inputSrc.Objective
+	data.Assessment = inputSrc.Assessment
+	data.TreatmentGoals = inputSrc.TreatmentGoals
+	data.Education = inputSrc.Education
+	data.Action = inputSrc.Action
+	data.Frequency = inputSrc.Frequency
+	data.IntervalUnit_Code = inputSrc.IntervalUnit_Code
+	data.FollowUpType = inputSrc.FollowUpType
+	data.FollowUpNote = inputSrc.FollowUpNote
+}

internal/use-case/main-use-case/kfr/lib.go

@@ -0,0 +1,140 @@
+package kfr
+
+import (
+	"errors"
+	e "simrs-vx/internal/domain/main-entities/kfr"
+	plh "simrs-vx/pkg/lib-helper"
+	pl "simrs-vx/pkg/logger"
+	pu "simrs-vx/pkg/use-case-helper"
+
+	dg "github.com/karincake/apem/db-gorm-pg"
+	gh "github.com/karincake/getuk"
+	"gorm.io/gorm"
+)
+
+func CreateData(input e.CreateDto, event *pl.Event, dbx ...*gorm.DB) (*e.KFR, error) {
+	pl.SetLogInfo(event, nil, "started", "DBCreate")
+
+	data := e.KFR{}
+	setData(&input, &data)
+
+	var tx *gorm.DB
+	if len(dbx) > 0 {
+		tx = dbx[0]
+	} else {
+		tx = dg.I
+	}
+
+	if err := tx.Create(&data).Error; err != nil {
+		return nil, plh.HandleCreateError(input, event, err)
+	}
+
+	pl.SetLogInfo(event, nil, "complete")
+	return &data, nil
+}
+
+func ReadListData(input e.ReadListDto, event *pl.Event, dbx ...*gorm.DB) ([]e.KFR, *e.MetaDto, error) {
+	pl.SetLogInfo(event, input, "started", "DBReadList")
+	data := []e.KFR{}
+	pagination := gh.Pagination{}
+	count := int64(0)
+	meta := e.MetaDto{}
+
+	var tx *gorm.DB
+	if len(dbx) > 0 {
+		tx = dbx[0]
+	} else {
+		tx = dg.I
+	}
+
+	tx = tx.
+		Model(&e.KFR{}).
+		Scopes(gh.Preload(input.Includes)).
+		Scopes(gh.Filter(input.FilterDto)).
+		Count(&count).
+		Scopes(gh.Paginate(input, &pagination)).
+		Order("\"CreatedAt\" DESC")
+
+	if err := tx.Find(&data).Error; err != nil {
+		if errors.Is(err, gorm.ErrRecordNotFound) {
+			return nil, &meta, nil
+		}
+		return nil, nil, plh.HandleListError(input, event, err)
+	}
+
+	meta.Count = int(count)
+	meta.PageNumber = pagination.PageNumber
+	meta.PageSize = pagination.PageSize
+
+	pl.SetLogInfo(event, nil, "complete")
+	return data, &meta, nil
+}
+
+func ReadDetailData(input e.ReadDetailDto, event *pl.Event, dbx ...*gorm.DB) (*e.KFR, error) {
+	pl.SetLogInfo(event, input, "started", "DBReadDetail")
+	data := e.KFR{}
+
+	var tx *gorm.DB
+	if len(dbx) > 0 {
+		tx = dbx[0]
+	} else {
+		tx = dg.I
+	}
+
+	if err := tx.Scopes(gh.Preload(input.Includes)).First(&data, input.Id).Error; err != nil {
+		if processedErr := pu.HandleReadError(err, event, source, input.Id, data); processedErr != nil {
+			return nil, processedErr
+		}
+	}
+
+	pl.SetLogInfo(event, nil, "complete")
+	return &data, nil
+}
+
+func UpdateData(input e.UpdateDto, data *e.KFR, event *pl.Event, dbx ...*gorm.DB) error {
+	pl.SetLogInfo(event, data, "started", "DBUpdate")
+	setData(&input, data)
+
+	var tx *gorm.DB
+	if len(dbx) > 0 {
+		tx = dbx[0]
+	} else {
+		tx = dg.I
+	}
+
+	if err := tx.Save(&data).Error; err != nil {
+		event.Status = "failed"
+		event.ErrInfo = pl.ErrorInfo{
+			Code:   "data-update-fail",
+			Detail: "Database update failed",
+			Raw:    err,
+		}
+		return pl.SetLogError(event, input)
+	}
+
+	pl.SetLogInfo(event, nil, "complete")
+	return nil
+}
+
+func DeleteData(data *e.KFR, event *pl.Event, dbx ...*gorm.DB) error {
+	pl.SetLogInfo(event, data, "started", "DBDelete")
+	var tx *gorm.DB
+	if len(dbx) > 0 {
+		tx = dbx[0]
+	} else {
+		tx = dg.I
+	}
+
+	if err := tx.Delete(&data).Error; err != nil {
+		event.Status = "failed"
+		event.ErrInfo = pl.ErrorInfo{
+			Code:   "data-delete-fail",
+			Detail: "Database delete failed",
+			Raw:    err,
+		}
+		return pl.SetLogError(event, data)
+	}
+
+	pl.SetLogInfo(event, nil, "complete")
+	return nil
+}

internal/use-case/main-use-case/kfr/middleware-runner.go

@@ -0,0 +1,103 @@
+package kfr
+
+import (
+	e "simrs-vx/internal/domain/main-entities/kfr"
+	pl "simrs-vx/pkg/logger"
+	pu "simrs-vx/pkg/use-case-helper"
+
+	"gorm.io/gorm"
+)
+
+type middlewareRunner struct {
+	Event  *pl.Event
+	Tx     *gorm.DB
+	MwType pu.MWType
+}
+
+// NewMiddlewareExecutor creates a new middleware executor
+func newMiddlewareRunner(event *pl.Event, tx *gorm.DB) *middlewareRunner {
+	return &middlewareRunner{
+		Event: event,
+		Tx:    tx,
+	}
+}
+
+// ExecuteCreateMiddleware executes create middleware
+func (me *middlewareRunner) RunCreateMiddleware(middlewares []createMw, input *e.CreateDto, data *e.KFR) error {
+	for _, middleware := range middlewares {
+		logData := pu.GetLogData(input, data)
+
+		pl.SetLogInfo(me.Event, logData, "started", middleware.Name)
+
+		if err := middleware.Func(input, data, me.Tx); err != nil {
+			return pu.HandleMiddlewareError(me.Event, string(me.MwType), middleware.Name, logData, err)
+		}
+
+		pl.SetLogInfo(me.Event, nil, "complete")
+	}
+	return nil
+}
+
+func (me *middlewareRunner) RunReadListMiddleware(middlewares []readListMw, input *e.ReadListDto, data *e.KFR) error {
+	for _, middleware := range middlewares {
+		logData := pu.GetLogData(input, data)
+
+		pl.SetLogInfo(me.Event, logData, "started", middleware.Name)
+
+		if err := middleware.Func(input, data, me.Tx); err != nil {
+			return pu.HandleMiddlewareError(me.Event, string(me.MwType), middleware.Name, logData, err)
+		}
+
+		pl.SetLogInfo(me.Event, nil, "complete")
+	}
+	return nil
+}
+
+func (me *middlewareRunner) RunReadDetailMiddleware(middlewares []readDetailMw, input *e.ReadDetailDto, data *e.KFR) error {
+	for _, middleware := range middlewares {
+		logData := pu.GetLogData(input, data)
+
+		pl.SetLogInfo(me.Event, logData, "started", middleware.Name)
+
+		if err := middleware.Func(input, data, me.Tx); err != nil {
+			return pu.HandleMiddlewareError(me.Event, string(me.MwType), middleware.Name, logData, err)
+		}
+
+		pl.SetLogInfo(me.Event, nil, "complete")
+	}
+	return nil
+}
+
+func (me *middlewareRunner) RunUpdateMiddleware(middlewares []readDetailMw, input *e.ReadDetailDto, data *e.KFR) error {
+	for _, middleware := range middlewares {
+		logData := pu.GetLogData(input, data)
+
+		pl.SetLogInfo(me.Event, logData, "started", middleware.Name)
+
+		if err := middleware.Func(input, data, me.Tx); err != nil {
+			return pu.HandleMiddlewareError(me.Event, string(me.MwType), middleware.Name, logData, err)
+		}
+
+		pl.SetLogInfo(me.Event, nil, "complete")
+	}
+	return nil
+}
+
+func (me *middlewareRunner) RunDeleteMiddleware(middlewares []readDetailMw, input *e.ReadDetailDto, data *e.KFR) error {
+	for _, middleware := range middlewares {
+		logData := pu.GetLogData(input, data)
+
+		pl.SetLogInfo(me.Event, logData, "started", middleware.Name)
+
+		if err := middleware.Func(input, data, me.Tx); err != nil {
+			return pu.HandleMiddlewareError(me.Event, string(me.MwType), middleware.Name, logData, err)
+		}
+
+		pl.SetLogInfo(me.Event, nil, "complete")
+	}
+	return nil
+}
+
+func (me *middlewareRunner) setMwType(mwType pu.MWType) {
+	me.MwType = mwType
+}

internal/use-case/main-use-case/kfr/middleware.go

@@ -0,0 +1,9 @@
+package kfr
+
+// example of middleware
+// func init() {
+// 	createPreMw = append(createPreMw,
+// 		CreateMw{Name: "modif-input", Func: pm.ModifInput},
+// 		CreateMw{Name: "check-data", Func: pm.CheckData},
+// 	)
+// }

internal/use-case/main-use-case/kfr/tycovar.go

@@ -0,0 +1,44 @@
+/*
+DESCRIPTION:
+A sample, part of the package that contains type, constants, and/or variables.
+
+In this sample it also provides type and variable regarding the needs of the
+middleware to separate from main use-case which has the basic CRUD
+functionality. The purpose of this is to make the code more maintainable.
+*/
+package kfr
+
+import (
+	"gorm.io/gorm"
+
+	e "simrs-vx/internal/domain/main-entities/kfr"
+)
+
+type createMw struct {
+	Name string
+	Func func(input *e.CreateDto, data *e.KFR, tx *gorm.DB) error
+}
+
+type readListMw struct {
+	Name string
+	Func func(input *e.ReadListDto, data *e.KFR, tx *gorm.DB) error
+}
+
+type readDetailMw struct {
+	Name string
+	Func func(input *e.ReadDetailDto, data *e.KFR, tx *gorm.DB) error
+}
+
+type UpdateMw = readDetailMw
+type DeleteMw = readDetailMw
+
+var createPreMw []createMw      // preprocess middleware
+var createPostMw []createMw     // postprocess middleware
+var readListPreMw []readListMw  // ..
+var readListPostMw []readListMw // ..
+var readDetailPreMw []readDetailMw
+var readDetailPostMw []readDetailMw
+var updatePreMw []readDetailMw
+var updatePostMw []readDetailMw
+var deletePreMw []readDetailMw
+var deletePostMw []readDetailMw