Pocro Vento Documentation

Technical documentation for the Events and Employee evaluation app

Version Commit: 4c93c29

Generated: 2026-06-17

1. Introduction

This is the starting point for the new project documentation. Add content through Decap CMS or directly in docs/content.

2. General

2.1 Dictionary

Application

Refers to the custom-made application that is the subject of this document. Application management interface is private: only authenticated and authorized users can access it.

Brand

Refers to Porsche Croatia brands: Volkswagen (VW), Volkswagen Gospodarska vozila (VW GV), Škoda, Seat, Cupra, Audi. Every brand has a name and a code.

Client

Porsche Croatia d.o.o.

User

Each authenticated user of the application.

Brand manager

Users of the app that mostly manages events.

Promotor

Promotors working on events that scan the QR codes of invitees and manages the signing of the document.

Invitees

Visitors of the event that need to sign the documents.

3. Events

3.1 QR Codes

  • QR codes are generated by the app

  • Each invitee has a unique QR code for each event

  • QR code is accessible on the invitee detail page in the app

  • When the QR code is scanned, the invitee profile for the specific event is shown

  • User must be signed in to see the invitee profile

  • After the event is done, the QR codes can stop working

4. Fleet

4.1 Calendar

The calendar shows the booking status of all vehicles from the general inventory (Inventar / Popis vozila), regardless of which area they’re designated for — both Vozni park vehicles and Događaji (Events) vehicles appear on the same calendar.

Vehicles are grouped into two sections (this is defined when user adds a new vehicle to the general vehicle inventory):

Vozni park – further grouped by purpose (Namen): IT, Postprodaja, Novinarji, Veliki kupci, etc., with a vehicle count shown per group. *NICE TO HAVE, can be left out

Događaji

For each vehicle, the calendar shows:

Brand, model and registration plate as the row label.

A timeline with a colored bar (blue color) for each reservation in Vozni park, labeled with the renter or customer name (e.g. “Jutranji list,” “Ana Horvat”) spanning the booked dates.

A timeline with a colored bar (green color) for each period the vehicle is added to an event.

Periods where the vehicle is marked “Neispravno” (red color) on its inventory page are also shown as a blocked period directly on the timeline – vehicle set as “Neispravno” is shown as Neispravno for all the future dates.

We do not show vehicles that were picked-up/returned by the pick-up/return record on the calendar. If the wish is to have accurate calendar, the Manager of vozni park should manually change the reservation dates (if there was a change from reservation to actual pick-up/return).

Past reservations can also be edited.

If user wants to add a car as “out of order” for a certain period, they need to make a new reservation for that period and write “Odjava”/”Out of order” or similar as the customer name (shown in blue color).

Hovering over a vehicle shows a tooltip with additional vehicle info: chassis number and color.

Clicking an existing reservation bar opens a menu with options to edit the reservation, open its handover protocol (“zapisnik o preuzimanju”), or remove the reservation.

A filter at the top of the page allows filtering the calendar view by brand. *NICE TO HAVE FUNCTIONALITY

5. Vehicle Inventory

5.1 Vehicle Inventory List

The general vehicle inventory is the master list of all vehicles available across the application (accessible via “Inventar” in the main navigation).
On events vehicles are selected from this list. On Vozni park we show all the vehicles from this list.

The list contains the following information per vehicle:

Brand

Type/Model

Registration plate

Chassis number

Color

Status (Aktivno / Zauzeto / Neispravno)

Status Aktivno / Neispravno is manually chosen from the edit vehicle page. Status Zauzeto is automatically set if the vehicle is used on an event or reserved/picked-up in Vozni park.

User can:

View all vehicles in the inventory (paginated list)

Search vehicles

Filter vehicles by brand

Filter to show arhived or to not show arhchived vehicles

Add a new vehicle (“Unesi vozilo”)

Edit an existing vehicle (“Uredi vozilo”)

Delete a vehicle from the inventory (“Ukloni vozilo”)

Arhive a vehicle from the inventory (“Arhiviraj vozilo”)

Deleting and archiving a vehicle

If the vehicle has never been added to an event, it can be permanently deleted (“Ukloni vozilo”).

If the vehicle has already been added to an event, it can only be archived (“Arhiviraj vozilo”) – permanent deletion is not available, since its booking history needs to be kept.

The default view on the vehicle inventory list excludes archived vehicles. A filter (“Prikaži arhivirana vozila”) lets the user include them.

Archived vehicles are not shown anywhere else in the app where vehicles can be selected – e.g. when adding vehicles to an event, or when creating a Vozni park reservation.

If the vehicle is “In use” it cannot be deleted or arhiced – this option is not available.

If the vehicle has active reservations for event or vozni park it cannot be deleted or arhived – we show a notification in a modal window.