عن المشروع

surreal_ck هو مشروع جداول بيانات تعاوني يعمل على الويب فقط. تجمع بنيته بين خادم خلفي مبني باستخدام Bun وHono، وواجهة أمامية ويب مبنية على Svelte، وحزمة مشتركة تحتوي على DTOs والمخططات المستخدمة من قبل كلا الجانبين. يتم تخزين البيانات في SurrealDB، حيث يصل الخادم إليها عبر WebSocket (WSS). يتم تنظيم المستودع كـ monorepo مقسم إلى ثلاثة أدلة: `server/` للخلفية، `web/` للواجهة الأمامية، و`shared/` لحزمة DTO/المخطط المشتركة. يتم الاحتفاظ بالكود القديم للحاسوب المكتبي تحت `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` يبدأ الحزمة، وبعد ذلك يمكن استخدام نفس نقطة التحقق الصحية لتأكيد أن الخادم قيد التشغيل ويستجيب.