طراحی واسط برنامهنویسی
طراحی واسط‌های REST یا GraphQL با نسخه‌بندی روشن و مستندات کامل، تا تیم‌های دیگر بتوانند بدون هماهنگی مداوم از آن استفاده کنند.
۰۴ راهکارها
معماری و یکپارچهسازی
اتصال سامانه‌هایی که قرار نبود با هم حرف بزنند، بدون آنکه مجبور شوید همه‌چیز را از نو بسازید.
سازمان‌هایی که چند سال فعالیت کرده‌اند معمولاً چند سامانهٔ جداگانه دارند: یکی برای مالی، یکی برای انبار، یکی برای فروش. هر کدام در کار خود درست عمل می‌کند اما داده‌ها میانشان دستی جابه‌جا میشود و همین نقطه، منشأ بیشتر خطاها و مغایرت‌هاست.
بازنویسی کامل در چنین وضعیتی معمولاً پرهزینه‌ترین و پرریسک‌ترین گزینه است. رویکرد ما ساخت لایهای واسط میان سامانههای موجود است تا داده‌ها به‌صورت خودکار و قابل ردیابی جریان پیدا کنند و سامانههای فعلی دست‌نخورده بمانند.
چه چیزی ارائه میشود
معماری رویدادمحور
انتشار رویدادها روی صف پیام به‌جای فراخوانی مستقیم؛ نتیجه این است که کندی یا قطعی یک سامانه، بقیه را متوقف نمیکند.
اتصال به سامانههای قدیمی
ساخت لایهٔ واسط برای سامانه‌هایی که واسط استاندارد ندارند، از طریق پایگاه داده، فایل یا سرویس‌های قدیمی، بدون تغییر در خود سامانه.
همگام‌سازی داده
تعریف منبع معتبر برای هر داده و قواعد روشن برای حل تعارض، تا مشخص باشد در صورت اختلاف، کدام سامانه حرف آخر را می‌زند.
ردیابی و ممیزی
ثبت مسیر کامل هر تراکنش میان سامانه‌ها؛ وقتی رکوردی جا می‌افتد باید بتوان دقیقاً نشان داد کجا متوقف شده است.
تفکیک تدریجی
جدا کردن بخش‌های پرترافیک از سامانهٔ یکپارچهٔ قدیمی به‌صورت مرحله‌ای، به‌جای مهاجرت یک‌بارهٔ پرریسک.
خروجی پروژه
آنچه در پایان کار تحویل داده میشود، فارغ از اندازهٔ پروژه.
- مستند معماری وضعیت موجود و وضعیت هدف
- مستندات واسط برنامهنویسی
- لایهٔ واسط پیاده‌سازی‌شده به همراه کد منبع
- داشبورد پایش جریان داده میان سامانه‌ها
- برنامهٔ مهاجرت مرحله‌ای
فناوری‌های متداول این حوزه
- REST
- GraphQL
- gRPC
- RabbitMQ
- Node.js
- Python
- Docker
- Nginx
پرسش‌های متداول
آیا برای یکپارچهسازی باید سامانههای فعلی را تغییر دهیم؟
در بیشتر موارد خیر. هدف ما ساخت لایهای است که سامانههای موجود را همانطور که هستند به هم متصل کند. تغییر در سامانهٔ فعلی تنها وقتی پیشنهاد میشود که راه دیگری وجود نداشته باشد.
اگر سامانهٔ قدیمی ما هیچ واسط برنامهنویسی نداشته باشد چه؟
در این حالت از مسیرهای جایگزین استفاده میکنیم: خواندن مستقیم از پایگاه داده، تبادل فایل زمانبندیشده یا شبیهسازی رفتار کاربر. انتخاب مسیر در مرحلهٔ امکانسنجی و با در نظر گرفتن ریسک هر گزینه انجام میشود.
یکپارچهسازی چه تأثیری بر کارکرد فعلی دارد؟
لایهٔ واسط جدا از سامانههای موجود اجرا میشود و بار اضافی محسوسی ایجاد نمیکند. پیش از استقرار نهایی، عملکرد در محیط آزمایشی با دادههای واقعی سنجیده میشود.
دربارهٔ پروژهٔ خود گفت‌وگو کنیم
شرح کوتاهی از نیاز سازمان بفرستید؛ در نخستین روز کاری بررسی و پاسخ داده میشود.