# Almasa Contract Management — User guide

This guide covers everyday work: uploading contracts, checking them, reminders, renewals, approvals, tasks
and reports. What you can see and do depends on your role. If a button described here is missing, ask
your administrator.

## 1. Signing in and the screen

- Open the system address (for example `https://contracts.almasa.ae`), enter your e-mail and password,
  then press **Sign in**. If you forget your password, use **Forgot password?**.
- Switch between **العربية / English** from your profile menu at the top. Arabic shows right-to-left.
- **Main menu:** Contracts, Reports, Notifications, Master data, Users & Access, System. You only see the
  sections you're allowed to use.
- **Bell / inbox icon (top bar):** opens the **Notification center**.
- **Search** (top): find a contract by number, reference, title or party.

## 2. Dashboard

The dashboard shows:
- Counts: active contracts, contracts expiring soon, expired contracts, contracts waiting for renewal.
- A **priority list**: contracts expiring within 3 or 7 days, overdue payments, contracts with no
  renewal decision, contracts with missing documents.
- Your tasks and approvals.

Click any number or line to open the matching contracts. **Analytics** shows charts. **Calendar** shows
start, end, renewal, payment and document-expiry dates. Both include only the contracts you can see.

## 3. Uploading a contract and checking it against the file

1. Go to **Contracts → Contract import & analysis**, then press **Import contract PDFs**.
2. Choose one or more files (PDF or scanned images). The system reads the text, using OCR for scans,
   and fills in the fields automatically. This takes from a few seconds to a few minutes; the status
   changes when it's done. If the same file was uploaded before, you'll see a duplicate warning.
3. Open the document, then press **Review extracted fields**:
   - Each field shows the value read from the file, a **confidence** level, and the **page** it came from.
     Compare every value with the file, especially fields marked low confidence.
   - Fields marked *"AI generated — requires human review"* must be checked by a person.
   - Correct anything that's wrong. **Save review** keeps your work without saving it to a contract yet.
4. Choose **Create a new contract** or **Complete an existing contract**, then press **Confirm & save**.
   Nothing is saved to the contract until you confirm.
5. You become the contract's owner. From now on, expiry reminders are sent to you automatically.

> You can also create a contract by hand: **Contracts → New**. Importing many contracts from Excel/CSV is
> under **Import contracts**.

## 4. Working with a contract

Open a contract to see its details, parties, documents, payments, tasks, notes, history and timeline.
The buttons at the top (depending on your permissions):

| Button | What it does |
|---|---|
| **Edit** | Change contract details. Every change is recorded in the history. |
| **Edit financials** | Rent, charges, deposits and **VAT (optional)**: switch VAT on or off and choose which charges it applies to. Finance only. |
| **Renewal & approval** menu | **Renewal decision**, **Start renewal**, **Renew contract**, **Submit for approval** |
| **⋯** menu | **Change status**, **Transfer ownership**, **Archive**, Delete |

- **Documents** tab: upload extra files (for example a permit or a signed copy), with an expiry date if
  there is one. A reminder is sent before a document expires.
- **Notes & comments:** choose who can read each note (everyone, your department, or only you). Type
  `@name` to notify a colleague.
- **History:** who changed what, and when (before and after values).

## 4a. Sharjah contracts and private-company contracts

Under **Contracts** there are two new sections:

- **Sharjah contracts:** Sharjah City Municipality permits and other Sharjah contracts (category "Sharjah Contracts").
  - A new contract created from this section is pre-filled with Sharjah and a local-government entity.
  - It gets a **Municipality permit** tab for the permit number, licence number, advertisement content, size, fees type, receipt number, annual and paid amounts, and comments.
- **Private companies contracts:** every contract in the "Private Company Contract" category or with a private counterparty.

When you upload a **Sharjah Municipality permit**, even a scanned one, its details are read automatically. It is filed under Sharjah contracts as a *Permit*, with no VAT.
Check the permit's start and expiry dates before confirming, because scans may not read them reliably.

## 4b. Folders by emirate and Operations Management

The sidebar has one group per emirate, containing exactly the folders of the company archive:

| Group | Folders |
|---|---|
| **Dubai** | Commercial licences, Lease contracts, Private advertising-site contracts |
| **Sharjah** | Commercial licences, Vehicles, Commercial contracts, Ministry contracts, Sharjah municipality permits, Private advertising-site contracts (Sharjah) |
| **Abu Dhabi** | Private contracts |
| **Fujairah** | Media Ministry permits, Licences, Contracts, Private contracts |
| **Ras Al Khaimah** | Federal contracts, Licences, Contracts, Private contracts |
| **Operations Management** | Media Ministry permits, Vehicle renewals (Fujairah - Sharjah), Generators, Pension Authority, Administrative decisions |

- **One record shows in two places:** under its emirate and under the matching Operations Management folder. For example, a car registered in Sharjah appears under Sharjah → Vehicles and under Operations Management → Vehicle renewals.
- **Not everything is a contract:** commercial licences, vehicle licences, media licences, generators and the like are *records*. Each type has its own fields (for a vehicle: plate, chassis, insurance) on the **Record details** tab, and gets the same expiry reminders as contracts.
- **Adding a record:** open the folder and press **New**. The record type, emirate and category are pre-filled.
- **Uploading files:** in **Contracts → Contract import & analysis**, choose the **Folder** the files belong to. Each file is read according to its type; for a vehicle that means plate, traffic code, expiry, insurance, chassis and engine. If you leave the folder empty, the type is recognised from the content.
- **Before confirming:** check the fields on the review screen. Free-text private agreements yield few fields, so complete them by hand or switch on the AI provider.

## 5. Reminders and notifications

Reminders are **automatic**. The system's default rules apply to every contract, so you don't have to set
anything up:

| When | Who is reminded |
|---|---|
| 30 days before expiry | Contract owner |
| 14 days before | Owner and department manager |
| 7 days before | Owner, department manager and contract managers |
| 3 days before | Owner and general management |
| 1 day before / on the day | **Critical alert:** must be acknowledged |

Reminders are also sent before document expiry and payment due dates. They arrive in the system, by
e-mail, and by WhatsApp or Telegram if your number or chat ID is in your profile.

In the **Notification center** you can mark alerts read or unread, open the contract, snooze an alert
(1 hour, tomorrow, 3 days or a custom time), or dismiss it. Critical alerts can't be snoozed; they close
only after you acknowledge them. Snoozing never changes any contract date.

## 6. Renewals

From the **Renewal & approval** menu:
1. **Renewal decision:** *Renew*, *Do not renew*, *Under negotiation* or *Approval required*, with a note.
2. **Start renewal:** the contract moves to *Renewal in progress*.
3. **Renew contract:** creates the new contract linked to the old one. The new term, numbers and
   history are kept.

## 7. Approvals

If an approval workflow applies, press **Submit for approval**. While it's pending, the contract is
locked for editing. Approvers find requests under **My approvals** and press **Approve** or **Reject**
(rejecting needs a reason). The submitter is notified of the result.

## 8. Tasks

Under **Tasks**, or the **Tasks** tab on a contract, create a task, assign it to a person and set a due
date and a reminder time. The person assigned is reminded in the system and by e-mail. Mark tasks done
when finished.

## 9. Reports

1. Go to **Reports → Report builder**.
2. Choose filters (status, dates, category, type, department, emirate, party…) and the columns to show.
3. Choose **PDF**, **Excel** or **CSV**, then **Download**, **Print**, or **Email** it to people.
4. Save the setup as a **template** to reuse it later. Your past reports are listed in the export
   history.

Reports include only the contracts you can see. Financial columns appear only if you have permission to
view financials. Large reports are prepared in the background, and you get a notification when they're
ready.

## 10. Good practice

- Always check extracted fields against the original file before pressing **Confirm & save**.
- Make a renewal decision well before the 30-day reminder.
- Keep your mobile/WhatsApp number up to date in your profile so urgent alerts reach you.
- Never share your password. Sign out on shared computers.

Need help? Contact your system administrator.
