Pharmacy suite
Chemist and dispensary operations — batch/expiry stock, regulatory product metadata, and a dedicated Pharmacy suite workspace.
Full product scope: PHARMACY_SUITE_MASTER_SCOPE.md.
Module key
pharmacy_management — enable on subscription tier features. For chemist-only tenants, also set:
"suite_experience": "pharmacy"
This hides rental, hospitality, and manufacturing from navigation.
Permissions
| Gate | Purpose |
|---|---|
view-pharmacy |
Hub, batches, near-expiry report |
manage-pharmacy-setup |
Suite settings |
manage-pharmacy-batches |
Record and adjust batch stock |
Typical workflow (Phase 0)
- Enable tier —
pharmacy_management+ core modules (operations,inventoryminimum). - Suite settings —
/pharmacy/settings— FEFO, expiry rules, batch requirements. - Medicines — On Products → Add / Edit, when you have
manage-pharmacy-setupand thepharmacy_managementmodule, use the Pharmacy profile card to mark batch-tracked items (prescription / controlled flags, schedule, storage, dispensing label). Batches are still added under Pharmacy → Batches. - Sell — Standard POS. When
require_batch_on_saleis on and the item is a pharmacy product, dispensing uses FEFO by default. Cashiers can open Batches on a cart line to override which batch IDs sell, as long as picked quantities sum to the line’s base units; quote checkout cannot use manual picks. - Monitor — Near-expiry report under Pharmacy → Reports.
Tier examples
| Tier slug (example) | Features |
|---|---|
chemist_kiosk |
pharmacy_management, operations, inventory, suite_experience: pharmacy |
chemist_pro |
Kiosk + crm, reports, expenses |
chemist_enterprise |
Pro + accounts, hr, integrations, analytics, advanced_reports, pos_credit |
Create tiers in Platform → Subscription tiers; copy module checkboxes from presets in config/business_modules.php → tier_presets.
Routes (Phase 0)
| Route | Purpose |
|---|---|
pharmacy.index |
Suite hub |
pharmacy.batches.index |
Batch register |
pharmacy.batches.create |
Add batch stock |
pharmacy.reports.near-expiry |
Expiring batches |
pharmacy.settings.edit |
Organization settings |
Related
- Corporate UI:
.cursor/rules/corporate-form-ui.mdc(forms/lists) - Modules:
docs/BUSINESS_MODULES_AND_TIERS.md