# PHINMA Learning Companion — POC Context

**Date:** 2026-02-17
**Project Lead:** JedAI (cyberblaze007)
**Platform:** Symphony (Symph Agency)

---

## Project Overview

**Client:** PHINMA Education (144K+ students, 10+ institutions)
**Pilot Location:** Southwestern University PHINMA (SWU), Cebu
**Pilot Subject:** Anatomy & Physiology (Anaphy)
**Timeline:** 2-3 weeks
**Goal:** Reduce dropout rate (currently 15-20%) by helping students pass difficult courses

---

## Three User Portals

### 1. Teacher Portal (Functional)
- **Student List:** View all students with color-coded status (🔴<65%, 🟡65-75%, 🟢>75%)
- **Student Detail:** Progress %, quiz history, attempts count, struggling topics, current learning path
- **Auto-Intervention:** System-generated recommendations based on performance
- **Feedback:** Teachers can send personalized messages to students

### 2. Student Portal (Functional)
- **Subject Dashboard:** All subjects with status + encouraging messages
- **Learning Path:** AI-curated steps (Reading → Video → Quiz) with locked progression
- **Content:** Static content + links to external resources
- **Quizzes:** Multiple choice with progress tracking
- **AI Feedback:** Personalized feedback after quiz completion
- **AI Q&A:** Static UI only ("Coming Soon") — NOT functional in POC

### 3. Admin Dashboard (Static — Display Only)
- **Course Overview:** All courses with student count, avg progress, status
- **Sections Alert:** Which sections are falling behind
- **Student Distribution:** On Track / Needs Help / At Risk breakdown
- **Content Management:** UI mockup only (upload, add video, create quiz buttons visible but non-functional)

---

## Technical Stack
- Frontend: Next.js 15 + Tailwind CSS + shadcn/ui
- Database: Firebase Firestore
- Auth: Firebase Auth (Email/Password)
- AI: OpenAI GPT-4 (feedback generation)
- Hosting: Vercel or Cloud Run

---

## POC Boundaries

**Functional:**
- Teacher: student list, progress, interventions, feedback
- Student: subjects, learning path, content, quizzes, AI feedback

**Static UI (non-functional buttons):**
- Student: AI Q&A
- Admin: Content upload, quiz creation

**Not Included:**
- Mobile responsiveness
- LMS integrations (Canvas, Gradechum)
- Actual file uploads

**Assumption:** Students have pre-existing quiz/exam results (seeded mock data)

---

## Brand Guidelines
- Primary: PHINMA Green (#00652E)
- Typography: Montserrat (headings) + Open Sans (body)
- Style: Clean, practical, no-frills
- Tagline: "Making lives better through education"
