Reorganize repo: backend/, deploy/, docs/ layout + AGENTS.md

Restructure the monorepo into clear top-level directories: - backend/: Go module root (cmd, internal, pkg, configs, migrations, docs/swagger, scripts, tests, go.mod, Makefile, .air.toml) - deploy/: Docker (Dockerfile, docker-compose*), quickstart, fluentd - docs/: project documentation + reports/ (moved from repo root) - AGENTS.md: new AI coding-agent guide at repo root Update all references to the new layout: - Dockerfile: COPY backend/go.mod, COPY backend/ (context = repo root) - docker-compose files: context ../.., dockerfile deploy/docker/Dockerfile, env_file ../../.env, volume mounts ../../backend:/app - deploy/quickstart/compose.yaml: dockerfile deploy/docker/Dockerfile - CI: working-directory: backend for go commands, file deploy/docker/Dockerfile, coverage path backend/coverage.out, health_check backend/scripts/ - backend/Makefile: docker target uses -f ../deploy/docker/Dockerfile ../ - README: architecture tree, quickstart, config paths updated Move root stray scripts (rename_models.*, run_m11_tests.sh, verify_build.sh, gorm_bool_main.go) to backend/scripts/legacy/. All moves via git mv to preserve history. Build, vet, SQLite tests, and docker compose config verified.
2026-07-07 14:44:12 +08:00
parent d4ef996f49
commit aeddedf2a3
1348 changed files with 176 additions and 57 deletions
@@ -0,0 +1,143 @@
+package v1
+
+import (
+	"errors"
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+
+	"github.com/gochat/gochat/internal/service"
+	"github.com/gochat/gochat/pkg/response"
+)
+
+// InboxCsatTemplateHandler handles CSAT template endpoints for inboxes.
+// Reference: Chatwoot app/controllers/api/v1/accounts/inboxes/inbox_csat_templates_controller.rb
+// CSAT template is a singular resource per inbox: show, create, and analyze actions.
+type InboxCsatTemplateHandler struct {
+	svc *service.CsatTemplateService
+}
+
+// NewInboxCsatTemplateHandler creates a new InboxCsatTemplateHandler.
+func NewInboxCsatTemplateHandler(svc *service.CsatTemplateService) *InboxCsatTemplateHandler {
+	return &InboxCsatTemplateHandler{svc: svc}
+}
+
+// Show retrieves the CSAT template status for an inbox.
+// GET /api/v1/accounts/:account_id/inboxes/:inbox_id/csat_template
+// If no template exists, returns an empty object (Chatwoot returns nil in this case).
+func (h *InboxCsatTemplateHandler) Show(c *gin.Context) {
+	inboxID, err := parseUintParam(c, "inbox_id")
+	if err != nil {
+		response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid inbox_id")
+		return
+	}
+
+	status, svcErr := h.svc.ShowTemplateStatusResult(c.Request.Context(), inboxID)
+	if svcErr != nil {
+		handleServiceError(c, svcErr)
+		return
+	}
+	response.OK(c, status)
+}
+
+// Create creates or updates a CSAT template for an inbox.
+// POST /api/v1/accounts/:account_id/inboxes/:inbox_id/csat_template
+// Body: { "message": "..." }
+func (h *InboxCsatTemplateHandler) Create(c *gin.Context) {
+	inboxID, err := parseUintParam(c, "inbox_id")
+	if err != nil {
+		response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid inbox_id")
+		return
+	}
+
+	req, err := bindCreateCsatTemplateRequest(c)
+	if err != nil {
+		response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid request body")
+		return
+	}
+
+	template, svcErr := h.svc.CreateTemplate(c.Request.Context(), inboxID, req)
+	if svcErr != nil {
+		handleServiceError(c, svcErr)
+		return
+	}
+
+	c.JSON(http.StatusCreated, template)
+}
+
+// Analyze analyzes a CSAT template message for quality.
+// POST /api/v1/accounts/:account_id/inboxes/:inbox_id/csat_template/analyze
+// Body: { "message": "..." }
+func (h *InboxCsatTemplateHandler) Analyze(c *gin.Context) {
+	inboxID, err := parseUintParam(c, "inbox_id")
+	if err != nil {
+		response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid inbox_id")
+		return
+	}
+
+	req, err := bindAnalyzeCsatTemplateRequest(c)
+	if err != nil {
+		response.AbortWithStatusError(c, http.StatusBadRequest, response.ErrBadRequest, "invalid request body")
+		return
+	}
+
+	result, svcErr := h.svc.AnalyzeTemplate(c.Request.Context(), inboxID, req)
+	if svcErr != nil {
+		handleServiceError(c, svcErr)
+		return
+	}
+
+	response.OK(c, result)
+}
+
+func bindCreateCsatTemplateRequest(c *gin.Context) (service.CreateCsatTemplateRequest, error) {
+	var body struct {
+		Message    string                            `json:"message"`
+		ButtonText string                            `json:"button_text"`
+		Language   string                            `json:"language"`
+		Template   service.CreateCsatTemplateRequest `json:"template"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil {
+		return service.CreateCsatTemplateRequest{}, err
+	}
+	req := body.Template
+	if req.Message == "" {
+		req.Message = body.Message
+	}
+	if req.ButtonText == "" {
+		req.ButtonText = body.ButtonText
+	}
+	if req.Language == "" {
+		req.Language = body.Language
+	}
+	if req.Message == "" {
+		return req, errors.New("message is required")
+	}
+	return req, nil
+}
+
+func bindAnalyzeCsatTemplateRequest(c *gin.Context) (service.AnalyzeCsatTemplateRequest, error) {
+	var body struct {
+		Message    string                             `json:"message"`
+		ButtonText string                             `json:"button_text"`
+		Language   string                             `json:"language"`
+		Template   service.AnalyzeCsatTemplateRequest `json:"template"`
+	}
+	if err := c.ShouldBindJSON(&body); err != nil {
+		return service.AnalyzeCsatTemplateRequest{}, err
+	}
+	req := body.Template
+	if req.Message == "" {
+		req.Message = body.Message
+	}
+	if req.ButtonText == "" {
+		req.ButtonText = body.ButtonText
+	}
+	if req.Language == "" {
+		req.Language = body.Language
+	}
+	if req.Message == "" {
+		return req, errors.New("message is required")
+	}
+	return req, nil
+}