# Wallet

كيف يعمل تصدير المحفظة، من الوصل إلى حل المشكلات.

## الوصل

اضغط «توصيل» بجانب المحفظة في الشاشة الرئيسية لـ Exporter، ثم «فتح مجلد Passes». تُفتح اللوحة في المجلد الذي يحفظ فيه macOS بطاقاتك، `~/Library/Passes`: اضغط «اختيار هذا المجلد». ثم اختر مكان حفظ الملفات واضغط «استخدام هذا المجلد».

خذ مجلد Passes نفسه، لا مجلد `Cards` بداخله. يقرأ Exporter البطاقات من `Cards`، ويقرأ `passes23.sqlite` بجواره لشيء واحد فقط: يوم توقيع البطاقة، وهو التاريخ الوحيد الذي تحمله كثير من البطاقات القديمة.

## أين تذهب الملفات

ملف Markdown واحد لكل بطاقة، في مجلد واحد، باسم مأخوذ من تاريخها ومما هي عليه: `2026-09-17 united airlines SFO-EWR.md`، `2026-09-11 the sf database meetup.md`. والبطاقة التي بلا تاريخ تحمل اسمها فقط (`apple store.md`). أما المجلد الموجود مباشرة في مجلد المستخدم، مثل `~/Documents`، فيحصل بداخله على مجلد `wallet-export`؛ والمجلد الأعمق، مثل `~/Documents/wallet`، يُستخدم كما هو.

## ما الذي يُصدَّر

كل بطاقة محدّدة في البطاقة: بطاقات الصعود، وتذاكر القطار والحافلة، وتذاكر الفعاليات، وبطاقات المتاجر، والقسائم، والبطاقات العامة. والأقراص تُرشِّح القائمة فقط: البطاقات (كلها)، والرحلات (ومعها القطارات والحافلات)، والفعاليات، وبطاقات المتاجر.

البطاقتان اللتان قد تعطيان اسم الملف نفسه تأخذ كل واحدة لاحقة قصيرة من مُعرِّفها، فلا تطمس إحداهما الأخرى. وإلغاء تحديد بطاقة يزيل ملفها في المزامنة التالية؛ وتحديدها من جديد يعيده.

## الصيغة

دائمًا Markdown: الـ front matter للبطاقة، ثم عنوان وسطر واحد يقول أين ومتى، ثم الحقول تمامًا كما ترسمها البطاقة، وظهر البطاقة تحت عنوان `Back`، ورقم الرمز الشريطي.

## الملف

| المفتاح | المحتوى |
| --- | --- |
| `title`, `id` | اسم البطاقة، والمُعرِّف الذي تعطيه إياها المحفظة |
| `kind` | `flight` أو `transit` أو `event` أو `card` أو `other` |
| `date`, `date_source` | متى تهمّ البطاقة، وهل هذا تاريخ المُصدِر أم انتهاؤها أم يوم التوقيع |
| `organization`, `pass_type` | المُصدِر ومُعرِّف نوع البطاقة لديه |
| `expires`, `voided` | متى تنتهي، وهل وضعت المحفظة عليها علامة الاستخدام |
| `coordinates` | نقطة المكان، إن كانت البطاقة تحملها |

يحمل قسم `Details` حقول Apple المُصنَّفة التي لا تعرضها البطاقة أصلًا: المحطات، وبوابة الوصول، والمناطق الزمنية، ودرجة الأجرة. ويسمّي قسم `Where` المكان. أما الرمز الشريطي الذي تكون رسالته ثنائية فيقول ذلك بدل كتابة محارف تحكّم في الملف.

```markdown
---
title: "United Airlines SFO-EWR"
kind: flight
date: 2026-09-17T18:20:00
date_source: relevant
organization: "United Airlines"
---
# United Airlines SFO-EWR

San Francisco (SFO) → Newark (EWR) · 17 Sep 2026

- FLIGHT: UA 274
- GATE: F19
- SEAT: 34D

## Back

- CONFIRMATION: GGCLMQ
```

## التواريخ، حتى بلا تاريخ

تُوضع البطاقة تحت يومها هي، بالمنطقة الزمنية التي كتبها المُصدِر: رحلة تغادر دنفر في 23:25 هي ذلك اليوم في دنفر، لا اليوم التالي حيث تقرأها. وتذاكر الفعاليات القديمة كثيرًا ما لا تحمل أي تاريخ؛ تلك تُوضع تحت يوم التوقيع، و`date_source: signed` يقول ذلك في الملف.

## بطاقات بلغات أخرى

قد تحفظ البطاقة كلماتها في ملف `pass.strings` داخل حزمتها وتترك في البطاقة نفسها المفاتيح فقط. ويحلّها Exporter بلغة جهاز Mac لديك، فتقرأ التذكرة اسم الفعالية لا `EVENT_NAME`.

## المجاني والمفتوح

أحدث 20 بطاقة لديك مجانية وتبقى كذلك. وفتح المحفظة يصدّر البقية ([الأسعار](https://exporter.dev/pricing)).

## المزامنة وإعادة المزامنة الكاملة

بعد أول «زامن الآن»، يعيد Exporter كتابة ملف البطاقة عندما تتغير تلك البطاقة، مرة واحدة في الدقيقة على الأكثر. والبوابات والمقاعد وأوقات الصعود تتغير يوم السفر، وكل تغيير يعيد كتابة ملف تلك البطاقة وحدها.

«إعادة المزامنة الكاملة» تسأل أولًا، ثم تزيل ملفات البطاقات التي كتبها Exporter وتكتب من جديد كل بطاقة محدّدة. وكل ما عدا ذلك في المجلد يبقى.

## المشكلات والحلول

- «لا توجد بطاقات في هذا المجلد (اختر مجلد Passes في مكتبتك)»: اضغط «وصل» من جديد واختر المجلد الذي تُفتح فيه اللوحة
- بطاقة ناقصة: هي غير محدّدة في البطاقة، أو انتهت العشرون المجانية. افتح المحفظة واضغط «زامن الآن»
- بطاقة بلا تاريخ في اسمها: هي لا تحمل تاريخًا، ولم تتمكن قراءة قاعدة بيانات المحفظة. صِل `~/Library/Passes` نفسه بدل `Cards`
- أرقام البطاقات ليست هناك: هي ليست على جهاز Mac أصلًا. تحفظ المحفظة بطاقات الدفع في Secure Element، ولا يراها Exporter أبدًا

## Related

- [المحفظة](https://exporter.dev/ar/wallet): كل بطاقة كملف Markdown
- [البدء](https://exporter.dev/ar/docs/getting-started): التثبيت والربط وأول تصدير
- [خادم MCP](https://exporter.dev/ar/docs/mcp): اربط Claude والوكلاء الآخرين

---

human version: https://exporter.dev/ar/docs/wallet
every page: https://exporter.dev/llms.txt