252 lines
13 KiB
Go
252 lines
13 KiB
Go
// Package platform 提供项目隔离的工作区、素材、画布和协作 API;HTTP 认证与业务事务分层处理。
|
||
package platform
|
||
|
||
import (
|
||
"context"
|
||
"database/sql"
|
||
"encoding/json"
|
||
"errors"
|
||
"io"
|
||
"log"
|
||
"net/http"
|
||
"net/url"
|
||
"regexp"
|
||
"strings"
|
||
|
||
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/auth"
|
||
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/codex"
|
||
"github.com/jackc/pgx/v5/pgconn"
|
||
)
|
||
|
||
// service 共享连接池与启动配置;canvasAI 可缺省,队列仅在配置了客户端时启动。
|
||
type service struct {
|
||
canvasAI *codex.CanvasClient
|
||
db *sql.DB
|
||
origin string
|
||
callbacks map[string]string
|
||
onboardingConfigs map[string]OnboardingConfig
|
||
}
|
||
|
||
// response 用于小型 JSON 对象;大型画布文档通常保留 RawMessage 避免重编码字段。
|
||
type response map[string]any
|
||
|
||
// reply 写出 JSON 与 no-store;value 为 nil 时只写状态,供 204 响应使用。
|
||
func reply(w http.ResponseWriter, status int, value any) {
|
||
w.Header().Set("Content-Type", "application/json")
|
||
w.Header().Set("Cache-Control", "no-store")
|
||
w.WriteHeader(status)
|
||
if value != nil {
|
||
_ = json.NewEncoder(w).Encode(value)
|
||
}
|
||
}
|
||
|
||
// reject 用稳定错误码表示可预期业务拒绝;调用者随后返回 nil,避免 protected 重复响应。
|
||
func reject(w http.ResponseWriter, status int, code string) {
|
||
reply(w, status, response{"error": code})
|
||
}
|
||
|
||
// decode 对普通业务 JSON 限制 1 MiB,拒绝未知字段以及第二个 JSON 值;失败已经写出 400。
|
||
func decode(w http.ResponseWriter, r *http.Request, value any) bool {
|
||
decoder := json.NewDecoder(http.MaxBytesReader(w, r.Body, 1<<20))
|
||
decoder.DisallowUnknownFields()
|
||
if err := decoder.Decode(value); err != nil {
|
||
reject(w, 400, "invalid_request")
|
||
return false
|
||
}
|
||
if decoder.Decode(new(any)) != io.EOF {
|
||
reject(w, 400, "invalid_request")
|
||
return false
|
||
}
|
||
return true
|
||
}
|
||
|
||
// endpoint 接收已认证的 project/account;具体资源可见性仍由业务处理器在事务内校验。
|
||
type endpoint func(http.ResponseWriter, *http.Request, string, string) error
|
||
|
||
// protected 是统一路由包装:项目白名单/CORS、会话续期、资源别名解析、canonical 写入守卫和错误映射。
|
||
func (s *service) protected(callbacks map[string]string, handle endpoint) http.HandlerFunc {
|
||
return func(w http.ResponseWriter, r *http.Request) {
|
||
project := r.PathValue("project")
|
||
callback, exists := callbacks[project]
|
||
if !exists {
|
||
reject(w, 404, "not_found")
|
||
return
|
||
}
|
||
frontend, _ := url.Parse(callback)
|
||
w.Header().Set("Vary", "Origin")
|
||
if origin := r.Header.Get("Origin"); origin != "" {
|
||
if origin != frontend.Scheme+"://"+frontend.Host {
|
||
reject(w, 403, "origin_denied")
|
||
return
|
||
}
|
||
w.Header().Set("Access-Control-Allow-Origin", origin)
|
||
w.Header().Set("Access-Control-Expose-Headers", "ETag, X-Canvas-Schema-Version, "+auth.SessionExpiryHeader)
|
||
}
|
||
// 预检只验证项目和 Origin,不要求 bearer;真正业务请求仍必须通过会话认证。
|
||
if r.Method == http.MethodOptions {
|
||
w.Header().Set("Access-Control-Allow-Methods", "GET, POST, PATCH, DELETE, OPTIONS")
|
||
w.Header().Set("Access-Control-Allow-Headers", "Authorization, Content-Type, If-Match, Idempotency-Key, X-Expected-Account, X-Resource-Id")
|
||
reply(w, 204, nil)
|
||
return
|
||
}
|
||
session, err := auth.AuthenticateSession(r.Context(), s.db, project, r.Header.Get("Authorization"))
|
||
if errors.Is(err, auth.ErrInvalidSession) {
|
||
reject(w, 401, "invalid_session")
|
||
return
|
||
}
|
||
account := session.AccountID
|
||
if err == nil {
|
||
auth.WriteSessionHeaders(w, session)
|
||
// 客户端可携带预期账户,阻止浏览器切换身份后把旧页面的写入落到新账户。
|
||
if expected := r.Header.Get("X-Expected-Account"); expected != "" && expected != account {
|
||
reject(w, 409, "identity_changed")
|
||
return
|
||
}
|
||
}
|
||
// 将 slug 或 UUID 统一为 UUID 后再分派,后续 SQL 无需兼容两种引用;这一步不替代资源授权。
|
||
if err == nil && r.PathValue("workspace") != "" {
|
||
var id string
|
||
err = s.db.QueryRowContext(r.Context(), "SELECT id::text FROM workspaces WHERE project=$1 AND (id::text=$2 OR slug=$2)", project, r.PathValue("workspace")).Scan(&id)
|
||
if err == nil {
|
||
r.SetPathValue("workspace", id)
|
||
}
|
||
}
|
||
if err == nil && r.PathValue("material") != "" {
|
||
var id string
|
||
err = s.db.QueryRowContext(r.Context(), "SELECT id::text FROM materials WHERE project=$1 AND workspace_id=$2 AND (id::text=$3 OR slug=$3)", project, r.PathValue("workspace"), r.PathValue("material")).Scan(&id)
|
||
if err == nil {
|
||
r.SetPathValue("material", id)
|
||
}
|
||
}
|
||
if err == nil {
|
||
var stopped bool
|
||
stopped, err = s.guardLegacyCanonicalRequest(w, r, project, account)
|
||
if stopped {
|
||
return
|
||
}
|
||
}
|
||
if err == nil {
|
||
err = handle(w, r, project, account)
|
||
}
|
||
// 只公开可识别的约束/领域错误;其余依赖错误记录类型并统一返回 503。
|
||
if err != nil {
|
||
var pg *pgconn.PgError
|
||
switch {
|
||
case errors.As(err, &pg) && pg.Code == "55000" && pg.Message == "canonical_write_required":
|
||
reject(w, 409, "canonical_write_required")
|
||
case errors.Is(err, errSubgraphCycle):
|
||
reject(w, 409, "subgraph_cycle")
|
||
case errors.Is(err, errSubgraphDepth):
|
||
reject(w, 413, "graph_limit_exceeded")
|
||
case errors.Is(err, sql.ErrNoRows):
|
||
reject(w, 404, "not_found")
|
||
case errors.As(err, &pg) && (pg.Code == "22P02" || pg.Code == "23503" || pg.Code == "23514"):
|
||
reject(w, 400, "invalid_reference")
|
||
case errors.As(err, &pg) && pg.Code == "23505":
|
||
reject(w, 409, "already_exists")
|
||
default:
|
||
log.Printf("platform request failed (%T)", err)
|
||
reject(w, 503, "service_unavailable")
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// Register 由 main 装配平台路径;私有 AI 客户端存在时启动进程级队列,公开短链接单独处理。
|
||
func Register(mux *http.ServeMux, db *sql.DB, callbacks map[string]string, origin string, configs map[string]OnboardingConfig, clients ...*codex.CanvasClient) {
|
||
s := &service{db: db, origin: origin, callbacks: callbacks, onboardingConfigs: configs}
|
||
if len(clients) > 0 {
|
||
s.canvasAI = clients[0]
|
||
if s.canvasAI != nil {
|
||
go s.runCanvasQueue(context.Background())
|
||
}
|
||
}
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials", s.protected(callbacks, s.materials))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/assets", s.protected(callbacks, s.uploadAsset))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/assets/operations/{request}", s.protected(callbacks, s.assetOperation))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/assets/metadata/{asset}", s.protected(callbacks, s.getAssetMetadata))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/assets/{asset}", s.protected(callbacks, s.getAsset))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}", s.protected(callbacks, s.material))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas", s.protected(callbacks, s.canvas))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/models", s.protected(callbacks, s.canvasAIModels))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/operations/{request}", s.protected(callbacks, s.getCanvasAIAdmission))
|
||
mux.HandleFunc("POST /projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/runs", s.protected(callbacks, s.createCanvasAIRun))
|
||
mux.HandleFunc("GET /projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/runs", s.protected(callbacks, s.listCanvasAIRuns))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/runs/{run}", s.protected(callbacks, s.getCanvasAIRun))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/runs/{run}/cancel", s.protected(callbacks, s.cancelCanvasAIRun))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/ai/runs/{run}/apply", s.protected(callbacks, s.applyCanvasAIOutput))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/capabilities", s.protected(callbacks, s.canvasCapabilities))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/operations", s.protected(callbacks, s.submitCanvasOperations))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/operations/{request}", s.protected(callbacks, s.getCanvasOperation))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/model", s.protected(callbacks, s.getCanvasModel))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/model/migrate", s.protected(callbacks, s.migrateCanonicalCanvas))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/model/operations", s.protected(callbacks, s.submitCanvasModelOperations))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/model/operations/{request}", s.protected(callbacks, s.getCanvasModelOperation))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/connections", s.protected(callbacks, s.createCanvasConnection))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/subgraphs", s.protected(callbacks, s.createSubgraph))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/subgraphs/migrate", s.protected(callbacks, s.migrateSubgraphs))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/subgraphs/{frame}/dissolve", s.protected(callbacks, s.dissolveSubgraph))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/subgraphs/{frame}/members", s.protected(callbacks, s.moveSubgraphMembers))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/canvas/transactions/{transaction}/undo", s.protected(callbacks, s.undoCanvasTransaction))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/open", s.protected(callbacks, s.openMaterial))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/tags", s.protected(callbacks, s.tags))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/tags/{tag}", s.protected(callbacks, s.deleteTag))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/tags", s.protected(callbacks, s.materialTags))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/grants", s.protected(callbacks, s.materialGrants))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/grants/{account}", s.protected(callbacks, s.deleteMaterialGrant))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/layouts", s.protected(callbacks, s.layouts))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/materials/{material}/layouts/{layout}", s.protected(callbacks, s.layouts))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/shares/{link}/clicks", s.protected(callbacks, s.shareClicks))
|
||
mux.HandleFunc("/projects/{project}/onboarding", s.protected(callbacks, s.onboarding))
|
||
mux.HandleFunc("/s/{token}", s.shortLink)
|
||
mux.HandleFunc("/projects/{project}/shares/redeem", s.protected(callbacks, s.redeemShare))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/shares", s.protected(callbacks, s.shares))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/shares/{link}", s.protected(callbacks, s.revokeShare))
|
||
mux.HandleFunc("/projects/{project}/workspaces", s.protected(callbacks, s.workspaces))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}", s.protected(callbacks, s.workspace))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/members", s.protected(callbacks, s.members))
|
||
mux.HandleFunc("/projects/{project}/workspaces/{workspace}/members/{account}", s.protected(callbacks, s.member))
|
||
mux.HandleFunc("/projects/{project}/profile", s.protected(callbacks, s.profile))
|
||
}
|
||
|
||
var usernamePattern = regexp.MustCompile(`^[a-z0-9][a-z0-9_-]{2,39}$`)
|
||
|
||
// profile 只操作当前项目的本人账户;PATCH 规范化用户名后与 GET 共用完整资料响应。
|
||
func (s *service) profile(w http.ResponseWriter, r *http.Request, project, account string) error {
|
||
if r.Method == http.MethodPatch {
|
||
var input struct {
|
||
Username string `json:"username"`
|
||
DisplayName string `json:"display_name"`
|
||
}
|
||
if !decode(w, r, &input) {
|
||
return nil
|
||
}
|
||
input.Username = strings.ToLower(strings.TrimSpace(input.Username))
|
||
input.DisplayName = strings.TrimSpace(input.DisplayName)
|
||
if !usernamePattern.MatchString(input.Username) || len(input.DisplayName) > 160 {
|
||
reject(w, 400, "invalid_profile")
|
||
return nil
|
||
}
|
||
_, err := s.db.ExecContext(r.Context(), `
|
||
UPDATE project_accounts SET username=$3, display_name=$4, updated_at=now()
|
||
WHERE project=$1 AND id=$2
|
||
`, project, account, input.Username, input.DisplayName)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
} else if r.Method != http.MethodGet {
|
||
reject(w, 405, "method_not_allowed")
|
||
return nil
|
||
}
|
||
var username, email, avatar *string
|
||
var name string
|
||
err := s.db.QueryRowContext(r.Context(), `
|
||
SELECT username, display_name, email, avatar_url FROM project_accounts WHERE project=$1 AND id=$2
|
||
`, project, account).Scan(&username, &name, &email, &avatar)
|
||
if err != nil {
|
||
return err
|
||
}
|
||
reply(w, 200, response{"id": account, "project": project, "username": username, "display_name": name, "email": email, "avatar_url": avatar})
|
||
return nil
|
||
}
|