প্রকল্প সম্পর্কে

MathMaster Edu হলো শিক্ষার্থী ও শিক্ষকদের জন্য একটি স্মার্ট ভুল-প্রশ্ন ব্যবস্থাপনা প্ল্যাটফর্ম, যার মূল প্রবাহ হলো ছবি তুলে ভুল প্রশ্ন এন্ট্রি, AI কাঠামোবদ্ধ বিশ্লেষণ, গাণিতিক যাচাই, ভেক্টর আর্কাইভিং, দক্ষতা মূল্যায়ন ও অভিযোজিত পুনরাবৃত্তি। প্রকল্পে Streamlit ফ্রন্টএন্ড ও FastAPI গেটওয়ে ব্যবহৃত হয়, ব্যাকএন্ডে SQLAlchemy দিয়ে SQLite/MySQL/PostgreSQL ডেটা ব্যবস্থাপনা করা হয় এবং ChromaDB ভেক্টর অনুসন্ধান ক্ষমতা প্রদান করে। প্রধান বৈশিষ্ট্যগুলোর মধ্যে রয়েছে: AI ছবি তোলা প্রশ্ন এন্ট্রি, যেখানে ভিজ্যুয়াল বড় মডেল হাতে লেখা প্রশ্ন শনাক্ত করে পরীক্ষা-বিন্দু, ধাপে ধাপে ব্যাখ্যা, উত্তর, কঠিনতা, সহজে ভুল হওয়ার কারণ ও ভিন্নতা প্রশ্ন আউটপুট দেয়; বহু-মডেল প্রদানকারী বিমূর্তন, যা SiliconFlow, Tongyi Qianwen, Zhipu GLM, DeepSeek, OpenAI, Ollama বা Gemini-তে পরিবর্তনযোগ্য, Key না থাকলে স্বয়ংক্রিয়ভাবে ডেমো মোডে প্রবেশ করে; RAG ভেক্টর অনুসন্ধান সদৃশ প্রশ্ন পুনরুদ্ধার ও সেমান্টিক সার্চ সমর্থন করে, ভেক্টর স্টোর ব্যর্থ হলে কীওয়ার্ড অনুসন্ধানে অবনমন ঘটে; অন্তর্নির্মিত SM-2 বিরতি পুনরাবৃত্তি অ্যালগরিদম দিয়ে ফ্ল্যাশকার্ড-ধাঁচের পুনরাবৃত্তি; দক্ষতা ইঞ্জিন পুনরাবৃত্তি লগের সাথে মিলিয়ে সক্ষমতা প্রোফাইল ও দৈনিক পরিকল্পনা তৈরি করে; প্রতিটি ভুল প্রশ্নে বহু-রাউন্ড অনুসন্ধানমূলক ব্যাখ্যা সমর্থিত; শেখার ড্যাশবোর্ড জ্ঞান-বিন্দু বিতরণ, দুর্বল জ্ঞান-বিন্দু ও এন্ট্রি প্রবণতা দেখায়; এক ক্লিকে Word পুনরাবৃত্তি প্রশ্নপত্র রপ্তানি সমর্থিত; শিক্ষক-প্যানেলে শিক্ষার্থী সারসংক্ষেপ ও ভুল-প্রশ্ন টীকা প্রদান করা হয়; শেখার ক্যালেন্ডার হিটম্যাপ, সঠিকতার হার প্রবণতা ও ধারাবাহিক চেক-ইন দেখায়; জ্ঞান-গ্রাফ ট্যাগ সহ-উপস্থিতি নেটওয়ার্কে দক্ষতার অবস্থা উপস্থাপন করে। ইঞ্জিনিয়ারিং দিক থেকে প্রকল্পে ২৮৭টি pytest কেস, Playwright E2E পরীক্ষা, ruff স্ট্যাটিক চেক, GitHub Actions CI (বহু Python সংস্করণ ম্যাট্রিক্স, স্টার্টআপ স্মোক, Docker বিল্ড), Alembic ডেটাবেস মাইগ্রেশন, Docker Compose এক-ক্লিক ডিপ্লয়মেন্ট, এবং RAG অনুসন্ধানের অফলাইন মূল্যায়ন ও AI Tutor-এর LLM-as-judge মূল্যায়ন রয়েছে। প্রকল্পে MCP Server-ও প্রদান করা হয়, যা Claude Desktop বা Cursor-এ সংযুক্ত করে প্রাকৃতিক ভাষায় পরিচালনা করা যায়। ডিপ্লয়মেন্ট পদ্ধতিতে স্থানীয় রান, Docker Compose ও স্বতন্ত্র FastAPI গেটওয়ে সমর্থিত। সিড অ্যাকাউন্ট admin/admin123 শিক্ষক ভূমিকা এবং demo/demo123 শিক্ষার্থী ভূমিকা বহন করে। পরিচিত সীমাবদ্ধতার মধ্যে রয়েছে লগইন রেট-লিমিট ও অ্যাসিঙ্ক্রোনাস কিউ ডিফল্টভাবে কেবল একক ইনস্ট্যান্স সমর্থন করে, ছবি স্থানীয় ডিস্কে সংরক্ষিত হয় ইত্যাদি।