macula_root (macula v0.20.5)

View Source

Macula Application Root Supervisor.

This is the top-level supervisor for the Macula application. It manages all Macula subsystems in an always-on architecture.

Supervision Hierarchy (v0.16.0+):

  macula_root (this module - application root)
   macula_routing_server (core DHT infrastructure - always on)
   macula_nat_system (NAT traversal - always on)
      macula_nat_detector
      macula_hole_punch
      macula_relay_registry
      macula_connection_upgrade
   macula_bootstrap_system (bootstrap services - always on)
      macula_bootstrap_server
      macula_bootstrap_registry
      macula_bootstrap_health
   macula_gateway_system (gateway services - always on)
      macula_gateway_health
      macula_gateway_diagnostics
      macula_gateway_quic_server
      macula_gateway
      macula_gateway_workers_sup
   macula_bridge_system (hierarchical mesh bridging - optional)
      macula_bridge_node (parent mesh connection)
      macula_bridge_mesh (peer bridge mesh)
      macula_bridge_cache (parent query results cache)
   macula_peers_sup (dynamic peer connections - always on)
   macula_peer_discovery (DHT-based P2P mesh - always on)
   macula_platform_system (distributed coordination - always on)
      macula_crdt (LWW-Register, OR-Set, G-Counter, PN-Counter)
   macula_registry_system (package distribution - always on)
       macula_registry_store (ETS + disk storage)
       macula_registry_server (publish/fetch API)
       macula_cluster_controller (app lifecycle)
       macula_app_monitor (runtime defense)
  

Architecture Philosophy (v0.8.5): - All nodes have ALL capabilities (no mode selection) - Zero configuration required (TLS auto-generated) - Simplified deployment (every node is bootstrap + gateway + peer) - True P2P mesh (nodes connect on-demand based on capability discovery)

Naming Convention (v0.7.10+): - _root: Application root supervisor (one per application) - _system: Subsystem root supervisors (gateway, peer, bootstrap, etc.) - _sup: Worker supervisors (workers_sup, peers_sup)

Summary

Functions

init(_)

start_link()