يناقش هذا المستند الخطوات التي يتعين على كل من مشغّل النقل العام (PTO) والشركة المتعهّدة للأنظمة، المُشار إليها لاحقًا باسم جهة الإصدار، اتخاذها لتوفير عملية تنفيذ الأساليب في "محفظة Google".
1- إكمال المتطلبات الأساسية
- وقِّع اتفاقية عدم الإفصاح (NDA) مع Google. يشارك فريق تطوير الأعمال (BD) في Google هذا النموذج عبر الإنترنت للقبول.
- الدمج مع Google Wallet API العادية لرموز الاستجابة السريعة:
- تستخدم جهة الإصدار Google Wallet API لتوفير البطاقات وإضافتها إلى تطبيق "محفظة Google" الخاص بالمستخدم. يمكنك مراجعة مستندات رموز الاستجابة السريعة للنقل العام وإكمال المتطلبات الأساسية اللازمة لدمجها مع واجهة برمجة التطبيقات.
- يجب التسجيل في "خدمة التذاكر الإلكترونية" في VDV للحصول على رقم تعريف المالك (orgId) وتفاصيل PKI ذات الصلة المطلوبة لاستخدام Motics.
2. التنفيذ الفني
تتضمن الخطوة الثانية تفاصيل التنفيذ الفني الرئيسية، والتي يجب تطويرها بالتوازي.
ترقية عملية تنفيذ Google Wallet API
توضّح صفحة التفاصيل الفنية الطرق والمَعلمات التي يجب أن تستخدمها جهة الإصدار وتعديلها لدمج Motics. على وجه التحديد، تحتاج جهة الإصدار إلى استدعاء الطرق التالية لواجهة Google Wallet API مع معلَمات إضافية ذات صلة بـ Motics:
تنفيذ نقطة نهاية التفعيل
يستدعي خادم Google نقطة نهاية التفعيل التي تستضيفها جهة الإصدار. يؤدي ذلك إلى بدء إنشاء بيانات الاستحقاق الثابتة (sigSTB) على خادم جهة الإصدار. راجِع قسم نقطة نهاية التفعيل للحصول على التفاصيل.
تنفيذ عملية "النقل وإلغاء الربط"
لتقديم تجربة مستخدم جيدة، يجب أن يكون المستخدم قادرًا على نقل تذكرة Motics من جهاز إلى آخر، ضمن حدود معيّنة تحدّدها جهة الإصدار. لهذا السبب، على جهة الإصدار تنفيذ عملية النقل وإلغاء الربط.
إرسال رسالة تأكيد إلكترونية عند حفظ التذكرة
تشترط Google أن ترسل جهة الإصدار رسالة تأكيد إلكترونية إلى المستخدمين عند حفظهم تذكرة Motics في "محفظة Google". يجب أن تحتوي رسالة التأكيد الإلكترونية (على حد أدنى) على ما يلي:
- روابط مفيدة للمستخدمين لإدارة تذاكرهم (الاشتراك)
- تعليمات حول كيفية التواصل مع فريق دعم العملاء لدى جهة الإصدار
3- إجراء اختبار الدمج الشامل في STAGING
يمكنك إنشاء اختبار transitClass لمحفظة Google من أجل استخدام التطوير وبعد اكتمال عمليات الدمج، يجب التحقّق من صحة الحل واختباره
حتى يتم إنهاء استخدام الإصدار transitClass هذا. في transitObject:Insert،
اضبط السمة cert_environment على STAGING. يجب اختبار جميع حالات الاستخدام بالكامل
ويجب أن تحقق جميع حالات الاختبار نتيجة ناجحة.
4. إجراء اختبار شامل في PRODUCTION
بعد اختبار الحلّ بنجاح باستخدام بيئة STAGING،
أنشِئ transitClass جديدة للإنتاج. في هذه المرة، اضبط السمة cert_environment على
PRODUCTIONعند إدراج transitObject. اتبع جميع حالات الاختبار
والتعليمات الواردة في قسم الاختبار وأكمِلها.
5- متابعة عملية الإطلاق والحصول على الموافقات
قبل إطلاق برنامج تجريبي عام أو بدئه، يجب أن تحصل Google على الموافقة الكاملة على الإطلاق وتعتمد الموافقة على نتائج مراحل الاختبار المختلفة بالإضافة إلى عوامل أخرى مثل (على سبيل المثال لا الحصر) العوامل التالية التي يجب أن تراجعها Google وتوافق عليها:
- نطاق الإطلاق العام والخطة
- في حالة الإطلاق التجريبي، يجب أن تتضمن خطة الإطلاق معايير خروج واضحة وجداول زمنية للمضي قدمًا في الإطلاق الكامل.
- الأنشطة التسويقية المخططة
- اتصالات الإطلاق
- تاريخ الإطلاق
- المخططات الزمنية ليوم الإطلاق وعملية التصعيد وجهات الاتصال
- عمليات دعم المستخدم النهائي