pub mod crawl;
pub mod management;
pub mod map;
pub mod scrape;
pub mod search;
pub mod task;
use axum::Router;
pub fn build_forge_router() -> Router {
sdforge::http::build()
}
pub(crate) fn route_metadata(
name: &str,
version: &str,
description: &str,
) -> sdforge::prelude::ApiMetadata {
sdforge::prelude::ApiMetadata::new(
name.to_string(),
version.to_string(),
description.to_string(),
None,
false,
)
}
#[cfg(test)]
mod tests {
use super::build_forge_router;
use axum::http::{Request, StatusCode};
use tower::ServiceExt;
const EXPECTED_FORGE_PATHS: &[(&str, &str)] = &[
("POST", "/v1/scrape"),
("GET", "/v1/scrape/{id}"),
("POST", "/v1/crawl"),
("GET", "/v1/crawl/{id}"),
("GET", "/v1/crawl/{id}/results"),
("POST", "/v1/search"),
("GET", "/v1/map"),
("POST", "/v1/extract"),
("GET", "/v1/teams/me"),
("GET", "/v1/teams/me/usage"),
("PUT", "/v1/teams/geo-restrictions"),
("POST", "/v1/webhooks"),
("GET", "/v1/webhooks"),
("POST", "/v1/tasks/_cancel"),
("POST", "/v1/tasks/_query"),
("GET", "/v1/audit/logs"),
("GET", "/v1/audit/denied"),
("POST", "/v1/admin/api-keys"),
];
const PRODUCTION_PATHS: &[&str] = &[
"/v1/scrape",
"/v1/scrape/{id}",
"/v1/scrape/{id}/_cancel",
"/v1/crawl",
"/v1/crawl/{id}",
"/v1/crawl/{id}/_cancel",
"/v1/crawl/{id}/results",
"/v1/search",
"/v1/map",
"/v1/extract",
"/v1/teams/me",
"/v1/teams/me/usage",
"/v1/teams/geo-restrictions",
"/v1/webhooks",
"/v1/tasks/_cancel",
"/v1/tasks/_query",
"/v1/audit/logs",
"/v1/audit/denied",
"/v1/admin/api-keys",
];
#[tokio::test]
async fn forge_inventory_routes_stay_aligned_with_production() {
let router = build_forge_router();
for (method, path) in EXPECTED_FORGE_PATHS {
let response = router
.clone()
.oneshot(
Request::builder()
.method(*method)
.uri(*path)
.body(axum::body::Body::empty())
.unwrap(),
)
.await
.unwrap();
assert_ne!(
response.status(),
StatusCode::NOT_FOUND,
"forge inventory 声明了 {method} {path} 但 build_forge_router 探活 404——条目失效或方法/路径漂移"
);
}
}
#[test]
fn forge_paths_are_subset_of_production_paths() {
for (method, path) in EXPECTED_FORGE_PATHS {
assert!(
PRODUCTION_PATHS.contains(path),
"forge inventory 声明的 {method} {path} 不在生产装配路径集合中——注册面漂移"
);
}
}
#[test]
fn known_migration_gaps_are_pinned() {
for path in [
"/health",
"/metrics",
"/v1/version",
"/v1/scrape/{id}/_cancel",
"/v1/crawl/{id}/_cancel",
] {
assert!(
!EXPECTED_FORGE_PATHS
.iter()
.any(|(_, p)| *p == path),
"{path} 已迁入 forge——请把它从 known_migration_gaps 移入 EXPECTED_FORGE_PATHS 并更新迁移状态"
);
}
}
}