📚 Repository Documentation

Direct Supply Internal Documentation Portal

Welcome to Direct Supply Repository Documentation

Comprehensive technical documentation for all documented repositories. Navigate by repository below or use the quick links to jump to specific documentation types.

Last Updated: March 12, 2026

28 Documented Repositories
14 Fully Detailed Services
73 Documentation Files
8 Domain Areas

⭐ Building Services Domain

9 repos
API + MQ

CloudAPI

Dispatch list management API with multi-database support (PostgreSQL, SQL Server, Databricks). Features complex priority scoring and ML-driven propensity-to-win predictions.

API + MQ

TicketExceptions

Event-driven exception management with 27 specialized consumers monitoring dispatch list tickets. Integrates with Zendesk for automated ticket creation and status synchronization.

Batch Job

related-order-sync

Scheduled batch job linking related MDID orders to TBS tickets. Ensures comprehensive financial records with parent/child order relationships.

Terraform

building-services

Infrastructure definitions and CI/CD for Building Services ecosystem.

Terraform

building-services-infra

Shared infrastructure components for Building Services.

Terraform

mqservices

Message queue service infrastructure.

Terraform

propensity-to-win

ML model infrastructure for propensity-to-win scoring.

Terraform

smart

SMART system infrastructure.

Terraform

tels-provider-upload-processor

Provider upload processor infrastructure.

📋 Tasks & Work Orders

2 repos
API + MQ

Tasks Service

Task management system with scheduling, instance generation, and log templates. Features 234+ stored procedures and event-driven architecture with Quartz scheduling.

API + MQ

Work Orders

Work order management service providing REST API for work order operations including documents, mass creation, summaries, and status/priority lookups. Includes RabbitMQ subscriber for work order events.

💰 Billing Domain

5 repos
API + MQ

Billing Service

Order creation and billing management. Submits orders into the MDID transaction system, manages subscription billing, tracks transactions, handles tax calculations, and integrates with DSSI for electronic invoicing.

UI

Billing UI

React SPA hosted on AWS Lambda providing the TELS Billing web interface for managing custom PO number configuration and billing facility settings.

Utility

Billing Utilities

Manual execution utility for compiling reports of active PLTs with DSSI integration values, determining paper-based vs DSSI-based billing integration.

Batch Job

Invoice Monitor

Nomad batch job that monitors MDID invoice posting and automatically marks associated work items/tickets as "Invoicing Completed".

Legacy Batch

TELS Billing Processor

Nomad-orchestrated legacy Windows batch job that generates monthly subscription bills daily and processes MDID orders hourly.

📋 Contracted Services Domain

6 repos
API + MQ

Contracted Services

REST API for contract management, scheduling, and service events. Includes RabbitMQ subscriber with 16 consumers for async processing and shared business logic for scheduling algorithms.

Batch Job

ContractedServiceEventScheduler

Daily batch job (2 AM UTC) that schedules pending service events and retries failed ticket generation.

Batch Job

AvailableDocumentationNotifier

Weekly batch job (Mondays 9 AM UTC) notifying facility contacts when documentation has been uploaded for contracted service events.

Batch Job

ETA Notifier

Weekday batch job (8:37 AM) publishing upcoming ETA reminder commands to customers for contracted services.

Batch Job

ServiceProviderJobNotifier

Multiple monthly cron schedules publishing notification commands to service providers. Triggers 5 different notification types.

Batch Job

UpcomingServicesSummaryNotifier

Monthly batch job (1st of month, 10 AM UTC) summarizing upcoming contracted service work at each contact's facilities.

🔧 Core Platform Services

6 repos
API + MQ

Customers Service

Core REST API for the Customers domain managing facilities, contacts, owners, business units, and user access. Includes RabbitMQ consumer for async event processing.

API

Auth Service

Core authentication service that issues, refreshes, and validates JWT tokens for the TELS platform. Includes SDK for service consumers with JWT validation and resilience.

API

Platform Service

Centralized configuration and settings service providing a generic key-value store with JSONB values for schema-less configuration across the TELS ecosystem.

API + MQ

Assets Service

Core REST API for equipment lifecycle management. Includes RabbitMQ consumer for async event processing and serial number parsing/validation library.

API + MQ

Unity Notifications

Notification management API including email uploads, SMS webhooks, and bounce handling. Three RabbitMQ subscribers for outbound dispatch via AWS SES (email), Pinpoint (SMS), and SNS (push).

API + MQ

TELS Files

Centralized file management service for file upload, download, metadata management, and file group organization. Includes RabbitMQ subscriber for business unit and task document events.

📝 Quoting & Compliance

2 repos
API + MQ

Quoting Service

REST API for bid lifecycle management, pricing, fairness scoring, and PDF-to-bid generation. Includes RabbitMQ subscriber for bid expiration, fairness calculation, and PDF processing.

API + MQ

TELS Compliance

REST API for approval workflows managing articles, rules, roles, steps, and notifications. Includes RabbitMQ subscriber with 10 consumers across 3 exchanges for workflow events.

🚀 Infrastructure & Messaging

2 repos
Infrastructure

BusProxy

Centralized message publishing infrastructure with fallback strategies (S3/SQL). Provides NuGet client libraries used by all services. Critical shared component.

Worker Service

bus-proxy-queue-processor

Background worker processing SQL fallback queue for BusProxy. Ensures guaranteed message delivery when primary broker is unavailable.

📚 Documentation Resources

Skills & Templates

Reusable documentation skills for creating consistent documentation across repositories:

Skills located in: ~/.claude/skills/

Key Insights