1 of 1

Contracts

Overview

A contract document is a legal & financial obligation between any two parties entering into the contract.
After the estimates are created and approved, they are grouped or individually tendered/direct assigned to vendors to execute the work.
A works package is typically not seen in all Works Management Products. it is used only where high-complexity projects are executed where packaging is needed to form smaller or larger chunks so as to increase operational efficiency.
The current contract service includes Line items of estimates, Works packaging, Negotiation, Contract Terms, and Milestones.

Actors

The Junior Engineer/Assistant Engineer creates the contracts and the Municipal Engineer/Executing Officer approves the contract depending on its value. (Workflow configurations based on amount subject to platform capability in v1).

Create Contract

Story Detail

After Estimates are created and approved for projects/sub-projects, these estimates can be grouped in specific ways to form works packages.
The need for grouping arises in the way how the JE/ULB wants to execute the project(s). For instance -
- Small Projects(Estimates) of similar types in nearby localities can be grouped to form a single works package. This work package can be tendered, negotiated and contracted. (Most common need of work package)
- A huge project(estimate) can be broken down into multiple work packages by the line items approved within the estimate. The value of the work packages in this case will be proportional to the costs of the line items. (This breakdown is already achieved by dividing projects into sub-projects and hence might not be needed during estimations)
Works package will go for tendering or direct assignment depending on the project.
Tendering/Negotiation can be of two types
1. Lumpsum - Entire package will be negotiated by a percentage value or lump sum value.
  Running bills will be validated by the measurements of the line items in the works package.
  The final bill will be adjusted to the remaining amount
2. Percentage line item
  Each line item will be negotiated and negotiated values will be paid as part of the contract
  Running bills will be validated by the measurements of line items in te works package
  The final bill will be adjusted to the remaining negotiated amount of each line item.
The contract will have milestones and only when milestones are met, payments will be made to the contractors.
The contract will also have terms and conditions (text only in v1, to be codified in v2)
The contract will have an approval workflow. Upon clicking proceed to forward on the last tab, the user will be shown a popup to select forwarding details.
Rejected contracts will come to the inbox of the creator for any modifications.
Statuses of Contract
1. Created
2. In progress
3. Approved
4. Rejected (Rejected in Workflow. Comes to the inbox of the creator. Can be edited and resent for approval)
5. Cancelled (Completely Cancelled. Cannot be edited)

Contract Inbox

Clicking on the Contracts link on the home screen navigates users to a default contract inbox screen.
Default inbox items will be empty for a contract creator.
Users can filter and search using the following options
- Contract ID
- Estimate ID - Show a list of all contracts by each row when a particular estimate falls in all those contracts.
- Contractor ID
- Contract Type
- Contract Created from date
- Contract Created To date
- Status
Columns in the Table
- Contract ID
- Estimate ID(s) - If a contract is formed with multiple estimates show an array of estimates.
- Contractor
- Contract Type
- Status
- Contract Amount
- SLA

Search Estimates to Create Contract

Click on Create Contract in the contract inbox to search for approved Estimates.
Users can multi-select approved estimates to create contracts.
Search parameters
- Estimate ID
- Project ID
- Department
- Status
- Estimate created from date
- Estimate Created to Date
Table Columns
- Estimate ID
- Project ID
- Department
- Status (of the estimate)
- Estimated Amount
Select the estimates using checkboxes - a counter shows at bottom of the page.
- it should be allowed to search/re-search using the filters while the selection is frozen.
- Refreshing the page might lose the selections from UI.
- Clicking on create contract will add selected estimates to the respective contract UI to be further actionable(on the next page)

Create Contract - Header & Contractor Details

Contract creation UI displays the headers and multiple tabs.
Attribute details are added separately in the story
Contract Amount is a display-only field.
- Value dynamically changes based on selections in the work details and the negotiation tab
- Initially, the contract amount is the sum of selected estimates
- But, if in the work details, certain line items are removed from the estimates, then only the remaining amount needs to be displayed in the Contract Amount
- In the negotiation tab, only line items that are fixed from the work details tab are shown. These will have negotiated percentage/amount values for each line item.
- Only the finalised sum of negotiated values is to be shown as the Contract Amount
Contractor ID is a display-only field. It is shown on searching and selecting a contractor from the contractor select drop-down.

Work Details

The Work Details section shows the list of estimates and estimates for the line items from the selection made before coming to the contract screen.
Estimate line items that are already selected and part of other created contracts should show up as non-selectable line items in this table UI.
Users can select line items from different estimates and the final amount of selected line items will show up in the Contract Amount under header details
Clicking on next will take the user to the Negotiation tab.

Negotiation Details

Negotiation is of two types
- Percentage-tender (Lumpsum)
- Item rate negotiation
In Lumpsum, the entire contract is negotiated by a certain amount/percentage.
On the UI, we will capture by percentage and calculate the final amount of the contract.
The same will be displayed on Contract Amount in the Header details
For the Item rate negotiation type, line items selected in the Work Details tab only will be shown in a table.
This table will have a column for the users to input either amount or percentage of the line item that is negotiated.
Finalised amount, the sum of all negotiated values is the contract amount.

Milestones Creation

Milestones are tagged to a certain percentage of completion of the project.
There will be milestone templates(v2) based on project type and subtype. Users will only have to fill in start and end dates then.
A contract can have any number of milestones.
- The sum of % completion of all these milestones however should add up to 100%

Terms and Conditions

Terms and conditions are an array of upto 100 strings in V1.

View Contract

Users can click on Contract ID in their inboxes to come to view the contract screen.
The View Contract attributes is the same as Create Contract attributes from a UI perspective. All the fields are standard view-only components.
The View Contract screen will additionally have the Contract ID displayed in the header details
Depending on the user and path selected View Contract will have the call to action options.
1. For users in the workflow
  - Approve
  - Reject
2. For final users
  - Approve
  - Reject

Search Contract

Modify Contract

Before the contract is finally approved, all fields should be editable. System-generated Contract ID is non-editable.
By the time contract becomes editable, some of the estimates/estimate line items could possibly be added to other contracts.
1. The system should ensure the same line items are not part of 2 different created contracts
Base Contracts once issued and accepted cannot be modified

Revised Contracts (v2)

Estimates go through revision and also need a revised contract to be issued
A revised contract can be a change in line items (scope) or a change in the amount