Add Project
The form is the same for every firm type. Your firm type only changes which stages the project gets. Fields are listed in screen order, from Client Information to Additional Options. Client Information ("Contact details and project location") holds the first four fields. Project Information ("Basic project details and specifications") starts at Project Name and holds Load & System, Utility Type, Priority Level, Unit System and Currency.
| Field | Required | What to enter, options and default |
|---|---|---|
| Select Enquiry (optional) | No | An open enquiry, found by enquiry number or customer. Fills the client fields and makes the project start as Tender. Shown only with View on Enquiries. No enquiry (clear selection) removes it. |
| Client Name | Yes | "Select or type a client name". Pick a client, or type a name and select Use "[name]" as a new client. Add new client… opens the add client box, with Add on Customers. |
| Client Email (Optional) | No | An email address. |
| Client Phone | Yes | 7 to 15 digits, with the country flag. |
| Project Name | Yes | Up to 100 characters. |
| Project Type | Yes | New Installation, System Replacement, Repair & Maintenance, System Upgrade or Inspection & Assessment. |
| Project Country | Yes | Starts with your company's country. "Sets the standard load-calculation engine below and centres the site map." |
| Load & System: Load Intent | Yes | Cooling (default), Heating or Both. |
| Load & System: System type | No | One per side, for cooling and heating. Starts from the country. |
| Load & System: Engine | No | One per side. Starts at "Select engine". An engine for your country is marked "Recommended for your region". |
| Load & System: Chilled-water ΔT (°C) / Hot-water ΔT (°C) | No | Shown for water-based systems only. Defaults 5.5 and 10. |
| Utility Type | No | Default residential. "Applies to all spaces in this project, sets internal-heat (sensible/latent) values." |
| Priority Level | No | Low, Medium (default) or High. |
| Unit System | Yes | Imperial (ft, sq ft) or SI / Metric (m, sqm). Starts with your company's unit system, else Imperial. |
| Currency | No | Starts with your company's currency. Locked once the project is created. |
| Project Description | No | Free text. |
| Start Date | Yes | A date. "You can select today's date or any date up to 1 month in the past" |
| End Date (Optional) | No | A date, not before the start date. The same day as the start shows "⚠ End date equals start date, project duration will be 1 day." |
| Estimated Project Value | No | A positive amount. "Your internal estimate. The contract value comes from the accepted quotation." |
| Duration (Days) | Read only, marked Auto. Worked out from the start and end dates. | |
| Contract Value (if already agreed) | No | A positive amount. "Leave blank if this job will be priced through a quotation." |
| City | Yes | Pick from the country's cities, or type it when the country has none. Up to 50 characters. "No matching city: pin it on the map below." |
| Street Address | Yes | Start typing and pick the suggested address. |
| State (optional) | No | Free text. |
| ZIP Code (optional) | No | For example 12345, 12345-6789 or 123456. |
| Landmark | No | Up to 255 characters. |
| Latitude (Optional) / Longitude (Optional) | No | Read only. Set from the map, the address search or Use Current Location. The reset icon clears them. |
| Project Radius (meters) | No | 1 to 10,000. Default 100. |
| Select Location on Map | No | Select the site on the map. |
| Project Manager | No | An active user, or No manager assigned (default). + Add new manager opens "Add New Manager" with the role set to Manager. |
| Requires building permits | No | Tick box. |
| Has existing HVAC system | No | Tick box. |
| Additional Notes | No | Free text. |
Under Load & System, "Stages this project will get" lists the stages with a count. See Which stages a new project gets.
The buttons are Cancel and Add Project (it reads Creating... while it saves). If a field is wrong, a message names it: "Please fix [number] fields: start with [label]...".
Edit Project: what is different
Edit Project ("Update project details and information") has the same fields, grouped as Project Information, Client Information, Site Address, Project Details and Additional Options. The differences:
| Field or area | On Edit Project |
|---|---|
| Status | In Project Information, beside Priority, after Utility Type and before Unit System and Currency. Pending, In Progress, Completed, and Won only when the project is Won. Forward only. See I can't change a project's status back. |
| Priority | Low, Medium, High. |
| Unit System | Imperial (ft, °F, gr/lb) or SI / Metric (m, °C, g/kg). "Affects calculator units for duct & HVAC sizing" |
| Currency | "Used for budget & cost display" |
| Select Client | Links a client record. While one is linked, client name, email and phone are locked. |
| Contract Value | With an awarded quotation: "Contract value comes from quotation [number]". For a tender: "This project is out for pricing. Its contract value arrives with the accepted quotation." For a lost project: "This project was marked lost, so there is no contract value." Otherwise Contract Value (if already agreed). |
| Estimated Duration (Days) | Read only, marked Auto-calculated. |
| "Limited Editing Mode" | Shown once the project is in progress, completed or started. Start date, end date and location are locked. The radius is locked when "Work sessions exist for this project". See Dates, location or client are locked on Edit Project. |
| System type | Changing it when stages would be affected opens a warning with Cancel and Continue. |
The buttons are Cancel and Update. With View but not Edit on Projects, the form is read only and has no Update button.
