Skip to main content
The China logistics control towers are transparent source compositions over reviewed geographic corridors. They report evidence availability and freshness by family. They do not generate an opaque logistics-risk score, forecast disruption, or infer activity from source presence alone.

​
Reviewed corridors

Each corridor has a reviewed polygon, node registry, node owner, and source selector. A source record contributes only when its selector or reviewed geography maps it to that corridor. National inputs are clearly marked as national and can apply to all four corridors.

​
Six signal families

IMF PortWatch and AviationStack are node-scoped. Hazard observations are regional. WorldMonitor energy spine, UN Comtrade, and Shanghai Shipping Exchange inputs are national. The output keeps those scopes visible rather than presenting national evidence as a measured node value.

​
Availability composition

Every source signal carries:
  • publisher identity and class;
  • source URL when applicable;
  • node, regional, or national scope;
  • observation, release, and retrieval time with precision;
  • revision metadata when available;
  • transport and content freshness;
  • an inspectable summary and source metrics.
Each family condition is available, partial, stale, or unavailable. A corridor is:
  • available only when all six conditions are available;
  • stale when every condition is available or stale and at least one is stale;
  • unavailable when all six are unavailable; or
  • partial for every mixed or provenance-invalid state.
An absent configured port or airport becomes an explicit unavailable signal. A healthy feed with zero hazards can establish feed coverage, but it does not create a hazard event. A present energy-spine payload does not establish an activity direction. A current CCFI level without a prior comparison does not become a freight change.

​
Freshness budgets

The composer evaluates source timestamps at request time: Transport freshness proves that collection ran. Content freshness proves that the observation itself is timely. Neither substitutes for the other.

​
API and caching

GET /api/supply-chain/v1/get-china-corridor-control-towers reads the canonical Redis source seeds in one batch and isolates missing dependencies. It validates every composed provenance envelope before returning the wire payload. Healthy aggregates use a five-minute server cache. An all-unavailable result is not positively cached, so a recovery can appear immediately. The client circuit breaker deliberately retains no last-good aggregate that could hide a current fail-closed response. The panel refresh interval is 15 minutes. The response exposes upstreamUnavailable: true only when every corridor is unavailable. Partial corridor evidence remains inspectable rather than being collapsed into total outage or false health. This detailed control-tower response is a REST/UI surface. MCP has no dedicated corridor-control-tower tool; Pro MCP receives only its bounded contribution to get_china_decision_signals.

​
Relationship to the nowcast

The China Activity Nowcast can use a corridor-family breadth change only when a comparable prior corridor snapshot exists. The control-tower response itself remains a source composition and does not publish a directional economic conclusion.