Contact person: Business Client

Phone:Show

Email:Show

Location: Cumming, United States

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"---

# **FunFin Eco-Spender – Game Plan**

**Target Audience:** Middle schoolers (grades 6–8, ages 11–14)
**Objective:** Teach students ethical and eco-conscious finance through fun, interactive decision-making.

---

## **1. Login System**

* **Student Login:** Gmail OAuth 2.0
* **Optional Teacher/Admin Login:** View class progress and stats
* **Counters Assigned to Student:**

* **Money Counter:** Starts at $100
* **EcoMeter / Ethical Points:** Starts at 50–60

**Notes:**

* Money can go below $0; EcoMeter can go below 0. Both trigger game replay.
* Neither counter can exceed 100.

---

## **2. Core Features**

| Feature | Description |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Money Counter** | Tracks remaining virtual budget. Updates in real-time. Cannot exceed $100; can go below 0 (triggers replay). |
| **EcoMeter / Ethical Points** | Tracks environmental & ethical choices. Updates after each decision. Cannot exceed 100; can go below 0 (triggers replay). |
| **EcoGuru Hints** | Pop-up guidance for each scenario explaining trade-offs. Animated avatar for engagement. |
| **Scenario Engine** | Loads 100 pre-defined scenarios dynamically from JSON, divided into 5 levels. |
| **Replay System** | Allows retry when thresholds breached: current scenario, level, or entire game. Counters reset appropriately. |
| **Certificate of Completion** | Generated when thresholds met: Money ≥ $0, Eco ≥ 50, Ethical ≥ 50. Includes pie chart showing budget allocation by category. |

---

## **3. Game Mechanics**

### **Counters & Scoring**

* **Money Counter:** $100 start. Goes down with purchases; can go below 0.
* **EcoMeter / Ethical Points:** Start at 50–60. Positive actions increase, negative actions decrease.
* **Color Feedback:**

* Green = good (>75)
* Yellow = moderate (50–75)
* Red = poor (<50)
* **Thresholds:**

* Money < 0 → replay triggered
* Eco/Ethical < 50 → replay triggered

### **Replay Options**

* Retry **current scenario** (restore counters to scenario start)
* Restart **level** (reset counters to level start)
* Restart **entire game** (reset counters to full starting values)

### **Scenario Points**

* **Money Impact:** -$1 to -$30 per choice
* **Eco/Ethical Impact:** ±5 to ±20 per choice
* **Counters capped at 100** for positive gains

---

## **4. Scenario Structure**

Each scenario contains:

1. **Scenario Text** – Describes the decision students must make
2. **Options (2–3)** – Each with:

* Cost (money spent)
* Eco/Ethical points gained/lost
* Category: Food, Clothing, Transport, Entertainment, Donations, Miscellaneous
3. **EcoGuru Hint** – Guidance explaining trade-offs

**Levels (20 scenarios each):**

* **Level 1:** Budgeting Basics
* **Level 2:** Eco-Friendly Spending
* **Level 3:** Ethical Finance & Community
* **Level 4:** Complex Trade-Offs
* **Level 5:** Final Challenge / Multi-Step Decisions

---

## **5. Certificate of Completion**

**Award Criteria:** Money ≥ $0, Eco ≥ 50, Ethical ≥ 50

**Certificate Layout:**

* Header: “FunFin Eco-Spender Certificate of Completion”
* Student Name & Date
* Achievement Summary Text
* Final Scores: Money remaining, Eco Points, Ethical Points
* Pie Chart: Visual breakdown of spending by category
* EcoGuru Seal / Icon
* Footer: FunFin Logo / Tagline

**Notes:** Pie chart is **color-coded** for categories to help students understand their budget decisions.

---

## **6. UI/UX Design**

* **Modern 2D Dashboard** – Easy-to-read counters and icons
* **Counters Visible in Corner** – Real-time updates
* **EcoGuru** – Animated pop-up avatar with helpful hints
* **Scenario Icons** – Simple 2D illustrations for clarity
* **Certificate** – Clean, visually appealing layout

---

## **7. Developer Instructions**

1. Implement **login system** (Gmail OAuth)
2. Build **game engine** to load scenarios from JSON
3. Integrate **Money Counter & EcoMeter** with real-time updates
4. Implement **replay logic** based on thresholds with EcoGuru pop-ups
5. Design **certificate generator** including pie chart
6. Ensure **all 100 scenarios** work correctly with costs, points, and hints
7. Use **reusable UI components** for buttons, charts, pop-ups
8. Optional: **Responsive design** for tablet/desktop

---

## **8. Outcome**

* Fully functional ethical finance game for middle schoolers
* Counters and EcoGuru provide **instant feedback**
* Replay system reinforces learning and allows recovery from mistakes
* Certificate encourages students and visually summarizes achievements
* JSON structure makes it easy to **add or update scenarios** in the future" (client-provided description)