The purpose of this documentation is to outline the use case, processes and technical details associated with Hibou's Equipment Timesheets module.

The Equipment Timesheet module allows you to easily record time spent on your maintenance requests. Additionally, Equipment Timesheet can be used in conjunction with analytic accounting to track time spent on maintenance or repair of equipment across projects and departments.

First things first, we want to install the module! Navigate to the Apps application and search 'Equipment Timesheets'. When ready, click the Install button.

Once there, click on Maintenance and then Maintenance Requests.

Select an existing Maintenance request, or create one by clicking the Create button.

In order to use TImesheets on Maintenance Requests, a Billing Project must be selected. Once the Billing Project has been selected, you will see a new Timesheets tab below the Notes section. Click "Add an Item" to enter a new timesheet. 

Once the timesheet entry has been added and you're ready, hit the Save button.

If you enter an expected amount of hours for the maintenance request to be completed, you can track your Remaining Hours on the request as you enter timesheets.

The Billing Project you chose can be configured with a Department, a Customer or both.

Within the Accounting application, click on Reporting and then Analytic Entries.

Here you can view the number of hours that have been entered for a project under Quantity. You can also drill down further to view the project's associated partner or department.

In this way, you can report on the time that is spent on maintenance requests for a general project or a specific department or customer. This allows you to budget time accordingly and follow up as needed for those that are utilizing a higher than expected amount of time on maintenance requests.

This module adds a new 'Timesheets' notebook tab on the Maintenance Request form to add timesheets to maintenance requests. Additionally, it adds:

•  New `maintenance_request_id` field to `account.analytic.line` model

• New `project_id`, `timesheet_ids`, `effective_hours` and `remaining_hours` fields on `maintenace_request` model. Effective hours are computed using the sum of the maintence work done, remaining hours is the total remaining time.

• New Smart button 'Maintenance' on the equipment form view that dynamically displays the number of maintenance requests for the piece of equipment.