架构与运维

系统由哪些进程组成、请求从哪条路进入、静态文档站怎么部署。

三个进程

系统按职责拆成三个独立进程,各司其职:

进程入口作用
apicmd/apiHTTP 服务,健康检查与对外接口
workercmd/worker队列消费者,简历流水线全在这里
migratecmd/migrate建表与迁移,启动 worker 前必须先跑

依赖组件

组件用途
PostgreSQL主库;River 队列也跑在 PG 里,不需要额外消息队列
Redis缓存
对象存储 + 数据万象原件存储与 PDF 转图
视觉 / 语言模型图转文本、字段抽取

/api 与 /open/v1

站内与对外走两条不同的入口,共用同一个 HTTP 服务(127.0.0.1:8080),由 nginx 反向代理,不重写路径前缀:

前缀面向认证方式nginx
/api站内前端浏览器会话 Cookielocation /api { proxy_pass http://127.0.0.1:8080; }
/open/v1小程序 / 外部合作方API Key(Bearer)location /open/ { proxy_pass http://127.0.0.1:8080; }

/open/v1 只开只读能力,接口清单、认证、统一返回信封与错误码见「对外 API」。两套入口的权限点复用同一套判定,范围不同。

文档站部署方式

本站(foundu/docs-site/)是纯静态站点:只有 HTML、CSS 和一个本地 JS,不依赖任何外部 CDN,也不需要后端进程。部署方式:

文档站访问入口

计划域名
docs.founduai.com
站点根目录
/srv/foundu-docs-site
发布方式
rsync + nginx 静态
依赖
无外部 CDN

nginx server block 草案、rsync 命令、DNS 记录建议与回滚方式,见仓库内 docs-site/DEPLOY.md。