Documentation
Everything you need to know about Pomavo: from templates and workflows to projects, permissions, and beyond.
Welcome to the Pomavo documentation. Use the sections below to navigate to the topic you need, or use the sidebar to browse all pages.
Features
Templates
Define ticket types with custom fields, screens, icons, colors, and sequence numbers.
Workflows
Create state machines that control how tickets move through your process.
Template Links
Define relationships between ticket types: parent/child, blocks, duplicates, and more.
Tickets
The core unit of work: create, edit, comment, attach files, link, and track history.
Integrations
Machine identities, API keys, and the MCP server for AI-powered automation.
Permissions
Fine-grained access control with subject-action-resource model and public access.
Org Settings
Manage members, default permissions, join requests, export, and organization identity.
Search & Saved Queries
Full-text and structured search with a custom query language and saved filters.
Inbox
Real-time notifications for assignments, comments, mentions, state changes, and more.
Projects
Projects Overview
Organize work into projects with iterations, boards, backlogs, and timelines.
Scrum Board
Sprint-based agile boards with burndown charts and iteration management.
Kanban Board
Continuous-flow boards with column configuration and WIP visibility.
Backlog
Prioritize and groom upcoming work before pulling it into a sprint or board.
Timeline
Gantt-style view for planning work across time with date-based ticket fields.
Automation
Automations
Build event-driven, no-code workflows with a visual node-graph editor.
Node Reference
Every trigger, action, condition, logic, math, list, and data node in one place.
Schedulers
Run automations on a recurring cron schedule or after a delay.
Ticket Locks
Restrict edits to fields, links, attachments, transitions, and comments.
Platform & Administration
Plugins & Marketplace
Extend Pomavo with sandboxed, installable plugins and widgets.
GitHub Plugin
Link commits, branches, and pull requests to tickets via ticket keys.
MCP & AI Integration
Connect AI assistants to Pomavo through the Model Context Protocol server.
Admin Dashboard
Operational tooling for background jobs, search index, and object storage.
Quotas & Tiers
Per-organization usage limits, rate windows, and subscription tiers.
Analytics & Customization
Reports
Sprint burndown, velocity, and workload metrics with an inline report pane.
Themes
Choose from multiple color themes or let it follow your system preference.
Architecture
Go under the hood, how Pomavo is built, where data lives, and the principles that keep it fast, multi-tenant, and extensible.
Architecture Overview
Service topology, data stores, messaging, and core design principles.
Automation Engine Internals
Typed node contracts, the resolution pipeline, the orchestrator, and runtime shape validation.
The Job Pipeline
How an event becomes a durable background job, gets executed, and fans out into sub-jobs.
Search Internals
Lexing, parsing, and translating the query language into Elasticsearch and aggregations.
Extensibility Internals
The plugin SDK protocol, the iframe sandbox, manifests, and integration surfacing.
Security Model
Identity, tokens, API keys, permissions, sandboxing, and tenant isolation.