Atlas project production

aether

Script-first operational toolbox spanning SIS, Google Workspace, identity, asset, and reporting workflows through shared shell libraries, config packs, SQL sources, and per-workflow entry scripts.

Internal-only entry. Do not publish externally without review.
Type
System
Lifecycle
Active
Last touched
2026-03-26
Visibility
Internal

Purpose

Provide a practical integration toolbox for recurring district automation workflows where script-first execution remains the fastest operational fit.

Current state

Active with broad implementation evidence and refreshed repo-level documentation from the current workbench pass. Host/scheduler normalization now treats this repository as the primary Linux automation layer on `sal-01.bousd.us` for many cron-driven workflows, while Windows Task Scheduler-centric runner jobs remain primarily in Integr8r on `saw-01.bousd.us`.

Next step

Map active production entrypoints to explicit run schedules, owners, and host assignment (`sal-01` default versus exceptions), then split stable workflow families into tighter runbooks/playbooks.

Interfaces

Inputs
  • Config files under conf.d/ and config/
  • SQL query definitions
  • API/domain system data
Outputs
  • CSV/report artifacts
  • API updates
  • Email/HTML outputs
  • Operational logs

Reality to Action trace

Reality Ingestion

Contributes in this stage.

Canonical Storage

Not in scope.

Automation Engines

Contributes in this stage.

Human Interfaces

Contributes in this stage.

Operational Adoption

Contributes in this stage.

Core workflow

TBD. Document the 5-10 steps that define the core workflow.

Artifacts

  • Root Push/*sync scripts
  • lib/ helper modules
  • conf.d/ configs
  • sql/ queries
  • templates/

Operational notes

Constraints and scars

  • Large heterogeneous script surface.
  • Multiple overlapping legacy and successor workflows require careful classification.

Reliability posture

High utility and broad coverage, but behavior varies by script. Host normalization now places most Linux script-scheduled workloads on `sal-01.bousd.us`, while Windows runner workloads remain centered on `saw-01.bousd.us` via Integr8r. Safe operation still depends on workflow-specific validation and ownership discipline.

Observability

  • Per-script logs
  • stdout/stderr
  • Generated artifacts in runtime folders

Security and privacy

Repository handles sensitive operational integrations. Keep credentials outside source control and treat generated data/log artifacts as restricted where they contain PII or privileged context.

Dependencies

Upstream
  • Aeries
  • Google Workspace
  • Snipe-IT
  • TitanHST
  • Other district platforms
Downstream
  • District integration operations
  • Reporting and notification workflows

Ownership

Owners

Josh Barton

Users

Technology Services, Operations maintainers