Die Screenshots enthalten Python-Code für eine asynchrone Funktion zum Erstellen einer Bestellung in einem Webdienst. Der Code umfasst: - Parsen von JSON-Anfragedaten für user_id, items und promo_code. - Berechnung des Gesamtpreises der Artikel. - Optionales Anwenden eines Rabatts durch Aufruf eines externen Rabattdienstes. - Einfügen der Bestellung in eine PostgreSQL-Datenbank. - Reservierung der Artikel durch Aufruf eines Lagerdienstes. - Veröffentlichung eines Ereignisses 'Bestellung erstellt' an einen Kafka-Adapter. - Aktualisierung des Bestellstatus auf 'verarbeitet'. Die im Code implizierte Aufgabe ist: "Implementieren eines asynchronen API-Endpunkts zum Erstellen einer Bestellung, der: - Eingabedaten validiert. - Den Gesamtbestellpreis berechnet. - Einen Rabatt anwendet, falls ein Promo-Code bereitgestellt wird, durch Aufruf eines externen Rabattdienstes. - Die Bestellung in einer PostgreSQL-Datenbank einfügt und die neue Bestell-ID abruft. - Einen Lagerdienst aufruft, um die bestellten Artikel zu reservieren. - Ein Ereignis 'Bestellung erstellt' an einen Kafka-Adapter veröffentlicht. - Den Bestellstatus in der Datenbank auf 'verarbeitet' aktualisiert. - Potenzielle Fehler wie die Trennung vom Rabattdienst elegant behandelt."

Для реализации асинхронного API эндпоинта создания заказа в Python можно использовать asyncio и библиотеки, поддерживающие асинхронность, например, aiohttp для веб-сервера, asyncpg для работы с PostgreSQL, а также асинхронные HTTP клиенты для вызова внешних сервисов.

Основные шаги:

1. Валидация входных данных — проверяем, что user_id, items и опционально promo_code корректны.
2. Расчет стоимости — суммируем цены товаров из items.
3. Применение скидки — если есть promo_code, вызываем внешний сервис скидок асинхронно, обрабатываем ошибки (например, таймауты, недоступность сервиса) и корректируем итоговую сумму.
4. Вставка заказа в БД — асинхронно вставляем запись в PostgreSQL, получаем order_id.
5. Резервирование товаров — вызываем асинхронно складской сервис для резервирования, обрабатываем ошибки.
6. Публикация события — отправляем сообщение в Kafka (через асинхронный адаптер).
7. Обновление статуса заказа — меняем статус на "processed" в БД.

Пример упрощенного кода с использованием aiohttp и asyncpg:

import aiohttp
import asyncpg
from aiohttp import web

async def create_order(request):
    data = await request.json()
    user_id = data.get('user_id')
    items = data.get('items')
    promo_code = data.get('promo_code')

    if not user_id or not items:
        return web.json_response({'error': 'Invalid input'}, status=400)

    total_price = sum(item['price'] * item['quantity'] for item in items)

    # Применяем скидку
    if promo_code:
        try:
            async with aiohttp.ClientSession() as session:
                async with session.get(f'http://discount-service/apply?code={promo_code}&amount={total_price}') as resp:
                    if resp.status == 200:
                        discount_data = await resp.json()
                        total_price = discount_data.get('discounted_amount', total_price)
        except Exception:
            # Логируем ошибку, но продолжаем без скидки
            pass

    pool = request.app['db_pool']
    async with pool.acquire() as conn:
        async with conn.transaction():
            order_id = await conn.fetchval(
                'INSERT INTO orders(user_id, total_price, status) VALUES($1, $2, $3) RETURNING id',
                user_id, total_price, 'pending'
            )

            # Резервируем товары
            try:
                async with aiohttp.ClientSession() as session:
                    reserve_payload = {'order_id': order_id, 'items': items}
                    async with session.post('http://warehouse-service/reserve', json=reserve_payload) as resp:
                        if resp.status != 200:
                            raise Exception('Warehouse reservation failed')
            except Exception:
                await conn.execute('UPDATE orders SET status=$1 WHERE id=$2', 'failed', order_id)
                return web.json_response({'error': 'Failed to reserve items'}, status=500)

            # Публикуем событие в Kafka (псевдокод)
            # await kafka_producer.send('order_created', {'order_id': order_id, 'user_id': user_id})

            await conn.execute('UPDATE orders SET status=$1 WHERE id=$2', 'processed', order_id)

    return web.json_response({'order_id': order_id, 'total_price': total_price})

Важные моменты:

• Все внешние вызовы и операции с БД выполняются асинхронно.
• Ошибки внешних сервисов обрабатываются, чтобы не прерывать весь процесс.
• Транзакция в БД гарантирует целостность данных.
• Публикация в Kafka может быть реализована через асинхронный клиент.

Такой подход обеспечивает отзывчивость API и устойчивость к сбоям внешних сервисов.