# Understanding the Platform

### Navigation at a Glance

* **Home (Dashboard):** Your live points, daily check-in, activity streaks, badges, referrals, and task/project stats.
* **Marketplace:** Browse and accept projects by category (All, Educational, Accuracy, Social).
* **Earnings:** See a weekly points recap and a detailed ledger by Task / Check-in / Referral; view badges.
* **Leaderboard:** Rankings across Task Points, Check-in Points, Referral Points, and total Perle Points.
* **Referral:** Your invite link, share buttons (X, Telegram, Email), and referral analytics (totals, pending, points).

### How Points Work

#### Point System Overview

* **Task Points:** Earned for completing tasks in accepted projects.
* **Check-in Points:** Daily check-ins award points and help build your streak multiplier.
* **Referral Points:** Earn points when referrals join and participate.
* **Pending Points:** Points awaiting validation/settlement before they post to your total.
* **Spin Points:** Bonus points from daily spin wheel.
* **Feedback Points:** Earn points for providing feedback.

#### Point Tracking & Transparency

* Your total points are visible on every page header tile (Home/Earnings/Referral).
* **Earnings → Weekly Recap** shows a graph of points by day for the current week.
* **Earnings → Task / Badges / Points tabs** give itemized history (title, project, date, points, status).
* **Pending, Referral, and Total** counters are surfaced on the Dashboard and Referral pages.

### Dashboard (Home)

What you see:

* **Points Card:** Total points and last 24h delta.
* **Daily Check-in:** Tap “Check in” to claim points and extend your streak.
* **Active Days / Longest Streak:** Consistency metrics that influence multipliers and badges.
* **Quick Stats:** Accepted Tasks, Total Tasks, Completed Projects, Total Projects (with week-over-week indicator).
* **Referral Snapshot:** Total Referrals, Referral Points, Pending Points + your invite link.
* **Profile & Badges:** View current tier and open the full badge list.
* **Recommended Projects:** Shortcut to Marketplace when opportunities are live.

**Pro tip:** Check in daily first, then accept tasks from Recommended Projects or Marketplace for a higher effective yield.

### Marketplace

How it works:

* **Popular Projects:** When live, featured opportunities appear here.
* **Category Tabs:** All / Educational / Accuracy / Social to quickly filter.
* **Sort:** Use the Sort control (bottom right) to order by newest, points, or relevance (options may vary by release).
* **Accepted/Total/Completed/Projects tiles:** Your current workload and throughput.

**Project types you’ll see:**

* **Educational:** Micro-lessons & quizzes to unlock higher-value work.
* **Accuracy:** Annotation, evaluation, and validation across text, image, audio, and video.
* **Social:** Community and referral-driven actions (when available).

### Earnings

* **Points Tile:** Live totals with quick chips for Task / Check-in / Referral subtotals.
* **Weekly Recap Chart:** A day-by-day bar chart of points earned this week.
* **Ledger Tabs**
  * **Task:** Per-task entries (Title, Project, Date, Points, Status).
  * **Badges:** Milestones that grant points or unlocks.
  * **Points:** Unified breakdown of all point events.
* **List Tools:** Sort and layout toggle (list/grid), plus pagination and rows per page.

**Pro tip:** If an expected entry isn’t posted, check the “Pending Points” on Dashboard/Referral. Most items settle after validation.

### Leaderboard

* **Columns:** Position, User, Task Points, Check-in Points, Referral Points, Perle Points (total).
* **Purpose:** Shows platform-wide performance to recognize top contributors across different activities.
* **Fairness:** Quality and validation rules still apply, high accuracy sustains rank better than raw volume.

**Pro tip:** Balanced activity wins, combine daily check-ins, steady task accuracy, and ethical referrals.

### Referral

* **Share & Earn Panel:** Your invite link + share buttons (X, Telegram, Email).
* **Counters:** Total Referrals, Referral Points, Pending Points.
* **Search & Tabs:** Search referrals; switch between User and Tasks views to audit what’s crediting your points.

**Payout logic (high level):**

* You earn a percentage of your referrals’ verified points (terms may vary by campaign).
* Referral Points appear as “Pending” until validation completes.

### Progression & Tiers

* **Tier Badges:** Novice → Researcher → Scholar → Professor → Mastermind (based on lifetime points and sustained accuracy).
* **Accuracy Gates:** Maintaining quality (e.g., benchmark/consensus pass rates) unlocks higher-value tasks.
* **Streak Effects:** Longer streaks → stronger multipliers → faster tier progress.
* **Visibility:** Your current tier and badges are shown on Dashboard and in Earnings → Badges.

**Coming soon:** The first tier (**Researcher**) is now available and can be easily unlocked through Educational projects.  Higher tiers will be introduced in upcoming platform releases.

### Best-Practice Tips

* Check in daily to keep your streak and multiplier active.
* Finish Educational modules early to unlock Accuracy projects.
* Prioritize accuracy. Quality boosts points more than volume over time.
* Use the Marketplace filters to target projects that match your domain.
* Invite peers you trust. High-quality referrals sustain Referral Points (and your reputation).
* Monitor Earnings weekly to catch issues early and track your growth.

### **Tier Progression System**

COMING SOON


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://perle.gitbook.io/perle-docs/getting-started/understanding-the-platform.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
