feat: implement browser extension for media publishing and add backend support for media management

server/internal/tenant/transport/media_handler.go

@@ -0,0 +1,139 @@
+package transport
+
+import (
+	"strconv"
+
+	"github.com/gin-gonic/gin"
+
+	"github.com/geo-platform/tenant-api/internal/bootstrap"
+	"github.com/geo-platform/tenant-api/internal/shared/response"
+	"github.com/geo-platform/tenant-api/internal/tenant/app"
+)
+
+type MediaHandler struct {
+	svc *app.MediaService
+}
+
+func NewMediaHandler(a *bootstrap.App) *MediaHandler {
+	return &MediaHandler{svc: app.NewMediaService(a.DB)}
+}
+
+func (h *MediaHandler) ListPlatforms(c *gin.Context) {
+	data, err := h.svc.ListPlatforms(c.Request.Context())
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) ListPlatformAccounts(c *gin.Context) {
+	data, err := h.svc.ListPlatformAccounts(c.Request.Context())
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) DeletePlatformAccount(c *gin.Context) {
+	id, err := strconv.ParseInt(c.Param("id"), 10, 64)
+	if err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_id", "platform account id must be a number"))
+		return
+	}
+	if err := h.svc.DeletePlatformAccount(c.Request.Context(), id); err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, nil)
+}
+
+func (h *MediaHandler) CreatePluginSession(c *gin.Context) {
+	var req app.CreatePluginSessionRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_params", err.Error()))
+		return
+	}
+	data, err := h.svc.CreatePluginSession(c.Request.Context(), req)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) RegisterPluginInstallation(c *gin.Context) {
+	var req app.RegisterPluginInstallationRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_params", err.Error()))
+		return
+	}
+	data, err := h.svc.RegisterPluginInstallation(c.Request.Context(), req)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) CreatePublishBatch(c *gin.Context) {
+	articleID, err := strconv.ParseInt(c.Param("id"), 10, 64)
+	if err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_id", "article id must be a number"))
+		return
+	}
+	var req app.CreatePublishBatchRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_params", err.Error()))
+		return
+	}
+	data, err := h.svc.CreatePublishBatch(c.Request.Context(), articleID, req)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.SuccessWithStatus(c, 201, data)
+}
+
+func (h *MediaHandler) ListPublishRecords(c *gin.Context) {
+	articleID, err := strconv.ParseInt(c.Param("id"), 10, 64)
+	if err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_id", "article id must be a number"))
+		return
+	}
+	data, err := h.svc.ListArticlePublishRecords(c.Request.Context(), articleID)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) PluginBindCallback(c *gin.Context) {
+	var req app.PluginBindCallbackRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_params", err.Error()))
+		return
+	}
+	data, err := h.svc.HandleBindCallback(c.Request.Context(), req)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}
+
+func (h *MediaHandler) PluginPublishCallback(c *gin.Context) {
+	var req app.PluginPublishCallbackRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.Error(c, response.ErrBadRequest(40001, "invalid_params", err.Error()))
+		return
+	}
+	data, err := h.svc.HandlePublishCallback(c.Request.Context(), req)
+	if err != nil {
+		response.Error(c, err)
+		return
+	}
+	response.Success(c, data)
+}

server/internal/tenant/transport/router.go

@@ -12,6 +12,11 @@ func RegisterRoutes(app *bootstrap.App) {
 	authAPI.POST("/login", authHandler.Login)
 	authAPI.POST("/refresh", authHandler.Refresh)
 
+	pluginHandler := NewMediaHandler(app)
+	callbacks := app.Engine.Group("/api/callback/plugin")
+	callbacks.POST("/bind", pluginHandler.PluginBindCallback)
+	callbacks.POST("/publish", pluginHandler.PluginPublishCallback)
+
 	protected := app.Engine.Group("/api")
 	protected.Use(auth.Middleware(app.JWT, app.Sessions))
 	protected.Use(middleware.TenantScope())
@@ -47,8 +52,17 @@ func RegisterRoutes(app *bootstrap.App) {
 	articles.PUT("/:id", artHandler.Update)
 	articles.GET("/:id/stream", artHandler.Stream)
 	articles.GET("/:id/versions", artHandler.Versions)
+	articles.GET("/:id/publish-records", pluginHandler.ListPublishRecords)
+	articles.POST("/:id/publish-batches", pluginHandler.CreatePublishBatch)
 	articles.DELETE("/:id", artHandler.Delete)
 
+	media := protected.Group("/tenant/media")
+	media.GET("/platforms", pluginHandler.ListPlatforms)
+	media.GET("/platform-accounts", pluginHandler.ListPlatformAccounts)
+	media.POST("/plugin-installations/register", pluginHandler.RegisterPluginInstallation)
+	media.POST("/plugin-sessions", pluginHandler.CreatePluginSession)
+	media.DELETE("/platform-accounts/:id", pluginHandler.DeletePlatformAccount)
+
 	brands := protected.Group("/tenant/brands")
 	brandHandler := NewBrandHandler(app)
 	brands.GET("", brandHandler.List)