#安装与 feature

A3S Boot 使用 Cargo feature 控制协议适配器和技术模块。先使用默认集合启动 HTTP 应用，再只为实际业务边界启用额外能力。

#默认安装

[dependencies]
a3s-boot = "0.2.0"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

默认 feature 是：

tokio 的 runtime feature 由最终应用决定。上面的配置适合带 #[tokio::main] 的多线程服务。

#最小核心

不需要 HTTP 适配器、宏或信号处理时，关闭默认 feature：

[dependencies]
a3s-boot = { version = "0.2.0", default-features = false }

这种组合适合只使用显式 builder、由宿主提供 runtime 的库，或者只想依赖协议中立核心的集成。

#按能力启用

[dependencies]
a3s-boot = {
  version = "0.2.0",
  features = ["auth", "security", "session", "openapi-schemas"]
}
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

#应用与 HTTP

#后台能力

#消息传输

tcp-transport、redis-transport、nats-transport、mqtt-transport、rabbitmq-transport、kafka-transport 与 grpc-transport 分别启用对应网络实现。InProcessTransport 不需要额外 feature。

启用 transport 只会加入客户端与适配器实现，不会创建或管理外部 broker。

#PostgreSQL 队列版本差异

[dependencies]
a3s-boot = { version = "0.2.0", features = ["queue-postgres"] }
serde_json = "1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Boot v0.2.0 的 queue-postgres 使用 A3S ORM 0.3.0。该 ORM 版本提供队列 claim 所需的类型化 UPDATE CTE、UPDATE FROM 与表达式赋值。

不要在应用中手动覆盖 Boot 的可选 A3S ORM 依赖版本。Cargo feature 会在整个依赖图中合并，部署前应检查 cargo tree -e features 的最终结果。

#验证选择

cargo check
cargo tree -e features -p a3s-boot
cargo test

需要评估所有集成能否一起编译时，再运行 cargo check --all-features。网络 transport 和 PostgreSQL 的端到端测试可能需要对应外部服务。

接下来使用快速开始运行第一条路由。