# HelpingHand

> Food bank e-commerce platform for managing orders, fulfilment, referrals, and donations.

## Audiences
- Admin: food bank staff who manage their food bank's operations
- Recipient: people receiving food from the food bank

## Admin Docs
- [Admin Overview](/docs/admin/index): Feature overview for food bank administrators
- [Orders](/docs/admin/orders): Order management, fulfilment, picking, and status tracking
- [Products](/docs/admin/products): Product catalogue, variants, bundles, barcodes, stock levels, scanning, and stocktake
- [Customers](/docs/admin/customers): Customer records, demographics, and groups
- [Pickup Locations](/docs/admin/pickup-locations): Location setup, scheduling, and cutoff times (pickup mode)
- [Referrers](/docs/admin/referrers): Referrer organisations, caseworkers, and auth codes
- [Donations](/docs/admin/donations): Donation choices and points configuration
- [Reports](/docs/admin/reports): Pickup location reports and data exports
- [Training](/docs/admin/training): Training topics, questions, and video content
- [Questions](/docs/admin/questions): Custom registration and checkout questions
- [Recurring Orders](/docs/admin/recurring-orders): Recurring order management

## Recipient Docs
- [Recipient Overview](/docs/recipient/index): Guide for food recipients
- [Placing an Order](/docs/recipient/placing-an-order): Browsing products, cart, and ordering
- [Checkout](/docs/recipient/pickup): Checkout flow and fulfilment options
- [Account](/docs/recipient/account): Registration, login, profile, and order history
- [Referral](/docs/recipient/referral): Auth codes and referrer linking
- [Recurring Orders](/docs/recipient/recurring-orders): Setting up and managing recurring orders

## Key Concepts
- Separate instances: each food bank has its own separate instance
- Referrers: organisations that refer recipients to the food bank
- Fulfilment modes: pickup locations, drop-in kiosk, registration only, or delivery
- Pickup locations: physical sites where recipients collect orders (one of several fulfilment modes)
- Auth codes: 8-digit codes issued by referrer contacts that grant recipients access to register
- Donation choices: configurable donation-to-points mappings
- Pricing modes: points only, currency only, or both
- Recurring orders: automatic order repetition on weekly/fortnightly/monthly schedules

## Glossary
- [Glossary](/docs/glossary): Canonical definitions of all domain terms