# Pharmacy Workflows

> Use this guide for day-to-day medication catalog, dispensing, stock, and point-of-sale work in FlowRise HMS.

For current rollout status, see [Module Status](../shared/module-status.md).

## What Pharmacy Means in Practice

Pharmacy is where medication orders become **dispensed medicine** with stock tracking.

In simple terms:

- clinicians place medication orders through **Clinical** (`ServiceRequest` / `RequestItem`)
- pharmacy staff fulfill those orders from the **Pharmacy** cluster
- stock levels and dispense records stay linked back to the original request item

## Who Uses This Workflow

- pharmacists and pharmacy technicians
- nurses or clinicians checking dispense status
- administrators maintaining the medication catalog and stock

## The Basic Flow

```text
Clinician places medication RequestItem in Clinical
        ->
Pharmacy queue/widget surfaces pending work
        ->
Pharmacy staff dispense against the request item
        ->
Stock is decremented and a Dispense record is created
```

## Common Scenarios

### 1. Dispense a clinical medication order

1. Open the **Pharmacy** cluster in the sidebar.
2. Review the dispensing queue widget or open **Dispenses**.
3. Locate the request tied to the patient order.
4. Confirm stock availability and complete the dispense workflow.
5. Verify the dispense is linked to the clinical request item.

### 2. Sell over-the-counter items at the pharmacy desk

1. Open **Pharmacy POS** in the Pharmacy cluster.
2. Add medications or services to the cart.
3. Apply discounts or tender payment as your branch policy allows.
4. Complete checkout; stock and billing side effects are handled by pharmacy services.

### 3. Maintain catalog and stock

1. Use **Medications** and **Drugs** resources to maintain catalog data.
2. Use **Stock Items** to track on-hand quantities.
3. Use **Stock Movements** to review adjustments, receipts, and other inventory changes.

## Current Filament Surfaces

| Surface | Purpose |
|---------|---------|
| Medications | Branch medication catalog |
| Drugs | Reference drug master data and imports |
| Stock Items | On-hand stock records |
| Stock Movements | Stock change history |
| Dispenses | Dispense records linked to clinical request items |
| Pharmacy POS | Walk-in / OTC checkout |
| Pharmacy Report | Operational and sales reporting widgets |

## Permissions and Safety

- prescription-required items may be blocked for users without authorized roles
- controlled substances and insufficient-stock conditions raise domain exceptions
- always verify patient context before dispensing against a clinical order

## Related Guides

- [Clinical Workflows](clinical-workflows.md)
- [Billing Workflows](billing.md)
- [Pharmacy Module README](../../Modules/Pharmacy/README.md)