# 3. Flashcard Management

User Type: **Super Administrator**
Source: *Mi Digital Academy - Education CRM Features Document*

---

## 3. Flashcard Management

### 3.1 Auto-Generated Flashcards from Video Content
**What it does:** Generates flashcards automatically from video content using the platform's in-house AI: the system produces draft flashcards (the concept on one side, the definition/explanation on the other) based on a video's content, which the Super Administrator (or the content owners) then reviews and approves. AI generation accelerates flashcard creation; human review ensures the cards are accurate and useful for recall.

**Sub-features:**
- AI generation: flashcards generated from a video's content
- Card structure: the concept (front) and the definition/explanation (back)
- Draft status: the generated cards are drafts, not final
- Human review: the generated cards reviewed for accuracy before approval
- Approval: the reviewed cards approved into the deck (or corrected/rejected)
- Generation parameters: the card count and the focus requested
- Traceability: the AI-generated cards marked as such (the source video)
- Audit logging of generation and approval

**Super Administrator User Journey:**
1. For a video, Super Admin requests AI-generated flashcards: the count and the focus (the concepts to cover), from the video's content.
2. The platform's in-house AI generates the draft flashcards from the video content (the concept on the front, the definition/explanation on the back); they appear as drafts.
3. Super Admin reviews the generated cards for accuracy: the concepts match the video's content and the definitions are correct.
4. For a correct card, approves it into the deck (it is now available for recall practice).
5. For an inaccurate or off-topic card, corrects it (and approves the correction) or rejects it (it does not enter the deck).
6. Confirms the traceability: the AI-generated cards are marked as such, with the source video, so their origin is known.
7. Reviews the generation parameters for the next batch (adjusting the count/focus based on the review outcome).
8. The generation and approval events are audit-logged with the video, the cards, the actor, and the timestamp.

**Rules & Edge Cases:**
- AI-generated flashcards are drafts; they enter the deck only after human review and approval.
- The card structure is the concept (front) and the definition/explanation (back); it is the recall format.
- The review checks accuracy (the concept matches the content, the definition is correct); an inaccurate card is corrected or rejected.
- The generation parameters (count, focus) are set per request; they are explicit.
- The AI-generated cards are marked as such, with the source video; the origin is traceable.
- Generation and approval are audit-logged with the video, cards, actor, and timestamp.

### 3.2 Image and Audio Support, and Topic/Difficulty Categorization
**What it does:** Enriches the flashcards with image and audio support and organizes them by topic and difficulty: the Super Administrator adds the images (the visual for a concept) and the audio (the pronunciation/explanation) to the cards, and categorizes the cards by topic and difficulty, so the recall practice is multimodal and the decks are organized for targeted study.

**Sub-features:**
- Image support: the image attached to a card (the visual for the concept)
- Audio support: the audio attached to a card (the pronunciation/explanation)
- Topic categorization: the cards categorized by topic
- Difficulty categorization: the cards categorized by difficulty
- Deck organization: the cards organized into decks by topic/difficulty
- Recall practice: the cards used for recall (the learner flips to check)
- Audit logging of card enrichment/categorization

**Super Administrator User Journey:**
1. For a flashcard deck, Super Admin adds the image support: the image for the concept cards (the visual that aids recall).
2. Adds the audio support: the audio for the cards that need it (the pronunciation, the spoken explanation).
3. Categorizes the cards by topic (the cards grouped by the topic they cover) and by difficulty (the easy/medium/hard cards).
4. Organizes the decks: the cards into decks by topic/difficulty, so a learner can study a specific topic or difficulty.
5. A learner uses the deck for recall practice: they see the concept (front), recall the definition (back), and flip to check; the image/audio aid the recall.
6. For a card that needs a visual (a concept that is easier with an image), Super Admin adds the image; the change is recorded.
7. Reviews the categorization: the cards are in the right topic/difficulty (a mis-categorized card is moved); the decks are organized.
8. The card enrichment/categorization is audit-logged with the deck, the cards, and the timestamp.

**Rules & Edge Cases:**
- The image and audio are attached to the cards where they aid recall; they are not mandatory for every card.
- The cards are categorized by topic and difficulty; the decks are organized for targeted study.
- A mis-categorized card is moved to the right topic/difficulty; the change is recorded.
- The recall practice is the flip-to-check format; the learner recalls before checking.
- The image/audio are curated (they match the concept); a misleading visual is not attached.
- Card enrichment/categorization is audit-logged with the deck, cards, and timestamp.

### 3.3 Public Flashcard Library and Moderation of Shared Decks
**What it does:** Manages the public flashcard library: the community-created flashcard decks that are shared publicly, and the moderation of the shared decks. The Super Administrator oversees the public library so the shared decks are accurate and appropriate — the community contribution is a feature, but it is moderated so a bad deck does not mislead the learners.

**Sub-features:**
- Public library: the community-created decks shared publicly
- Deck submission: a learner/teacher submits a deck to the public library
- Moderation: the submitted decks reviewed for accuracy and appropriateness
- Approval: the reviewed decks approved into the public library (or rejected)
- Rejection: a deck that fails the review rejected (with the reason)
- Removal: a published deck removed where it is found to be faulty
- Audit logging of the moderation actions

**Super Administrator User Journey:**
1. A learner/teacher creates a flashcard deck and submits it to the public library.
2. Super Admin (or the designated moderator) reviews the submitted deck for accuracy (the concepts and definitions are correct) and appropriateness (the content is suitable).
3. For a deck that passes, approves it into the public library; it is now available to all learners.
4. For a deck that fails (inaccurate cards, inappropriate content), rejects it with the reason; the submitter is informed and can revise.
5. For a published deck that is later found to be faulty (an error reported), Super Admin removes it from the public library; the removal is recorded.
6. Reviews the public library: the shared decks, their quality, and the moderation queue (the pending submissions), so the library is curated.
7. For a high-quality deck (frequently used, well-rated), Super Admin may feature it (a highlighted deck); the curation is visible.
8. The moderation actions are audit-logged with the deck, the action (approve/reject/remove), and the timestamp.

**Rules & Edge Cases:**
- The public library is the community-created decks; they are shared publicly, but moderated.
- A submitted deck is reviewed for accuracy and appropriateness before it is published; it is not auto-published.
- A rejected deck is informed of the reason; the submitter can revise and resubmit.
- A published deck can be removed where it is found faulty; the removal is recorded.
- The moderation queue is managed (the pending submissions reviewed); the library is curated, not a free-for-all.
- Moderation actions are audit-logged with the deck, action, and timestamp.