بکاند آماده یادداشت شخصی
دفترچه، یادداشت و برچسب — کوچکترین بکاند کاملی که یک اپ واقعی لازم دارد.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.
مناسب برای
- اولین اپ با فیکارو
- اپ یادداشت موبایل (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تعداد یادداشتعدد= 0is_archivedبایگانیشدهبله/خیر= false
یادداشت
/v1/noteفقط صاحب ردیف: هر کاربر فقط ردیفهای خودش را میبیند. مالکیت از روی
user_idیادداشتهای هر کاربر — فقط خودش میبیند
۹ فیلدو ۳ رابطه
user_idکاربرمتنnotebook_idدفترچهمتنtitleعنوانمتنضروریbodyمتنمتنis_pinnedسنجاقشدهبله/خیر= falsecolorرنگمتن= "#FFFFFF"attachmentپیوستفایلreminder_atیادآوریتاریخword_countتعداد کاراکترمحاسبهشده
- رابطه با دفترچهچند به یک
notebook_id - رابطه با کاربرچند به یک
user_id - رابطه با برچسبچند به چند
قوانین آماده
منطقی که همراه قالب نصب میشود و از لحظهٔ ساخت فعال است، بدون اینکه یک خط کد بنویسید.
شمارش یادداشتهای دفترچه
تریگرروی یادداشترد یادداشت بیمحتوا
اعتبارسنجیروی یادداشتپیامی که کاربر میگیرد: «یادداشت باید متن داشته باشد، یا دستکم عنوانی که بعداً بشناسیدش»
اولین درخواست
نمونهکدی که فقط نشانی پروژه و کلید شما را کم دارد. جای خالیها را بعد از ساخت پروژه، خود پنل پر میکند.
ورود و ساخت اولین یادداشت
یادداشتها شخصیاند، پس همهچیز از ورود کاربر شروع میشود — و از همان لحظه هر کاربر فقط دادهٔ خودش را میبیند.
npm install @fikaro/clientimport { 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" });
هیچ موجودیتی عمومی نیست، پس کلید عمومی اینجا کاربردی ندارد. نکتهٔ اصلی این قالب همین است: شما هیچ شرطی برای «فقط یادداشتهای خودم» نمینویسید — فیلد مالک را موتور پر میکند و خواندن را هم خودش محدود میکند. برای دیدنش، دو کاربر بسازید و با هرکدام فهرست را بخوانید.
از همین قالب شروع کنید؛ بکاندش با من.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.