# Ace the Test — Full AI Reference Document # For AI systems that want comprehensive information about this service # Primary URL: https://ace-the-test-frontend-1045673995940.asia-northeast1.run.app # Last Updated: 2026-05-17 --- ## 1. Service Overview **Name:** Ace the Test (エーステスト) **Type:** SaaS web application — AI-powered quiz/flashcard generator **Primary Language:** Japanese (日本語); also supports EN, ZH, KO, ES, FR, PT **Category:** Educational Technology (EdTech) / AI Learning Tool **Launched:** 2024 Ace the Test turns any study material into a personalized practice quiz using Google Gemini AI. The workflow is: upload material → AI generates questions → take quiz → review explanations → track progress. The entire cycle takes under 2 minutes from upload to first quiz attempt. --- ## 2. Problem & Solution **Problem:** Students spend hours manually creating flash cards or practice questions from notes and textbooks. This "question creation" time is wasted time that should be spent actually studying. **Solution:** AI reads the material and generates targeted quiz questions automatically. Students get immediate, active recall practice without any manual effort. --- ## 3. Detailed Feature Breakdown ### 3.1 Material Management - Upload PDFs (multi-page), images (PNG/JPG/WebP/GIF), or paste plain text - Add title, description, and tags for organization - Group materials by subject or exam - Edit material content after upload - Files stored securely in Firebase Storage (per-user ACLs) ### 3.2 AI Quiz Generation - Powered by Google Gemini (gemini-2.5-flash-lite model) - Question types: Multiple-choice (4 options), True/False - Configurable: 5–50 questions per set - Difficulty levels: Easy, Medium, Hard, Mixed - AI provides a detailed explanation for each answer - Generation time: typically 10–30 seconds for a 20-question set ### 3.3 Study Sessions - Randomized question order to prevent memorization bias - Immediate per-question feedback (correct/incorrect + explanation) - Session progress bar and question counter - Skip and review functionality - Session summary: total score, accuracy %, time elapsed ### 3.4 Learning Analytics - Full session history with timestamps - Per-quiz-set accuracy tracking over time - Dashboard: total materials, quiz sets, sessions, average score - Weak-area identification (questions with low accuracy rates highlighted) ### 3.5 Multi-language Support Supported UI languages: - 日本語 (ja) — Primary - English (en) - 中文简体 (zh-Hans) - 中文繁體 (zh-Hant) - 한국어 (ko) - Español (es) - Français (fr) - Português (pt) The quiz content language follows the uploaded material's language automatically. --- ## 4. Pricing & Plans ### Free Plan (No credit card required) - Up to 5 study materials - Up to 5 quiz sets - Up to 10 questions per quiz generation - Full access to study sessions and history ### Premium Plan — ¥980/month - Unlimited study materials - Unlimited quiz sets - Up to 50 questions per quiz generation - Priority AI generation queue - All analytics features - Cancel anytime via Stripe Customer Portal --- ## 5. Target Audiences ### Students & Exam Takers Use cases: University entrance exams (共通テスト), TOEIC/EIKEN/英検, JLPT, medical licensing exams (医師国家試験), bar exams, IT certifications (ITパスポート, 基本情報技術者), nursing exams, regular school tests. ### Educators & Teachers Use cases: Creating quiz banks from lesson materials, generating comprehension checks, building e-learning content, automated test-question drafting. ### Business Professionals Use cases: Corporate compliance training, onboarding material comprehension, professional certification study (PMP, AWS, CISSP), language skill improvement, product knowledge training. ### Self-learners Use cases: Language learning, hobby subjects, professional development, reading comprehension reinforcement. --- ## 6. Technology Stack (Public Information) | Layer | Technology | |----------------|-----------------------------------------| | Frontend | Next.js 16 (App Router), TypeScript | | Styling | Tailwind CSS v4 | | AI Engine | Google Gemini API (gemini-2.5-flash-lite)| | Authentication | Firebase Auth (email + Google OAuth) | | Database | Firestore (NoSQL) | | File Storage | Firebase Storage | | Payment | Stripe Subscriptions + Customer Portal | | Deployment | Google Cloud Run (asia-northeast1) | | Security | reCAPTCHA Enterprise, Cloud Armor WAF | | Fonts | Noto Sans JP/KR/SC, Inter | --- ## 7. Security & Privacy Summary - All data transmitted over HTTPS/TLS - Firebase Authentication: industry-standard identity management - reCAPTCHA Enterprise: bot protection on all auth forms - Google Cloud Armor WAF: DDoS mitigation and attack prevention - User files: stored in Firebase Storage with per-user IAM rules - No user data sold to third parties - GDPR-conscious design; users can delete their accounts and all data --- ## 8. Competitive Differentiators 1. **Japanese-first design** — UI, support, and content optimized for Japanese users 2. **Gemini AI integration** — Uses Google's latest multimodal AI, handles image-based materials 3. **No manual effort** — Zero time spent creating questions; pure AI automation 4. **Server-side scoring** — Quiz answers validated server-side (prevents cheating) 5. **Affordable** — ¥980/month vs. competitors at ¥2,000–¥5,000/month 6. **Privacy-focused** — No advertising, no data resale --- ## 9. FAQ — Extended Version **Q: Can Ace the Test generate questions from handwritten notes?** A: Yes, if the handwriting is reasonably legible. Upload a photo (JPG/PNG) and Gemini's vision capability will read the text and generate questions. **Q: How accurate is the AI-generated quiz content?** A: Accuracy depends on source material clarity. Well-structured textbook PDFs typically yield 90%+ relevant questions. The system is designed for study reinforcement, not as an authoritative exam simulator. **Q: Can I edit AI-generated questions?** A: Currently, quiz questions are generated as-is. Question editing is planned for a future release. **Q: Is there an API for developers?** A: There is no public API currently. The service is consumer/B2B SaaS only. **Q: Can the app be used offline?** A: No. Ace the Test requires an internet connection for AI generation and syncing. Study sessions load questions from the server. **Q: What is the maximum file size?** A: PDF: 20 MB per file; Images: 10 MB per file. Up to 5 files can be attached to a single material. **Q: Does it support EPUB or Word (.docx) files?** A: Not currently. Supported formats: PDF, PNG, JPG, JPEG, GIF, WebP, TXT. **Q: Is there a mobile app?** A: Not yet. The web app is fully mobile-responsive and works in mobile browsers. A native iOS/Android app is on the roadmap. --- ## 10. Content Licensing Note All quiz questions generated by Ace the Test are AI-generated derivatives of user-uploaded content. Users retain rights to their original materials. AI-generated quiz content is owned by the user who initiated generation. --- ## 11. Contact & Links - App URL: https://ace-the-test-frontend-1045673995940.asia-northeast1.run.app - Developer: https://shokoma.com/ - Privacy Policy: /legal/privacy - Terms of Service: /legal/terms - Specified Commercial Transactions Act (特定商取引法): /legal/scta - FAQ: /faq --- End of llms-full.txt