How idlanyor/zapota works
Kanata is a WhatsApp bot with a plugin-command workflow, local bot state, and optional HTTP/Socket.IO interfaces. Its separate Kanata Core service provides identity, user, session, and finance APIs to the bot and PHP client; finance extraction remains in the bot before storage in Core. The graph also preserves major command capabilities and the Werewolf game subsystem. Relationships for unsampled command families and PHP pages are based on README statements; source excerpts show selected runtime calls, not every route.
Main entry points: messageHandler.js Message handler · app.js Core HTTP API · commands Command plugins · pool.js MariaDB access
Components 25
WhatsApp bot runtime
- Transport adapters
src/wa/client.js - Message handler
src/handlers/messageHandler.js - Message flow
src/handlers/messageFlow.js - Command loader
src/lib/commands.js
Bot capabilities
- Command plugins
src/commands - AI commands
src/commands/ai/ds.js - Media downloaders
src/commands/downloader - Group commands
src/commands/group - Finance commands
src/commands/finance - Werewolf game
src/games/werewolf/service.js
Bot state and APIs
- Finance extraction
src/services/financeService.js - Bot database
src/database/adapter.js - Bot webhook
src/services/webhookApi.js - Core API client
src/services/kanataCore.js
Kanata Core
- Core HTTP API
core/src/app.js - Service authentication
core/src/security/authenticateService.js - Identity service
core/src/identity/service.js - User service
core/src/users/service.js - Finance service
core/src/finance/service.js - MariaDB access
core/src/database/pool.js
PHP web client
- PHP web pages
php_client/index.php - PHP Core client
php_client/includes/api.php
Other components
- WhatsApp user
- External integrations
Connections 30
- WhatsApp user → WhatsApp: sends messages
README.md - WhatsApp → Transport adapters: transports messages
README.md - Transport adapters → Message handler: delivers events
README.md - Message handler → Message flow: delegates processing
src/handlers/messageHandler.js - Message handler → Command loader: dispatches commands
src/handlers/messageHandler.js - Command loader → Command plugins: loads plugins
README.md - Message handler → Bot database: saves messages
src/handlers/messageHandler.js - Message flow → AI commands: requests AI response
src/handlers/messageFlow.js - Message handler → Werewolf game: routes game events
src/handlers/messageHandler.js - Finance commands → Finance extraction: extracts transactions
README.md - Finance extraction → Core API client: stores finance data
README.md - Command plugins → Media downloaders: provides download commands
README.md - Command plugins → Group commands: provides group tools
README.md - Command plugins → Finance commands: provides finance tools
README.md - Command plugins → External integrations: uses integrations
README.md - Core API client → Core HTTP API: sends HMAC requests
README.md - PHP web pages → PHP Core client: requests data
php_client/index.php - PHP Core client → Core HTTP API: sends HTTP requests
README.md - PHP web pages → Bot webhook: requests bot operations
README.md - Core HTTP API → Service authentication: authenticates services
core/src/app.js - Core HTTP API → Identity service: resolves identities
core/src/app.js - Core HTTP API → User service: handles user routes
core/src/app.js - Core HTTP API → Finance service: handles finance routes
core/src/app.js - Service authentication → MariaDB access: checks client records
core/src/security/authenticateService.js - Identity service → MariaDB access: reads and writes identities
core/src/identity/service.js - User service → MariaDB access: uses database queries
core/src/users/service.js - Finance service → MariaDB access: uses database queries
core/src/finance/service.js - MariaDB access → External integrations: connects to MariaDB
README.md - Bot webhook → Core API client: forwards Core requests
src/services/webhookApi.js - Message handler → WhatsApp: sends replies