2.9 KiB

Raw Blame History

Architecture (clean layering)

Layers

Domain (src/adn_server/domain/) — entities, value objects, errors, Result. No I/O, no Twisted.
Application (src/adn_server/application/) — use cases (RoutingUseCases, VoiceUseCases, …) and ports (interfaces).
Infrastructure (src/adn_server/infrastructure/) — YAML config, Twisted UDP/TCP, voice, persistence, security adapters.

Dependency rule: infrastructure → application → domain (inward only).

flowchart TD
  INF["Infrastructure<br/>Twisted UDP/TCP · YAML · voice<br/>report_server · persistence · security"]
  APP["Application<br/>RoutingUseCases · VoiceUseCases<br/>ports · SubscriptionStore · router"]
  DOM["Domain<br/>entities · value objects · errors · Result"]
  INF --> APP --> DOM

Entrypoint

main.py wires configuration, LoopingCall timers, factories for HBPProtocol, report client, and injects use cases.

Runtime routing authority

Voice routing is driven by SubscriptionStore (domain subscriptions). RoutingUseCases orchestrates dmrd_received and delegates forward resolution to SubscriptionRouter.

Conceptual comparison with legacy BRIDGES: BRIDGES vs Subscriptions.

Performance changes in 2.x (indexes, reporting, integrated proxy): Performance (2.x).

Drop-in plugins (voice/unit-data bus, ServerPlugin contract): Plugins user guide. Reference skeleton: plugins/example/ in the repository root.

InMemoryAclRouter (AclRouter port) — ACL range checks only (acl_check).
routing_table_for_report() — export shim for monitor/report (legacy BRIDGE_SND shape); not used for runtime forwards.

Wire opcodes and YAML keys may still say “bridge” for legacy monitor compatibility (BRIDGE_SND, GEN_STAT_BRIDGES).

Where to read code

Topic	Location
Voice routing, `dmrd_received`, OpenBridge forward	`application/routing_use_cases.py`, `application/routing/`
Subscription store, router, in-band rules	`application/subscription/`
HBP / OpenBridge UDP	`infrastructure/twisted_adapters/udp_hbp.py`
Report TCP	`infrastructure/twisted_adapters/report_server.py` (factory), routing events from use cases
Voice / TTS	`application/voice_use_cases.py`, `infrastructure/voice/`
Hotspot proxy (fan-in)	`infrastructure/proxy/` (`udp_fanin.py`, `runtime.py`), `application/proxy/` use cases
Self-service (MySQL)	`infrastructure/proxy/self_service_bridge.py`, `infrastructure/proxy/persistence/`
Dynamic TG persistence	`application/dynamic_tg_use_cases.py`, `infrastructure/persistence/dynamic_tg_repository.py`, `application/routing/dynamic_tg_restore.py`

Configuration as shared state

A mutable config dict is passed through adapters; runtime updates (options, SUB_MAP, OpenBridge _bcsq) remain visible globally for the lifetime of the process.

2.9 KiB Raw Blame History