core

core · 业务核心库

PigeonBox 业务核心库:17 个域服务(含 config 系统配置中心) + 数据访问 + 存储抽象 + HTTP 装配(bootstrap)。不含 main、不含静态资源、不含配置文件——本模块定位是被复用的库,消费方:

• pigeonbox/server —— 标准独立部署(自托管)
• pigeonbox/fnos —— 飞牛 fnOS 应用(单容器库式调用)
• pigeonbox/openwrt —— OpenWrt/iStoreOS 原生包(库式调用)
• pigeonbox/qnap —— 威联通 QTS 原生 QPKG(库式调用)

🗂️ PigeonBox 生态成员仓 · 总览见 装配仓 pigeonbox · 架构图集

结构

分层职责(继承自原仓库 internal 设计)

1. app/ —— 业务逻辑层,不依赖具体传输协议,不直接操作数据库(经 repo 层)
2. transport/ + gen/ —— 传输层,协议适配,调用 app 层服务
3. repo/ —— 数据访问层,封装 DB/Redis/外部服务
4. pkg/ —— 项目内横切工具(不含对外通用库)

库用法

import "github.com/pigeonbox/core/bootstrap"

h, err := bootstrap.Bootstrap("/path/to/config.yaml")
if err != nil { log.Fatal(err) }
defer bootstrap.Cleanup()
go h.Spin()

依赖规则(强制)

core ──► contracts ──► (thrift runtime)
  └─ 不允许 import server / frontend;不引入任何 UI 与部署物

• thrift 版本约束由 contracts 以 require 传递,下游无需任何 replace(这是从原仓库拆出的重要修复:原仓库靠 replace thrift => v0.13.0 钉版本,库使用者被迫复述该约束)。
• 显式钉 bytedance/sonic v1.15.0:hertz 声明的 v1.12.7 在 go1.27/arm64 有 linkname 链接错误。

来源

拆分自 zy84338719/fileCodeBox 的 backend/api、backend/gen/http/{handler,router}、backend/cmd/server/bootstrap,import 路径机械替换,业务逻辑零变更。

License

Apache-2.0