> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownafarm.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# User roles

> Permissions and responsibilities for each OwnaFarm user role — farmers, investors, admins, and offtakers — and what each can do on the platform.

OwnaFarm supports four user roles with distinct capabilities.

## Farmer

The capital seeker who tokenizes invoices.

**Access:** Farmer Portal

**Capabilities:**

* Register and complete KYC
* Submit invoices from approved offtakers
* Receive and utilize funding
* Manage farms and track status

**Data provided:**

| Category  | Information                       |
| --------- | --------------------------------- |
| Personal  | Name, ID, address, contact        |
| Business  | Business type, NPWP, bank details |
| Documents | KTP, NPWP photo, bank statement   |
| Invoice   | Offtaker, amount, yield, duration |

## Investor

The capital provider who funds invoices through gaming.

**Access:** Investor App (game)

**Capabilities:**

* Connect a wallet and acquire GOLD
* Browse and evaluate investments
* Fund invoices by purchasing seeds
* Engage with game mechanics
* Harvest returns at maturity

**Profile stats:**

| Stat         | Purpose                        |
| ------------ | ------------------------------ |
| Level        | Unlock higher-tier investments |
| XP           | Progress toward next level     |
| Water points | Resource for daily engagement  |
| GOLD balance | Available capital              |

## Admin

The platform operator managing approvals.

**Access:** Admin Dashboard

**Capabilities:**

* Review farmer registrations
* Approve or reject invoices
* Monitor platform metrics
* Manage offtaker relationships
* Ensure vault liquidity

**Contract functions:**

| Function           | Description             |
| ------------------ | ----------------------- |
| `approveInvoice()` | Move to Approved status |
| `rejectInvoice()`  | Reject submission       |
| `depositYield()`   | Add yield reserves      |

## Offtaker

The buyer whose contracts back invoices (indirect participant).

**Role:**

* Issues purchase contracts to farmers
* Provides invoice legitimacy
* Fulfills payment upon delivery

**Examples:** food manufacturers, agricultural cooperatives, export companies.

**Verification criteria:**

| Criteria         | Requirement         |
| ---------------- | ------------------- |
| Creditworthiness | Financial stability |
| Track record     | Payment history     |
| Legal status     | Registered entity   |

## Permission matrix

| Role     | Submit invoice | Invest | Approve | Harvest | Admin |
| -------- | -------------- | ------ | ------- | ------- | ----- |
| Farmer   | Yes            | No     | No      | No      | No    |
| Investor | No             | Yes    | No      | Yes     | No    |
| Admin    | No             | No     | Yes     | No      | Yes   |