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

surreal_ck একটি ওয়েব-ভিত্তিক সহযোগিতামূলক স্প্রেডশীট প্রকল্প। এর স্থাপত্যে Bun এবং Hono দিয়ে নির্মিত একটি ব্যাকএন্ড সার্ভার, Svelte-ভিত্তিক ওয়েব ফ্রন্টএন্ড এবং উভয় পক্ষের ব্যবহৃত DTO ও স্কিমা সম্বলিত একটি শেয়ার্ড প্যাকেজ রয়েছে। ডেটা SurrealDB-তে সংরক্ষিত হয়, যা সার্ভার WebSocket (WSS)-এর মাধ্যমে অ্যাক্সেস করে। রিপোজিটরিটি একটি মনোরেপো হিসেবে তিনটি ডিরেক্টরিতে বিভক্ত: ব্যাকএন্ডের জন্য `server/`, ফ্রন্টএন্ডের জন্য `web/` এবং সাধারণ DTO/স্কিমা প্যাকেজের জন্য `shared/`। প্রকল্পটি ওয়েব-ভিত্তিক মডেলে স্থানান্তর অব্যাহত রাখার সময় `server/legacy/` এবং `web/legacy/`-এর অধীনে ঐতিহাসিক ডেস্কটপ কোড ধরে রাখা হয়েছে। স্থানীয় উন্নয়নের জন্য, প্রকল্পটি pnpm ওয়ার্কস্পেস ব্যবহার করে: `pnpm install` দিয়ে নির্ভরতা ইনস্টল করুন, `.env.example`-কে `.env`-এ কপি করুন, `pnpm -r run typecheck` দিয়ে সব প্যাকেজে টাইপ চেকিং চালান এবং `pnpm --filter @surreal-ck/server dev` দিয়ে সার্ভারটি ডেভেলপমেন্ট মোডে শুরু করুন। সার্ভারটি `http://localhost:8080/health`-এ একটি হেলথ এন্ডপয়েন্ট প্রকাশ করে, যা curl দিয়ে যাচাই করা যায়। Docker ডিপ্লয়মেন্টও সমর্থিত: `docker compose up --build` চালালে স্ট্যাকটি শুরু হয়, তারপর একই হেলথ এন্ডপয়েন্ট ব্যবহার করে সার্ভারটি চালু এবং সাড়া দিচ্ছে কিনা নিশ্চিত করা যায়।