How joshua00ralph/sunny-spark-builder works
AssetOctopus is a multi-tenant asset-management and administration application. Users work in a React console to manage the asset directory, imports, audits, lifecycle and reporting; the self-hosted API handles requests and persists tenant-scoped data. The repository also includes authentication/SSO, integrations and webhooks, background jobs, and platform administration. The frontend API client documents fetch-based communication with the self-hosted backend, but the sampled material does not show its exact route dispatches, so that link is marked unverified. Several capability nodes are based on the file tree rather than inspected implementations.
Main entry points: db.ts PostgreSQL · index.ts HTTP service · api-client.ts API client · directory.routes.ts Directory API
Components 22
Console
- Application routes
src/routes - Sign-in
src/routes/auth.tsx - Supabase client
src/integrations/supabase/client.ts - API client
src/lib/api-client.ts - Directory screens
src/routes/directory.tsx - Site-sweep audits
src/routes/audits.site-sweeps.tsx
API and identity
- HTTP service
server/src/index.ts - Authentication and SSO
server/src/auth/index.ts
Asset workflows
- Directory API
server/src/routes/directory.routes.ts - Import API
server/src/routes/import.routes.ts - Import processing
server/src/services/import-service.ts - Retention and recovery
server/src/routes/lifecycle.routes.ts - Asset search
server/src/search/search-service.ts
Platform capabilities
- Tenant administration
server/src/routes/admin.routes.ts - Webhook delivery
server/src/webhooks/engine.ts - Background jobs
server/src/jobs/queue.ts - Email service
server/src/email/email-service.ts
Runtime services
- PostgreSQL
server/src/db.ts - Tenant context
server/src/tenancy.ts - File storage
server/src/storage
Other components
- Console user
- Webhook endpoints
Connections 20
- Console user → Application routes: uses
- Console user → Sign-in: signs in
- Sign-in → Supabase client: authenticates
src/routes/auth.tsx - Application routes → API client: requests data
src/routes/auth.tsx - API client → HTTP service: calls API
- HTTP service → Directory API: routes requests
server/src/index.ts - HTTP service → Import API: routes requests
server/src/index.ts - HTTP service → Authentication and SSO: routes requests
server/src/index.ts - Directory screens → API client: loads assets
- Site-sweep audits → API client: loads audits
- Directory API → PostgreSQL: reads and writes
server/src/routes/directory.routes.ts - Directory API → Tenant context: resolves tenant
server/src/routes/directory.routes.ts - Import API → Import processing: delegates import
- Import processing → PostgreSQL: persists records
server/src/services/import-service.ts - Retention and recovery → PostgreSQL: manages records
server/src/routes/lifecycle.routes.ts - Tenant administration → PostgreSQL: reads and writes
server/src/routes/admin.routes.ts - Tenant administration → Tenant context: resolves tenant
server/src/routes/admin.routes.ts - Webhook delivery → PostgreSQL: queues deliveries
server/src/webhooks/engine.ts - Background jobs → File storage: uses storage
server/src/jobs/queue.ts - Webhook endpoints → Webhook delivery: triggers delivery