بکاند آماده فرمساز / نظرسنجی
فرم و سؤال عمومی، پاسخها خصوصی — بکاند نظرسنجی و فرم جمعآوری داده.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.
مناسب برای
- نظرسنجی رضایت مشتری
- فرم ثبتنام رویداد
- جمعآوری بازخورد داخل اپ
همان لحظهٔ ساخت، اینها در جدول هستند
/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تعداد پاسخعدد= 0internal_ownerمسئول داخلیمتنپنهان
سؤال
/v1/questionعمومی: هر کسی میخواندش، حتی بدون ورود و با کلید عمومی داخل اپ.
سؤالهای هر فرم — عمومی، چون بخشی از خود فرماند
۷ فیلدو ۱ رابطه
survey_idفرممتنضروریpositionترتیبعددضروریkindنوعگزینهای= "short_text"textمتن سؤالمتنضروریhelp_textراهنمامتنchoicesگزینههاJSONis_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/clientimport { 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,
});
کلید عمومی فرم و سؤالها را میخواند و همین برای رندرکردن فرم کافی است. ثبت پاسخ نیازمند ورود کاربر است تا هر پاسخ به صاحبش گره بخورد؛ پاسخدهنده فقط پاسخ خودش را میبیند و کاربری با نقش «مدیر» همهٔ پاسخها را.
از همین قالب شروع کنید؛ بکاندش با من.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.