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

بک‌اند آماده یادداشت شخصی

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

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

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

مناسب برای

  • اولین اپ با فیکارو
  • اپ یادداشت موبایل (Flutter / Kotlin / Swift)
  • دفترچهٔ شخصی با ورود کاربر

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

یادداشت/v1/note
  • جمع‌بندی جلسهٔ سه‌شنبه
  • سؤال‌هایی که باید از تیم بپرسم
  • کتاب‌هایی که می‌خواهم بخوانم

۳ جدولورود کاربران۲ قانون۸ ردیف نمونه

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

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

  • ثبت‌نام و ورود

    هر کاربر با ایمیل و رمز وارد می‌شود؛ از این لحظه دادهٔ او از بقیه جداست.

    POST /v1/auth/signup
  • ساخت یادداشت

    فیلد مالک را نفرستید — موتور آن را با شناسهٔ کاربر واردشده پر می‌کند و قابل جعل نیست.

    POST /v1/note
  • اثبات جداسازی داده

    با کاربر دوم ثبت‌نام کنید و همان فهرست را بخوانید: خالی است. هیچ شرطی برایش ننوشته‌اید.

    GET /v1/note
  • برچسب‌زدن یادداشت

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

    POST /v1/note/{id}/tags

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

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

برچسب

۲ ردیف/v1/tag
نامرنگ
ایده#F59E0B
کارها#2563EB

دفترچه

۲ ردیف/v1/notebook
نامآیکونتعداد یادداشت
کار💼۲
شخصی🌱۲

یادداشت

۴ ردیف/v1/note
عنوانرنگسنجاق‌شدهیادآوری
جمع‌بندی جلسهٔ سه‌شنبه#FEF3C7بله—
سؤال‌هایی که باید از تیم بپرسم——۲۱ مرداد ۱۴۰۵ ساعت ۱۱:۰۰
کتاب‌هایی که می‌خواهم بخوانم#DCFCE7——

و ۱ ردیف دیگر

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

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

  • برچسب

    /v1/tag

    کاربران واردشده: هر کاربری که وارد شده باشد همه را می‌بیند.

    برچسب‌های مشترک — برای دسته‌بندی یادداشت‌ها

    ۲ فیلد
    • nameناممتنضروری
    • colorرنگمتن= "#9CA3AF"
  • دفترچه

    /v1/notebook

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

    دفترچه‌های هر کاربر — فقط خودش می‌بیند

    ۵ فیلد
    • user_idکاربرمتن
    • nameناممتنضروری
    • iconآیکونمتن= "📓"
    • note_countتعداد یادداشتعدد= 0
    • is_archivedبایگانی‌شدهبله/خیر= false
  • یادداشت

    /v1/note

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

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

    ۹ فیلدو ۳ رابطه
    • user_idکاربرمتن
    • notebook_idدفترچهمتن
    • titleعنوانمتنضروری
    • bodyمتنمتن
    • is_pinnedسنجاق‌شدهبله/خیر= false
    • colorرنگمتن= "#FFFFFF"
    • attachmentپیوستفایل
    • reminder_atیادآوریتاریخ
    • word_countتعداد کاراکترمحاسبه‌شده
    • رابطه با دفترچهچند به یکnotebook_id
    • رابطه با کاربرچند به یکuser_id
    • رابطه با برچسبچند به چند

قوانین آماده

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

  • شمارش یادداشت‌های دفترچه

    تریگرروی یادداشت
  • رد یادداشت بی‌محتوا

    اعتبارسنجیروی یادداشت

    پیامی که کاربر می‌گیرد: «یادداشت باید متن داشته باشد، یا دست‌کم عنوانی که بعداً بشناسیدش»

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

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

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

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

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

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

// ثبت‌نام یا ورود
await client.auth.signup("me@example.com", "یک-رمز-امن");

// ساخت دفترچه و یادداشت — user_id را نمی‌فرستید، موتور خودش می‌گذارد
const notebook = await client.from("notebook").create({ name: "کار", icon: "💼" });
await client.from("note").create({
  notebook_id: notebook.id,
  title: "اولین یادداشت",
  body: "این فقط برای من دیده می‌شود.",
});

// فهرست یادداشت‌ها — بدون هیچ فیلتری روی کاربر
const { data: notes } = await client.from("note").list({ sort: "-createdAt" });

هیچ موجودیتی عمومی نیست، پس کلید عمومی اینجا کاربردی ندارد. نکتهٔ اصلی این قالب همین است: شما هیچ شرطی برای «فقط یادداشت‌های خودم» نمی‌نویسید — فیلد مالک را موتور پر می‌کند و خواندن را هم خودش محدود می‌کند. برای دیدنش، دو کاربر بسازید و با هرکدام فهرست را بخوانید.

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

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

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

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

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