Skip to main content

Organization Locations

Manage global hubs, regional offices, and physical project sites for your organization.

What are Organization Locations?​

Organization Locations allow you to define the physical and virtual spaces where your organization operates. This includes your headquarters, branch offices, client sites, remote work designations, and warehouses. Each location maintains a name, address, geographical coordinates, and an active/inactive status.

Why would I use this?​

Registering your organization's locations establishes a centralized directory of operating areas. This directory is then used to accurately distribute your workforce—allowing you to assign team members to specific base locations, and attach standard organizational locations to specific projects.

How to get here​

Organization Settings → Organization Locations

Application URL:
https://agiledigest.dev-orbit.com/org/location

Understanding the Locations page​

The main Organization Locations page provides a complete view of your defined sites. It features a dual-mode interface:

  • Search: Quickly find a location by typing its name or address.
  • List View: A detailed table displaying all locations, their type, address, coordinates, and status.
  • Map View: A geographical map showing the exact positions of all locations with valid coordinates.

📸 Screenshot placeholder: Organization Locations — List View
Capture the List view showing the search bar, the table of locations, and the "Add Location" button.

Table Columns​

  • Location Name: The display name of the location (e.g., "Headquarters").
  • Type: The classification of the location (e.g., Office, Client Site).
  • Address: The physical street address.
  • Coordinates: The latitude and longitude, indicating its exact map position.
  • Status: Shows whether the location is currently Active or Inactive.
  • Actions: Icons to edit or delete the location.

Adding a location​

To register a new location, click the Add Location button in the top right corner. This opens the Add New Location drawer on the right side of the screen.

📸 Screenshot placeholder: Add New Location — Drawer
Capture the drawer showing all fields (Name, Type, Address, Coordinates, Active toggle) and the Save button.

Location fields​

Location Name​

What is this? The identifying name for the location.
What should I enter? A clear, recognizable name for the office or site.
Example: London Regional Hub
Required? Yes.
What is it used for? This name is displayed in the list and in all location selection menus across the platform.

Location Type​

What is this? The classification of the location.
What should I enter/select? Choose the category that best fits the space. Available options include:

  • Office
  • Client Site
  • Warehouse
  • Regional Hub
  • Virtual / Remote
  • Other
    Example: Office
    Required? Yes.
    What is it used for? Primarily for categorization and filtering.

Full Address​

What is this? The physical street address.
What should I enter? The complete postal address of the location.
Example: 123 Business Way, Suite 400, London, UK
Required? No, but highly recommended.
What is it used for? Provides detailed routing and physical context for team members.

Pick from Map​

What is this? A visual tool to automatically find coordinates.
How it works: Clicking "Pick from Map" opens an interactive map. When you search for a place or click a point on this map, it automatically populates the Latitude, Longitude, and often the Full Address fields for you.

Latitude and Longitude​

What is this? Latitude and longitude identify the exact position of the location on a map. Latitude is the north/south position, and Longitude is the east/west position.
What should I enter? The numerical coordinates of the site.
Example: Latitude: 51.5074, Longitude: -0.1278
Required? No.
What is it used for? These coordinates are required for the location to appear on the Map View. If left blank, the location will only appear in the List view.

This location is active​

What is this? A toggle controlling the location's availability.
What happens when enabled? The location is Active. It can be selected and assigned to projects and team members.
What happens when disabled? The location becomes Inactive. It is soft-disabled and will no longer be available for new assignments, though it retains its history.

What happens after I save?​

When you click Save Location, the system validates your input. Upon success, the drawer closes, the list refreshes, and the new location is instantly available to be assigned to team members and projects.

Editing a location​

If a location moves or details change, you can update it:

  1. Find the location in the list.
  2. Click the Edit (pencil) icon in the Actions column.
  3. The Edit Location drawer will open, allowing you to change the Name, Type, Address, Coordinates, and Active status.
  4. Click Update Location.

Important: Modifying a location updates its details universally. If a team member is assigned to this location, their profile will reflect the new address or name immediately.

Deleting a location​

To remove a location permanently:

  1. Find the location in the list.
  2. Click the Delete (trash) icon in the Actions column.
  3. A confirmation modal will appear.
  4. Click Confirm to permanently delete the location.

Warning: This is a destructive action. If the location is currently heavily relied upon, consider unchecking "This location is active" (soft-disable) instead of deleting it.

Example: Adding a new office​

Suppose your organization opens a new branch in Gurgaon.

You would click Add Location and enter:

  • Location Name: Gurgaon Cyber Hub Office
  • Location Type: Office
  • Full Address: Building 8, Cyber Hub, DLF Phase 2, Gurgaon
  • You click Pick from Map, search for "Cyber Hub", and the system automatically fills:
    • Latitude: 28.4955
    • Longitude: 77.0894
  • Active: Checked

After saving, this office immediately becomes available in the Team Location Allocation matrix, allowing you to assign your Gurgaon-based employees to this hub.

Where are Organization Locations used?​

Organization Locations serve as the foundational directory for physical spaces across the platform. They are specifically consumed by:

  1. Team Location Allocation (/org/team-location/grid): Administrators use this matrix to assign employees to primary and secondary base locations. This connects your human resources to physical sites.
  2. Project Locations: When setting up a new Project, project managers can create project-specific sites or assign standard organizational locations to define where project work takes place.

Technical / Implementation Notes​

Route​

/org/location

Main component​

/src/routes/org/LocationPage.tsx

Supporting components​

  • LocationMap.tsx (Map View rendering)
  • MapPickerModal.tsx (Pick from Map interactive coordinate finder)
  • TeamLocationGrid.tsx (Primary downstream consumer)
  • ProjectLocations.tsx (Project-level location management)

API operations​

  • GET /org/locations — Fetches list of locations (can filter by project)
  • GET /org/locations/all — Fetches all locations for map rendering
  • POST /org/locations — Creates a new location
  • PUT /org/locations/:id — Updates an existing location
  • DELETE /org/locations/:id — Removes a location

Data model (Location)​

  • id (UUID)
  • organization_id
  • project_id (Nullable)
  • name (String)
  • location_type (String)
  • address (String)
  • latitude (Float, nullable)
  • longitude (Float, nullable)
  • is_active (Boolean)

Downstream consumers​

  • Team Location Grid (/src/components/locations/TeamLocationGrid.tsx): Consumes the location_id to build a matrix where users (rows) are assigned to locations (columns). Uses POST /org/team-location/assign.
  • Project Locations (/src/components/projects/ProjectLocations.tsx): Project spaces can mirror or create specific project-bound locations.

Note: There is currently no verified direct dependency between Organization Locations and the Orbit People Attendance (check-in/out) flow, which captures point-in-time device GPS rather than strictly enforcing geofencing against this registry.