Tickets
Create, view, and manage tickets with rich fields, comments, attachments, links, and full history.
Overview
Tickets are the core work items in Pomavo. Each ticket is based on a template that defines its fields, workflow, and visual identity. Tickets support rich content including comments with reactions, file attachments, cross-ticket links, and a complete audit history.
Creating Tickets
Create tickets from anywhere using the global create dialog. Select a template, fill in required fields, and optionally assign it to a project and iteration.
Key features of ticket creation:
- Template selection: Choose the ticket type, such as Bug Report, Task, or Epic
- Dynamic fields: Only fields defined in the template's create screen are shown
- Project & Iteration: Assign directly to a project and sprint
- Pre-creation attachments: Upload files before the ticket is saved using a client-generated ID for linking
- Linked ticket creation: Create and link tickets in one flow
Ticket Detail View
The ticket detail page has three main areas:
Header
- Sequence number, such as BUG-00001, with template icon and color
- Title with inline editing
- Workflow state transition buttons showing all available next states
Content Area
- Rich text description with @mentions, ticket references, and inline attachments
- Comments section with threaded replies and reactions
- History/audit trail tab showing all changes
- Linked tickets section
- Attachments gallery
Sidebar
- All template fields rendered according to the detail screen layout
- Fields are organized into named sections
- Inline editing for all field types
Ticket Detail Pane
When browsing boards or lists, click a ticket to open it in a split-view preview pane without leaving your current context. The pane shows the full ticket detail with all fields, comments, and actions.
Comments
Comments support rich text with full formatting, @mentions, and inline attachments.
Threaded Replies
Reply to any comment to create a threaded conversation. Replies are visually nested under the parent comment.
Reactions
React to comments using emoji reactions. Available reactions include thumbs up, heart, smile, party popper, rocket, and eyes. Each user can add multiple different reactions to a comment, and clicking an existing reaction toggles it.
Editing & Deletion
Edit your own comments at any time, edited comments are marked with an "edited" indicator. Delete comments when they are no longer relevant.
Attachments
Attach files to tickets for supporting documentation, screenshots, logs, and more.
Upload Methods
- Drag and drop: Drop files directly onto the ticket detail view
- Inline embedding: Paste or drop images directly into the rich text editor
- Upload button: Traditional file picker
Thumbnails
Uploaded images automatically generate thumbnails in two sizes:
- Preview: 256x144, used in the attachment gallery
- List Icon: 48x48, used in compact list views
Reference Tracking
Attachments embedded in rich text fields or comments are tracked via reference counting. This ensures attachments are properly managed even when removed from content.
Presigned URLs
All file uploads and downloads use presigned URLs via MinIO object storage, ensuring secure and efficient file transfer without passing files through the API server.
Ticket Links
Link tickets together to model dependencies, hierarchies, and relationships. See the Template Links page for details on configuring link types.
Link Operations
- Create links from the ticket detail view
- Choose link type and direction, such as "blocks" versus "is blocked by"
- Navigate between linked tickets with a single click
- Update or remove links as relationships change
Ticket History
Every ticket maintains a complete audit trail of all changes:
- Creation: Initial field values when the ticket was created
- State Changes: Workflow transitions with from/to states
- Field Changes: Individual field modifications with old and new values
- Comments: When comments are added, edited, or deleted
- Links: When links are created, modified, or removed, including direction and relation details
- Attachments: When files are uploaded or deleted
History entries are grouped by event for unified display, showing who made the change and when.
Following
Follow a ticket to receive inbox notifications for all activity on it. You are automatically followed on tickets you create, are assigned to, or comment on. Use the follow button to manually subscribe or unsubscribe.
Rich Text Features
All textarea and comment rich text fields support:
- @Mentions: Type
@to mention team members, triggering inbox notifications - Ticket References: Type a sequence number to create a clickable link to another ticket
- Inline Attachments: Paste or drop images directly into the editor
- Full Formatting: Headings, bold, italic, lists, code blocks, links, and more