فصل ۲: کاربرهای اپ و دسترسیدرس ۶ از ۲۳
مدیر فروشگاه
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
یکی از کاربرهای اپ را «مدیر» میکنیم: نقشها و دسترسیهایشان را در پنل میبینیم، و در صفحهی سایت بخشی میسازیم که فقط مدیر میبیند؛ و اینکه نقش تازه با تازه شدن توکن به صفحه میرسد.
در این درس یاد میگیرید
- فرق نقش «کاربر» و «مدیر» در پروژه
- مدیر کردن یک کاربر اپ از پنل
- بخشی از صفحه که فقط مدیر میبیند، با
s.user.role - اینکه نقش تازه با تازه شدن توکن به اپ میرسد
برای ادامه بخوانید
- مدت
- ۲ دقیقه۴ قدم
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
index.html
۱۴۱ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
<!doctype html>
<html lang="fa" dir="rtl">
<meta charset="utf-8">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vazirmatn@33.0.3/Vazirmatn-font-face.css">
<style>
body { font: 19px/1.9 Vazirmatn, Tahoma, sans-serif; background: #f5f5f4; color: #1c1917;
max-width: 1040px; margin: 0 auto; padding: 24px; }
main { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; align-items: start; }
.card { background: #fff; border: 1px solid #e7e5e4; border-radius: 14px; padding: 20px; }
h1 { margin: 0 0 16px; } h2 { margin: 0 0 8px; font-size: 20px; }
input { font: inherit; width: 100%; box-sizing: border-box; margin-bottom: 10px;
padding: 6px 12px; border: 1px solid #d6d3d1; border-radius: 8px; }
button { font: inherit; padding: 4px 16px; border: 0; border-radius: 8px;
background: #ea580c; color: #fff; cursor: pointer; }
button.quiet { background: #f0efee; color: #1c1917; }
ul { list-style: none; padding: 0; margin: 0 0 16px; }
li { display: flex; justify-content: space-between; align-items: center;
padding: 6px 0; border-top: 1px solid #f0efee; }
dl { display: grid; grid-template-columns: auto 1fr; gap: 4px 16px; margin: 0 0 16px; }
dd { margin: 0; text-align: right; color: #57534e; }
dd[dir] { font-family: monospace; }
.error { color: #b91c1c; margin: 0; }
</style>
<body>
<h1>فروشگاه من</h1>
<main>
<form id="auth" class="card">
<h2>ورود به حساب</h2>
<input id="email" type="email" placeholder="ایمیل">
<input id="password" type="password" placeholder="رمز (حداقل ۸ حرف)">
<button id="login">ورود</button> <button id="signup" class="quiet">ثبتنام</button>
<p id="error" class="error"></p>
</form>
<section id="session" class="card" hidden>
<h2>سلام <span id="who"></span></h2>
<dl>
<dt>توکن دسترسی</dt><dd id="access" dir="ltr"></dd>
<dt>معتبر تا</dt><dd id="expires"></dd>
<dt>توکن تازهسازی</dt><dd id="refresh" dir="ltr"></dd>
</dl>
<button id="renew" class="quiet">تازه کردن توکن</button> <button id="logout">خروج</button>
</section>
<section class="card">
<h2>محصولات</h2>
<ul id="products"></ul>
<h2>علاقهمندیهای من</h2>
<ul id="favorites"></ul>
</section>
<section id="stats" class="card" hidden>
<h2>آمار علاقهمندیها (فقط مدیر)</h2>
<ul id="popular"></ul>
</section>
</main>
<script type="module">
import { createClient, browserStorage } from "https://cdn.jsdelivr.net/npm/@fikaro/client/+esm";
const fikaro = createClient({
project: "my-shop",
key: "YOUR_KEY",
storage: browserStorage(),
});
const $ = (id) => document.getElementById(id);
const { data: products } = await fikaro.from("product").list();
const MESSAGES = {
invalid_credentials: "ایمیل یا رمز اشتباه است.",
email_taken: "این ایمیل قبلاً ثبت شده؛ «ورود» را بزنید.",
validation_failed: "ایمیل درست و رمز حداقل ۸ حرفی لازم است.",
rate_limited: "رمز چند بار اشتباه زده شد؛ ۱۵ دقیقه صبر کنید.",
};
async function show() {
const s = fikaro.auth.session;
$("auth").hidden = !!s;
$("session").hidden = !s;
if (s) {
$("who").textContent = s.user.email;
$("access").textContent = "…" + s.accessToken.slice(-12);
$("expires").textContent = new Date(s.expiresAt).toLocaleTimeString("fa-IR");
$("refresh").textContent = "…" + s.refreshToken.slice(-12);
}
$("products").replaceChildren(...products.map((p) => {
const li = document.createElement("li");
li.textContent = `${p.name} — ${p.price.toLocaleString("fa-IR")} تومان`;
const heart = document.createElement("button");
heart.textContent = "♥";
heart.className = "quiet";
heart.onclick = async () => {
await fikaro.from("favorite").create({ product_id: p.id });
show();
};
if (s) li.append(heart);
return li;
}));
const { data: favs } = s ? await fikaro.from("favorite").list({ limit: 100 }) : { data: [] };
const mine = favs.filter((f) => f.user_id === s.user.id);
$("favorites").replaceChildren(...mine.map((f) => {
const li = document.createElement("li");
li.textContent = products.find((p) => p.id === f.product_id)?.name ?? "؟";
return li;
}));
// مدیر همهی علاقهمندیها را میگیرد، نه فقط مال خودش را
const admin = s?.user.role === "admin";
$("stats").hidden = !admin;
if (admin) {
$("popular").replaceChildren(...products.map((p) => {
const n = favs.filter((f) => f.product_id === p.id).length;
const li = document.createElement("li");
li.textContent = `${p.name}: ${n.toLocaleString("fa-IR")} نفر`;
return li;
}));
}
}
const signIn = (how) => async (e) => {
e.preventDefault();
$("error").textContent = "";
try {
await fikaro.auth[how]($("email").value, $("password").value);
$("auth").reset();
show();
} catch (err) {
$("error").textContent = MESSAGES[err.code] ?? err.message;
}
};
$("login").onclick = signIn("login");
$("signup").onclick = signIn("signup");
$("renew").onclick = async () => { await fikaro.auth.refresh(); show(); };
$("logout").onclick = async () => { await fikaro.auth.logout(); show(); };
// اگر نشستِ ذخیرهشده دیگر معتبر نباشد، فیکارو خودش پاکش میکند.
if (fikaro.auth.session) await fikaro.auth.me().catch(() => {});
show();
</script>هر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
علی وارد شده و یک علاقهمندی دارد.کاربر معمولی فقط علاقهمندیهای خودش را میبیند؛ علاقهمندی سارا را نه.
در پنل، از منوی کناری «رکوردها» را باز کنید.
جدول «کاربران» را انتخاب کنید.کاربرهای اپ شما اینجا هستند؛ سارا و علی.
«نقشها» را بزنید.ببینیم هر نقش چه اجازهای دارد.
«کاربر» فقط رکوردهای خودش را ویرایش و حذف میکند؛ «مدیر» همه را.و «فقط رکوردهای خودِ کاربر» که روی جدول علاقهمندی گذاشتیم، جلوی مدیر را نمیگیرد.
از منوی کنار ردیف علی، «مدیر» را انتخاب کنید.
علی حالا مدیر است.
این index.html تازه است؛ متن کاملش را از صفحهی همین آموزش در fikaro.ir کپی کنید.همان صفحهی قسمت ۵، با چند خط بیشتر.
مدیر، علاقهمندیهای همه را میگیرد.پس «علاقهمندیهای من» را با شناسهی خود کاربر جدا میکنیم.
اگر نقش کاربر «مدیر» باشد، آمار هر محصول را نشان بده.نقش، داخل نشست کاربر است:
s.user.role.فایل را ذخیره کنید (Ctrl+S).
صفحه را تازه کنید (F5).
هنوز آماری نیست.نقش داخل توکن دسترسی است، و علی توکنش را پیش از مدیر شدن گرفته بود.
«تازه کردن توکن» را بزنید.توکن تازه با نقش تازه صادر میشود؛ در اپ واقعی حداکثر تا یک ساعت خودش این اتفاق میافتد، یا با ورود دوباره.
حالا علی آمار همه را میبیند.هر محصول چند نفر دوستش دارند؛ علاقهمندی سارا هم در آمار هست.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.