# مقدمة

> تاروت منصة سحابية سعودية. انشر التطبيقات وقواعد البيانات المُدارة والتخزين والنطاقات من لوحة تحكم واحدة وبأسعار بالريال السعودي.

تاروت منصة سحابية (PaaS) مصمَّمة للسوق السعودي والشرق الأوسط. انشر كودك من GitHub أو GitLab، وأنشئ قواعد بيانات مُدارة، وأدر النطاقات والتخزين - كل ذلك من لوحة تحكم واحدة وبأسعار بالريال السعودي. وتُحتسب الخوادم السحابية وبوابة الذكاء الاصطناعي من رصيد مدفوع مسبقًا بالريال.

## البدء السريع

إذا كان مشروعك جاهزًا على جهازك، فهذا كل ما يلزم:

```sh
npm install -g @tarout/cli
tarout login
tarout deploy --wait
```

تكتشف تاروت إطار العمل تلقائيًا، وتبني التطبيق، وتعيد لك رابط HTTPS مباشرًا على نطاق فرعي `*.tarout.app`.

> [!TIP]
> تعمل مع وكيل برمجي؟ وجّهه إلى [دليل الوكلاء](https://tarout.sa/docs/for-ai/start.md) وسيتولى عملية النشر بالكامل. كل صفحة في المستندات متاحة كنص markdown خام على نفس الرابط مع إضافة `.md`.

## ماذا يمكنك أن تفعل

- **التطبيقات** - اربط مستودع Git وتاروت تتولى البناء والنشر وتجديد شهادات SSL. الخطة المجانية تشمل تطبيقًا واحدًا؛ اشتراك Starter يغطي 5 تطبيقات مشتركة، وخطط Pro تشغّل تطبيقاتك على خادم مخصص لك.
- **قواعد البيانات** - **PostgreSQL** مُدارة مع تجميع الاتصالات، من قاعدة مجانية بسعة 2 ميجابايت إلى مستويات إضافات مدفوعة. ويمكن للمستويات المدفوعة جدولة نسخ احتياطية إلى تخزينك الخاص المتوافق مع S3.
- **الخوادم السحابية** - أجهزة افتراضية بمعالجات CPU في الدمام، تُحتسب بالساعة من محفظة مدفوعة مسبقًا، عندما تحتاج تحكمًا كاملاً في عبء العمل. (خوادم GPU غير متاحة بعد.)
- **التخزين** - حاويات متوافقة مع S3 للملفات والمرفقات والأصول الساكنة - حاوية مجانية بسعة 50 ميجابايت، ثم 0.12 ريال/جيجابايت/شهر.
- **النطاقات** - اشترِ نطاقًا جديدًا أو استخدم نطاقك الحالي. يتم التحقق من DNS وتوفير SSL تلقائيًا.
- **بوابة الذكاء الاصطناعي** - مفتاح واحد متوافق مع OpenAI (`https://tarout.sa/api/ai/v1`) لجميع النماذج: خمسة نماذج رائدة مفتوحة الأوزان على المسار العالمي، واستدلال سريع على مسار المملكة العربية السعودية. اختر النموذج في كل طلب، وادفع لكل رمز بالريال، وعيّن حد إنفاق شهريًا اختياريًا لكل مفتاح.
- **واجهة سطر الأوامر** - أدر تطبيقاتك وقواعد بياناتك ونطاقاتك وعمليات النشر من الطرفية عبر `@tarout/cli`.

## المنظمات والمشاريع

عند التسجيل، تُنشئ تاروت لك **منظمة** ومشروعًا **افتراضيًا** بداخلها. التطبيقات وقواعد البيانات والتخزين تنتمي إلى مشروع، حتى تجمع مكونات المنتج الواحد معًا وتفصل الأعمال غير المرتبطة. أما الخوادم السحابية فتنتمي إلى المنظمة كلها.

المشروع يحدد أيضًا **مكان** تشغيل موارده: تختار مزود السحابة والمنطقة مرة واحدة عند إنشاء المشروع، وترث كل الموارد بداخله هذا الاختيار. أما متغيرات البيئة فتُضبط لكل تطبيق على حدة.

ادعُ زملاءك بصلاحية **owner** أو **admin** أو **member** من **الإعدادات → الأعضاء**.

## كيف تعمل

1. **سجّل** في [tarout.sa](https://tarout.sa). تُنشأ المنظمة والمشروع الافتراضي تلقائيًا.
2. **اربط مزود Git** (GitHub أو GitLab) من **الإعدادات → مزودي Git**.
3. **أنشئ تطبيقًا** - تاروت تكتشف إطار العمل تلقائيًا وتضبط إعدادات البناء.
4. **انشر** - يصبح تطبيقك متاحًا على نطاق `*.tarout.app` مع SSL.
5. **أضف نطاقًا مخصصًا** - وجّه DNS إلى تاروت ويتم إصدار SSL لك.

## الفوترة

تعتمد تاروت **فوترة الاشتراكات** - خطة مجانية، وخطة **Starter** ثابتة (19 ريال/شهر وتشمل 5 تطبيقات مشتركة)، ومستويات **Pro** مخصصة (399 / 849 / 1,599 ريال/شهر)، مع إضافات لقواعد البيانات والبريد والتخزين المحسوب بالاستخدام. تعرض صفحة **الفوترة** اشتراكك وفواتيرك وتحليلات الاستخدام.

> [!NOTE]
> جميع الأسعار بـ **الريال السعودي** وتظهر قبل إتمام الدفع. الفوترة السنوية تمنحك شهرين مجانًا.

راجع قسم [الفوترة](https://tarout.sa/docs/billing) لتفاصيل الخطط والحدود.

## الخطوات التالية

- [البدء السريع](https://tarout.sa/docs/getting-started/quickstart) - انشر أول تطبيق خلال دقائق.
- [انشر أول تطبيق](https://tarout.sa/docs/getting-started/deploy-first-app) - شرح خطوة بخطوة لعملية النشر.
- [واجهة سطر الأوامر](https://tarout.sa/docs/cli) - ثبّت `@tarout/cli` وأدر تاروت من الطرفية.

---

## Every Tarout agent guide

- [Start Here (Agents)](https://tarout.sa/docs/for-ai/start.md)
- [Overview](https://tarout.sa/docs/for-ai.md)
- [Deploying an app](https://tarout.sa/docs/for-ai/deploy.md)
- [Databases](https://tarout.sa/docs/for-ai/database.md)
- [Object storage](https://tarout.sa/docs/for-ai/storage.md)
- [Custom domains](https://tarout.sa/docs/for-ai/domains.md)
- [Plans and upgrades](https://tarout.sa/docs/for-ai/billing.md)
- [Troubleshooting](https://tarout.sa/docs/for-ai/troubleshoot.md)
- [Agent Onboarding](https://tarout.sa/docs/for-ai/onboarding.md)
- [CLI Reference](https://tarout.sa/docs/for-ai/cli-reference.md)
- [CLI JSON Schema](https://tarout.sa/docs/for-ai/cli-json-schema.md)

Whole corpus in one file: https://tarout.sa/llms-full.txt · index: https://tarout.sa/llms.txt
Any docs page is raw markdown at the same URL + `.md`. Short link to the entry point: https://tarout.sa/deploy.md