Creating Projects

Customers can create new projects directly from the Ordering Portal when a project doesn't already exist in the system.

Project Select Page

Route: GET /project/select

The project select page presents two options as selection cards:

Option 1: Search Existing Project

• Click the "Search Existing Project" card (magnifying glass icon)
• A search section expands with jQuery UI autocomplete
• Works identically to the dashboard search
• Selecting a result navigates to that project's view

Option 2: Create New Project

• Click the "Create New Project" card (plus icon)
• A creation form expands with address search fields

New Project Creation Flow

Step 1: Enter Address

The creation form includes:

• Address search input — connected to Vicmap/Vicplan geocoding
• A loading indicator shows while geocoding runs
• The system resolves the address to:
  • Full formatted address
  • SPI (Standard Parcel Identifier)
  • Latitude/Longitude coordinates

Step 2: Submit

• The form posts to POST /project/create
• The backend calls V3OrderingApiClient::createProject() which creates the project via the v3 API
• The ProjectCreationService handles:
  • Creating the Project entity
  • Setting all address fields (SPI, lat/lng, known address, EZI address)
  • Associating with the customer's company and user group
  • Setting initial status to "unprocessed"

Step 3: Redirect

• On success, the customer is redirected to /project/{id}/confirm-address
• This enters the Order Creation Wizard at Step 1

Address Resolution

The system uses multiple sources for address data:

What Gets Created

A new project includes:

• Address fields (knownAddress, lotAddress, eziAddress, numRoadAddress)
• Location data (lat, lng, SPI)
• Lot details (lotNo, streetNo, streetName, postcode, suburb, state)
• Company and user group association
• Initial "unprocessed" status

After Creation

Once the project is created, the customer proceeds directly into the Order Creation Wizard to place their first orders. See Order Creation Wizard.