专注你的业务，
其余交给 Aynur.

开发时可使用本地 path 依赖；部署时，将全部核心 crate 和官方模块固定到同一个 Git tag。

# 放入项目的 [dependencies]
aynur_core_module_api = { git = "https://gitee.com/aynurcn/aynur_core.git", tag = "v0.4.0" }
aynur_core_sdk = { git = "https://gitee.com/aynurcn/aynur_core.git", tag = "v0.4.0" }
aynur_core_gateway = { git = "https://gitee.com/aynurcn/aynur_core.git", tag = "v0.4.0" }

完整的运行入口、构建依赖与数据库 feature 接线，以 consumer 示例为准。生成到 Cargo OUT_DIR 的代码无需提交。

1. 依赖 aynur_core_module_api 和 aynur_core_sdk，声明模块的 ModuleDescriptor。
2. 通过 inventory 注册一份 ModuleRegistration 和一份对应的 ModuleIntegration，连接模型、HTTP 路由与生命周期。
3. 在项目 modules.toml 中填写模块 ID、crate 和 GraphQL 根类型，在 Profile 中启用模块。
4. 在 build.rs 中生成 Schema 和模块链接代码，由网关装配入口引入。

依赖使用点分模块 ID，例如 aynur.core_auth。跨模块读取通过强类型端口连接，GraphQL resolver 仅提取请求数据，校验与业务逻辑放在服务层。

生成代码公开 schema_builder、finish_schema 和 build_schema。需要注入项目专用的强类型数据时，使用 builder 扩展点。

#[derive(Clone)]
struct ProjectSchemaData;

fn build_project_schema(
    context: &aynur_core_sdk::AppContext,
) -> anyhow::Result<ActiveSchema> {
    Ok(finish_schema(
        schema_builder(context).data(ProjectSchemaData),
    ))
}

该片段放在已引入生成代码的装配入口中，再传入 GatewayBootstrap::new。生成的 Schema 内嵌构建期 Profile 名称；运行时 Profile 名称不一致会拒绝启动，需要重新构建。

默认使用 SQLite。切换到 PostgreSQL，需要同时启用编译特性和设置 PostgreSQL 连接 URL。仓库的 PostgreSQL 编译检查：

cargo check --workspace \
  --no-default-features --features postgresql

仅修改 DATABASE_URL 不会启用数据库驱动。部署环境使用 aynur_core_migrator 与经过审查的迁移，不开启网关自动建表。

网关和迁移器均以 project_root 为基准，加载其中的 .env，并解析相对 Profile 路径和 SQLite 数据库路径。

APP_PROFILE

必填，当前运行的 Profile 文件路径。

DATABASE_URL

SQLite 或 PostgreSQL 连接 URL，须匹配编译特性。

JWT_SECRET

JWT 与登录风控指纹使用的密钥。

TRUSTED_PROXY_IPS

允许提供转发头的确切代理 IP，逗号分隔，默认空。

GRAPHQL_MAX_DEPTH

查询深度限制，默认 16。

GRAPHQL_MAX_COMPLEXITY

查询复杂度限制，默认 500。