﻿# Getting started

> 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).

Source: https://workwise-solutions.net/docs/getting-started/ · Language: en · Hungarian version: https://workwise-solutions.net/hu/docs/getting-started/

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](https://workwise-solutions.net/docs/installation/requirements/)) and that you are the person who will be the first application administrator (Super Admin).

![From a new installation to the first work ticket](https://workwise-solutions.net/docs/images/diagram-getting-started-en.png)
*The seven steps of this page.*

## 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).

![Licence page of a new installation](https://workwise-solutions.net/docs/images/getting-started-licence-unlicensed.png)
*A new installation opens on the licence page.*

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](https://workwise-solutions.net/docs/features/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.

![First admin setup form](https://workwise-solutions.net/docs/images/getting-started-first-admin.png)
*The first-user form appears only while the local user store has no users.*

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](https://workwise-solutions.net/docs/installation/authentication/)).

## 3. Check the basic settings

Open **Alkalmazás → App Konfiguráció** ([App configuration](https://workwise-solutions.net/docs/features/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](https://workwise-solutions.net/docs/features/work-tickets/#printouts)).
- **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](https://workwise-solutions.net/docs/installation/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](https://workwise-solutions.net/docs/permissions-and-roles/), [User management](https://workwise-solutions.net/docs/features/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](https://workwise-solutions.net/docs/features/workspaces/)).

![Workspaces page](https://workwise-solutions.net/docs/images/workspaces-list.png)
*Two workspaces: Szerviz (Service) and Értékesítés (Sales).*

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](https://workwise-solutions.net/docs/features/notifications/), [File storages](https://workwise-solutions.net/docs/features/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:

1. **Gyártók & Típusok** (Manufacturers and types): manufacturers, their product groups and product types.
2. **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).
3. Optional: **Ügyfelek** (Clients). A ticket can also create the client from the data typed into it.
4. Optional: **Munkafolyamatok** (Acting works), **Szállítások** (Deliveries) and **Komponensek** (Components) for the costs on tickets.

See [Manufacturers and ticket options](https://workwise-solutions.net/docs/features/manufacturers-and-ticket-options/), [Clients](https://workwise-solutions.net/docs/features/clients/), [Acting works and deliveries](https://workwise-solutions.net/docs/features/acting-works-and-deliveries/), [Warehouse](https://workwise-solutions.net/docs/features/warehouse/).

## 7. The first ticket

1. 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.
2. Click **Új munkajegy létrehozása** (Create new work ticket).
3. 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.
4. Choose the ticket type, the work type, the guarantor, the manufacturer, product group and product type, and the status (*Új*, New).
5. Under **Munkát végző felhasználók/csoportok** (Users/groups doing the work) add yourself or the responsible group.
6. Recommended: add a notification channel under **Értesítési beállítások** and choose a file storage under **Mellékletek** (Attachments).
7. Click **Munkajegy létrehozása** (Create work ticket).

![Creating a work ticket](https://workwise-solutions.net/docs/images/tickets-new.png)
*A new, empty 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](https://workwise-solutions.net/docs/features/work-tickets/).

## Next steps

- [Super Admin guide](https://workwise-solutions.net/docs/guides/super-admin/)
- [Workspace administrator guide](https://workwise-solutions.net/docs/guides/workspace-admin/)
- [Ticket administrator and technician guide](https://workwise-solutions.net/docs/guides/ticket-admin-and-technician/)
