فصل ۲: کاربرهای اپ و دسترسیدرس ۷ از ۲۳
ورود با شماره موبایل
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
به صفحهی فروشگاه یک فرم «ورود با موبایل» اضافه میکنیم: `fikaro.auth.sendCode` کد را پیامک میکند و `verifyCode` با همان کد کاربر را وارد میکند؛ اگر حسابی نباشد، همان بار اول ساخته میشود. هزینهی هر پیامک از اعتبار نقدی کیفپول کم میشود.
در این درس یاد میگیرید
- روشن بودن «موبایل و کد یکبارمصرف» در روشهای ورود پروژه
- فرم دومرحلهای با
fikaro.auth.sendCodeوverifyCode - ساخته شدن حساب با همان اولین ورود، بدون ایمیل و رمز
- هزینهی هر پیامک، از اعتبار نقدی کیفپول
- مدت
- ۳ دقیقه۴ قدم
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
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>
<form id="otp" class="card">
<h2>ورود با موبایل</h2>
<input id="mobile" inputmode="tel" placeholder="شماره موبایل، مثلاً ۰۹۱۲۱۲۳۴۵۶۷">
<button id="send">ارسال کد</button>
<div id="step2" hidden>
<input id="code" inputmode="numeric" placeholder="کد ۶ رقمی">
<button id="verify">ورود</button>
</div>
<p id="otpError" class="error"></p>
</form>
<section id="session" class="card" hidden>
<h2>سلام <bdi id="who"></bdi></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>
</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: "چند بار پشت سر هم امتحان شد؛ کمی صبر کنید.",
invalid_mobile: "شماره موبایل درست نیست؛ مثلاً ۰۹۱۲۱۲۳۴۵۶۷.",
otp_invalid: "کد اشتباه است.",
otp_expired: "کد منقضی شده؛ دوباره «ارسال کد» را بزنید.",
sms_unavailable: "ارسال پیامک الان ممکن نیست؛ با ایمیل وارد شوید.",
};
async function show() {
const s = fikaro.auth.session;
$("auth").hidden = !!s;
$("otp").hidden = !!s;
$("session").hidden = !s;
if (s) {
$("who").textContent = s.user.email ?? s.user.mobile;
$("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: mine } = s ? await fikaro.from("favorite").list() : { data: [] };
$("favorites").replaceChildren(...mine.map((f) => {
const li = document.createElement("li");
li.textContent = products.find((p) => p.id === f.product_id)?.name ?? "؟";
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");
// ورود با موبایل: اول کد پیامک میشود، بعد همان کد کاربر را وارد میکند.
// اگر حسابی با این شماره نباشد، همین بار اول ساخته میشود.
$("send").onclick = async (e) => {
e.preventDefault();
$("otpError").textContent = "";
try {
await fikaro.auth.sendCode($("mobile").value);
$("step2").hidden = false;
$("code").focus();
} catch (err) {
$("otpError").textContent = MESSAGES[err.code] ?? err.message;
}
};
$("verify").onclick = async (e) => {
e.preventDefault();
$("otpError").textContent = "";
try {
await fikaro.auth.verifyCode($("mobile").value, $("code").value);
$("otp").reset();
$("step2").hidden = true;
show();
} catch (err) {
$("otpError").textContent = MESSAGES[err.code] ?? err.message;
}
};
$("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 کپی کنید.همان صفحهی قسمت ۵، با یک فرم بیشتر.
یک فرم دومرحلهای: شماره، و بعد کد.مرحلهی دوم تا کد فرستاده نشده پنهان است.
fikaro.auth.sendCodeکد را به شماره پیامک میکند.شماره با رقم فارسی هم پذیرفته میشود.و
fikaro.auth.verifyCodeبا همان کد کاربر را وارد میکند.اگر حسابی با این شماره نباشد، همین بار اول ساخته میشود.خطاهای پیامکی هم پیام فارسی خودشان را دارند.کد اشتباه، کد منقضی، یا شمارهی نادرست.
فایل را ذخیره کنید (Ctrl+S).
صفحه را تازه کنید (F5).
رضا شمارهاش را مینویسد؛ با رقم فارسی.
«ارسال کد» را بزنید.
کد فرستاده شد و جای وارد کردنش باز شد.کد پنج دقیقه اعتبار دارد.
کد ۶ رقمی پیامک را وارد کنید و «ورود» را بزنید.
رضا وارد شد؛ حسابش همین الان ساخته شد.بدون ایمیل و بدون رمز؛ همان توکنهای قسمت ۵ را دارد.
رضا با شمارهی موبایلش آمده، با نقش «کاربر».شماره به شکل بینالمللی، با کد ۹۸ ایران، ذخیره شده است.
پیامکهای این ماه و هزینهشان همینجاست.پیامک سهمیهی ماهانه ندارد؛ هر ارسال همان لحظه از اعتبار نقدی کم میشود.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.