# Quick Start Guide

Get your FlowRise HMS up and running in minutes.

## Step 1: Initial Setup Checklist

Before using Locations and Departments:

- [ ] You have administrator access
- [ ] Your organization is created
- [ ] Your branches are configured
- [ ] Timezone is set correctly

## Step 2: Create Your First Facility

1. Go to **Infrastructure → Locations**
2. Click **New Location**
3. Configure:
   ```
   Branch: Select your branch
   Type: Facility
   Name: Main Hospital
   Code: FAC-001 (optional)
   ```
4. Click **Save**

## Step 3: Add Buildings (Optional)

If you have multiple buildings:

1. Go to **Infrastructure → Locations**
2. Click **New Location**
3. Configure:
   ```
   Branch: Select your branch
   Type: Building
   Name: Building A
   Parent Location: Main Hospital
   ```
4. Repeat for other buildings

## Step 4: Add Floors

1. Click **New Location**
2. Configure:
   ```
   Branch: Select your branch
   Type: Floor
   Name: Ground Floor
   Parent Location: Building A
   ```
3. Repeat for other floors

## Step 5: Add Rooms

1. Click **New Location**
2. Configure:
   ```
   Branch: Select your branch
   Type: Room
   Name: Room 101
   Parent Location: Ground Floor
   ```
3. Add all rooms in your facility

## Step 6: Create Departments

1. Go to **Infrastructure → Departments**
2. Click **New Department**
3. Configure:
   ```
   Name: Cardiology
   Service Type: Clinical
   Description: Heart and cardiovascular care
   ```
4. Click **Save**

## Step 7: Assign Locations to Departments

1. View the Cardiology department
2. Click **Attach Locations**
3. Select the rooms where cardiology operates
4. Mark one as **Primary**
5. Click **Attach**

## Common Setups

### Small Clinic (Single Building)

```
Main Clinic (Facility)
    ├── Ground Floor (Floor)
    │   ├── Reception (Room)
    │   ├── Consultation 1 (Room)
    │   └── Consultation 2 (Room)
    └── First Floor (Floor)
        ├── Pharmacy (Room)
        └── Lab (Room)
```

### Large Hospital

```
Main Hospital (Facility)
    ├── Building A (Building)
    │   ├── Ground Floor (Floor)
    │   │   ├── Emergency (Room)
    │   │   └── Triage (Room)
    │   ├── Floor 1 (Floor)
    │   │   ├── ICU (Room)
    │   │   └── CCU (Room)
    │   └── Floor 2 (Floor)
    │       ├── Cardiology (Room)
    │       └── Neurology (Room)
    └── Building B (Building)
        ├── Laboratory (Room)
        └── Radiology (Room)
```

### Department Assignments

| Department | Primary Location | Other Locations |
|------------|-----------------|------------------|
| Emergency | Building A, Ground Floor, Emergency | - |
| Cardiology | Building A, Floor 2, Cardiology | Building A, ICU |
| Laboratory | Building B, Laboratory | - |
| Pharmacy | Building A, Ground Floor, Pharmacy | Building B, Pharmacy |

## Tips for Success

1. **Start simple** - Don't over-engineer the hierarchy
2. **Use codes** - Short codes make locations easier to identify
3. **Be consistent** - Use the same naming pattern throughout
4. **Set primary locations** - Every department should have one main location
5. **Keep locations active** - Use inactive status, don't delete

## Next Steps

Once locations and departments are set up:

- Configure user roles and permissions
- Set up patient registration
- Configure billing categories
- Add clinical workflows

See the [User Guide](README.md) for detailed documentation.