How kaiden-bell/rootmap works
RootMap is a Linux host-inventory and dependency-mapping application, organized around a head-node API, a host agent, and a web dashboard. The demonstrated collection flow gathers host identity and OS/network details, posts a report to the backend, and stores host records; the dashboard can also list and add hosts and supports login/password change. Service-version and configuration collection is present as a separate agent capability, but the shown agent entry point sends only system information. Scheduling, script synchronization, and dependency-visualization processing are README goals not substantiated by the sampled runtime. Edges reflect shown calls, HTTP requests, or documented interactions.
Main entry points: backend/main.py API and account handling · App.tsx Login and host dashboard · connection.py PostgreSQL connector · rootmap_client/main.py Collection entry point
Components 13
Host Agent
- Collection entry point
client/src/rootmap_client/main.py - System information
client/src/rootmap_client/scripts/host.py - Service/config inventory
client/src/rootmap_client/scripts/service.py
Head Node API
- API and account handling
backend/main.py
Persistence
- Schema initialization
backend/src/db/init_db.py - PostgreSQL connector
backend/src/db/connection.py - Database schema
backend/src/db/schema.sql
Web Dashboard
- Login and host dashboard
frontend/src/App.tsx - Host table
frontend/src/App.tsx
Other components
- Dashboard user
- Linux host
- PostgreSQL
- Dashboard operator
Connections 12
- Linux host → System information: provides host data
client/src/rootmap_client/scripts/host.py - Collection entry point → System information: collects system info
client/src/rootmap_client/main.py - Collection entry point → API and account handling: posts report
client/src/rootmap_client/main.py - API and account handling → PostgreSQL connector: opens connections
backend/main.py - API and account handling → PostgreSQL: reads/writes hosts and users
backend/main.py - Schema initialization → PostgreSQL connector: connects through
backend/src/db/init_db.py - Schema initialization → Database schema: executes schema
backend/src/db/init_db.py - PostgreSQL connector → PostgreSQL: connects to
backend/src/db/connection.py - Login and host dashboard → API and account handling: requests API data
frontend/src/App.tsx - Login and host dashboard → Host table: renders hosts
frontend/src/App.tsx - Dashboard operator → Login and host dashboard: uses dashboard
README.md - Dashboard user → Login and host dashboard: manages hosts
README.md