> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commerce.thecanbrand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Branch

# Locations

The **Locations** module manages all the geographic and operational aspects of your organization's branches. It includes the following main features:

* **Branches**
* **Branch Assignment**
* **Branches Cluster**
* **Service**

***

## Branches

The **Branches** screen provides a list of all registered branches in the system.

### Branch List View

Each branch row displays:

* **Code**: Unique identifier for the branch
* **Name**: Name of the branch
* **Address**: Full address of the branch
* **Phone**: Contact number
* **Area Covered**: Description of areas the branch serves
* **Actions**: Buttons to:
  * Navigate to **Edit Branch**
  * Navigate to **Branch Details**

***

<img src="https://mintcdn.com/nepalcan/YUEPfNTeT8u15GiR/images/branch/branchlist.png?fit=max&auto=format&n=YUEPfNTeT8u15GiR&q=85&s=d801e147bd5090e6d25529d3928a74ae" alt="Favicon Image" width="1897" height="817" data-path="images/branch/branchlist.png" />

## Branch Detail View

Clicking on a branch leads to a **detailed view** that includes:

* Full branch information
* **Working Hours** section displaying operating days and times
* **Tabs**:
  * **Services**: Assign or update the services offered at this branch
  * **Admissions Number**: Manage admission/contact numbers (add, edit, activate, or deactivate)

This helps keep all operational and customer-facing details well organized.

***

<img src="https://mintcdn.com/nepalcan/YUEPfNTeT8u15GiR/images/branch/branchdetail.png?fit=max&auto=format&n=YUEPfNTeT8u15GiR&q=85&s=2e8f3d802dae26f1d5ebb97dcf5dc1b8" alt="Favicon Image" width="1873" height="796" data-path="images/branch/branchdetail.png" />

<img src="https://mintcdn.com/nepalcan/YUEPfNTeT8u15GiR/images/branch/detailview.png?fit=max&auto=format&n=YUEPfNTeT8u15GiR&q=85&s=e4b78c78fbca8f17649ffb27d89bd755" alt="Favicon Image" width="1914" height="876" data-path="images/branch/detailview.png" />

## Edit Branch

The **Edit Branch** screen allows you to update any branch details.

Editable sections include:

* Name, address, phone, and area covered
* **Working Hours** (adjust opening and closing times)
* Services offered
* Admission/contact numbers

Use this screen to keep branch data up-to-date.

***

<img src="https://mintcdn.com/nepalcan/YUEPfNTeT8u15GiR/images/branch/editbranch.png?fit=max&auto=format&n=YUEPfNTeT8u15GiR&q=85&s=8fd16bf6cfa00dcdcdae75e3d9b50040" alt="Favicon Image" width="1858" height="796" data-path="images/branch/editbranch.png" />

## Add New Branch

The **New Branch** screen allows users to create a brand-new branch.

### Required Information:

* Branch Code
* Branch Name
* Address
* Phone
* Area Covered

### Working Hours Section

Scroll down to the **Working Hours** section to:

* Define operating days (e.g., Mon–Sat)
* Set custom open and close times per day
* Assign available services
* Add one or multiple admission numbers with status control

This ensures the new branch is fully functional from day one.

***

## Technology & UX Notes

* Built using **React** and **Material UI**
* Data managed via **RTK Query** / **Axios**
* Routes and screens use role-based access where applicable

***

<img src="https://mintcdn.com/nepalcan/YUEPfNTeT8u15GiR/images/branch/addbranch.png?fit=max&auto=format&n=YUEPfNTeT8u15GiR&q=85&s=96efb2b96defd10da92f32af59fa9e7f" alt="Favicon Image" width="1872" height="801" data-path="images/branch/addbranch.png" />

## Services

The **Services** feature allows you to manage the different services offered at each branch.

***

### Service List View

* Displays a table of all existing services.
* Each row includes:
  * **Service Name**
  * **Service Description**
  * **Status Toggle**: Easily switch a service between **Active** and **Inactive** using a toggle button.
  * **Actions**:
    * **Edit**: Update existing service details.

***

<img src="https://mintcdn.com/nepalcan/7iypnXb7att4Iqts/images/service/listservice.png?fit=max&auto=format&n=7iypnXb7att4Iqts&q=85&s=bea6bec8d82b8bdb6141390c18bd70a2" alt="Favicon Image" width="1893" height="817" data-path="images/service/listservice.png" />

### Add Service

* Use the **Add Service** form to create a new service.
* Required fields:
  * **Service Name**
  * **Description**
* After submission, the service will be listed and can be toggled active or inactive at any time.

***

<img src="https://mintcdn.com/nepalcan/7iypnXb7att4Iqts/images/service/addservice.png?fit=max&auto=format&n=7iypnXb7att4Iqts&q=85&s=b4b5b1fe3101c7891305898958c17501" alt="Favicon Image" width="1918" height="771" data-path="images/service/addservice.png" />

### Edit Service

* Select a service from the list and click **Edit** to:
  * Update the name or description
  * Change its active status

***

<img src="https://mintcdn.com/nepalcan/7iypnXb7att4Iqts/images/service/editservice.png?fit=max&auto=format&n=7iypnXb7att4Iqts&q=85&s=f792c4b3f2b2cc7e225abddfc473b44e" alt="Favicon Image" width="1912" height="786" data-path="images/service/editservice.png" />

### Features

* Real-time toggle for enabling/disabling services
* Clean and intuitive interface for managing service offerings
* Role-based access (if applied) to ensure only authorized users can create/edit

***

### Service Detail

Service Detail shows the detail of the service you added.

<img src="https://mintcdn.com/nepalcan/7iypnXb7att4Iqts/images/service/detailservice.png?fit=max&auto=format&n=7iypnXb7att4Iqts&q=85&s=c520c122f13abef9b89483cb49f2b5e7" alt="Favicon Image" width="1906" height="835" data-path="images/service/detailservice.png" />
