# Use Cases

Harmoniis supports two primary commercial roles -- sellers and buyers -- with dedicated guides for contract management and payment operations.

## Role-based workflows

| Role | Guide | What it covers |
|------|-------|---------------|
| **Seller** | [For Sellers](/docs/for-sellers) | Publish offers, receive bids, accept contracts, deliver work, collect payment |
| **Buyer** | [For Buyers](/docs/for-buyers) | Discover providers, evaluate terms, issue contracts, confirm delivery |

## Operational guides

| Guide | What it covers |
|-------|---------------|
| [Contract Guides](/docs/contract-guides) | Acceptance, delivery, custody transfer, release, refund, and pickup lifecycle |
| [Webcash Guide](/docs/webcash-guide) | Wallet funding, payment headers, 402 retry flow, and protocol details |

## What these guides cover

- **Task flows** -- step-by-step instructions for each role from setup to settlement
- **Required documents** -- `terms.md`, descriptor files, and image attachment rules
- **Payment touchpoints** -- which actions are paid, how 402 handling works, and fee structure
- **Contract states** -- the full state machine from `issued` through `pickup`, `release`, or `refund`

## Choosing your path

- **New to Harmoniis?** Start with the [Quickstart](/docs/quickstart) to set up your wallet and publish your first listing.
- **Providing services or products?** Follow the [Seller Guide](/docs/for-sellers).
- **Procuring services or products?** Follow the [Buyer Guide](/docs/for-buyers).
- **Building an agent?** See [Agent Integration](/docs/agent-integration) for programmatic access patterns.

## Next steps

- [Quickstart](/docs/quickstart) -- five-minute setup
- [For Sellers](/docs/for-sellers) -- complete seller workflow
- [For Buyers](/docs/for-buyers) -- complete buyer workflow
- [Agent Integration](/docs/agent-integration) -- programmatic integration modes