Horizon
Horizon is the module in Pirivision where KPI widgets created in Cartography are placed into dashboard pages called boards. It uses the V1 layout engine (ResponsiveGridBoard) with a drag-and-drop grid holding up to 20 widgets per board. It is preferred for operator panels, shift reports, and quick single-screen KPI summaries.
flowchart LR
A[Port<br/>Data Source] --> B[Compass<br/>Query]
B --> C[Cartography<br/>KPI Widget]
C --> D[Horizon<br/>Board]
D -.more advanced.-> E[Atlas<br/>Dashboard]What You Can Do in Horizon
| Action | Description | Guide |
|---|---|---|
| Create Board | Set up a new Horizon board | Create Board |
| Widget Placement | Add Cartography widgets to the grid, drag-and-drop, resize | Widget Placement |
| Global Filters | Apply common parameters to the entire board (date range, etc.) | Global Filters |
| Captain AI | Chat over board data in natural language, XLSX export | Captain AI |
| PDF / PNG / XLSX Export | Export the board in report format | Export |
| User Sharing | Share a board with other users | Share |
| Folder / Management | Move, duplicate, delete board | Management |
Horizon List Screen
The main screen at /horizon/list consists of the following elements:
| Element | Description |
|---|---|
| Sidebar | Folder tree on the left edge |
| Breadcrumb | Current folder path at the top; clickable history |
| Search | Instant search by name and description |
| Filter Overlay | Owner filter (My / Shared / All), tag, status |
| Sort Overlay | Sort by name, creation date, last modified date |
| Create New Board | Starts a new board in the top-right |
| Board Cards | Name, description, usage, sharing badge, More menu for each board |
| Folder Cards | Folders — double-click to enter |
Prerequisite
At least one KPI widget must have been created in the Cartography module before using Horizon. If no widget exists, ModuleChainGuard will redirect you to the Cartography module.
Horizon vs Atlas
| Feature | Horizon (V1) | Atlas (V2) |
|---|---|---|
| Layout Engine | V1 (fixed cell) | V2 (proportional) |
| Max Widgets | 20 / board | Unlimited (practically) |
| Responsive Grid | Limited | Full support |
| Public Share | — | ✓ |
| Embed (iframe) | — | ✓ |
| User Share | ✓ | ✓ |
| Captain AI | ✓ | — |
| XLSX / PNG Export | ✓ | — |
| Multi-layer Panel | — | — |
| Ease of Use | Simple, fast | Flexible, comprehensive |
Which Module?
- Operator panel with 5–15 KPIs on a single screen → Horizon
- Public dashboard, mobile view, embed → Atlas
- AI-powered chat analysis, quick XLSX report → Horizon (Captain AI)
Next Step
Ecosystem & Related Modules
| Module / Feature | Relationship with Horizon |
|---|---|
| Captain AI | Analyze board data in natural language, get XLSX exports |
| Ecosystem | General overview of CaptainAI, Product Memory, and Automation |
| Automation | Connect the data your board widgets monitor to rule-based alerts |
| Atlas | Switch to Atlas for flexible layout, public links, and iframe embed |