به محتوای اصلی

بک‌اند آماده فرم‌ساز / نظرسنجی

فرم و سؤال عمومی، پاسخ‌ها خصوصی — بک‌اند نظرسنجی و فرم جمع‌آوری داده.

ماه اول رایگانبا پلناسپرسو

اعتبار هدیهٔ ثبت‌نام هزینه‌اش را می‌دهد؛ لازم نیست حتی یک تومان پرداخت کنید.

مناسب برای

  • نظرسنجی رضایت مشتری
  • فرم ثبت‌نام رویداد
  • جمع‌آوری بازخورد داخل اپ

همان لحظهٔ ساخت، این‌ها در جدول هستند

فرم/v1/survey
  • نظرسنجی رضایت مشتریان — تابستان
  • ثبت‌نام کارگاه «بک‌اند بدون سرور»

۴ جدولورود کاربران۳ قانون۱۰ ردیف نمونه

با این قالب چه می‌شود ساخت

کارهایی که اپ یا سایت شما از روز اول روی همین بک‌اند انجام می‌دهد.

  • رندرکردن فرم

    فرم و سؤال‌ها عمومی‌اند؛ با یک کلید عمومی و مرتب‌سازی روی position فرم را بسازید.

    GET /v1/question
  • ثبت پاسخ

    کاربر وارد می‌شود، یک response می‌سازد و جواب‌ها را به آن وصل می‌کند؛ شمارندهٔ پاسخ فرم خودکار بالا می‌رود.

    POST /v1/response
  • دیدن نتایج

    پاسخ‌دهنده فقط پاسخ خودش را می‌بیند. کاربری با نقش «مدیر» همان درخواست را می‌زند و همهٔ پاسخ‌ها را می‌گیرد.

    GET /v1/response

داده‌ای که همان لحظه دارید

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

فرم

۲ ردیف/v1/survey
عنوانوضعیتنشانیتعداد پاسخ
نظرسنجی رضایت مشتریان — تابستانبازsummer-satisfaction۱
ثبت‌نام کارگاه «بک‌اند بدون سرور»بازbackend-workshop—

سؤال

۴ ردیف/v1/question
متن سؤالنوعراهنماترتیب
چقدر احتمال دارد ما را به دیگران معرفی کنید؟امتیازاز ۰ تا ۱۰۱
دلیل امتیازی که دادید چیست؟متن بلند—۲
چطور با ما آشنا شدید؟تک‌گزینه‌ای—۳

و ۱ ردیف دیگر

پاسخ

۱ ردیف/v1/response
کد پیگیریتکمیل‌شدهزمان ارسال
RS-1403-0007بله۵ مرداد ۱۴۰۵ ساعت ۱۷:۳۵

جواب

۳ ردیف/v1/answer
مقدار متنیمقدار عددی
—۹
ارسال سریع بود و پشتیبانی همان روز جواب داد.—
——

جدول‌ها و دسترسی

هر جدول یک مسیر API دارد و از قبل مشخص است چه کسی می‌خواندش. فیلدهای هر جدول زیر همان جدول باز می‌شوند.

  • فرم

    /v1/survey

    عمومی: هر کسی می‌خواندش، حتی بدون ورود و با کلید عمومی داخل اپ.

    فرم‌ها — عمومی، تا هر کسی با لینک بتواند بازشان کند

    ۷ فیلد
    • titleعنوانمتنضروری
    • slugنشانیمتنضروری
    • descriptionتوضیحاتمتن
    • statusوضعیتگزینه‌ای= "open"
    • closes_atپایان پذیرشتاریخ
    • response_countتعداد پاسخعدد= 0
    • internal_ownerمسئول داخلیمتنپنهان
  • سؤال

    /v1/question

    عمومی: هر کسی می‌خواندش، حتی بدون ورود و با کلید عمومی داخل اپ.

    سؤال‌های هر فرم — عمومی، چون بخشی از خود فرم‌اند

    ۷ فیلدو ۱ رابطه
    • survey_idفرممتنضروری
    • positionترتیبعددضروری
    • kindنوعگزینه‌ای= "short_text"
    • textمتن سؤالمتنضروری
    • help_textراهنمامتن
    • choicesگزینه‌هاJSON
    • is_requiredالزامیبله/خیر= false
    • رابطه با فرمچند به یکsurvey_id
  • پاسخ

    /v1/response

    فقط صاحب ردیف: هر کاربر فقط ردیف‌های خودش را می‌بیند. مالکیت از روی respondent_id

    یک بار پرکردن فرم — فقط برای خود پاسخ‌دهنده و مدیر

    ۵ فیلدو ۳ رابطه
    • respondent_idپاسخ‌دهندهمتن
    • survey_idفرممتنضروری
    • referenceکد پیگیریمتن
    • submitted_atزمان ارسالتاریخ
    • is_completeتکمیل‌شدهبله/خیر= false
    • رابطه با فرمچند به یکsurvey_id
    • رابطه با کاربرچند به یکrespondent_id
    • رابطه با جوابیک به چندresponse_id
  • جواب

    /v1/answer

    فقط صاحب ردیف: هر کاربر فقط ردیف‌های خودش را می‌بیند. مالکیت از روی respondent_id

    جواب یک سؤال — با همان محدودهٔ پاسخی که به آن تعلق دارد

    ۶ فیلدو ۲ رابطه
    • respondent_idپاسخ‌دهندهمتن
    • response_idپاسخمتنضروری
    • question_idسؤالمتنضروری
    • value_textمقدار متنیمتن
    • value_numberمقدار عددیعدد
    • value_choicesگزینه‌های انتخابیJSON
    • رابطه با پاسخچند به یکresponse_id
    • رابطه با سؤالچند به یکquestion_id

قوانین آماده

منطقی که همراه قالب نصب می‌شود و از لحظهٔ ساخت فعال است، بدون اینکه یک خط کد بنویسید.

  • ثبت زمان ارسال

    تریگرروی پاسخ
  • شمارش پاسخ‌های فرم

    تریگرروی پاسخ
  • الزام گزینه برای سؤال چندگزینه‌ای

    اعتبارسنجیروی سؤال

    پیامی که کاربر می‌گیرد: «سؤال گزینه‌ای بدون گزینه معنا ندارد — فهرست گزینه‌ها را در choices بگذارید»

اولین درخواست

نمونه‌کدی که فقط نشانی پروژه و کلید شما را کم دارد. جای خالی‌ها را بعد از ساخت پروژه، خود پنل پر می‌کند.

خواندن یک فرم و سؤال‌هایش

فرم و سؤال‌ها عمومی‌اند — هر کسی با لینک می‌تواند بازشان کند، بدون ورود.

npm install @fikaro/client
import { createClient } from "@fikaro/client";

const client = createClient({
  project: "{{slug}}",
  key: "{{publishable_key}}",
});

// فرم و سؤال‌هایش، بدون ورود
const { data: forms } = await client.from("survey").list({ filter: { status: "open" } });
const { data: questions } = await client.from("question").list({
  filter: { survey_id: forms[0].id },
  sort: "position",
});

// ثبت پاسخ نیازمند ورود است
await client.auth.login("respondent@example.com", "«رمزی که هنگام ساخت پروژه دیدید»");
const response = await client.from("response").create({ survey_id: forms[0].id });
await client.from("answer").create({
  response_id: response.id,
  question_id: questions[0].id,
  value_number: 9,
});

کلید عمومی فرم و سؤال‌ها را می‌خواند و همین برای رندرکردن فرم کافی است. ثبت پاسخ نیازمند ورود کاربر است تا هر پاسخ به صاحبش گره بخورد؛ پاسخ‌دهنده فقط پاسخ خودش را می‌بیند و کاربری با نقش «مدیر» همهٔ پاسخ‌ها را.

قالب‌های دیگر

از همین قالب شروع کنید؛ بک‌اندش با من.

ماه اول رایگانبا پلناسپرسو

اعتبار هدیهٔ ثبت‌نام هزینه‌اش را می‌دهد؛ لازم نیست حتی یک تومان پرداخت کنید.

شروع رایگان با این قالب