How andrewmbarros/nova works
NOVA is a support-inbox triage service: it fetches incoming mail, filters messages, identifies the customer or requests tax-ID clarification, then sends a reply and records a pre-ticket for ERP entry. Its README also describes escalation after failed or unanswered requests, customer/contact learning, and both IMAP/SMTP and Microsoft Graph modes. The main processor and several core modules are indexed as read, but not excerpted; their listed references and README support the broad links below, while unverified orchestration is shown dashed.
Main entry points: processor.py Triage processor · sender.py Mail gateway · repository.py Repository · worker.py Inbox worker
Components 27
Inbox intake
- Inbox worker
app/worker.py - Mail sources
app/email/sources.py - Message parser
app/email/parser.py - Incoming message
app/email/models.py
Triage and identity
- Triage processor
app/processor.py - Message filters
app/rules/engine.py - Blocklists
app/rules/blocklist.py - Tax ID validation
app/documents/validator.py - Company-name matching
app/customers/names.py - Customer group rules
app/customers/groups.py
Customer and records
- Contact resolution
app/customers/contacts.py - Customer lookup
app/customers/service.py - Repository
app/database/repository.py - SQL database
app/database/models.py - Conversation states
app/rules/states.py
Replies and integrations
- Reply templates
app/email/templates.py - Mail gateway
app/email/sender.py - SMTP service
- Microsoft Graph client
app/microsoft/graph.py - Microsoft Graph
Runtime and API
- Settings
app/config.py - Database connection
app/database/connection.py - FastAPI routes
app/api/routes.py - Email simulator
app/api/dev.py
Other components
- Email sender
- Support team
- ERP-ready pre-ticket
Connections 36
- Email sender → Mail sources: sends email
README.md - Inbox worker → Mail sources: fetches mail
app/worker.py - Mail sources → Message parser: parses messages
app/email/sources.py - Message parser → Incoming message: creates
app/email/parser.py - Inbox worker → Triage processor: dispatches for triage
- Triage processor → Message filters: filters through
app/processor.py - Triage processor → Blocklists: checks senders
app/processor.py - Triage processor → Customer group rules: checks group rules
app/processor.py - Triage processor → Contact resolution: resolves sender
app/processor.py - Triage processor → Tax ID validation: extracts and validates
app/processor.py - Triage processor → Company-name matching: matches signature
app/processor.py - Customer group rules → Customer lookup: looks up customer
app/customers/groups.py - Contact resolution → Repository: reads and learns links
app/customers/contacts.py - Contact resolution → Customer lookup: resolves linked customer
app/customers/contacts.py - Customer lookup → Tax ID validation: normalizes tax ID
app/customers/service.py - Triage processor → Repository: records processing
app/processor.py - Repository → SQL database: reads and writes records
app/database/repository.py - Triage processor → Conversation states: applies conversation states
app/processor.py - Triage processor → Reply templates: builds reply text
app/processor.py - Triage processor → Mail gateway: sends response
app/processor.py - Mail gateway → SMTP service: sends mail
- Mail gateway → Microsoft Graph client: uses Graph gateway
app/email/sender.py - Mail sources → Microsoft Graph client: fetches via Graph
app/email/sources.py - Microsoft Graph client → Microsoft Graph: calls API
app/microsoft/graph.py - Mail gateway → Support team: escalates to team
README.md - Mail gateway → Email sender: requests or confirms
README.md - Triage processor → ERP-ready pre-ticket: builds pre-ticket
README.md - Triage processor → Support team: hands over unresolved cases
README.md - Inbox worker → Repository: persists cursor and status
app/worker.py - Database connection → SQL database: initializes schema
app/database/connection.py - Settings → Inbox worker: configures inbox
app/worker.py - Settings → Mail gateway: configures gateway
app/email/sender.py - FastAPI routes → Settings: uses settings
app/api/routes.py - Email simulator → Triage processor: simulates email
app/api/dev.py - Email simulator → Repository: reads recorded results
app/api/dev.py - Email simulator → Mail gateway: uses outbox
app/api/dev.py