How aryannehe/synapse works
Synapse Workspace is an internal operations portal whose main workflows are employee knowledge search, support-ticket handling, and AI-assisted chat, alongside an admin analytics hub. Dashboard pages call shared services and workspace state; API routes enforce sessions and access MongoDB models, while AI routes use the Gemini integration. The README documents richer UI capabilities than the excerpts show; those are represented by their page components without inferring unshown internal flows.
Main entry points: serviceLayer.ts Workspace services · auth.ts Session and access · db.ts Database connector · route.ts Analytics API
Components 27
Workspace experience
- Analytics hub
src/app/(dashboard)/page.tsx - Profile settings
src/app/(dashboard)/profile/page.tsx - Workspace settings
src/app/(dashboard)/settings/page.tsx - Navigation bar
src/components/layout/Navbar.tsx - Workspace sidebar
src/components/layout/Sidebar.tsx - App providers
src/components/layout/Providers.tsx - Workspace services
src/services/serviceLayer.ts - Workspace state
src/store/useWorkspaceStore.ts - Analytics API
src/app/api/analytics/route.ts
Knowledge search
- Knowledge workspace
src/app/(dashboard)/knowledge/page.tsx - Knowledge API
src/app/api/knowledge/route.ts - Document records
src/models/Document.ts
Ticket operations
- Ticket board
src/app/(dashboard)/support/page.tsx - Ticket conversation
src/app/(dashboard)/support/[ticketId]/page.tsx - Ticket collection API
src/app/api/tickets/route.ts - Ticket detail API
src/app/api/tickets/[ticketId]/route.ts - Ticket records
src/models/Ticket.ts
AI assistant
- Prompt playground
src/app/(dashboard)/assistant/page.tsx - Assistant stream API
src/app/api/assistant/stream/route.ts - Markdown renderer
src/components/chat/MarkdownRenderer.tsx
Identity and data
- Authentication APIs
src/app/api/auth/login/route.ts - Session and access
src/lib/auth.ts - User records
src/models/User.ts - Database connector
src/lib/db.ts - MongoDB
- Gemini integration
src/lib/ai.ts
Other components
- Workspace user
Connections 42
- Workspace user → Analytics hub: views
- Workspace user → Knowledge workspace: searches
- Workspace user → Ticket board: manages tickets
- Workspace user → Prompt playground: prompts
- Analytics hub → Workspace services: requests stats
src/app/(dashboard)/page.tsx - Workspace services → Analytics API: fetches stats
src/services/serviceLayer.ts - Knowledge workspace → Workspace services: searches articles
src/app/(dashboard)/knowledge/page.tsx - Workspace services → Knowledge API: queries
src/services/serviceLayer.ts - Knowledge API → Session and access: checks session
src/app/api/knowledge/route.ts - Knowledge API → Database connector: connects
src/app/api/knowledge/route.ts - Knowledge API → Document records: searches and writes
src/app/api/knowledge/route.ts - Knowledge API → Gemini integration: generates answers
src/app/api/knowledge/route.ts - Ticket board → Workspace services: loads tickets
src/app/(dashboard)/support/page.tsx - Ticket conversation → Workspace services: updates ticket
src/app/(dashboard)/support/[ticketId]/page.tsx - Workspace services → Ticket collection API: requests tickets
src/services/serviceLayer.ts - Workspace services → Ticket detail API: requests ticket
src/services/serviceLayer.ts - Ticket collection API → Session and access: checks session
src/app/api/tickets/route.ts - Ticket collection API → Database connector: connects
src/app/api/tickets/route.ts - Ticket collection API → Ticket records: reads and writes
src/app/api/tickets/route.ts - Ticket detail API → Session and access: checks session
src/app/api/tickets/[ticketId]/route.ts - Ticket detail API → Database connector: connects
src/app/api/tickets/[ticketId]/route.ts - Ticket detail API → Ticket records: reads and updates
src/app/api/tickets/[ticketId]/route.ts - Prompt playground → Workspace services: streams response
src/app/(dashboard)/assistant/page.tsx - Workspace services → Assistant stream API: opens stream
src/services/serviceLayer.ts - Prompt playground → Markdown renderer: renders replies
src/app/(dashboard)/assistant/page.tsx - Assistant stream API → Gemini integration: uses AI
src/app/api/assistant/stream/route.ts - Knowledge workspace → Workspace state: uses state
src/app/(dashboard)/knowledge/page.tsx - Ticket board → Workspace state: uses state
src/app/(dashboard)/support/page.tsx - Ticket conversation → Workspace state: uses state
src/app/(dashboard)/support/[ticketId]/page.tsx - Prompt playground → Workspace state: uses state
src/app/(dashboard)/assistant/page.tsx - Workspace state → Authentication APIs: submits login
src/store/useWorkspaceStore.ts - Authentication APIs → Session and access: signs session
src/app/api/auth/login/route.ts - Authentication APIs → Database connector: connects
src/app/api/auth/login/route.ts - Authentication APIs → User records: checks user
src/app/api/auth/login/route.ts - Session and access → Database connector: connects
src/lib/auth.ts - Session and access → User records: loads user
src/lib/auth.ts - Database connector → MongoDB: connects
src/lib/db.ts - Analytics API → Session and access: checks session
src/app/api/analytics/route.ts - Analytics API → Database connector: connects
src/app/api/analytics/route.ts - Analytics API → Ticket records: aggregates tickets
src/app/api/analytics/route.ts - Analytics API → Document records: aggregates documents
src/app/api/analytics/route.ts - Analytics API → User records: counts users
src/app/api/analytics/route.ts