أفضل ممارسات المايكروسيرفيس

# ✅ جيد: خدمة للمدفوعات
payment-service:
  responsibility: معالجة المدفوعات والفوترة

# ❌ سيء: خدمات صغيرة جداً
validate-card-service:     # مجرد دالة
charge-service:            # مجرد استدعاء API
receipt-service:           # مجرد إرسال إيميل

// ✅ كل خدمة لها قاعدة بياناتها الخاصة
const db = new Database(process.env.DATABASE_URL);

// ❌ لا تشارك قاعدة بيانات مع خدمة أخرى
const db = new Database('shared-database-url');

// ✅ توثيق مباشر في الكود
/**
 * @openapi
 * /users/{id}:
 *   get:
 *     summary: الحصول على مستخدم
 */
app.get('/users/:id', getUser);

// ✅ أضف مراقبة من البداية
const logger = pino({ level: 'info', name: 'user-service' });
const metrics = new MetricsRegistry();

app.get('/health', (req, res) => {
  res.json({
    status: 'healthy',
    uptime: process.uptime(),
    memory: process.memoryUsage(),
  });
});

// ✅ إعدادات واضحة مع قيم افتراضية
const config = {
  port: process.env.PORT || 3001,
  dbHost: process.env.DB_HOST || 'localhost',
  dbName: process.env.DB_NAME || 'users',
  logLevel: process.env.LOG_LEVEL || 'info',
  redisUrl: process.env.REDIS_URL || 'redis://localhost:6379',
};

// ✅ دائماً جهز Fallback
async function getUser(id) {
  try {
    return await userService.getUser(id);
  } catch {
    logger.warn(`فشل جلب المستخدم ${id}، استخدام الكاش`);
    return await cache.get(`user:${id}`) || { id, name: 'غير معروف' };
  }
}

استراتيجيات النشر:
  Rolling Update:   تحديث تدريجي — Pod تلو الآخر
  Blue/Green:       بيئتان — واحدة نشطة وأخرى جاهزة
  Canary:           إصدار جديد لنسبة صغيرة من المستخدمين

# ✅ أسماء واضحة ومنطقية
user-service
course-service
payment-service
notification-service

# ❌ أسماء غامضة
core-service
utils-service
backend-service

قبل كتابة الخدمة:
  1. صمم API (OpenAPI spec)
  2. ناقش العقود مع الفرق الأخرى
  3. طبق Contract Tests
  4. ابدأ التطوير

// ✅ نسخ الكود إذا كان صغيراً، أو افصل الخدمة
// ❌ مكتبة مشتركة تربط الخدمات