این سؤال تنها با زبان‌های PHP ، Python ، Go و JS (Node.js) قابل حل است.

دیجی‌کال‍ا قصد دارد برای بخش تحویل محصولات خود یک سامانه‌ی ساده‌ی ثبت پیشنهادات و انتقادات راه‌اندازی کند. از شما می‌خواهیم یک API برای این سامانه طراحی کنید.

جزئیات پروژه

پروژه‌ی اولیه را از این لینک دانلود کنید.

در این سؤال، یک REST API شامل endpoint های زیر باید پیاده‌سازی شود:

در این API هر کاربر باید یک توکن داشته باشد. این توکن برای هر کاربر ثابت است.

%align_right_start%

endpoint های موردنیاز

%align_end%

در همه‌ی endpoint ها، پاسخ باید به‌صورت JSON باشد.

اطلاعات ورودی به‌صورت application/x-www-form-urlencoded به endpoint ها ارسال می‌شوند.

بررسی up بودن سرویس

پاسخ این endpoint باید به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه: {"ok":true}

ثبت‌نام

دو پارامتر username و password باید به این endpoint ارسال شوند. در صورتی که حداقل یکی از این پارامترها ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {"ok":false,"error":"no username or password provided"}

اگر کاربری با نام کاربری واردشده از قبل موجود باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {"ok":false,"error":"user already exists"}

در غیر این‌صورت، کاربر باید ساخته شود، یک توکن یکتا برایش تولید شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 201
• بدنه: {"ok":true,"token":"USER_TOKEN"}

ورود به حساب کاربری

دو پارامتر username و password باید به این endpoint ارسال شوند. در صورتی که حداقل یکی از این پارامترها ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {"ok":false,"error":"no username or password provided"}

اگر نام کاربری یا رمز عبور نادرست باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {"ok":false,"error":"invalid username or password"}

در غیر این‌صورت، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 200
• بدنه: {"ok":true,"token":"USER_TOKEN"}

درج پیشنهاد یا انتقاد

این endpoint نیازمند authentication است. در ریکوئست ارسالی مقدار هدر Authorization باید برابر با توکن کاربر باشد (بدون Bearer یا موارد مشابه).

پارامتر text (متن پیشنهاد یا انتقاد) باید به این endpoint ارسال شود. در صورتی که این پارامتر ارسال نشده باشد یا برابر با رشته‌ی خالی باشد، پاسخ باید به‌صورت زیر باشد:

• کد وضعیت: 400
• بدنه: {"ok":false,"error":"no text provided"}

در غیر این‌صورت، پیشنهاد یا انتقاد باید ثبت شود و پاسخ به‌صورت زیر باشد:

• کد وضعیت: 201
• بدنه: {"ok":true}

دریافت لیست پیشنهادات و انتقادات

این endpoint باید لیست پیشنهادات و انتقادات ثبت‌شده در سامانه را در قالب یک لیست برگرداند. این لیست شامل پیشنهادات و انتقادات ثبت‌شده توسط همه‌ی کاربران است.

• کد وضعیت: 200
• مثالی از پاسخ:

[
    {
        "user": "username1",
        "text": "sample suggestion 1"
    },
    {
        "user": "username2",
        "text": "sample suggestion 2"
    }
]

نکات تکمیلی

• نیازی به persistent بودن داده‌ها نیست!
• سیستم داوری docker-compose.yml زیر را خارج از فولدر api پاسخ شما قرار می‌دهد و با دستور docker-compose up --build آن را اجرا می‌کند.

version: "3"

services:
  api:
    build: "./api"
    container_name: "api"
    ports:
      - "80:80"

Copy

YAML

docker-compose.yml

• شما مجاز به تغییر یا ارسال docker-compose.yml دلخواه نیستید.
• سرویس شما باید روی پورت 80 آدرس localhost قابل دسترسی باشد.
• توصیه می‌کنیم در runner.sh خود APIتان را روی 0.0.0.0:80 اجرا کنید.

نحوه ارسال پاسخ

شما می‌توانید تمامی محتوای موجود در پوشه‌ی api را تغییر دهید و هر فایلی که می‌خواهید اضافه یا کم کنید.

api
├──  api.py   # or main.go somefile.js anyfile.php name.any ...
├── Dockerfile
├── requirements.txt  # or go.mod package.json composer.json
└── runner.sh

توجه کنید که نام فایل کد شما برای سیستم داوری اهمیتی ندارد و این خود شما هستید که در runner.sh از نام آن برای اجرای پروژه استفاده می‌کنید.

در نهایت این پوشه را zip کرده و ارسال کنید. توجه کنید که پس از extract کردن فایل zip شما، باید پوشه‌ی api را ببینیم که درون آن Dockerfile وجود دارد.