Frequently Asked Questions

## 1. General Overview **Q: What is the purpose of the app?** A: Naija2Tor is an academic performance booster for Nigerian Senior Secondary School (SSS) students preparing for WAEC, NECO, and JAMB. It combines curriculum‑aligned study content, AI‑generated quizzes & flashcards, an AI tutor, performance tracking, and subscription billing.

**Q: What are its main features & functionalities?** * User authentication (Email/Password & Google) with individual profiles & class level * Curriculum (NERDC) aligned content & personal notes (create / edit / attach PDFs) * AI quiz generation (dynamic multiple‑choice questions) * AI flashcards (topic summarisation – inferred from flows, if implemented similarly) * Virtual Tutor & in‑app Floating Chatbot (guide vs tutor personas; guest mode with limits) * Performance tracking (quiz history, PDF & email reports, weekly parent email automation) * Subscription & billing via Paystack (monthly / annual) * PDF performance report generation (client) and scheduled parental reports (Cloud Functions)

## 2. User FAQ ### Getting Started **Q: How do I install / access the app?** A: It’s a web application. Visit the deployed site URL (e.g. https://naija2tor.ng or local dev at http://localhost:9003). No separate installation required beyond a modern browser.

**Q: What are the prerequisites?** * A modern browser (Chrome, Edge, Firefox, Safari) with JavaScript enabled. * (Optional) A Google account for Google sign‑in, or an email for email/password sign‑up. * (If subscribing) A valid payment method supported by Paystack.

**Q: How do I create an account?** 1. Click Sign Up. 2. Provide name, email, password (or use Google). 3. Pick class level (SS1–SS3) and optionally select subjects of interest. 4. Complete — you begin on a free trial (if configured) or free tier.

**Q: How do I sign in later?** Use the Sign In page with your email/password or Google button.

### Using Core Features **Q: How do I generate a quiz?** Navigate to Practice / Quiz section, choose subject, exam type (WAEC / NECO / JAMB / General), and number of questions. The AI flow produces structured multiple‑choice questions.

**Q: How does the AI tutor differ from the floating chatbot?** * Floating Chatbot (Katty “guide” mode by default) focuses on platform navigation and basic assistance; refuses purely academic solving requests unless in tutor mode. * Tutor mode (access via Tutor page) offers broader academic help within exam scope.

**Q: Guest vs authenticated experience?** Guests can ask only a limited number (configured ~3) of AI replies per session and chat history is not saved. Sign in to unlock persistent history, performance tracking, notes, and subscription features.

**Q: How do I create or manage notes?** Go to Notes > New. Enter title, content, optional subject/topic. You can attach PDFs (uploaded to Firebase Storage). Edit or delete from the notes list.

**Q: How do I get performance reports?** From Performance section you can generate a PDF report (download) or trigger an email (if the email callable is integrated in the UI). Parents with an email set may receive weekly automated summaries.

**Q: How do subscriptions work?** Choose Monthly or Annual on the Subscribe page. Payment processed by Paystack. After successful payment, the app calls a secure Cloud Function (`verifyPaystackPayment`) to activate/renew your subscription. Renewal date is stored; expired plans become inactive automatically via a daily scheduled job.

### Permissions & Data **Q: What permissions must I grant?** Only standard browser permissions. File upload permission if attaching note PDFs. No invasive device permissions are required.

**Q: What data do you store?** Name (if provided), email, chosen class level, subjects of interest, notes, quiz results, subscription metadata (plan, renewal date, payment reference), optional parent email, and chat messages (for logged‑in users) in Firestore.

### Common Issues & Self‑Help **Q: I can’t sign in (Auth error).** Ensure you used the correct email/password. If using Google, allow popups. Developer: confirm Firebase Auth providers are enabled.

**Q: Quiz generation spinner never finishes.** Likely AI key misconfiguration or temporary service issue. Refresh and retry. If persistent, contact support (developer should verify `GOOGLE_GENAI_API_KEY`).

**Q: Subscription paid but still not active.** Wait a few seconds and refresh. If unresolved, developer should check Cloud Function logs for `verifyPaystackPayment` and confirm the client invoked the callable with the Paystack reference.

**Q: Chat stops responding in guest mode.** You reached the guest reply limit. Sign in for continued conversation.

**Q: Rate limit message: “Too many messages.”** Wait ~30 seconds and retry (client‑side throttle: 5 msgs / 30s).

**Q: PDF report downloads but is blank or incomplete.** You may have no quiz results in the selected range. Take a quiz first and regenerate.

### Account & Privacy **Q: How do I delete my data?** Currently no in‑app full account deletion path described; contact support or an admin to remove your user document and associated records.