Getting started
On this page
This page takes a new installation from the first start to the first work ticket. It assumes the application is installed and reachable in a browser (Installation) and that you are the person who will be the first application administrator (Super Admin).
1. First start and the licence#
When the application has no valid licence, every page redirects to the Licenc (Licence) page with the message Az alkalmazás nem licencelt (The application is not licensed).
Click Új licenc fájl feltöltése (Upload a new licence file) and choose the licence file (.key) you received from WorkWise Solutions. While there is no valid licence, no sign-in is needed for this, so you can license the installation before any user exists. After a successful upload the page shows Licenc érvényes (Licence valid), the customer name, the start, expiry and renewal warning dates, and the licensed features.
The licence can also be uploaded through the API: send the file as the request body to POST /api/licensing/set (see Licence).
2. Create the first Super Admin#
With the default Local user store, the sign-in page asks for the first administrator on a new installation: Hozza létre az alkalmazás első admin felhasználóját (Create the first admin user of the application). Enter an e-mail address and a password twice, then click Beállít (Set up). This user gets the Super admin permission. Sign in with it.
With Active Directory, LDAP, Microsoft Entra ID or OAuth there is no setup form: the users and groups listed in AdminUsers / AdminGroups in appsettings.json become Super Admins when they first sign in (Authentication).
3. Check the basic settings#
Open Alkalmazás → App Konfiguráció (App configuration) and check these categories, then click Módosítás (Save):
- Cégadatok (Company details): company name, addresses, tax number, phone, e-mail, bank details, and the Azonosító (identifier) used as a prefix for ticket names. These appear on printouts and in e-mails to clients.
- Általános forgalmi adó (VAT): the VAT rate (27 % by default) and the currency label (Ft by default). A change applies to new prices only; existing tickets keep their values.
- Szolgáltatás felvételi lap (Intake sheet): turn it on if you want to print an intake acknowledgement for clients (Work tickets).
- Háttérfolyamatok (Background jobs): for example the reminder for tickets that have not changed for 5 days.
If the application sends e-mails (password reset, new-user details, client e-mails, low-stock warnings), the SMTP server in EmailSettings of appsettings.json must be set (Configuration).
4. Users and groups#
On Felhasználók (Users) create the people who will work in the application, and on Csoportok (Groups) put them into groups, for example Szerviztechnikusok (service technicians). Give application permissions only where needed: most users need only Public plus workspace roles (Permissions and roles, User management).
5. The first workspace#
A new installation already has one workspace, named Default. Rename it, or create new ones on Munkaterületek (Workspaces) with Új munkaterület hozzáadása (Add workspace). In the second step of the dialog, Hozzáférés-szabályozás (Access control), add users and groups and tick their roles, for example Admin for the team lead and Technikus for the technicians' group (Workspaces).
Optionally add a notification channel (e-mail, Slack or Teams) and a file storage to the workspace, or at application level for all workspaces (Notifications, File storages). Tickets work without them, but then nobody is notified and no attachments can be uploaded.
6. Master data#
Tickets pick their values from lists. Fill them before the first ticket:
- Gyártók & Típusok (Manufacturers and types): manufacturers, their product groups and product types.
- Munkajegy Konfigurációk: Garanciát Viselők (Guarantors, at least one, because the field is required; add one such as Ügyfél – saját költség for paid jobs), Munkajegy Típusok (Ticket types) and Munka Típusok (Work types, with the legal text printed on the summary).
- Optional: Ügyfelek (Clients). A ticket can also create the client from the data typed into it.
- Optional: Munkafolyamatok (Acting works), Szállítások (Deliveries) and Komponensek (Components) for the costs on tickets.
See Manufacturers and ticket options, Clients, Acting works and deliveries, Warehouse.
7. The first ticket#
- Open Adminisztráció → Munkajegyek (Work tickets). If no workspace is selected, click Változtatás (Change) next to Munkaterület at the top and choose one.
- Click Új munkajegy létrehozása (Create new work ticket).
- Fill in the name (a name is offered automatically), the problem description, and the client: either Kiválaszt (Select) an existing client or type a new one.
- Choose the ticket type, the work type, the guarantor, the manufacturer, product group and product type, and the status (Új, New).
- Under Munkát végző felhasználók/csoportok (Users/groups doing the work) add yourself or the responsible group.
- Recommended: add a notification channel under Értesítési beállítások and choose a file storage under Mellékletek (Attachments).
- Click Munkajegy létrehozása (Create work ticket).
The client gets a registration confirmation e-mail if an e-mail address is given and the SMTP server is configured. The assignees get a notification through the ticket's notification channels. From here, continue with Work tickets.