Ecosystem Gaps Register

Purpose: Track external dependencies referenced by documented repositories that have not yet been documented themselves. As repos are added to the documentation effort, resolved entries are updated with links to their documentation.

Summary

Status	Count
Unresolved	20
Resolved	1

External Services

#	Referenced Component	Reference Type	Found In	Context	Status
1	Auth Service	HTTP API	`TELS.Tasks.Api/ServiceWrappers/AuthServiceWrapper.cs`, `TELS.Tasks.MQServices/Logic/Proxies/AuthServiceProxy.cs`, `appsettings.json` (AuthEndpoint)	Token retrieval (`POST /token/refresh`) for all outbound service calls. Used by both API and MQServices.	Unresolved
2	Assets Service	HTTP API + NuGet (`DSE.TELS.Assets.Contracts` v2.724197.0)	`TELS.Tasks.Api/ServiceWrappers/AssetsServiceWrapper.cs`, `appsettings.json` (AssetsEndpoint)	Loads asset details (`POST /v1/assets/queries/loadAssets`) when resolving task instance data.	Unresolved
3	Customers Service	HTTP API + NuGet (`DSE.TELS.Customers.Contracts` v1.78.0)	`TELS.Tasks.MQServices/Logic/Proxies/SchedulingProxy.cs`, `appsettings.json` (CustomersEndpoint)	Customer/facility queries from MQServices via WebServiceClient.	Unresolved
4	Scheduling Service	MQ Events + NuGet (`TELS.Scheduling.Events` v1.4.3)	`TELS.Tasks.MQServices/Consumers/ScheduleCreatedConsumer.cs`, `ScheduleRemovedConsumer.cs`, `TaskUpdatedConsumer.cs`, `MassSchedulesRemovedConsumer.cs`	Publishes `IScheduleCreatedEvent`, `IScheduleRemovedEvent`, `ITaskUpdatedEvent`, `IMassSchedulesRemovedEvent` consumed by Tasks. Tasks also publishes `ScheduleCreatedEvent` and `ScheduleRemovedEvent` back to it.	Unresolved
5	Notifications Service	HTTP API + NuGet (`Unity.Notifications.Messaging` v1.10.846068)	`TELS.Tasks.Api/ServiceWrappers/NotificationsWrapper.cs`, `appsettings.json` (NotificationsEndpoint)	Email attachment uploads (`POST /Email/UploadAttachment`) and outbound email publishing (`OutboundEmailEnvelope` via BusProxy).	Unresolved
6	Files Service	HTTP API	`appsettings.json` (FilesEndpoint: `http://localhost:7180/files`)	Configured endpoint, available for file operations.	Unresolved
7	BusProxy Service	HTTP API + NuGet (`TELS.BusProxy.Client` v2.2.0-2.3.0, `TELS.BusProxy.Client.S3Fallback` v2.6.0, `TELS.BusProxy.Client.SqlFallback` v2.4.0)	`TELS.Tasks.Api/ServiceWrappers/BusProxyService.cs`, `TELS.Tasks.MQServices/Configuration/BusProxyConfiguration.cs`, `CloudAPI.Api/DependencyInjection/`	Central message publishing infrastructure. Primary delivery via HTTP, with S3 fallback (prod) or SQL fallback (local/integration). 45s timeout. Used by Tasks and CloudAPI. [See ~/gitlab/BusProxy/docs/]	Resolved
13	Work Orders Service	HTTP API	`CloudAPI.Api/Startup.cs` (WorkOrdersServiceEndpoint)	Work order data access from CloudAPI.	Unresolved
14	Platform Service	HTTP API	`CloudAPI.Api/Startup.cs` (PlatformServiceEndpoint)	Platform-level operations from CloudAPI.	Unresolved
15	Databricks	ODBC Analytics	`CloudAPI.DAL/Databricks/DatabricksDataContext.cs`	Read-only analytics queries for complex priority metrics. Queries facility/chain/owner spend, win rates, market analysis.	Unresolved
16	FastAPI Service	HTTP REST ML Service	`CloudAPI.DAL/FastAPI/FastAPIDataContext.cs`	Machine learning model for propensity-to-win predictions. Endpoints: `/predict` and `/backfill_predict`.	Unresolved
18	Zendesk	External REST API	`TicketExceptions` via RestSharp	External ticketing system. TicketExceptions creates tickets, posts comments, updates status via REST API. Critical operational dependency.	Unresolved
19	Bidding Service	MQ Events + NuGet (`TELS.Bidding.Contracts`)	`TicketExceptions.MQServices/Consumers/BiddingConsumer.cs`	Publishes `IBidConversationAdded`, `IBidStatusChanged`, `IBidModification` events consumed by TicketExceptions for bid-related exception detection.	Unresolved
20	Compliance Service	MQ Events + NuGet (`TELS.Compliance.Contracts`)	`TicketExceptions.MQServices/Consumers/ComplianceConsumer.cs`	Publishes `IArticleNotificationOutcome` events consumed by TicketExceptions.	Unresolved
21	Contracted Services	MQ Events + NuGet (`TELS.ContractedServices.Contracts`)	`TicketExceptions.MQServices/Consumers/ContractedServiceDocumentationRequirementMetConsumer.cs`	Publishes contract service document upload events consumed by TicketExceptions for document-related exceptions.	Unresolved

External Databases

#	Referenced Component	Reference Type	Found In	Context	Status
8	TELS database (dbo schema)	Cross-database SQL	`Tasks.DbUp/Schema/20200429 - TELS.dbo.TaskInstance.sql`, `Tasks.DbUp/StoredProcedures/TIG/*.sql`, multiple migration scripts	Core tables: `dbo.telsTask`, `dbo.telsTaskInstance`, `dbo.telsTaskInstanceHist`, `dbo.telsTaskSchedule`, `dbo.telsProgram`, `dbo.LogTemplate`, `dbo.telsDefaultReqDocTasks`. Tasks schema has FK relationships into these dbo tables. TIG stored procedures operate directly on dbo tables.	Unresolved
9	CONTACT database	Cross-database SQL	`Tasks.DbUp/StoredProcedures/` (referenced in stored procedures)	Contact/person data lookups from stored procedures. Three-part name references (`CONTACT.dbo.*`).	Unresolved

External Event Sources

#	Referenced Component	Reference Type	Found In	Context	Status
10	Customers Events Publisher	MQ + NuGet (`DSE.TELS.Customers.Events` v1.0.287926)	`TELS.Tasks.MQServices/Consumers/BusinessUnitChangeConsumer.cs`	Publishes `IBusinessUnitChangeV1` events that trigger task instance generation when business units are activated.	Unresolved

Internal Shared Libraries (NuGet)

#	Referenced Component	Reference Type	Found In	Context	Status
11	TELS.WebServiceClients	NuGet (multiple packages)	`TELS.Tasks.Api.csproj`, `TELS.Tasks.MQServices.csproj`	Shared HTTP client library for calling other TELS services. Provides typed clients for Auth, Customers, Assets, etc.	Unresolved
12	TELS.WebServices.Auth.Contracts	NuGet (v4.1.1)	`TELS.Tasks.Api.csproj`, `TELS.Tasks.MQServices.csproj`	Shared auth DTOs and token contracts used for JWT validation and service-to-service auth.	Unresolved
17	BuildingServices.Contracts	NuGet (v1.511.0-v1.524.0)	`CloudAPI.Api.csproj`, `CloudAPI.MQServices.csproj`	Shared event contracts for Building Services domain. Includes `CalculatePropensityToWinMessage`, `FlushCacheRequest`, `RequestType`.	Unresolved

Resolution Log

Date	Entry #	Action	Details
2026-03-02	—	Documented	CloudAPI repo documented at `~/gitlab/BuildingServices/CloudAPI/docs/`
2026-03-02	—	Documented	TicketExceptions repo documented at `~/gitlab/BuildingServices/TicketExceptions/docs/`
2026-03-02	—	Documented	Related-order-sync repo documented at `~/gitlab/BuildingServices/related-order-sync/docs/`
2026-03-02	#7	Resolved	BusProxy repo documented at `~/gitlab/BusProxy/docs/` + bus-proxy-queue-processor at `~/gitlab/bus-proxy-queue-processor/docs/`

Notes

Entries 3 (Customers Service) and 10 (Customers Events Publisher) likely live in the same repository but are listed separately because they represent different integration types (HTTP vs MQ).
Entry 8 (TELS dbo schema) is the highest-impact gap. The Tasks schema has direct FK references into dbo tables, and the TIG stored procedures execute against dbo tables. Understanding the full dbo schema is critical for a complete ER diagram.
Entry 7 (BusProxy) is shared infrastructure used by many services. Documenting it once will resolve the gap for all downstream repos.