# Civitas

Civitas is Axon's people-operations module at `/app/civitas`.

## What Civitas covers

* PTO requests and approvals
* HR/certificate request handling
* General HR tickets
* Organization documents

## Access model

* Personal area: users can submit and track their own requests.
* Organization area: visible to roles with Civitas processing access.
* Processing controls and full profile-level people operations require `Manage Civitas`.

## Personal tab

Main features:

* PTO snapshot widgets:
  * Available PTO days
  * Next approved vacation period
  * Next public holiday (country + weekday)
* `Create new Civitas request` panel:
  * Supports PTO, certificate, HR, and general requests
  * Includes request metadata, title/description, and attachments
  * Closes automatically after successful submit
* `Latest requests` list with pagination (5 per page)
* Organization documents for personal/both audiences

## Organization tab

Main features:

* Organization widgets:
  * Pending request count
  * Next public holiday across configured office countries
* `Civitas processing queue`:
  * Latest 20 tickets, paginated
  * Filters by status and request type
  * Sort options (latest/oldest/status-first)
* Organization documents management:
  * Upload, audience targeting, and deletion

## Ticket lifecycle and details

* Statuses: `Pending`, `In Review`, `Approved`, `Rejected`, `Cancelled`
* Ticket detail includes:
  * Processing controls (status + assignee for processors)
  * Core fields (type, leave/certificate type, dates, manager/contact)
  * Attachments and comments
* Attachment behavior:
  * Users can manage attachments while ticket is open (`Pending`/`In Review`)
  * Processors can optionally save ticket attachments to user profile documents
* Comments:
  * Chronological thread with author and timestamp
  * Add and edit comment support
* Owner cancellation:
  * Allowed only while ticket is still open (`Pending`/`In Review`)

## Cross-module impact

* Home widget data:
  * Civitas requests and PTO widgets read from live Civitas ticket data
* Dashboard work status:
  * Next vacation reflects approved Civitas PTO
* Orbis + Locus booking impact:
  * Approved PTO blocks booking availability for affected dates
  * Existing overlapping bookings are cancelled automatically

## Related docs

* [Organization settings](/axon/dashboard/organization-settings.md)
* [People and teams](/axon/dashboard/people-and-teams.md)
* [Submit a Civitas request](/axon/task-guides/submit-a-civitas-request.md)
* [Process Civitas tickets](/axon/task-guides/process-civitas-tickets.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xdbx.gitbook.io/axon/app-modules/civitas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.