منصوبے کے بارے میں

الوس (Allos) ایک خود میزبان صحت کے ریکارڈ، ٹریکر اور کوچنگ ایپلی کیشن ہے جو افراد، گھرانوں اور نگہبانوں کے لیے مخصوص ہے۔ اس کا نام "ایلو سٹاسس" (allostasis) سے ماخوذ ہے، جو تبدیلیوں کے ذریعے استحکام برقرار رکھنے کا جسم کا طریقہ ہے۔ پروجیکٹ کا مقصد ذاتی صحت کی معلومات کو ایک نجی ٹائم لائن میں جمع کرنا ہے، نہ کہ انہیں تھرڈ پارٹی سروسز پر بکھیرنا ہے۔ ڈیٹا آپریٹر کی اپنی SQLite ڈیٹا بیس میں ذخیرہ ہوتا ہے، زیادہ تر تجزیہ مقامی طور پر جمع شدہ ڈیٹاسیٹس کے خلاف چلتا ہے، اور AI فیچرز اختیاری ہیں۔ ٹریکنگ کا دائرہ یہ ایپ روزمرّہ صحت (اعراض، موڈ، نیند، وائٹلز، جسمانی پیمائش، غذائیت، بہبود کی مشقوں)، تربیت (طاقت، کارڈیو، کھیل، روٹین، اہداف، بحالی کے سیاق و سباق)، طبی تاریخ (شرائط، الرجیز، پرائمریز، ٹیکوں، اپوائنٹمنٹس، احتیاطی منصوبوں، خاندانی تاریخ)، لیبارٹری اور دستاویزات (بائیومارکرز، حوالہ رینجز، اسکینز، PDFs، ریکارڈ امپورٹ)، اور ادویات اور سپلیمنٹس (شیڈولز، خوراک کی تاریخ، ریفلز، تعمیل، مقامی طور پر چیک شدہ تعاملی انتباہات) کو کور کرتی ہے۔ گھرانے کی حمایت میں الگ پروفائلز، نگہبان تک رسائی، صرف پڑھنے کی اجازتیں اور کراس پروفائل نظارے شامل ہیں، اور ہر پروفائل کے لیے لاگ ان درکار نہیں ہوتا۔ ڈیٹا Health Connect، Strava، Oura، Fitbit ایکسپورٹ، Withings، کیلنڈر فیڈز اور FHIR/CCD مبنی امپورٹ جیسے MyChart کے ذریعے آ سکتا ہے۔ یاد دہانیوں کو Telegram، Web Push، Home Assistant یا ای میل کے ذریعے بھیجا جا سکتا ہے، اور سب کو JSON، CSV، FHIR یا اپلوڈ فائلز کے طور پر ایکسپورٹ کیا جا سکتا ہے۔ ڈیزائن کے اصول README میں پانچ اصول درج ہیں: ڈیفالٹ طور پر لوکل، بیرونی سروسز آپشنل؛ صحت کو سکورنگ کے بجائے سمت دینے کے طور پر پیش کیا جائے، یعنی خام سگنلز دکھائے جائیں، کسی مطلق صحت اسکور کے بجائے؛ نتائج معلوماتی ہوں اور حوالہ جات دیں، ہدایت کار نہ ہوں؛ امنگ کا لہجہ جب تک حفاظت اہم نہ ہو، دوا کی حفاظتی یاد دہانیوں کو دیگر مشاہدات سے زیادہ احتیاط سے سنبھالا جائے؛ اور صارف کا کنٹرول، یعنی دستی اصلاحات سنکس پر برقرار رہیں، ترجیحات صارف کی ملکیت رہیں اور ڈیٹا برآمد کیا جا سکے۔ تعمیر اور نشر Docker Compose سفارش شدہ راستہ ہے۔ یہ ویب ایپ اور نوٹیفکیشنز اور بیک اپس کے لیے ایک چھوٹی شیڈولر سروس دونوں شروع کرتی ہے۔ آپریٹرز ریپوزٹری کلون کرتے ہیں، .env.example کو .env میں کاپی کرتے ہیں، اور کم از کم ایک ایڈمن پاس ورڈ اور ریچک آؤٹ سے باہر ایک مطلق DATA_DIR سیٹ کرتے ہیں (ڈیفالٹ ./data ہے)۔ پہلا ایڈمن پاس ورڈ صرف تب لاگو ہوتا ہے جب پہلا لاگ ان بنایا جائے۔ پوری اسٹیک docker compose up -d --pull always سے شروع کی جاتی ہے اور پورٹ 3000 پر پہنچی جاتی ہے۔ اپ ڈیٹس GitHub Container Registry سے شائع شدہ امیج کھینچتی ہیں؛ IMAGE متغیر کے ذریعے مخصوص بلڈ کو پن کیا جا سکتا ہے۔ ڈیٹا بیس مائیگریشنز اسٹارٹ اپ پر خود بخود چلتی ہیں، اور ڈیٹا بیس کو پہلے data/backups/pre-migration میں کاپی کیا جاتا ہے، اور اگر وہ کاپی نہ بن سکے تو کنٹینر شروع ہونے سے انکار کر دیتا ہے۔ ماخذ سے چلانے کے لیے Node.js 24 (.nvmrc میں پن شدہ)، npm اور better-sqlite3 کے لیے نیٹیو بلڈ پری رکویزٹس درکار ہیں؛ npm ci اور npm run dev کافی ہیں، SQLite ڈیٹا بیس data/allos.db پر بنایا جائے گا۔ ایک سیڈ کمانڈ کئی ہفتوں کی مصنوعی نمونہ ڈیٹا لوڈ کر سکتی ہے، جسے README حقیقی ریکارڈز والی انسٹنس پر چلانے سے منع کرتی ہے۔ لوگ اور رسائی ایڈمنز settings، People & access کے تحت ٹریک کی جانے والی افراد کے لیے پروفائلز، لاگ ان کرنے والوں کے لیے لاگ ان، اور منتخب پروفائلز کو/read-write یا صرف پڑھنے کی رسائی دینے والی گرانٹس بناتے ہیں۔ ایڈمنز ہر پروفائل تک رسائی حاصل کر سکتے ہیں، اس لیے وہاں ان کا انٹری منتخب کرتی ہے کہ کس پروفائل کی یاد دہانیوں تک وہ پہنچیں؛ نوٹیفکیشنز پروفائل کے لحاظ سے آپشنل ہیں۔ ڈیٹا، بیک اپ اور پرائیویسی DATA_DIR کے تحت مستقل حالت میں allos.db، اپلوڈ کردہ طبی فائلیں، لاگز، تصدیق شدہ بیک اپس اور پری مائیگریشن کاپیاں شامل ہیں۔ اندرونی رات کا اسنیپ شاٹ لائیو ڈیٹا بیس کے ساتھ ایک والیوم شیئر کرتا ہے، اس لیے README BACKUP_DEST_DIR کو دوسرے منسلک مقام کے طور پر ترتیب دینے اور Settings سے تصدیق کرنے کی سفارش کرتی ہے۔ اسنیپ شاٹس میں اپلوڈ کردہ فائلیں شامل نہیں ہوتیں، جنہیں والیوم سے باہر بیک اپ فیچر علیحدہ کاپی کرتی ہے۔ اختیاری سروسز کو صرف اتنا ڈیٹا ملتا ہے جتنا فعال فیچر کے لیے درکار ہو: ایک Anthropic-compatible endpoint ترتیب دیا جا سکتا ہے (AI_BASE_URL کے ذریعے خود میزبان شامل)، اور SMTP لاگ ان دعوت نامے، پاس ورڈ ری سیٹس اور آپشنل نوٹیفکیشن ای میل فراہم کرتی ہے جو ڈیفالٹ طور پر مواد سے خالی ہوتی ہے تاکہ کوئی بھی صحت کی تفصیلات ان باکس میں نہ پہنچے۔ تکنالوجی اور لائسنس اسٹیک Next.js 16 (App Router اور Server Actions کے ساتھ)، React 19، TypeScript، SQLite (better-sqlite3 کے ذریعے)، Tailwind CSS اور Recharts پر مبنی ہے، اختیاری Anthropic-compatible AI کے ساتھ۔ ڈویلپمنٹ چیکس میں فارمیٹنگ، لِنٹ، ٹائپ چیک، یونٹ ٹیسٹس، الگ SQLite انٹیگریشن ٹیسٹس، الگ سیڈ شدہ ڈیٹا بیسز کے خلاف Playwright اینڈ ٹو اینڈ ٹیسٹس، اور پروڈکشن بلڈ شامل ہیں۔ شراکت داروں کو AGENTS.md کی طرف رہنمائی کی جاتی ہے جہاں آرکیٹیکچر، ڈیٹا سکوپنگ، مائیگریشن اور ٹیسٹنگ کے اصول موجود ہیں۔ Alos GNU Affero General Public License v3.0 (AGPL-3.0-only) کے تحت لائسنس یافتہ ہے۔