架构与运维
系统由哪些进程组成、请求从哪条路进入、静态文档站怎么部署。
三个进程
系统按职责拆成三个独立进程,各司其职:
| 进程 | 入口 | 作用 |
|---|---|---|
api | cmd/api | HTTP 服务,健康检查与对外接口 |
worker | cmd/worker | 队列消费者,简历流水线全在这里 |
migrate | cmd/migrate | 建表与迁移,启动 worker 前必须先跑 |
依赖组件
| 组件 | 用途 |
|---|---|
| PostgreSQL | 主库;River 队列也跑在 PG 里,不需要额外消息队列 |
| Redis | 缓存 |
| 对象存储 + 数据万象 | 原件存储与 PDF 转图 |
| 视觉 / 语言模型 | 图转文本、字段抽取 |
/api 与 /open/v1
站内与对外走两条不同的入口,共用同一个 HTTP 服务(127.0.0.1:8080),由 nginx 反向代理,不重写路径前缀:
| 前缀 | 面向 | 认证方式 | nginx |
|---|---|---|---|
/api | 站内前端 | 浏览器会话 Cookie | location /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-site/目录同步到服务器静态目录/srv/foundu-docs-site。 - nginx 用一个独立 server block 指向该目录,用
try_files回落到index.html。 - 与业务站点(
talent.founduai.com)互不影响,可各自独立发布与回滚。
文档站访问入口
nginx server block 草案、rsync 命令、DNS 记录建议与回滚方式,见仓库内 docs-site/DEPLOY.md。