Project Atlas AetherDev project hub
Atlas project maintenance

APEXLearningAPI

Rust helper that batches classroom enrollment requests to APEX Learning from CSV input and API credentials defined in config.toml.

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

Purpose

Preserve and document the API-based APEX enrollment helper while keeping its relationship to newer provisioning paths explicit.

Current state

Code is runnable and evidence-backed, but Atlas treats it as maintenance/adjacent until production-primary usage is confirmed. No scheduler or host-runbook evidence was found in this repo. Current scheduler evidence does not show active invocation: the `saw-01.bousd.us` Task Scheduler artifact has no APEXLearningAPI task entries, and `aether/docs/cron-example.txt` contains no APEXLearningAPI path references. The workbench also contains a stronger APEX production path via OneRoster-oriented workflows.

Next step

Close lifecycle status explicitly: either document a current production invocation path (host, scheduler/manual trigger, operator/escalation owner) or classify this helper as manual/legacy fallback only; then remove token printing and add retry/backoff plus structured run reporting if continued use is confirmed.

Interfaces

Inputs
  • CSV enrollment records (ClassroomName, StudentId)
  • config.toml API credentials
Outputs
  • APEX API enrollment calls
  • error_log.csv

Reality to Action trace

Reality Ingestion

Not in scope.

Canonical Storage

Not in scope.

Automation Engines

Not in scope.

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.

Data integrity and contracts

Source of truth rules

  • SIS/export workflows remain canonical for roster source data.
  • This component is an integration helper, not a roster source of truth.

Safe handling

  • Do not expose tokens or credential material in logs.
  • Restrict access to enrollment input/output files.

Operational notes

Reliability posture

Concurrent posting model exists, but retry/backoff and hardened error handling are limited, and current implementation still prints the OAuth access token to stdout.

Observability

  • stdout/stderr
  • error_log.csv

Security and privacy

Treat API credentials, enrollment CSV inputs, and failure logs as restricted operational data.

Dependencies

Upstream
  • APEX Learning API
  • Upstream enrollment CSV generation
Downstream
  • Targeted enrollment support workflows

Ownership

Owners

Josh Barton

Users

Technology Services

APEXLearningAPI

Cross-Repo Context

Atlas currently treats this project as adjacent tooling, while APEX Learning OneRoster Provisioning Workflow represents the stronger production-backed path.

Validation Needed