TAPPaaS

TAPPaaS Foundation Layer - Dependency Documentation

Generated: 2026-11-09 by src/foundation/generate-dependencies.py, with PROGRAMS.csv and DEPENDENCIES.csv. Do not edit by hand: change the generator and run it again.

What a foundation program is, and what each code file under src/foundation/ depends on: the bash files it sources, the TAPPaaS programs its code names, and the site config files it reads. Read from the code, so a program called through a variable is missed and a name that only appears in a message counts; the generator's docstring has the exact rules.

Summary

162 programs, 845 code files read (414 bash, 335 typescript, 70 python, 26 nix), 1541 direct dependencies.

Area Bash Python TypeScript Nix Files
tappaas-cicd/ui 5 0 150 1 156
tappaas-cicd/lib 31 0 31 1 63
cluster 53 0 0 0 53
tappaas-cicd/controller/opnsense-controller 5 43 0 1 49
tappaas-cicd/manager/health-manager 9 0 36 1 46
tappaas-cicd/scripts 32 10 0 0 42
backup 41 0 0 0 41
tappaas-cicd/manager/module-manager 17 0 17 1 35
tappaas-cicd/manager/site-manager 11 0 20 1 32
network 28 0 2 1 31
tappaas-cicd/manager/network-manager 7 0 22 1 30
tappaas-cicd/migrations 27 0 0 0 27
tappaas-cicd/manager/backup-manager 4 0 14 1 19
tappaas-cicd/manager/identity-manager 5 0 12 1 18
templates 15 0 0 3 18
identity 13 0 0 2 15
satellite 14 0 0 0 14
tappaas-cicd/controller/cmdb-controller 3 0 9 1 13
tappaas-cicd/controller/node-provisioner 3 9 0 1 13
tappaas-cicd/manager/environment-manager 4 0 8 1 13
logging 9 0 0 1 10
storage 10 0 0 0 10
tappaas-cicd/controller/authentik-controller 3 5 0 1 9
tappaas-cicd/manager/asset-manager 4 0 4 1 9
tappaas-cicd/manager/ca-manager 3 0 5 1 9
tappaas-cicd/manager/storage-manager 3 0 5 1 9
tappaas-cicd 5 0 0 2 7
tappaas-cicd/controller/proxmox-controller 7 0 0 0 7
pvehost 6 0 0 0 6
tappaas-cicd/update-tappaas 3 2 0 1 6
tappaas-cicd/manager/ap-manager 5 0 0 0 5
tappaas-cicd/manager/switch-manager 5 0 0 0 5
console 4 0 0 0 4
debianhost 4 0 0 0 4
tappaas-cicd/controller/pbs-controller 4 0 0 0 4
(top level) 2 1 0 0 3
tappaas-cicd/controller 3 0 0 0 3
tappaas-cicd/manager 3 0 0 0 3
tappaas-cicd/test-vm-creation 2 0 0 0 2
tappaas-cicd/test-repository 1 0 0 0 1
tappaas-cicd/test-variants 1 0 0 0 1

Programs

86 programs, 50 scripts and 26 sourced libraries (PROGRAMS.csv lists each with its source). The front doors are the managers; controllers plug into them; the services run beside them.

Component Kind Programs
module-manager manager module-manager, adopt-module.sh, copy-update-json.sh, delete-module.sh, install-module.sh, module-format.sh, rename-instance.sh, resolve-module.sh, set-module-field.sh, snapshot-vm.sh, suspend-module.sh, test-module.sh, test-validate-module-tier-source.sh, update-module.sh, validate-module-tier-source.sh, validate-modules-mandatory.sh
site-manager manager site-manager, convert-json-to-config.sh, create-configuration.sh, create-site.sh, repository.sh, test-create-site.sh, validate-catalog.sh, validate-configuration.sh, validate-site.sh
network-manager manager network-manager, zone-reconcile, network-manager-wgvpn
environment-manager manager environment-manager
identity-manager manager identity-manager, validate-identities.sh, validate-people.sh, people-manager
backup-manager manager backup-manager
health-manager manager health-manager, check-disk-threshold.sh, check-firewall-cert.sh, check-ha-health.sh, check-repo-signatures.sh, reboot-guest.sh, update-os.sh
storage-manager manager storage-manager
ca-manager manager ca-manager
asset-manager manager asset-manager, position-manager, rack-manager
ap-manager manager ap-manager, setup-wlan-secrets.sh, ap-controller
switch-manager manager setup-switches.sh, switch-manager, switch-controller
pbs-controller controller pbs-controller, backup-controller
authentik-controller controller authentik-controller, authentik-manager, identity-controller
node-provisioner controller node-provisioner
opnsense-controller controller opnsense-controller, opnsense-firewall, zone-manager, dns-manager, dhcp-manager, unbound-manager, ipv6-manager, mdns-manager, caddy-manager, nat-manager, snat-manager, acme-manager, trust-manager, syslog-manager, rules-manager, test-network-manager, opnsense-ensure-patches, opnsense-manager
proxmox-controller controller migrate-node.sh, migrate-vm.sh, proxmox-controller, resize-disk.sh, proxmox-manager
cmdb-controller controller cmdb-controller, cmdb
update-tappaas service update-tappaas
console service console, tappaas

Most depended upon

File or program Files that name it What it is
common-install-routines.sh 151 script — tappaas-cicd/lib
site.json 122 config file
module-manager 92 program — manager: module-manager
zones.json 91 config file
site-manager 67 program — manager: site-manager
network-manager 54 program — manager: network-manager
backup-manager 52 program — manager: backup-manager
health-manager 34 program — manager: health-manager
asset-manager 30 program — manager: asset-manager
environments/ 29 config file
update-tappaas 26 program — service: update-tappaas
dns-manager 24 program — controller: opnsense-controller
ap-manager 24 program — manager: ap-manager
opnsense-controller 23 program — controller: opnsense-controller
switch-manager 22 program — manager: switch-manager
identity-manager 22 program — manager: identity-manager
environment-manager 22 program — manager: environment-manager
component-install-lib.sh 22 script — tappaas-cicd/lib
network.json 21 config file
ca-manager 21 program — manager: ca-manager
storage-manager 20 program — manager: storage-manager
module-catalog.json 19 config file
pbs-job.sh 18 sourced file
update-module.sh 15 program — manager: module-manager
node-provisioner 15 program — controller: node-provisioner
install-module.sh 15 program — manager: module-manager
authentik-controller 15 program — controller: authentik-controller
pbs-namespace.sh 14 sourced file
control-plane.json 13 config file
caddy-manager 12 program — controller: opnsense-controller

Entry points

Programs and scripts no other foundation code names: what an operator, a timer, a node or another repository runs.

What each front door calls

Each manager, controller and service, with the programs, sourced files and config files its source names directly.

module-manager (manager)

graph LR
    n0["module-manager"]
    n0 --> n1["switch-manager"]
    n0 --> n2["components.json"]
    n0 --> n3["install-module.sh"]
    n0 --> n4["adopt-module.sh"]
    n0 --> n5["update-module.sh"]
    n0 --> n6["delete-module.sh"]
    n0 --> n7["test-module.sh"]
    n0 --> n8["snapshot-vm.sh"]
    n0 --> n9["migrate-vm.sh"]
    n0 --> n10["suspend-module.sh"]
    n0 --> n11["control-plane.json"]
    n0 --> n12["site.json"]
    n0 --> n13["module-catalog.json"]
    n0 --> n14["zones.json"]
    n0 --> n15["site-manager"]
    n0 --> n16["rename-instance.sh"]
    n0 --> n17["set-module-field.sh"]
    n0 --> n18["network-manager"]

site-manager (manager)

graph LR
    n0["site-manager"]
    n0 --> n1["asset-manager"]
    n0 --> n2["validate-site.sh"]
    n0 --> n3["identity-manager"]
    n0 --> n4["network-manager"]
    n0 --> n5["module-manager"]
    n0 --> n6["environment-manager"]
    n0 --> n7["create-site.sh"]
    n0 --> n8["repository.sh"]
    n0 --> n9["update-tappaas"]
    n0 --> n10["adopt-module.sh"]
    n0 --> n11["site.json"]
    n0 --> n12["health-manager"]
    n0 --> n13["prepare-netboot.sh"]
    n0 --> n14["copy-update-json.sh"]
    n0 --> n15["channels.json"]
    n0 --> n16["module-catalog.json"]
    n0 --> n17["node-provisioner"]
    n0 --> n18["switch-manager"]
    n0 --> n19["zones.json"]
    n0 --> n20["update-module.sh"]
    n0 --> n21["storage-manager"]

network-manager (manager)

graph LR
    n0["network-manager"]
    n0 --> n1["dns-manager"]
    n0 --> n2["caddy-manager"]
    n0 --> n3["network-manager-wgvpn"]
    n0 --> n4["opnsense-firewall"]
    n0 --> n5["zones.json"]
    n0 --> n6["cmdb-controller"]
    n0 --> n7["health-manager"]
    n0 --> n8["asset-manager"]
    n0 --> n9["site-manager"]
    n0 --> n10["switch-manager"]
    n0 --> n11["ap-manager"]
    n0 --> n12["module-manager"]
    n0 --> n13["backup-manager"]
    n0 --> n14["environment-manager"]
    n0 --> n15["site.json"]
    n0 --> n16["environments/"]
    n0 --> n17["zone-manager"]
    n0 --> n18["proxmox-controller"]
    n0 --> n19["snat-manager"]
    n0 --> n20["ipv6-manager"]

environment-manager (manager)

graph LR
    n0["environment-manager"]
    n0 --> n1["site.json"]
    n0 --> n2["network-manager"]
    n0 --> n3["module-manager"]
    n0 --> n4["unbound-manager"]
    n0 --> n5["acme-manager"]
    n0 --> n6["ca-manager"]
    n0 --> n7["zones.json"]
    n0 --> n8["environments/"]

identity-manager (manager)

graph LR
    n0["identity-manager"]
    n0 --> n1["authentik-controller"]

backup-manager (manager)

graph LR
    n0["backup-manager"]
    n0 --> n1["pbs-controller"]
    n0 --> n2["site.json"]
    n0 --> n3["update-module.sh"]
    n0 --> n4["cmdb-controller"]
    n0 --> n5["site-manager"]
    n0 --> n6["environment-manager"]
    n0 --> n7["module-manager"]
    n0 --> n8["zones.json"]

health-manager (manager)

graph LR
    n0["health-manager"]
    n0 --> n1["tappaas"]
    n0 --> n2["backup-manager"]
    n0 --> n3["storage-manager"]
    n0 --> n4["proxmox-controller"]
    n0 --> n5["site-manager"]
    n0 --> n6["switch-manager"]
    n0 --> n7["site.json"]
    n0 --> n8["module-manager"]
    n0 --> n9["control-plane.json"]
    n0 --> n10["network-manager"]
    n0 --> n11["ipv6-manager"]
    n0 --> n12["zones.json"]
    n0 --> n13["update-os.sh"]
    n0 --> n14["reboot-guest.sh"]
    n0 --> n15["site-notify.sh"]
    n0 --> n16["module-catalog.json"]

storage-manager (manager)

graph LR
    n0["storage-manager"]
    n0 --> n1["module-manager"]
    n0 --> n2["proxmox-controller"]
    n0 --> n3["cmdb-controller"]
    n0 --> n4["install-module.sh"]
    n0 --> n5["site-manager"]

ca-manager (manager)

graph LR
    n0["ca-manager"]
    n0 --> n1["trust-manager"]
    n0 --> n2["caddy-manager"]
    n0 --> n3["acme-manager"]
    n0 --> n4["site.json"]

asset-manager (manager)

graph LR
    n0["asset-manager"]
    n0 --> n1["site-manager"]
    n0 --> n2["site.json"]
    n0 --> n3["network-manager"]
    n0 --> n4["cmdb-controller"]

ap-manager (manager)

graph LR
    n0["ap-manager"]
    n0 --> n1["common-install-routines.sh"]
    n0 --> n2["vm-net.sh"]
    n0 --> n3["cli-gate.sh"]
    n0 --> n4["wlan-lib.sh"]
    n0 --> n5["asset-role.sh"]
    n0 --> n6["controller-lib.sh"]
    n0 --> n7["locations.sh"]
    n0 --> n8["cmdb-report.sh"]
    n0 --> n9["asset-manager"]
    n0 --> n10["site-manager"]
    n0 --> n11["network-manager"]
    n0 --> n12["zones.json"]

switch-manager (manager)

graph LR
    n0["switch-manager"]
    n0 --> n1["common-install-routines.sh"]
    n0 --> n2["vm-net.sh"]
    n0 --> n3["cli-gate.sh"]
    n0 --> n4["controller-lib.sh"]
    n0 --> n5["locations.sh"]
    n0 --> n6["asset-role.sh"]
    n0 --> n7["cmdb-report.sh"]
    n0 --> n8["asset-manager"]
    n0 --> n9["site-manager"]
    n0 --> n10["ap-manager"]
    n0 --> n11["network-manager"]
    n0 --> n12["zones.json"]

pbs-controller (controller)

graph LR
    n0["pbs-controller"]
    n0 --> n1["cli-gate.sh"]
    n0 --> n2["module-manager"]
    n0 --> n3["backup-manager"]

authentik-controller (controller)

Names no other program or config file.

node-provisioner (controller)

graph LR
    n0["node-provisioner"]
    n0 --> n1["dhcp-manager"]

opnsense-controller (controller)

Names no other program or config file.

proxmox-controller (controller)

graph LR
    n0["proxmox-controller"]
    n0 --> n1["common-install-routines.sh"]
    n0 --> n2["vm-net.sh"]
    n0 --> n3["zones.json"]

cmdb-controller (controller)

graph LR
    n0["cmdb-controller"]
    n0 --> n1["components.json"]
    n0 --> n2["module-manager"]
    n0 --> n3["zones.json"]
    n0 --> n4["environments/"]

update-tappaas (service)

graph LR
    n0["update-tappaas"]
    n0 --> n1["module-manager"]
    n0 --> n2["backup-manager"]
    n0 --> n3["unbound-manager"]
    n0 --> n4["tappaas-repair-ownership.sh"]
    n0 --> n5["site-manager"]
    n0 --> n6["tappaas-self-rebuild.sh"]
    n0 --> n7["tappaas-collation-reconcile.sh"]
    n0 --> n8["site.json"]
    n0 --> n9["zones.json"]

console (service)

graph LR
    n0["console"]
    n0 --> n1["install-access.sh"]
    n0 --> n2["module-manager"]
    n0 --> n3["network-manager"]
    n0 --> n4["health-manager"]
    n0 --> n5["backup-manager"]
    n0 --> n6["switch-manager"]
    n0 --> n7["site.json"]
    n0 --> n8["module-catalog.json"]
    n0 --> n9["cmdb"]
    n0 --> n10["zones.json"]
    n0 --> n11["site-manager"]
    n0 --> n12["storage-manager"]
    n0 --> n13["environment-manager"]
    n0 --> n14["node-provisioner"]
    n0 --> n15["identity-manager"]
    n0 --> n16["rest-of-foundation.sh"]
    n0 --> n17["ap-manager"]
    n0 --> n18["cmdb-controller"]
    n0 --> n19["update-tappaas"]
    n0 --> n20["control-plane.json"]
    n0 --> n21["asset-manager"]
    n0 --> n22["ca-manager"]
    n0 --> n23["ipv6-manager"]