How marioivanov063/custom-ai-chatbot works
Chorus lets chatbot owners configure an AI agent and its facts, share a public chat link, and review transcripts. Owners use the management UI and guests provide contact details before chatting; the guest page starts a session through GraphQL and sends messages to the separate Ollama proxy. GraphQL resolvers enforce ownership and access PostgreSQL through data modules. Session review and the scheduled session-ending and summarisation job are distinct product stages. Edges reflect shown imports/calls or README statements; the background-job internals are documented but unsampled.
Main entry points: apollo-client.ts GraphQL client · page.tsx Public chat page · route.ts GraphQL endpoint · (admin) Management pages
Components 20
Chatbot management
- Create chatbot
components/chatbots/create-chatbot-form.tsx - Edit bot and facts
components/chatbots/edit-chatbot-form.tsx - Management pages
app/(admin)
Guest conversations
- Public chat page
app/(guest)/chatbot/[id]/page.tsx - Start chat
lib/start-new-chat.ts - Message proxy
app/api/send-message/route.ts
Session review
- Review pages
app/(admin)/review-sessions - Session lists and transcript
components/sessions - End and summarise sessions
db/scripts/sweep-and-summarize.mjs
Application services
- GraphQL client
lib/apollo-client.ts - GraphQL endpoint
app/api/graphql/route.ts - GraphQL resolvers
app/api/graphql/resolvers.ts - Chatbot data access
lib/data/chatbots.ts - Session data access
lib/data/sessions.ts - User data access
lib/data/users.ts - PostgreSQL
Other components
- Chatbot owner
- Guest
- Ollama model
- Clerk identity
Connections 24
- Chatbot owner → Management pages: manages bots
README.md - Management pages → Create chatbot: renders
app/(admin)/create-chatbot/page.tsx - Management pages → Edit bot and facts: renders
app/(admin)/edit-chatbot/[id]/page.tsx - Create chatbot → GraphQL client: submits mutations
components/chatbots/create-chatbot-form.tsx - Edit bot and facts → GraphQL client: updates bot
components/chatbots/edit-chatbot-form.tsx - Chatbot owner → Review pages: reviews sessions
README.md - Review pages → Session lists and transcript: renders
app/(admin)/review-sessions/page.tsx - Session lists and transcript → GraphQL client: queries sessions
components/sessions/sessions-by-chatbot.tsx - Guest → Public chat page: opens shared link
README.md - Public chat page → GraphQL client: loads chatbot
app/(guest)/chatbot/[id]/page.tsx - Public chat page → Start chat: starts session
app/(guest)/chatbot/[id]/page.tsx - Public chat page → Message proxy: sends message
app/(guest)/chatbot/[id]/page.tsx - Message proxy → Ollama model: proxies prompt
README.md - GraphQL client → GraphQL endpoint: posts GraphQL
lib/apollo-client.ts - GraphQL endpoint → GraphQL resolvers: dispatches
app/api/graphql/route.ts - GraphQL resolvers → Chatbot data access: reads and writes bots
app/api/graphql/resolvers.ts - GraphQL resolvers → Session data access: reads sessions
app/api/graphql/resolvers.ts - GraphQL endpoint → User data access: resolves request user
app/api/graphql/route.ts - Chatbot data access → PostgreSQL: queries
lib/data/chatbots.ts - Session data access → PostgreSQL: queries
lib/data/sessions.ts - User data access → PostgreSQL: queries
lib/data/users.ts - End and summarise sessions → PostgreSQL: ends and summarises
README.md - End and summarise sessions → Ollama model: requests summaries
README.md - GraphQL endpoint → Clerk identity: uses identity
README.md