البداية من حسابك

1. أنشئ حسابًا أو سجّل الدخول، وأكّد البريد بحسب إتاحة التسجيل في التجربة.
2. أضف سيارة بالصانع والموديل والسنة والممشى المتوفر. لا تخمّن تفاصيل غير مؤكدة.
3. من بطاقة السيارة اختر «تحديث سريع أو فاتورة»، أو افتح «إدخال سريع» واختر السيارة.

الصفحات العامة تشرح المنتج فقط. ملفات السيارات والفواتير والمستندات لا تُعرض للزائر العام، وتبقى خاضعة لتسجيل الدخول وصلاحيات الحساب.

صف، راجع، ثم أكّد

اختر الوقود أو الصيانة والمصروفات أو الفاتورة. اكتب وصفًا أو الصق نص المستند، ويمكن اختيار PDF أو صورة حتى 5 ميجابايت. يمكن للمساعد الموجّه جمع التفاصيل بالمحادثة وقراءة الصور والفواتير الممسوحة على جهازك بالعربية والإنجليزية. الحد 10 صفحات PDF، منها حتى 3 صفحات ممسوحة. لا يُستخدم نموذج محادثة سحابي. الحقول المقترحة قابلة للتعديل، والمجهول يبقى فارغًا. تُقرأ الحقول المسمّاة من فواتير موردين مختلفين؛ القيم المتعارضة تبقى فارغة. تظهر ملاحظات جودة القراءة في المراجعة، وتحتاج قراءة الصور والصفحات الممسوحة تأكيد مطابقة القيم مع الأصل. راجع التاريخ والمبلغ والعملة والممشى وحالة التعبئة قبل التأكيد. مبالغ المنصة مسجلة بالريال السعودي؛ لا تفترض تحويل العملات.

«حفظ كمسودة» يحتفظ بالمعلومات دون إنشاء عملية مالية. إذا عدت لاحقًا، أعد اختيار الملف الأصلي عند الحاجة؛ اسم الملف في المسودة لا يعني أن الأصل رُفع. تأكيد السجل خطوة مستقلة. إذا تعذّر إرفاق الملف بعد حفظ السجل، أعد محاولة المرفق بدل إنشاء مصروف آخر.

اربط المعلومة بمصدرها

يمكن ربط الوقود أو الصيانة بفاتورة متاحة للسيارة نفسها أو إنشاء فاتورة مرتبطة أثناء المراجعة. عند اختيار إنشاء فاتورة مرتبطة، تُعبّأ الحقول المتاحة من المستند للمراجعة؛ لا تُنشأ تلقائيًا. استبدال المستند يمسح الاقتراحات المحلية السابقة بعد تأكيدك. راجع تنبيه التكرار قبل اختيار حفظ عملية مستقلة. لا تجمع الفاتورة وخدمتها المرتبطة كمصروفين لنفس العملية. حدّد هدف السيارة وميزانية اختيارية لتلقي ملاحظات عن اكتمال السجل؛ هذه الملاحظات لا تشخّص الحالة ولا تحدد احتياجًا ماليًا مؤكدًا.

دليل أدوات المساعدة

يتوفر OpenAPI 3.1 لقراءة بنية الطلبات والنتائج والأخطاء آليًا. يصف العقد واجهة ميان الحالية ولا ينشئ حسابًا أو مفتاحًا أو صلاحية إضافية. تبقى جلسة المستخدم وصلاحيات السيارة مطلوبة.

الواجهة العامة GET /api/assistant تعرض إصدار العقد وثلاث أدوات موثقة: propose_entry_draft وlist_my_drafts وget_setup_feedback. لا تتضمن نتيجة هذا الطلب بيانات مستخدمين. هذه واجهة HTTP مخصصة وليست خادم MCP، ولا تعني أن نموذج محادثة موصول.

استدعاءات POST /api/assistant تحتاج جلسة مستخدم موثقة وسيارة مسموحًا له الوصول إليها. يرسل الربط الموثوق Authorization: Bearer <user access token> مع {tool, vehicle_id, arguments, language?}. تبقى بيانات الدخول في الربط الموثوق؛ لا تُرسل الرموز أو كلمات المرور أو مفاتيح الإدارة إلى النموذج. الأدوات تقترح أو تقرأ ضمن نطاق المستخدم، ولا تعتمد سجلًا ماليًا ولا تنفذ SQL أو طلبات ويب عشوائية.

متى تستخدم ميان مع أدوات AI؟

استخدم الصفحات العامة للتعريف بميان، ولشرح طريقة تسجيل الوقود والصيانة والفواتير. لبناء مساعد داخل حساب المستخدم، استخدم العقد الموثق والمصادقة والصلاحيات الحالية، واجعل اعتماد السجل بيد المستخدم في الموقع. لا تفهرس المسارات الخاصة، ولا تمرر فاتورة إلى مزود خارجي دون توضيح المعالجة وموافقة المستخدم. للملخص القابل للقراءة الآلية راجع llms.txt، ولحدود البيانات راجع الخصوصية.

Start in your account

1. Create an account or sign in, and confirm your email according to registration availability in the pilot.
2. Add a vehicle with the make, model, year and known mileage. Do not guess unverified details.
3. Choose “Add an update or invoice” on its vehicle card, or open Quick entry and select a vehicle.

Public pages explain the product only. Vehicle files, invoices and documents are not public visitor content; sign-in and account permissions remain required.

Describe, review, confirm

Choose fuel, service/expense or invoice. Describe the update or paste document text, and optionally select a PDF or image up to 5 MB. The guided assistant collects details through a conversation and reads image invoices and scanned PDFs on your device in Arabic and English. PDFs are limited to 10 pages, including up to 3 scanned pages. No cloud chat model is used. Suggestions are editable and unknown values stay blank. Labeled invoices from different suppliers are supported; conflicting values stay blank. Reading-quality notices remain in review, and image/scanned reads require acknowledgement against the original. Check dates, amounts, currency, mileage and full-tank status before confirming. Platform amounts are recorded in Saudi riyals; do not assume a currency conversion.

“Save as draft” keeps information without creating a financial record. When returning later, reselect the original file if needed: a filename in a draft does not mean the original was uploaded. Confirmation is a separate step. If an attachment fails after the record is saved, retry the attachment instead of creating another expense.

Link information to its source

Link fuel or service to an available invoice for the same vehicle, or create a linked invoice during review. During review, duplicate warnings show matching invoices and linked maintenance expenses before saving. Editing any field clears the previous approval; failed checks require retry. Inspect the existing records before deliberately saving a separate transaction. Do not count an invoice and its linked service as two expenses for the same update. Choose a vehicle goal and optional budget for feedback about record coverage; this does not diagnose condition or establish a confirmed financial need.

Assistant tool guide

The OpenAPI 3.1 contract provides machine-readable request, response and error schemas. It documents the existing Mayan interface; it creates no account, credential or additional access. The user session and vehicle permissions remain required.

The public GET /api/assistant manifest lists its contract version and three documented tools: propose_entry_draft, list_my_drafts and get_setup_feedback. This response contains no user context. It is a custom HTTP interface, not an MCP server, and does not mean that a conversational model is connected.

POST /api/assistant requires a verified user session and a vehicle the user can access. A trusted adapter sends Authorization: Bearer <user access token> with {tool, vehicle_id, arguments, language?}. Keep credentials within that adapter; never put session tokens, passwords or administrator keys in model context. Tools propose or read within user scope. They cannot approve a financial record, execute SQL or fetch arbitrary web addresses.

When to use Mayan with AI tools

Use public pages to explain Mayan and how to record fuel, maintenance and invoices. To build an assistant inside a user account, use the documented contract, authentication and existing permissions, and keep financial approval with the user in the website. Do not index private routes or send an invoice to an external provider without explaining the processing and obtaining consent. See llms.txt for machine-readable guidance and privacy information for data boundaries.