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

بک‌اند آماده وبلاگ / مجله

نوشته و دسته‌بندی عمومی، نظر و نشان‌شده‌های کاربر — بک‌اند یک مجلهٔ محتوایی.

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

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

مناسب برای

  • وبلاگ شخصی یا مجلهٔ تیمی
  • بخش محتوای یک اپ موبایل
  • بلاگ چندنویسنده با نظر کاربران

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

نوشته/v1/post
  • چرا بک‌اند نوشتن برای یک اپ کوچک این‌قدر طول می‌کشد
  • صفحه‌بندی با cursor، و چرا شمارهٔ صفحه دردسر دارد
  • قهوه، وقفه، و کدی که بعدش بهتر می‌شود

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

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

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

  • فهرست نوشته‌ها برای صفحهٔ اصلی

    نوشته‌ها عمومی‌اند؛ با include نویسنده و دسته‌بندی را در همان درخواست بگیرید.

    GET /v1/post
  • نظر گذاشتن

    کاربر وارد می‌شود و نظر می‌گذارد؛ author_id خودکار پر می‌شود و فقط خودش می‌تواند نظرش را ویرایش یا حذف کند.

    POST /v1/comment
  • نشان‌کردن یک نوشته

    «نشان‌شده‌ها» فقط برای صاحبش قابل خواندن است — کاربر دیگری آن را نمی‌بیند.

    POST /v1/bookmark

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

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

دسته‌بندی

۲ ردیف/v1/category
نامنشانیتوضیح
برنامه‌نویسیprogrammingیادداشت‌های فنی و تجربه‌های کدنویسی
سبک کارworklifeدربارهٔ تمرکز، ابزار و عادت‌های کاری

برچسب

۲ ردیف/v1/tag
نامنشانی
Gogo
APIapi

نوشته

۳ ردیف/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بازدیدعدد= 0
    • comment_countتعداد نظرعدد= 0
    • editor_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/client
import { 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 });

کلید عمومی فقط می‌خواند و فقط موجودیت‌های عمومی؛ برای گذاشتنش داخل اپ امن است. «نشان‌شده‌ها» فقط برای خود کاربر است و به توکن ورود نیاز دارد. نوشتن نظر هم نیازمند ورود است، چون هر نظر به نویسنده‌اش گره می‌خورد.

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

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

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

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

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