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

## প্রকল্পের পরিচিতি 专升本学习助手 (Zhuanshengben Study Assistant) হলো专升本 (কলেজ থেকে বিশ্ববিদ্যালয়ে ভর্তি) পরীক্ষার্থীদের জন্য একটি প্রস্তুতি ও ট্র্যাকিং অ্যাপ্লিকেশন। এটি ওয়েব (PWA) এবং উইন্ডোজ/ম্যাকওএস ডেস্কটপ সংস্করণে উপলব্ধ। ক্লাউডফ্লেয়ার ওয়ার্কার্স (Cloudflare Workers), ডি১ (D1) ডাটাবেস এবং আর২ (R2) স্টোরেজের মাধ্যমে এটি ক্লাউড-ভিত্তিক অ্যাকাউন্ট ও ডেটা সিঙ্ক্রোনাইজেশন সুবিধা প্রদান করে, যা ওয়েব এবং ডেস্কটপের মধ্যে নিরবচ্ছিন্ন অভিজ্ঞতা নিশ্চিত করে। মূল লক্ষ্য: "রেকর্ডিং → ফোকাস → মোটিভেশন → রিভিউ" এর মাধ্যমে একটি পূর্ণাঙ্গ লার্নিং লুপ তৈরি করা। ### কেন এই প্রকল্পটি বেছে নেবেন - **পূর্ণাঙ্গ লার্নিং লুপ**: প্রতিদিনের চেক-ইন, পোমোডোরো ফোকাস, প্রশ্ন সমাধান, ভুল প্রশ্নের তালিকা এবং রাতের প্রতিফলন—সবই এক জায়গায়। - **ক্লাউড সিঙ্ক্রোনাইজেশন**: অ্যাকাউন্ট রেজিস্টার করলে সব ডেটা ক্লাউডফ্লেয়ার ডি১-এ সিঙ্ক হয়, ফলে যেকোনো ডিভাইস থেকে পড়াশোনা চালিয়ে যাওয়া যায়। - **গ্যামিফিকেশন**: ব্রোঞ্জ থেকে কিং পর্যন্ত র‍্যাঙ্কিং সিস্টেম, ব্যাজ ওয়াল এবং পয়েন্ট সিস্টেম পড়াশোনাকে গেমের মতো আনন্দদায়ক করে তোলে। - **বিশেষায়িত প্রস্তুতি**: উচ্চতর গণিত ও ইংরেজির জন্য বিশেষ মডিউল, মার্কডাউন+LaTeX নোট এবং মোমো (墨墨) ভোকাবুলারি অ্যাপের সাথে ইন্টিগ্রেশন। - **পোমোডোরো ফোকাস**: টাস্ক ডেসক্রিপশনসহ টাইমার এবং প্রতিদিনের কাজের বিস্তারিত রিপোর্ট। - **কমিউনিটি ও স্টাডি পার্টনার**: আলোচনার জন্য ফোরাম, গ্রুপ স্টাডি এবং একে অপরকে চ্যালেঞ্জ জানানোর সুযোগ। - **ডেটা ভিজ্যুয়ালাইজেশন**: ই-চার্টস (ECharts) এর মাধ্যমে পড়াশোনার সময় ও অগ্রগতির গ্রাফিক্যাল বিশ্লেষণ। ### মূল বৈশিষ্ট্যসমূহ | বিভাগ | বৈশিষ্ট্য | | :--- | :--- | | লার্নিং রেকর্ড | বিষয়ভিত্তিক অগ্রগতি, পড়ার সময়, মক টেস্ট এবং টু-ডু লিস্ট | | নোট ও রিসোর্স | মার্কডাউন+KaTeX নোট, পিডিএফ রিডার ও রিসোর্স লাইব্রেরি | | ইংরেজি প্রস্তুতি | ভোকাবুলারি চেক-ইন, রিডিং, লিসেনিং ও রাইটিং টেমপ্লেট | | পোমোডোরো | টাইমার, টাস্ক ডেসক্রিপশন ও ফোকাস ওয়ালপেপার | | অভ্যাস ও রিভিউ | হ্যাবিট ট্র্যাকার, প্রতিদিনের প্রতিফলন ও শেয়ারিং কার্ড | | অ্যাচিভমেন্ট | পয়েন্ট সিস্টেম, র‍্যাঙ্কিং ও ব্যাজ ওয়াল | | কমিউনিটি | পোস্ট, কমেন্ট, গ্রুপ ডিসকাশন ও প্রাইভেট মেসেজ | | নিরাপত্তা | বিক্রিপ্ট (bcrypt) পাসওয়ার্ড, জেডব্লিউটি (JWT) এবং ক্লাউডফ্লেয়ার টার্নস্টাইল (Turnstile) ভেরিফিকেশন | ### প্রযুক্তিগত আর্কিটেকচার | স্তর | প্রযুক্তি | | :--- | :--- | | ফ্রন্টএন্ড | Vue 3, TypeScript, Vite 5, Pinia 2, Tailwind CSS 3 | | ভিজ্যুয়ালাইজেশন | ECharts 5, KaTeX 0.16, markdown-it | | ডেস্কটপ | Electron 43, electron-builder | | ব্যাকএন্ড | Cloudflare Workers, D1 Database, R2 Storage | ### দ্রুত শুরু করুন **প্রয়োজনীয়তা**: Node.js 18 বা তার বেশি সংস্করণ। ```bash git clone https://github.com/Han050912/zsb-study-tracker.git cd zsb-study-tracker npm install npm run dev ``` **ব্যাকএন্ড ওয়ার্কার চালু করা (লোকাল ডেভেলপমেন্টের জন্য)**: ```bash cd worker npm install npm run init:local npx wrangler dev ``` **ডেস্কটপ ক্লায়েন্ট**: ```bash npm run electron:dev ``` ### লাইসেন্স এই প্রকল্পটি এমআইটি (MIT) লাইসেন্সের অধীনে উন্মুক্ত।