Files
foundry-core/cmd/foundry/main.go
T

142 lines
6.6 KiB
Go

// Foundry 进程装配入口:HTTP 服务连接认证、平台、研究库和 Codex Unix socket。
package main
import (
"context"
"encoding/json"
"log"
"net"
"net/http"
"net/url"
"os"
"time"
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/auth"
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/codex"
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/platform"
"gitea.entroia.com/Zayden-Jung/foundry-core/internal/research"
"github.com/jackc/pgx/v5"
"github.com/jackc/pgx/v5/stdlib"
)
// env 将空环境变量视为缺省;仅用于允许默认值的配置项。
func env(key, fallback string) string {
if value := os.Getenv(key); value != "" {
return value
}
return fallback
}
// main 支持独立 codex-worker 模式,其余启动方式进入 HTTP API 服务。
func main() {
if len(os.Args) == 2 && os.Args[1] == "codex-worker" {
log.Fatal(codex.ServeWorker("/run/foundry-codex/worker.sock"))
}
// 公共 origin 只允许 HTTPS 根地址,回调路径由程序拼接,避免配置夹带查询或用户信息。
origin, err := url.Parse(os.Getenv("PUBLIC_ORIGIN"))
if err != nil || origin.Scheme != "https" || origin.Hostname() == "" || origin.User != nil ||
(origin.Path != "" && origin.Path != "/") || origin.RawQuery != "" || origin.Fragment != "" {
log.Fatal("PUBLIC_ORIGIN must be an HTTPS origin")
}
var callbacks map[string]string
if err := json.Unmarshal([]byte(os.Getenv("FOUNDRY_PROJECTS")), &callbacks); err != nil || len(callbacks) == 0 {
log.Fatal("FOUNDRY_PROJECTS must configure at least one project")
}
id, secret, dsn := os.Getenv("GOOGLE_CLIENT_ID"), os.Getenv("GOOGLE_CLIENT_SECRET"), os.Getenv("DATABASE_URL")
if id == "" || secret == "" || dsn == "" {
log.Fatal("Google credentials and DATABASE_URL are required")
}
config, err := pgx.ParseConfig(dsn)
if err != nil {
log.Fatal("Invalid DATABASE_URL")
}
// OpenDB 创建连接池,实际连接按需建立;HTTP 就绪检查再验证主库可用性。
db := stdlib.OpenDB(*config)
defer db.Close()
email, err := auth.EmailConfigFromEnv()
if err != nil {
log.Fatal(err)
}
// nil 邮件配置会直接返回;此后台任务使用进程级上下文,没有单独的优雅停机取消。
go email.Run(context.Background(), db)
slack, err := auth.SlackConfigFromEnv(origin.ResolveReference(&url.URL{Path: "/auth/slack/callback"}).String())
if err != nil {
log.Fatal(err)
}
// auth.New 先构造认证子路由器:邮箱/OAuth、会话及 healthz/readyz 都注册在其内部。
// 返回的 handler 尚未接到主路由器;下面通过 mux.Handle("/", handler) 统一挂载。
handler, err := auth.New(db, callbacks, origin.ResolveReference(&url.URL{Path: "/auth/google/callback"}).String(), id, secret, email, slack)
if err != nil {
log.Fatal(err)
}
// 所有对外 HTTP 模块共享这个主路由器;Register 是普通装配函数,不是自动扫描插件。
// ServeMux 按方法和路径的匹配规则选更具体的模式,不以注册先后决定谁优先处理请求。
mux := http.NewServeMux()
// 研究数据使用可选、独立且只读的连接池;配置后必须在五秒启动探测内可访问。
var papers research.Repository
if researchDSN := os.Getenv("FOUNDRY_RESEARCH_DATABASE_URL"); researchDSN != "" {
researchConfig, err := pgx.ParseConfig(researchDSN)
if err != nil {
log.Fatal("Invalid research database configuration")
}
researchConfig.RuntimeParams["default_transaction_read_only"] = "on"
researchConfig.RuntimeParams["application_name"] = "foundry-research"
researchDB := stdlib.OpenDB(*researchConfig)
defer researchDB.Close()
researchDB.SetMaxOpenConns(2)
researchDB.SetMaxIdleConns(2)
researchDB.SetConnMaxIdleTime(5 * time.Minute)
researchDB.SetConnMaxLifetime(30 * time.Minute)
repository, err := research.NewPostgresRepository(researchDB, env("FOUNDRY_RESEARCH_SCHEMA", "research"))
if err != nil {
log.Fatal("Invalid research database configuration")
}
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
err = repository.Check(ctx)
cancel()
if err != nil {
log.Fatal("Research database is unavailable or not published")
}
papers = repository
}
// 研究 API:只挂载 GET /projects/{project}/research/papers 及论文详情路径。
// 未配置研究库时 papers 为 nil,Register 直接返回,不安装这些可选路由。
research.Register(mux, papers, callbacks)
// 独立执行 API:配置完整时挂载 POST /projects/{project}/codex/exec,转发到私有 Unix socket。
// 这里使用专用项目授权令牌;不是平台业务 API 的普通用户会话认证。
// socket/grants 全缺省时不安装路由,只配置其中一项则启动失败,避免半配置服务。
if err := codex.Register(mux, callbacks, os.Getenv("FOUNDRY_CODEX_SOCKET"), os.Getenv("FOUNDRY_CODEX_GRANTS")); err != nil {
log.Fatal(err)
}
// 解析各项目的首次使用引导配置;这里只准备配置,具体路由由 platform.Register 安装。
onboarding, err := platform.ParseOnboarding(os.Getenv("FOUNDRY_ONBOARDING"), callbacks)
if err != nil {
log.Fatal(err)
}
// 平台 API:共享主数据库和项目配置,注册工作区、素材、画布、附件、分享及 AI 等业务路径。
// 各业务 handler 通常经 platform.protected 做会话/身份检查,领域层再检查资源权限和事务条件;
// 它们不是先经过上面的 auth handler 再进入平台。公开短链接等路径有各自处理方式。
// CanvasClient 与独立 exec API 共用 worker socket,但由平台组织画布任务;无 socket 时为 nil,
// 有客户端时 Register 还会启动画布 AI 后台队列,不能把它理解为只有路由表登记。
platform.Register(mux, db, callbacks, origin.Scheme+"://"+origin.Host, onboarding, codex.NewCanvasClient(os.Getenv("FOUNDRY_CODEX_SOCKET")))
// 将认证子路由器挂在主路由器的根路径:认证/健康检查由它继续分派,未知路径也交其处理。
// "/" 是兜底匹配;具体平台/研究/exec 路由优先,不因它在最后注册而获得特殊中间件语义。
mux.Handle("/", handler)
// HOST 默认只监听回环,容器部署显式覆盖;较长写超时用于耗时业务响应。
server := &http.Server{
Addr: net.JoinHostPort(env("HOST", "127.0.0.1"), env("PORT", "8080")),
Handler: mux, ReadHeaderTimeout: 5 * time.Second, ReadTimeout: 10 * time.Second,
WriteTimeout: 110 * time.Second, IdleTimeout: 60 * time.Second,
}
// 上面的 HTTP 路由装配完成后才开始监听;请求从 server.Handler 进入主 mux,再分派到对应模块。
log.Fatal(server.ListenAndServe())
}