بکاند آماده وبلاگ / مجله
نوشته و دستهبندی عمومی، نظر و نشانشدههای کاربر — بکاند یک مجلهٔ محتوایی.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.
مناسب برای
- وبلاگ شخصی یا مجلهٔ تیمی
- بخش محتوای یک اپ موبایل
- بلاگ چندنویسنده با نظر کاربران
همان لحظهٔ ساخت، اینها در جدول هستند
/v1/post- چرا بکاند نوشتن برای یک اپ کوچک اینقدر طول میکشد
- صفحهبندی با cursor، و چرا شمارهٔ صفحه دردسر دارد
- قهوه، وقفه، و کدی که بعدش بهتر میشود
۵ جدولورود کاربران۳ قانون۱۱ ردیف نمونه
با این قالب چه میشود ساخت
کارهایی که اپ یا سایت شما از روز اول روی همین بکاند انجام میدهد.
فهرست نوشتهها برای صفحهٔ اصلی
نوشتهها عمومیاند؛ با include نویسنده و دستهبندی را در همان درخواست بگیرید.
GET /v1/postنظر گذاشتن
کاربر وارد میشود و نظر میگذارد؛ author_id خودکار پر میشود و فقط خودش میتواند نظرش را ویرایش یا حذف کند.
POST /v1/commentنشانکردن یک نوشته
«نشانشدهها» فقط برای صاحبش قابل خواندن است — کاربر دیگری آن را نمیبیند.
POST /v1/bookmark
دادهای که همان لحظه دارید
این ردیفها با ساخت پروژه در جدولها هستند. رکورد معمولیاند و هر وقت خواستید از پنل ویرایش یا پاکشان میکنید.
دستهبندی
۲ ردیف/v1/category| نام | نشانی | توضیح |
|---|---|---|
| برنامهنویسی | programming | یادداشتهای فنی و تجربههای کدنویسی |
| سبک کار | worklife | دربارهٔ تمرکز، ابزار و عادتهای کاری |
برچسب
۲ ردیف/v1/tag| نام | نشانی |
|---|---|
| Go | go |
| API | api |
نوشته
۳ ردیف/v1/post| عنوان | وضعیت | نشانی | بازدید |
|---|---|---|---|
| چرا بکاند نوشتن برای یک اپ کوچک اینقدر طول میکشد | منتشرشده | why-backend-takes-long | ۴۱۲ |
| صفحهبندی با cursor، و چرا شمارهٔ صفحه دردسر دارد | منتشرشده | cursor-pagination | ۲۶۸ |
| قهوه، وقفه، و کدی که بعدش بهتر میشود | منتشرشده | coffee-break-and-code | ۹۷ |
نظر
۳ ردیف/v1/comment| متن نظر | نام نمایشی |
|---|---|
| دقیقاً همین! بخش مستندسازی همیشه از تخمین جا میماند. | سارا |
| یک نکته: تست نوشتن هم معمولاً در تخمین نیست ولی بیشترین وقت را میگیرد. | سارا |
| پیادهروی کوتاه هم همین اثر را دارد. | سارا |
نشانشده
۱ ردیف/v1/bookmark| یادداشت |
|---|
| برای بازخوانی موقع پیادهسازی صفحهبندی |
جدولها و دسترسی
هر جدول یک مسیر API دارد و از قبل مشخص است چه کسی میخواندش. فیلدهای هر جدول زیر همان جدول باز میشوند.
دستهبندی
/v1/categoryعمومی: هر کسی میخواندش، حتی بدون ورود و با کلید عمومی داخل اپ.
۳ فیلد
nameناممتنضروریslugنشانیمتنضروریdescriptionتوضیحمتن
برچسب
/v1/tagعمومی: هر کسی میخواندش، حتی بدون ورود و با کلید عمومی داخل اپ.
۲ فیلد
nameناممتنضروریslugنشانیمتنضروری
نوشته
/v1/postعمومی: هر کسی میخواندش، حتی بدون ورود و با کلید عمومی داخل اپ.
مطالب منتشرشده — عمومی، همان چیزی که خواننده بدون ورود میبیند
۱۳ فیلدو ۴ رابطه
titleعنوانمتنضروریslugنشانیمتنضروریexcerptخلاصهمتنcontentمحتوا (Markdown)متنcoverتصویر شاخصفایلauthor_idنویسندهمتنcategory_idدستهبندیمتنstatusوضعیتگزینهای= "published"published_atتاریخ انتشارتاریخview_countبازدیدعدد= 0comment_countتعداد نظرعدد= 0editor_noteیادداشت سردبیرمتنپنهانread_timeزمان مطالعه (دقیقه)محاسبهشده
- رابطه با کاربرچند به یک
author_id - رابطه با دستهبندیچند به یک
category_id - رابطه با برچسبچند به چند
- رابطه با نظریک به چند
post_id
نظر
/v1/commentعمومی: هر کسی میخواندش، حتی بدون ورود و با کلید عمومی داخل اپ.
نظرها — عمومی خوانده میشوند، ولی هرکس فقط نظر خودش را ویرایش یا حذف میکند
۴ فیلدو ۲ رابطه
post_idنوشتهمتنضروریauthor_idنویسندهٔ نظرمتنdisplay_nameنام نمایشیمتنbodyمتن نظرمتنضروری
- رابطه با نوشتهچند به یک
post_id - رابطه با کاربرچند به یک
author_id
نشانشده
/v1/bookmarkفقط صاحب ردیف: هر کاربر فقط ردیفهای خودش را میبیند. مالکیت از روی
user_idنوشتههایی که خواننده ذخیره کرده — فقط خودش میبیند
۳ فیلدو ۱ رابطه
user_idکاربرمتنpost_idنوشتهمتنضروریnoteیادداشتمتن
- رابطه با نوشتهچند به یک
post_id
قوانین آماده
منطقی که همراه قالب نصب میشود و از لحظهٔ ساخت فعال است، بدون اینکه یک خط کد بنویسید.
ثبت تاریخ انتشار
تریگرروی نوشتهشمارش نظر روی نوشته
تریگرروی نظرالزام خلاصه برای نوشتهٔ بلند
اعتبارسنجیروی نوشتهپیامی که کاربر میگیرد: «نوشتههای بلند باید خلاصه داشته باشند — خلاصه همان چیزی است که در فهرست و شبکههای اجتماعی دیده میشود»
اولین درخواست
نمونهکدی که فقط نشانی پروژه و کلید شما را کم دارد. جای خالیها را بعد از ساخت پروژه، خود پنل پر میکند.
خواندن فهرست نوشتهها
نوشتهها، دستهبندیها و نظرها عمومیاند — اپ بدون ورود کاربر میتواند کل مجله را نشان بدهد.
npm install @fikaro/clientimport { createClient } from "@fikaro/client";
const client = createClient({
project: "{{slug}}",
key: "{{publishable_key}}",
});
// فهرست نوشتهها با نویسنده و دستهبندی
const { data: posts } = await client.from("post").list({
filter: { status: "published" },
sort: "-published_at",
include: "author,category",
});
// نشانکردن یک نوشته نیازمند ورود کاربر است
await client.auth.login("reader@example.com", "«رمزی که هنگام ساخت پروژه دیدید»");
await client.from("bookmark").create({ post_id: posts[0].id });
کلید عمومی فقط میخواند و فقط موجودیتهای عمومی؛ برای گذاشتنش داخل اپ امن است. «نشانشدهها» فقط برای خود کاربر است و به توکن ورود نیاز دارد. نوشتن نظر هم نیازمند ورود است، چون هر نظر به نویسندهاش گره میخورد.
از همین قالب شروع کنید؛ بکاندش با من.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.