macula_root (macula v0.14.3)

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.8.5+):

  macula_root (this module - application root)
   macula_routing_server (core DHT infrastructure - always on)
   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_platform_system (platform layer - always on)
       macula_leader_election (deprecated - scheduled for removal v0.14.0)
       macula_crdt (LWW-Register, OR-Set in v0.14.0)
  

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()