इस प्रोजेक्ट के बारे में

surreal_ck एक वेब-केवल सहयोगी स्प्रेडशीट परियोजना है। इसकी वास्तुकला में Bun और Hono के साथ निर्मित एक बैकएंड सर्वर, Svelte-आधारित वेब फ्रंटएंड और दोनों पक्षों द्वारा उपयोग किए जाने वाले DTO और स्कीमा वाला एक साझा पैकेज शामिल है। डेटा SurrealDB में संग्रहीत किया जाता है, जिसे सर्वर वेबसॉकेट (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` चलाने से स्टैक शुरू होता है, जिसके बाद सर्वर के चालू और प्रतिक्रिया देने की पुष्टि के लिए उसी स्वास्थ्य एंडपॉइंट का उपयोग किया जा सकता है।