Merge pull request #165 from R3Nexe/dev

Domain Questions & Interview Prep

Author: sky-ruler

.gitignore

@@ -11,7 +11,22 @@ brain/
 server/DEPLOYMENT_NOTES.md
 CLAUDE.MD
 .playwright-mcp/
-docs/
 .superpowers/sdd/
 .claude/
 CLAUDE.md
+# Added by code-review-graph
+.code-review-graph/
+.kiro/steering/
+.qoder/
+.gemini/
+.cursor/
+.codebuddy/
+.cursorrules
+.mcp.json
+CODEBUDDY.md
+GEMINI.md
+AGENTS.md
+opencode.jsonc
+QODER.md
+.windsurfrules
+docs/superpowers/

CONTEXT.md

@@ -0,0 +1,97 @@
+# Algorithm Arena
+
+A platform for running DSA coding-challenge events for a community, built around a
+challenge → submission → manual review → scoring lifecycle. This glossary fixes the
+vocabulary for **questions, answers, and scoring** — the area most prone to drift now
+that questions come in more than one shape.
+
+## Questions
+
+**Question**:
+A single prompt a participant answers, stored as a `Challenge` document. Every question
+has a `type`. All questions share difficulty, points, and `tags`.
+_Avoid_: Problem, task (except "DSA question", see below).
+
+**Type**:
+The discriminator on a question: `dsa`, `mcq`, or `written`. Determines how it is
+answered, graded, and displayed. Defaults to `dsa`.
+
+**DSA question**:
+A `type: dsa` question answered with code, run against test cases via Judge0, then
+manually reviewed. The original and only pre-existing question shape.
+_Avoid_: Coding challenge, algorithm problem.
+
+**Domain question**:
+The umbrella for `mcq` and `written` questions — interview-style questions about a
+subject area rather than code. Lives in a standalone pool, not in a Question Set.
+_Avoid_: Theory question, quiz question.
+
+**MCQ question**:
+A `type: mcq` domain question with a fixed set of `options` and exactly one
+`correctOption`. Auto-graded server-side.
+_Avoid_: Poll, single-choice.
+
+**Written question**:
+A `type: written` domain question answered in prose, carrying a `modelAnswer`. The
+learner self-assesses against the model answer; a reviewer separately scores it.
+_Avoid_: Essay, long-answer, subjective question.
+
+**Question Set**:
+A weekly, deadline-bound collection of DSA questions with a target level. Domain
+questions are **not** part of any Question Set.
+_Avoid_: Assignment, batch, week.
+
+**Interview Prep**:
+The participant-facing area where the standalone domain-question pool is browsed by
+`tags` and answered. Distinct from Missions (the DSA/Question-Set area).
+
+## Answering & mastery
+
+**Submission**:
+A record of one participant answering one question — code, a selected MCQ option, or
+written prose — carrying a review status and the points actually awarded.
+
+**Mastery status**:
+A participant's per-question state, held in `DomainProgress`: `Unattempted`,
+`NeedsReview`, or `Mastered`. Independent of points.
+_Avoid_: Progress, completion, done.
+
+**Needs-review**:
+The mastery status of a domain question the participant got wrong (MCQ) or self-marked
+as not-yet-understood (written). Resurfaces after a cooldown.
+_Avoid_: Failed, incorrect, pending.
+
+**Mastered**:
+The mastery status of a domain question answered correctly (MCQ) or self-marked as
+understood (written). Still viewable, no longer resurfaced.
+
+**Self-assessment**:
+For written questions only: the participant's own *Got it* / *Review later* judgement
+after seeing the model answer. Drives mastery status, never points.
+
+**Cooldown**:
+The lock period before a Needs-review question may be re-attempted. Escalates by
+doubling per wrong/missed attempt (2 → 4 → 8 … days), capped once no points remain
+to earn.
+_Avoid_: Timeout, delay, wait.
+
+## Scoring
+
+**Full points**:
+A question's base award, derived from its difficulty (Easy/Medium/Hard). The starting
+value the MCQ decay halves and the amount a written approval grants.
+
+**Decayed award**:
+The MCQ points for a correct answer on attempt _n_: `round(fullPoints / 2^(n-1))`,
+dropping to 0 once it would fall below 5. Anti-farming device unique to auto-graded
+MCQ.
+_Avoid_: Penalty, discount.
+
+**Awarded points**:
+The points a Submission actually granted (a decayed award, full points, or 0) — as
+distinct from the question's full points. Recorded on the Submission.
+
+**Domain-mastered count**:
+A participant's tally of mastered domain questions, tracked separately from
+`solvedProblems` so domain badges and DSA badges stay independent.
+_Avoid_: Solved (that term is reserved for DSA `solvedProblems`).

admin-client/src/index.css

@@ -8,6 +8,7 @@
 /* Default Stack Imports: Inter (Body), Michroma & Orbitron (Headings) */
 @import url("https://rsms.me/inter/inter.css");
 @import url('https://fonts.googleapis.com/css2?family=Michroma&family=Orbitron:wght@400..900&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Exo+2:ital,wght@0,400;1,200&family=Work+Sans:ital,wght@0,100..900;1,100..900&display=swap');
 
 /* Additional Alternative Premium Fonts (Pre-imported for easy testing): */
 /*
@@ -18,9 +19,9 @@
    - Syne: Expressive, artistic headline font
    - Montserrat: Bold, high-character sans-serif
 */
-@import url('https://fonts.googleapis.com/css2?family=Exo+2:ital,wght@0,400;1,200&family=Work+Sans:ital,wght@0,100..900;1,100..900&display=swap');
 
-/* Tailwind Engine Directives */
+/*
+*/
 @tailwind base;
 @tailwind components;
 @tailwind utilities;
@@ -620,6 +621,7 @@ samp,
     }
 }
 
+
 /* Recent Activity Icon Glow in Dark Mode */
 [data-theme="dark"] .recent-activity-icon {
     filter: drop-shadow(0 0 6px rgba(var(--accent-rgb), 0.75));
@@ -638,6 +640,7 @@ samp,
     color: #25D366 !important;
     border-color: #25D366 !important;
     background-color: rgba(37, 211, 102, 0.1) !important;
+/* Default Stack Imports: Inter (Body), Michroma & Orbitron (Headings) */
 }
 
 .social-instagram:hover {
@@ -724,9 +727,6 @@ samp,
 /* 1. IMPORT GOOGLE FONTS & CUSTOM FONTS
    Uncomment or add imports below to easily test different styling. */
 
-/* Default Stack Imports: Inter (Body), Michroma & Orbitron (Headings) */
-@import url("https://rsms.me/inter/inter.css");
-@import url('https://fonts.googleapis.com/css2?family=Michroma&family=Orbitron:wght@400..900&display=swap');
 
 /* Additional Alternative Premium Fonts (Pre-imported for easy testing): */
 /*
@@ -737,7 +737,6 @@ samp,
    - Syne: Expressive, artistic headline font
    - Montserrat: Bold, high-character sans-serif
 */
-@import url('https://fonts.googleapis.com/css2?family=Exo+2:ital,wght@0,400;1,200&family=Work+Sans:ital,wght@0,100..900;1,100..900&display=swap');
 
 /* Tailwind Engine Directives */
 @tailwind base;
@@ -1434,5 +1433,3 @@ samp,
         animation: slideRightIn 0.6s cubic-bezier(0.16, 1, 0.3, 1) forwards;
     }
 }
-
-

admin-client/src/pages/AdminPanel.jsx

@@ -12,6 +12,7 @@ import PageHeader from '../components/PageHeader';
 // --- Subcomponents for Tabs ---
 import DashboardTab from './admin/DashboardTab';
 import QuestionSetsTab from './admin/QuestionSetsTab';
+import DomainQuestionsTab from './admin/DomainQuestionsTab';
 
 import ClanManagerTab from './admin/ClanManagerTab';
 import ResourcesTab from './admin/ResourcesTab';
@@ -20,7 +21,7 @@ import ReviewTab from './admin/ReviewTab';
 
 const AdminPanel = () => {
   const [searchParams] = useSearchParams();
-  const validTabs = ['dashboard', 'review', 'sets', 'clans', 'resources', 'members'];
+  const validTabs = ['dashboard', 'review', 'sets', 'domain', 'clans', 'resources', 'members'];
   const initialTab = validTabs.includes(searchParams.get('tab')) ? searchParams.get('tab') : 'dashboard';
   const [activeTab, setActiveTab] = useState(initialTab);
   const [initialClanFilter, setInitialClanFilter] = useState('');
@@ -29,6 +30,7 @@ const AdminPanel = () => {
     { id: 'dashboard', label: 'Overview', icon: FiActivity },
     { id: 'review', label: 'Review Work', icon: FiEye },
     { id: 'sets', label: 'Question Sets', icon: FiCode },
+    { id: 'domain', label: 'Domain Questions', icon: FiFileText },
 
     { id: 'clans', label: 'Clan Manager', icon: FiShield },
     { id: 'resources', label: 'Resources', icon: FiFolder },
@@ -85,6 +87,7 @@ const AdminPanel = () => {
           {activeTab === 'dashboard' && <DashboardTab setActiveTab={setActiveTab} setInitialClanFilter={setInitialClanFilter} />}
           {activeTab === 'review' && <ReviewTab />}
           {activeTab === 'sets' && <QuestionSetsTab />}
+          {activeTab === 'domain' && <DomainQuestionsTab />}
 
           {activeTab === 'clans' && <ClanManagerTab />}
           {activeTab === 'resources' && <ResourcesTab />}