How hyptofon/soma works
SOMA is a neuro-adaptive agile project-management platform. A user works in a workspace to manage work items and sessions through the .NET API; separately, the cognitive engine exposes telemetry WebSockets and computes fatigue-driven browser actions. The tree also shows identity, collaboration, billing, privacy, device-agent, and personalization capabilities. Sampled code supports the work-item/provider and work-session interactions, device-link reads, billing-event reconciliation, workspace authorization, and engine HTTP/WebSocket exposure. Wiring for unsampled feature handlers and the telemetry hub-to-fatigue path is not asserted.
Main entry points: Program.cs Web API · WorkItemsController.cs Work-item API · WorkSessionService.cs Work sessions · server.go Cognitive HTTP server
Components 21
API and access
- Web API
apps/api-dotnet/src/Soma.WebApi/Program.cs - Workspace authorization
apps/api-dotnet/src/Soma.WebApi/Security/WorkspaceAuthorizationHandler.cs - Identity and sessions
apps/api-dotnet/src/Soma.Application/Features/Auth
Agile work
- Work-item API
apps/api-dotnet/src/Soma.WebApi/Controllers/WorkItemsController.cs - Native work provider
apps/api-dotnet/src/Soma.Application/Common/Providers/SomaNativeProvider.cs - Backlog and stories
apps/api-dotnet/src/Soma.Application/Features/Backlog - Sprint planning
apps/api-dotnet/src/Soma.Application/Features/Sprints - Task management
apps/api-dotnet/src/Soma.Application/Features/Tasks - Work sessions
apps/api-dotnet/src/Soma.Infrastructure/Persistence/WorkSessionService.cs
Workspace services
- Teams and membership
apps/api-dotnet/src/Soma.Application/Features/Teams - Workspace lifecycle
apps/api-dotnet/src/Soma.Application/Features/Workspaces - Invitations
apps/api-dotnet/src/Soma.Application/Features/Invites - Billing and entitlements
apps/api-dotnet/src/Soma.Application/Features/Billing - Privacy and consent
apps/api-dotnet/src/Soma.Application/Features/Privacy - Device agents
apps/api-dotnet/src/Soma.Application/Features/Agents
Personalization
- Adaptation profiles
apps/api-dotnet/src/Soma.Application/Features/Adaptation - Accessibility settings
apps/api-dotnet/src/Soma.Application/Features/Accessibility
Cognitive engine
- Cognitive HTTP server
apps/cognitive-engine/internal/httpserver/server.go - Telemetry WebSocket
apps/cognitive-engine/internal/httpserver/server.go - Fatigue scoring
apps/cognitive-engine/internal/fatigue/engine.go
Other components
- User
Connections 9
- User → Web API: sends requests
- Web API → Work-item API: dispatches HTTP
- Web API → Workspace authorization: authorizes workspace
- Work-item API → Native work provider: calls provider
- Work-item API → Work sessions: starts work sessions
- Work sessions → Native work provider: checks work reference
- User → Cognitive HTTP server: sends telemetry
- Cognitive HTTP server → Telemetry WebSocket: serves WebSocket
- Telemetry WebSocket → User: returns telemetry actions