# TEC Flow User Guide

**Electrical Estimating & Tender Management Platform** · **From Opportunity to Award**

Version 3.8.2 · Estimator and Tenders

Open **? Help → User Guide** inside the website to search these instructions.

## Getting started

### Sign in and choose a homepage

1. Sign in using your assigned account. If prompted, change the temporary password first.
2. Choose Estimator or Tenders from the workspace switcher. Both use the same account.
3. Open My Profile to choose your own preferred homepage; Auto follows your role/team default.

**Tip:** Your administrator manages accounts, team access and permissions.

### Find your way around

1. Use the sidebar to open the features in your current workspace.
2. Use the Estimator / Tenders switcher to change workspace without signing out.
3. Use search in the relevant register to find a project by name, builder or reference.
4. Use Help → User Guide for step-by-step instructions or Help → AI Assistant for a question.

**Tip:** Opening a project should not force you to recreate a search or filter.

### My Profile, photo and security

1. Click your profile in the sidebar and edit your name, contact details and job title.
2. Upload a profile photo or select initials. Choose My homepage.
3. Enter the current password when changing your username or password, then save.

**Tip:** A password change signs out other sessions. Do not share passwords with Help.

## Estimator workspace

### Estimator Home and Project Board

1. Use Home for project status, assigned activity, deadlines and the Project Board.
2. Search all accessible projects with the top search box, regardless of selected month or status.
3. Open an estimate from its project card; use Details & actions for additional project operations.
4. Administrators can review team activity with selectable week or month.

**Tip:** Closed estimates are not counted as submitted/completed estimates.

### Create and set up an estimate

1. Select New Project. Enter the project name, builders, team and submission deadline.
2. Open the project, then set labour rate, working hours/day, crew size and mark-ups.
3. Use Manage project & activity to update its brief, team assignments and workflow.

**Tip:** Changes to costing settings affect project calculations; check totals before exporting.

### Project progress and deadlines

1. Use the Progress dropdown beside Estimate Setup guide.
2. Choose Not started, In progress, In review, Submitted or Closed as appropriate.
3. In review requires a review deadline. Submitted represents an estimate that has been submitted.

**Tip:** Closed may mean discarded work; it is not automatically a completed estimate.

### Add catalog items to an estimate

1. Search the reusable Catalog from the Estimate page.
2. Inspect the item, specification, materials and labour build-up before adding it.
3. Use Add to estimate, set the project quantity and adjust any project-only reference or price.

**Tip:** Changes to a project snapshot do not automatically change the master Catalog.

### Edit estimate items and components

1. Expand the relevant category to show its estimate items.
2. Edit quantity, reference, item description, remarks and project-only supply price as needed.
3. Use Edit item to inspect component quantities, material prices and labour hours.
4. Drag the dotted handle to reorder items or categories; use Expand All / Shrink All.

**Tip:** Fixed-quantity components do not scale with the parent quantity.

### Yellow and red item highlights

1. Click the highlight marker beside an item once for yellow, twice for red, then again to clear.
2. Highlights are stored with the estimate and can be viewed by other authorized users.
3. Read-only viewers can see markers but cannot change them.

**Tip:** Highlight colours do not affect the estimated price.

### Materials, labour and quoted total

1. Check project material mark-up, labour rate, labour-hour mark-up and final mark-up.
2. Review material totals, labour hours, labour cost and included quoted total.
3. Optional categories are excluded from the included quoted total.
4. Use the crew plan for approximate person-days and working-days calculations.

**Tip:** The application estimates costs; verify supplier quotes and project-specific assumptions.

### Activate and use Breakdown

1. Open Breakdown from an estimate and choose Active. It stays active until an editor switches it off.
2. Add Area / Floor / Space names and choose Allocation or Structured View.
3. Find items with Breakdown search by name, reference, remarks, category or area.
4. Changes autosave. Use Undo / Redo if a distribution is incorrect.

**Tip:** When inactive, Breakdown sections are omitted from Excel and public share views.

### Allocate quantities to areas

1. Select Single area for an item assigned entirely to one area.
2. Select Multiple areas to divide quantity between several spaces; enter quantities or distribute equally.
3. Use a common-to-all-areas option only for items intended as a shared allowance.
4. Check Remaining and the unallocated-only filter before finishing.

**Tip:** The breakdown divides the existing estimate quantity; it must not increase project totals.

### Save, view and compare revisions

1. Open Revisions in an estimate and save a snapshot at an appropriate milestone.
2. Use View to inspect a saved snapshot without changing the live estimate.
3. Use Compare to see differences against another revision or the working estimate.
4. Restore a revision only when you intend to replace the working state.

**Tip:** Check the revision date, label and totals before restoring.

### Notes, contributors and activity

1. Use Add Note to record assumptions, clarifications and decisions.
2. Use Manage project & activity to inspect the project journey, permissions and history.
3. Read activity and revisions before changing an estimate another colleague is editing.

**Tip:** Edits and notes are attributed to the signed-in account.

### Export Excel and share an estimate

1. Review included and optional totals, references, remarks and active Breakdown allocations.
2. Choose Export Excel to generate the estimate workbook.
3. Use Share to generate a read-only project view according to its sharing settings.

**Tip:** Sharing or exporting does not give the recipient permission to edit the project.

## Catalog, Light Price and imports

### Catalog Explorer

1. Open Catalog and search item titles, codes, components or categories.
2. Inspect component material price, hours and installation type in the details panel.
3. Add to estimate for a project snapshot, Edit catalog item for the reusable record, or Save as new version when appropriate.
4. Use Source history to trace imported sheets and workbook occurrences.

**Tip:** Catalog prices may be historical; confirm current supplier pricing.

### Light Price library

1. Open Light Price and search by supplier, catalogue number, description, project or nickname.
2. Inspect individual components, included/excluded items and connected unit cost.
3. Use supplier quotations as pricing references, not automatically current offers.

**Tip:** Quoted supplier prices are generally AUD excluding GST.

### Import an estimating workbook

1. Open Import and select the workbook upload/preview tools.
2. Check the detected sheet structure and warnings before committing an import.
3. Review the import summary and source history afterward.

**Tip:** Avoid importing a live database file as a workbook.

### Import supplier lighting prices

1. Open Import → Add supplier prices.
2. Check the quotation, review detected fittings and component pricing, then import selected records.
3. Inspect changed or duplicate quotes before approving an update.

**Tip:** Scanned PDF quotations may need a text-readable copy or OCR before extraction.

## Tender workspace

### Tender dashboard and pipeline

1. Use Dashboard for total projects, live submission pipeline, builder outcomes, pricing feedback and follow-ups.
2. Open Project Chase-up for detailed filters and the complete submission register.
3. Select a chart segment to view related submissions.

**Tip:** TEC Won and Builder Awarded are different outcomes.

### Create and edit a tender

1. Select New tender, complete project, builder, deadline, region and quotation details.
2. Save the submission and open it to add chase-up history or modify outcomes.
3. Use editing menus rather than Delete for routine corrections.

**Tip:** Keep tender status, builder result and pricing feedback distinct.

### Multi-select filters, search and saved context

1. Open the Filters panel in Project Chase-up, Projects or Builders.
2. Tick multiple options in Region, TEC status, Team, Builder outcome and other fields.
3. Values within one field use OR; different fields combine using AND.
4. Clear a field or use Clear filters to start over.

**Tip:** Filters should stay in place when opening a tender and returning to the register.

### Open–Awarded builder project follow-up (v3.8)

1. Open **Tenders → Open–Awarded**. Only builder submissions with TEC quotation **Open** and Builder outcome **Awarded** appear. All active signed-in users can view this register.
2. In **Cards** view, inspect project and builder, awarded date, estimated start date, submitted value, current project link, last chase-up, and awarded-project contact people. Cards sort by recorded awarded date (newest first; missing dates last).
3. Search by project, builder, contact or chase-up; enable **Missing contacts only** to find incomplete contact records.
4. Select **Edit / Add contact** to record an actual awarded date or estimated start date; neither is inferred from quotation deadlines. Enter a manual Project Link if you need to override the URL inherited from a linked Opportunity.
5. Use **Add contact person** to enter multiple people. Each person may have multiple separate phone numbers (**Add phone**) and email addresses (**Add email**). Remove individual entries or people as needed, then select **Save details**. The limits are 20 people and 12 emails / 12 phones per person.
6. Click a phone number to open the device dialler or an email to compose in Outlook on the web. Contact details appear on Cards, in the Calendar selected-day panel, and in the complete Tender Details drawer.
7. Switch to **Calendar** to see Awarded events in **amber** and Estimated Start events in **teal**. **Today** has a separate **blue** highlight in Sydney time. Navigate with arrows or the month picker.
8. Select an event to show its builder's contacts in the panel **beneath the calendar**. Use **View project** to open full Tender Details, or **Edit contact** to change fields. Dates that were not recorded are not shown as calendar events.
9. Select a Card or **View project** to open the existing Tender details and chase history. Changes to the awarded-project contacts do not overwrite the original Tender contact.

**Project link:** Linked Opportunities provide their current URL automatically. A unique exact project+builder+region match may provide a display-only suggestion, but ambiguous matches are never linked automatically. Clearing a manual URL restores the Opportunity URL when available.

**Tip:** The Calendar keeps the selected-day contact panel below the month grid. Contact details do not appear permanently inside date cells.

### Project Chase-up and follow-up history

1. For a newly submitted builder quote, enter the **Actual submission date** separately from the tender submission deadline. For the first 14 days, **Latest chase-up** shows **Recently Submitted**. After 14 days with no recorded chase-up, it shows **Ready for First Chase-Up**.
2. The first automatic chase-up is set for **9:00 am Sydney time on the first Wednesday after the 14-day period**, with **Repeat every 14 days** enabled. This only applies to quotes with a recorded actual submission date; older quotes without one are unchanged.
3. In **Schedule a chase-up**, choose the next date and time and optionally tick **Repeat automatically every 14 days until Closed or Lost**. Scheduled series advance automatically each fortnight until stopped or deleted.
4. If builder outcome becomes **Unsuccessful**, TEC quote status automatically changes to **Closed**, and all pending follow-ups are cancelled. **Closed** and **Lost** quotes cannot be chased or scheduled; other builders on the same project are unaffected.
5. In the **Reminders** or quotation schedule list, the **schedule author or admin** can select Delete and confirm. Removing an automatic first-chase series prevents it from being recreated automatically.
6. In the **Chase-up Calendar**, select any date to view that day's agenda in the panel beneath the calendar, including when there are no events.

**Tip:** Chase-up history retains its author; do not overwrite a colleague’s record to add a new contact.

### Projects and Builders registers

1. Use Projects for grouped project totals across builders.
2. Use Builders to compare builders’ submissions, wins and values.
3. Open a group to examine its connected quotations.

**Tip:** Project value may use the highest builder quote; builder submissions remain separate.

### Calendar, deadlines and reminders

1. Open Calendar for upcoming submission deadlines, follow-ups and approved opportunities.
2. Switch Month / Agenda where available and move to the required date.
3. Use Reminders to review due and completed follow-ups.

**Tip:** Notifications may require browser permission; in-app reminders do not.

### Import and export tender registers

1. Use Import Excel in Tenders to preview and merge new or changed submission rows.
2. Check duplicate matches and merged builder records before proceeding.
3. Use Export to download the currently selected register results.

**Tip:** Back up the live database before major imports.

### Opportunities and approvals

1. Open Opportunities and add a project with its address, builder, deadline and scope.
2. Review incoming opportunities, assign an authorized team and approve or reject.
3. Use Approved → Need to quote to find approved projects awaiting a quotation.

**Tip:** Opportunity approval is separate from submitting an electrical quotation.

### Create an estimate from an approved opportunity

1. Open an Approved opportunity and go to Project Journey → Estimator project.
2. Choose Create Estimate if your assigned team has Estimator access, or link an existing estimate.
3. Check the copied project brief, builder, deadline and team before pricing.

**Tip:** This operation is permission-checked and prevents duplicate links.

### Record quotations and outcomes

1. In an Approved opportunity, choose Quoted or Not quoted as appropriate.
2. Connect a quoted opportunity to the corresponding Tender project or Chase-up record.
3. Update the builder’s actual award outcome separately from TEC’s quote result.

**Tip:** Do not treat builder award status as proof TEC won the work.

### Opportunity analytics

1. Open Opportunities → Analytics to view created, approved, pending quotation, rejected and expired counts.
2. Select month, month-by-month, custom dates or All time.
3. Use Original added date versus Upload/creation date when reconciling imported Excel opportunities.

**Tip:** All signed-in active users can view Analytics; counts use the selected date source.

## Teams, administration and safety

### Accounts, teams and editing access

1. Administrators open Manage Users to add users, manage roles and team memberships.
2. One account may belong to multiple teams. Team assignment controls access to relevant estimate editing.
3. Each team can have its own default homepage and Estimator usage setting.

**Tip:** Do not share admin credentials. Viewer access and edit access are different.

### Settings, AI configuration and backups

1. Administrators open App Settings to configure supported application options and Gemini access.
2. Confirm integrations before submitting private workspace records or documents to an external AI provider.
3. Use database backup/restore controls carefully; restoring a backup replaces newer data.

**Tip:** Your application has separate Estimator and Tender SQLite databases; protect both.

### AI Assistant, documents and confirmed actions

1. Open ? Help → AI Assistant to ask about an estimate, project, catalog item or tender.
2. Use the attachment button to supply a text PDF, spreadsheet, DOCX or text file.
3. Enable configured Gemini in Help Settings if you want AI-powered analysis using supplied context.
4. For supported write tasks, such as adding a note, updating project progress, changing a deadline, recording Won/Lost or renaming a project, review the preview and select Confirm.

**Tip:** The assistant cannot arbitrarily access external systems, ignore user permissions or execute unknown operations. Actions require approval.

### Saving, retry and recovery

1. Watch Saved / Saving / Unsaved status in Estimator and Breakdown.
2. If a write fails, do not repeat it blindly: first verify whether the server saved the change.
3. Use revisions, Undo/Redo or authorized backup recovery for mistakes.

**Tip:** When your connection is interrupted, keep the page open until you have verified the saved state.

