FixControl User Manual

A guide for new users — how to set up your company in the admin panel and how to work with defects day to day in the app (Windows / Android).

Table of Contents

1. Introduction
2. Company registration and login
3. Admin panel — first steps
4. Estates — how to add
5. Buildings — how to add
6. Locations and floor plans
7. Defect types
8. Contractors and contractor accounts
9. Roles and permissions
10. Users (sub-accounts) and building access
11. Adding a defect in the app
12. Defect statuses
13. Working on the floor plan
14. Export and reports (XLSX / PDF)
15. My account

1. Introduction

1.1 What is FixControl

FixControl is a system for recording and tracking construction defects. Defects are marked on building floor plans, assigned to contractors, and their status is tracked — from being reported, through repair, to confirmed closure.

1.2 Data structure — from company to defect

Data in the system is organized hierarchically:

Company
 └─ Estate (optional — groups buildings, e.g. "Sunny Estate")
     └─ Building (e.g. "B15")
         └─ Location / floor plan (e.g. "0p", "1p", "dach", "M12")
             └─ Defect

• Company — your organization. All data (buildings, defects, users) is visible only to people from your company.
• Estate — an optional level that groups buildings. If you're building only one building or don't need grouping, you can skip it entirely.
• Building — e.g. a specific block/building on the construction site.
• Location (floor plan) — the plan of a floor, apartment, or other area on which defects are marked. Each location can have an uploaded plan (PDF/PNG).
• Defect — a single entry: description, type, status, contractor, optional photo, and position on the plan.

1.3 Two places to work: the app and the web panel

• App (Windows / Android) — day-to-day work on site: adding defects, marking them on floor plans, changing statuses, taking photos, exporting reports.
• Web panel (https://fixcontrol.pl/app/panel) — company configuration: estates, buildings, locations/floor plans, contractors, users, roles and permissions, invoice data.

Most of the actions described in points 4–10 are performed in the web panel, as an administrator. Points 11–12 cover day-to-day work in the app.

2. Company registration and login

2.1 Registering a new company (web panel)

1. Go to https://fixcontrol.pl/app/register.
2. Fill in the fields:
3. Company name
4. Email and Repeat email (must match)
5. Your name (e.g. "John Smith") — this will be the administrator's login
6. Password and Repeat password
7. Check both checkboxes: acceptance of the Terms of Service and acknowledgement of the Privacy Policy.
8. Click "Register company".

After registration, the company account starts with a trial period — information about the number of trial days and plans is shown on the registration and pricing pages.

2.2 Logging in to the web panel

1. Go to https://fixcontrol.pl/app/login.
2. Enter your Email and Password, then click "Log in".
3. The administrator lands on /app/panel, other users land on /app/konto.

The "Forgot your password?" link leads to a password reset. The "New company?" link leads to registration.

2.3 Logging in to the app (Windows / Android)

1. Open the FixControl app.
2. In the "Email or login" field, enter:
3. your email (administrator / sub-account), or
4. your login — for contractor accounts (see point 8), which do not use an email address as their login.
5. Enter your Password and click "Log in".

The server address is built into the app — no configuration is needed.

3. Admin panel — first steps

After logging in as an administrator, the panel (/app/panel) has a sidebar menu with the following tabs:

Most forms save automatically — after entering a value and pressing Enter / clicking outside the field (e.g. renaming, role dropdown, building checkboxes). Where relevant, a short confirmation message appears next to the field for 3 seconds — the page does not reload.

If you log in as a sub-account (not an administrator), you will only see the My account tab (/app/konto) — see point 15.

Plan limits: if a message about exceeding a plan limit appears (e.g. number of floor plans, defects, contractor accounts, or sub-accounts), adding new data of that type is blocked until the plan is upgraded ("Company data" tab → "Subscription" → "Pricing / change plan").

4. Estates — how to add

An estate is an optional level that groups buildings (e.g. when you're building several buildings as part of one development). If you don't need it, skip this point — buildings without an estate work normally.

1. In the panel, go to the "Buildings and estate assignment" tab.
2. In the "Estates" section, click "Add".
3. Fill in:
4. Short name — required, a short name used in lists and report file names
5. Full name — optional, the full name of the development (e.g. "Sunny Hill Estate")
6. Save the form.

The newly added estate will appear in the list as a label with a ✏ icon — clicking it opens the rename form (the same two fields, "Save" button).

5. Buildings — how to add

1. In the panel, go to the "Buildings and estate assignment" tab.
2. In the "Buildings" section, click "Add".
3. Fill in:
4. Building — the building's name (e.g. "B15")
5. Estate — an optional dropdown; choose an estate or leave it as "— no estate —"
6. Click "Add".

The new building appears in the buildings table:

• Estate — a dropdown for assigning the estate, saved automatically on change.
• "Archive" — moves the building to the archive (the building is no longer visible in day-to-day work, but the data is not deleted; archived buildings are greyed out and marked "arch."). The "Restore" button in the archive undoes this.
• "Delete" — permanently deletes the building together with its locations, defects, defect history, and permissions for that building. If the building has any defects, the panel will warn you about this before deletion — the operation cannot be undone.

After adding a building, go to point 6 to add locations (floors/apartments) and upload their plans.

6. Locations and floor plans

A location is a single floor, apartment, or other area of a building on whose plan (the "floor plan") defects are marked.

6.1 Adding a location in the panel

1. In the panel, go to the "Drawings / locations" tab.
2. Click "Add" — a form for adding rows will appear.
3. For each location, fill in the row:
4. Estate (if the company has estates) — filters the list of buildings to choose from
5. Building — choose from the list
6. Name — a short name/slug, e.g. 0p, 1p, dach, m12
7. Floor plan type — see point 6.2
8. Storey number — visible only when the type is "Storey"
9. Floor plan (optional) — you can drop or select a PDF/PNG plan file right away
10. Click "+ Add row" to add another location to the same form (useful when setting up multiple floors at once).
11. Finally, click "Add all".

6.2 Floor plan type and storey level

Each location has an assigned floor plan type, which determines how it is sorted in lists, PDF reports, and on the floor plan view:

For the "Storey" type, the "Storey number" (level) field accepts: - whole numbers: -1, 0, 1, 2, … - half-floors: 1,5 or 1.5 - the word "parter" (ground floor) — corresponds to level 0 - the word "dach" (roof) — always sorted last, regardless of floor numbering

Storeys are always sorted (in lists, on the floor plan view, in PDFs) in ascending order by level, with "dach" always last. Apartments and "Other" locations are sorted alphabetically by name.

The type and level can be changed at any time in the locations table ("Floor plan type" column) — the change saves automatically when selected from the list / when the field loses focus.

6.3 Uploading / changing a floor plan in the panel

If a location does not yet have an uploaded plan (the "Floor plan" column shows "None"):

1. Click "↑ Upload / Change" next to the location.
2. Choose a PDF or PNG file with the floor/apartment plan.

The plan is converted automatically (PDF → PNG, max. 2048 px). After uploading, the "Floor plan" column shows "Uploaded". To replace the existing plan with a new one, use the same button again. The "✕" button removes the uploaded plan from the location (with confirmation).

6.4 Uploading a floor plan from the app

A plan can also be added/replaced directly from the app, without going into the panel:

1. On the home screen (Dashboard), click the "Floor plan" button in the top menu.
2. Select "Add floor plan".
3. (optional) select an estate to narrow down the list of buildings.
4. Select the building.
5. Enter the location name (e.g. -1p, 0p, +1p) — it will be saved as a slug.
6. Select the floor plan type (Storey / Apartment / Other); for a storey, enter the level.
7. Click "Choose file (PDF or PNG)" and select the plan file.
8. After uploading, you'll see the confirmation "Floor plan uploaded successfully".

If a location does not yet have any floor plan, the floor plan screen will show a "No floor plan uploaded" message with a prompt to upload one — filters and navigation remain available.

7. Defect types

Defect types are a list of categories to choose from in the defect form (e.g. "Realizacja", "Odbiorowa"). Each company has its own list.

1. In the panel, go to the "Defect types" tab.
2. To add a new type: click "Add", enter the name, confirm.
3. To rename an existing type: click ✏ next to the type, change the text, click "Save".
4. To delete a type: click "×" next to the type (with confirmation).

At least one defect type must remain — the last remaining type cannot be deleted.

New companies start with the default types "Realizacja" and "Odbiorowa". The list of types is fetched automatically by the app on startup and shown in the defect form.

8. Contractors and contractor accounts

8.1 What is a "contractor"

A contractor is a company, subcontractor, or crew responsible for fixing defects (e.g. "Smith Electrics", "XYZ Company — plumbing"). Each defect can have an assigned contractor — this makes it easier to filter defects and generate reports per contractor.

8.2 Adding a contractor in the panel

1. In the panel, go to the "Contractors" tab.
2. Click "Add".
3. Fill in:
4. Name — required
5. Email — optional (see below for what it's used for)
6. Click "Add".

The name and email can be edited directly in the table (saved automatically when the field loses focus). The "Delete" button removes the contractor — if it has assigned defects, the panel will show a warning about how many defects will be unassigned (the defects themselves are not deleted, only the contractor assignment is removed).

8.3 Contractor user account ("repair contractor")

If a contractor has an email set, the system can create a login account for them in the app with the "naprawiający" (repair contractor) role — so they can change the status of their own defects themselves (e.g. mark "Mark done") without access to the full panel.

How to create a contractor account:

1. In the "Contractors" table in the panel, if a contractor doesn't have an account yet, the "Login" column shows an "Add account" button.
2. Click it — the account is created automatically:
3. Login = company-name-contractor-name (generated automatically, without underscores)
4. A temporary password is generated automatically
5. The contractor receives a welcome email with the login, temporary password, a link to download the app, and information about the need to change the password
6. The login can be changed later directly in the table (editable field, saved automatically).

Without an email set, the "Add account" button won't work — the email is needed only to send the login details; it is not used for logging in (login is via the login field, not by email).

What a contractor account sees after logging in:

• The default "naprawiający" (repair contractor) role has the following permissions: view defects, change status to "Mark done" and "Reopen" (see point 9 for permission details).
• It does not see the admin panel — only /app/konto (password change, and possibly renaming assigned locations/contractors, if it has access to them).
• Visibility of buildings depends on assigned permissions (see point 10) — by default, a new contractor account has no assigned buildings, and this must be configured manually in the users table.

8.4 Adding a contractor "on the fly" from the app

While adding/editing a defect in the app, if the contractor you need isn't on the list:

1. In the defect form, next to the "Contractor" field, click "+".
2. Enter the name of the new contractor and optionally a "Contractor email (optional)".
3. Click "Add" — the contractor is created immediately (along with a "repair contractor" account, if an email was provided — see above) and automatically selected in the form.

If the entered name is very similar to an existing contractor, the app will show a warning about a possible duplicate and ask for confirmation.

9. Roles and permissions

9.1 Built-in roles

Every company has three roles by default (in addition to the admin role, which always has all permissions and requires no configuration):

9.2 What each permission means

For the detailed status and button flow, see point 12.

9.3 Creating a custom role

1. In the panel, go to the "Company users" tab.
2. In the "Roles and permissions" section, click "Add".
3. Enter the role name and check the boxes for the relevant permissions (View, Add, Repair, Reopen, Complete).
4. Click "Add".

The new role will appear as another row in the roles table and will be available for selection when adding/editing users.

9.4 Changing a role's permissions

In the roles table, each role/permission combination is a checkbox — checking or unchecking it saves the change automatically.

• The "admin" role has no row in this table — it is protected and always has all permissions.
• A role can be deleted with the "Delete" button (with confirmation), as long as it is not currently assigned to any user.

10. Users (sub-accounts) and building access

10.1 Adding a new user

1. In the panel, go to the "Company users" tab.
2. Click "+ Add user" — a dialog will open.
3. Fill in:
4. Email address — will be the login for the panel and the app
5. Full name
6. Temporary password and Repeat password (min. 6 characters)
7. Role — choose from the company's list of roles or "Administrator"
8. In the "Buildings (sub-account)" section, check the buildings the user should have access to. Buildings are grouped by estate — the "whole estate" button selects all buildings of that estate with one click.
9. Click "Add and send email".

The user will receive an email with their login details and a request to change their password.

Building access does not apply to the "Administrator" role — admins see all of the company's buildings. For other roles: no buildings checked = no access to any defects/floor plans.

10.2 Changing the role and access of an existing user

In the "Company users" table:

• Role — a dropdown for each non-administrator; the change saves automatically. An admin cannot change the role of another admin or their own role.
• Buildings (sub-account) — building checkboxes (grouped by estate, with a "whole estate" button); the change saves automatically shortly after the last click.
• Status — indicates whether the account is active.
• "Deactivate" / "Activate" — blocks/unblocks login without deleting the account.
• "Delete" — permanently deletes the account (with confirmation).

10.3 Requesting access (for sub-accounts)

If a logged-in user (sub-account) doesn't have access to all the buildings they need, they can request access themselves:

1. Go to /app/konto.
2. In the "Building access" section, you'll see a list of buildings you already have access to (green labels).
3. If there are buildings without access, a "Request access" section will appear with a list of checkboxes — check the buildings you need.
4. Click "Send request".

A message will be sent to the email addresses of all active administrators of the company (who have an email set). There is no in-app notification — the administrator must grant access manually in the panel (point 10.2).

11. Adding a defect in the app

11.1 From the home screen (Dashboard)

1. On the home screen, click the "Add" button (bottom right corner, "+" icon).
2. Fill in the form (see point 11.3).
3. Click "Save".

11.2 From the floor plan

1. Go to the "Floor plan" screen for the chosen location.
2. Tap the spot on the plan where the defect is — a new defect form will open with the position on the plan already set.
3. Fill in the form and save — the defect will appear on the plan as a point.

Alternatively (Windows): you can drag a defect photo from File Explorer straight onto the floor plan — the form will open automatically with the photo attached and the position set to where it was dropped.

Defects without an assigned position on the plan are visible in the "Unplaced" side panel — they can later be dragged to the correct spot on the plan.

11.3 Defect form fields

* required fields.

Important: if a defect is already placed on the plan (has an x/y position), the "Description" field is locked for editing — it can only be set when creating the defect or before placing it on the plan. The other fields (type, status, contractor, photo) can always be edited.

11.4 Adding a photo

In the defect form, in the photo section:

• "Take photo" — opens the device camera.
• "Add from gallery" — choose an existing file.
• If the defect already has a photo, the buttons change to "Change photo".

The photo is automatically compressed before being uploaded.

12. Defect statuses

12.1 Status list

Colors on the floor plan: Open = orange, Done = blue, Completed = green.

12.2 Status change flow (buttons)

            [Mark done]               [Confirm completion]
  Open     ───────────▶  Done      ───────────────────────▶  Completed
     ▲                       │                                    │
     │      [Reopen]         │                                    │
     └───────────────────────┘                                    │
     ▲                                  [Revert to open]           │
     └───────────────────────────────────────────────────────────┘

• "Mark done" (blue button) — visible for Open defects; changes the status to Done.
• "Reopen" (orange) — visible for Done defects; changes the status back to Open (e.g. when the repair was not sufficient).
• "Confirm completion" (green) — visible for Open and Done defects; changes the status to Completed (e.g. when the recipient immediately confirms that the defect doesn't exist or has been fixed).
• "Revert to open" — visible for Completed defects; restores the status to Open (e.g. when the defect reappears).

The status buttons are available on the home screen (defect card), on the floor plan (details panel), and in the defect edit form — they work the same way everywhere.

12.3 Permissions required to change status

Each button requires the corresponding permission on the user's role (see point 9.2):

If the user does not have the required permission, the corresponding button is not available.

13. Working on the floor plan

The "Floor plan" screen shows the plan of a floor/apartment with defects marked as colored dots (color according to status — see point 12.1).

• Filters (bar below the top menu): Estate (if the company has estates) → Building → Location → Contractor → Type → Status. Selecting a different location switches the view to its plan.
• "Unplaced" panel (right side) — defects without a set position on the plan; they can be dragged onto the plan to place them. On desktop, the panel can be shown/hidden with the button on the right edge of the screen.
• Clicking a dot opens the defect details panel — description, status, contractor, photo, status change buttons, a "Remove from plan" button (the defect returns to the "Unplaced" panel, without being deleted from the system), and a "History" button (the full change history of the defect).
• Moving a dot — press and hold, then drag the dot to a new location. The last move can be undone with Ctrl+Z.
• Dropping a photo from File Explorer (Windows) onto the plan opens a new defect form with the photo attached.

14. Export and reports (XLSX / PDF)

The "Export" screen (available from the top menu) allows you to:

• Export to XLSX — a file with the list of defects (with filters applied), for offline editing and re-importing (changes are merged on the server side).
• Generate PDF — a report with floor plans showing marked defects, tables, and photos.

Before generating a PDF, you can configure:

• Filters — Estate, Building, Location, Contractor, Type, Status (by default only "Open").
• "Separate report files" — which dimension (e.g. contractor) is used to generate separate PDF files.
• "Grouping of items within each file" — which dimensions are used to group sections within each file (by default: building → location).

After the reports are generated, the "Generated reports" list lets you open the file, open the folder containing the file, or prepare an email with the report as an attachment (with the contractors' email addresses from that report pre-filled by default).

15. My account

The /app/konto page is available to all logged-in users (admins and sub-accounts) and includes:

• My account — login, email, role (view only).
• Change password — "Current password", "New password", "Repeat new password" fields (min. 6 characters).
• Building access (non-administrators) — a list of buildings you have access to, plus the option to request access to the rest.
• Contractors — rename (if the user has access to any contractors) — the ability to correct a contractor's name without going into the admin panel.
• Drawings / locations — rename (if the user has access to buildings) — renaming a location and changing its floor plan type/level (see point 6.2).

The administrator sees the same account options additionally in the panel (/app/panel → "My account").