🚀 راهنمای کامل و جامع · نسخه ۲۰۲۶ · تعاملی

بدون کدنویسی محصول بساز

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

⚡ آیا واقعا نیازی به کدنویسی ندارم؟ (واقعیت مهم)

خبر خوب: برای ساخت ابزارهای کاربردی و MVP نیازی نیست یک خط کد با دست بنویسی. هوش مصنوعی کد را برایت تولید می‌کند.

خبر واقعی: نداشتن نیاز به نوشتن کد، به معنای عدم نیاز به «سواد خواندن کد» (Code Literacy) نیست. وقتی اپلیکیشن بزرگ می‌شود و AI به دلیل حجم بالای فایل‌ها گیج می‌زند، اگر بتوانی ساختار کدی که AI نوشته را بخوانی و درک کنی (بدون اینکه بتوانی از صفر بنویسیش)، می‌توانی مشکلات را در یک دقیقه با یک پرامپت دقیق حل کنی؛ در حالی که یک فرد بی‌تجربه ممکن است ساعت‌ها با پرامپت‌های مبهم در حلقه باطل ارورها گیر کند.

🏗️ پس از این راهنما چه چیزهایی خواهی ساخت؟

🌐 پلتفرم وب (SaaS)

از یک صفحه لندینگ ساده تا یک سیستم کامل با ثبت‌نام کاربر، دیتابیس اختصاصی، پنل ادمین و اتصال به درگاه پرداخت آنلاین.

🤖 ایجنت هوش مصنوعی شخصی

مثلاً: اپلیکیشنی که لینک یوتیوب می‌گیرد، زیرنویس را استخراج می‌کند و فلش‌کارت آموزشی یا خلاصه مقاله تحویل می‌دهد.

📱 اپلیکیشن PWA (موبایل)

طراحی Responsive و تبدیل سایت به اپلیکیشنی که بدون نیاز به اپ‌استور، آیکون آن روی صفحه گوشی نصب شود.

بخش اول

پایه‌های Vibe Coding و تغییر ذهنیت

۱.۱ Vibe Coding چیست؟

Vibe Coding یعنی بذار هوش مصنوعی زحمت تایپ کردن سینتکس و جزئیات خسته‌کننده را بکشد و تو فقط از نتیجه‌ی کار لذت ببر و روی منطق و حس خوب ساختن محصول متمرکز باش. به بیان ساده، شما به جای مجسمه‌تراشی با دست، نقش یک کارگردان را بازی می‌کنید که دستورات را به یک تیم فنی بسیار سریع (AI) می‌دهد.

۱.۲ تغییر ذهنیت: تفکر سیستمی (Thinking in Scaffolds)

مهم‌ترین تغییر ذهنیت در Vibe Coding این است که شما معمار هستید. هوش مصنوعی می‌تواند آجرها را با سرعت نور بچیند، اما «نقشه ساختمان» (Scaffold) را شما باید مشخص کنید. اگر از همان روز اول ساختار پوشه‌ها، مسیر چرخش داده‌ها و نوع دیتابیس را برای AI روشن نکنید، خیلی زود پروژه به یک «کد اسپاگتی» تبدیل می‌شود که حتی خود هوش مصنوعی هم از حل ارورهای آن عاجز می‌ماند.

۱.۳ مدل ذهنی یک اپلیکیشن مدرن

قبل از اینکه پرامپت بنویسید، باید بدانید قطعات نرم‌افزار چگونه به هم وصلند. وقتی می‌گویید "یک سیستم ورود بساز"، AI باید در هر سه لایه زیر تغییر ایجاد کند:

🧑‍💻
Client / User
مرورگر کاربر
(کلیک روی دکمه ورود)
ارسال ایمیل و رمز (Request)پاسخ سرور: موفق / خطا (Response)
🖥️
Frontend (UI)
React / Tailwind
ظاهر فرم و اخطارها
⚙️
Backend (API)
Node.js / Python
منطق چک کردن رمز عبور
🗄️
Database
PostgreSQL
جستجوی کاربر در لیست
۱.۴ واژه‌نامه تخصصی (برای مکالمه دقیق با AI)
Terminal 💻
محیط متنی کامپیوتر. جایی که با تایپ کردن دستور (مثل npm install) کارهای زیرساختی انجام می‌دهیم.
Framework 🏗️
اسکلت آماده کدنویسی. به جای نوشتن کدهای تکراری از صفر، از فریم‌ورک‌هایی مثل React یا Next.js استفاده می‌کنیم.
Context 🧠
حافظه کوتاه‌مدت AI در یک چت. اگر چت طولانی شود، کانتکست پر شده و AI اطلاعات قبلی را فراموش می‌کند (توهم می‌زند).
Deployment 🚀
فرآیند آپلود کدها از کامپیوتر شما (لوکال) به یک سرور واقعی تا با یک دامنه (مثل .com) برای همه قابل دیدن باشد.
Component 🧩
قطعات مستقل سازنده ظاهر سایت (مثل دکمه، هدر، منو) که می‌توان آن‌ها را در جاهای مختلف بدون کدنویسی مجدد استفاده کرد.
بخش دوم

مفاهیم فنی، جریان داده و ارورها

۲.۱ اینترنت چطور کار می‌کند؟ (کنسول مرورگر)

برای دیباگ کردن، باید مرورگر را بشناسید. با زدن کلید F12 در کروم، ابزار Developer Tools باز می‌شود. در تب Console خطاهای مربوط به جاوااسکریپت و در تب Network تمام اطلاعاتی که بین سیستم شما و سرور جابجا می‌شود قابل مشاهده است. این مهم‌ترین ابزار شما برای اسکرین‌شات گرفتن و فرستادن به AI است.

۲.۲ زبان مشترک سیستم‌ها (JSON)

وقتی سایت می‌خواهد لیست محصولات را از سرور بگیرد، داده‌ها با فرمت استانداردی به نام JSON جابجا می‌شوند. درک این ساختار درختی برای توصیف دیتا به AI حیاتی است.

response.json
{
  "status": "success",
  "user": {
    "name": "Ali",
    "is_premium": true,
    "skills": ["Design", "AI"]
  }
}
۲.۳ قلب تپنده برنامه‌ها: State (وضعیت)

بزرگترین عامل باگ در Vibe Coding، عدم درک State است. State یعنی حافظه موقت اپلیکیشن در همان لحظه. تصور کنید کاربر وارد سبد خرید می‌شود:

  • وضعیت ۱: سبد خالی است (یک متغیر در کد false است).
  • وضعیت ۲: روی دکمه خرید کلیک می‌شود (وضعیت به حالت Loading می‌رود و دکمه می‌چرخد).
  • وضعیت ۳: خرید موفق است (وضعیت به Success تغییر می‌کند و رنگ دکمه سبز می‌شود).
🎯
چگونه پرامپت بدهیم؟
هرگز نگویید: "رنگ دکمه را سبز کن". بگویید: "یک State به نام isSubscribed تعریف کن. اگر این مقدار `true` بود، دکمه را سبز نشان بده و اگر `false` بود، قرمز."
۲.۴ انواع دیتابیس (کجا ذخیره کنیم؟)

📊 SQL (رابطه‌ای)

داده‌ها در جدول‌های دقیق (مثل اکسل) ذخیره می‌شوند. ساختار آن سخت‌گیرانه است.

ابزار: PostgreSQL (Supabase)
کاربرد: سیستم‌های مالی و فروشگاه.

📄 NoSQL (سندمحور)

داده‌ها به صورت فایل‌های JSON ذخیره می‌شوند. بسیار منعطف و سریع است.

ابزار: MongoDB, Firebase
کاربرد: شبکه‌های اجتماعی و چت.

🧠 Vector DB (برداری)

کلمات را به اعداد تبدیل کرده و ارتباط معنایی آن‌ها را برای AI درک‌پذیر می‌کند.

ابزار: Pinecone
کاربرد: چت‌بات با دیتای شخصی (RAG).

۲.۵ Git (ماشین زمان شما)

وقتی هوش مصنوعی کدی می‌نویسد که درست کار می‌کند، باید وضعیت پروژه را Save کنید تا اگر در پرامپت بعدی کل پروژه را خراب کرد، پنیک نکنید و به نقطه امن برگردید. این کار با Git انجام می‌شود.

ترمینال (ذخیره کد)
# بعد از تست و اطمینان از کارکرد ویژگی جدید:
git add .
git commit -m "login page works perfectly"
۲.۶ ارتباط با بیرون (API و Webhook)
تکنولوژیمفهوم انسانیکاربرد واقعی
APIشما تماس می‌گیرید و سوال می‌پرسید.دریافت قیمت لحظه‌ای دلار از سرور بانک.
Webhookشماره می‌دهید تا وقتی خبری شد تماس بگیرند.درگاه پرداخت اینترنتی. وقتی کاربر پول داد، بانک به سایت شما Webhook می‌فرستد.
۲.۷ مدیریت وابستگی‌ها و package.json

هوش مصنوعی گاهی کدهایی می‌دهد که نیازمند لایبرری‌های خارجی (مثل axios یا framer-motion) هستند. لیست تمام این لایبرری‌ها در فایلی به نام package.json قرار دارد. اگر با ارور Module not found مواجه شدید، به AI بگویید دستور npm install مربوطه را به شما بدهد.

۲.۸ کابوس CORS (Cross-Origin Resource Sharing)

هنگام تست پروژه‌های Full-Stack روی کامپیوتر خودتان، اگر فرانت‌اند (مثلا localhost:3000) بخواهد به بک‌اند (localhost:5000) متصل شود، مرورگر به دلایل امنیتی آن را مسدود می‌کند و ارور قرمز CORS می‌دهد.

🚫
راه‌حل پرامپتی CORS
همیشه هنگام ساخت سرور بک‌اند به AI این شرط را اضافه کنید: "پکیج cors را نصب و پیکربندی کن تا تمام درخواست‌های localhost بدون مشکل دریافت شوند."
۲.۹ متغیرهای محیطی (.env)

کدهایی که حاوی رمز عبور دیتابیس یا کلیدهای API (مثل کلید OpenAI) هستند، هرگز نباید مستقیما در فایل‌های کد نوشته شوند، زیرا با آپلود در GitHub همه می‌توانند آن‌ها را سرقت کنند. این مقادیر باید در فایلی به نام .env قرار گیرند که هرگز آپلود نمی‌شود.

بخش سوم

راه‌اندازی محیط کار و انتخاب مسیر

۳.۱ نبرد بزرگ: ابری یا لوکال؟

انتخاب محیط توسعه اشتباه در روز اول، می‌تواند شما را کاملاً از برنامه‌نویسی دلزده کند. دو مسیر اصلی وجود دارد:

مسیر اول: مبتدی و سریع

☁️ ابزارهای ابری (Cloud-based)

مثل: Lovable, Bolt.new, v0.dev

  • بدون نصب: در مرورگر باز می‌کنید و شروع می‌کنید.
  • پیش‌نمایش زنده: در یک سمت چت می‌کنید، سمت دیگر سایت ساخته می‌شود.
  • هاستینگ خودکار: به سرعت یک لینک به شما می‌دهد تا اپ را منتشر کنید.
  • محدودیت مقیاس: برای اپ‌های بسیار بزرگ با دیتابیس‌های پیچیده کم می‌آورد و کانتکست آن سریع پر می‌شود.
مسیر دوم: حرفه‌ای و قدرتمند

💻 ابزارهای لوکال (Desktop)

مثل: Cursor, Windsurf, Claude Code

  • کنترل 100%: فایل‌ها روی ویندوز/مک شماست. محدودیتی در اتصال به سرورها ندارید.
  • قدرت ویرایش کل پروژه: هوش مصنوعی می‌تواند به طور همزمان 50 فایل را بررسی و ویرایش کند.
  • پیشنیاز فنی: باید نرم‌افزارهایی مثل Node.js و Git را نصب کنید و از خطایابی ترمینال نترسید.
  • استقرار: برای آنلاین کردن اپلیکیشن باید خودتان زحمت دیپلوی روی Vercel یا cPanel را بکشید.
🚀
پیشنهاد قطعی مدرس
اگر اولین بار است محصول می‌سازید، به هیچ وجه با Cursor و محیط لوکال شروع نکنید! ارورهای نصب پکیج‌ها شما را نابود می‌کند. ۳۰ روز اول فقط از Lovable استفاده کنید تا با منطق پرامپت‌نویسی آشنا شوید و بعد از مسلط شدن، به محیط دسکتاپ (Cursor) مهاجرت کنید.
بخش چهارم

دنیای ابزارها و دستیارهای هوشمند

۴.۱ نقشه جامع ابزارها (اکوسیستم ۲۰۲۶)
❤️
LovableBy Lovable Inc
پادشاه فعلی Vibe Coding ابری. اتصال خودکار و بی‌نقص به دیتابیس Supabase. کدهایی بسیار تمیز و قابل نگهداری تولید می‌کند.
🌐 Web Cloud L1L2
⌨️
CursorBy Anysphere
ادیتور دسکتاپ بر پایه VS Code. دارای بخش Composer که می‌تواند با دریافت پرامپت، یک پروژه کامل را از پایه تا سقف بسازد. استاندارد صنعت.
💻 Desktop L3L4L5
Bolt.newBy StackBlitz
رقیب قدرتمند Lovable. اجرای کدهای Full-stack (فرانت‌اند و بک‌اند باهم) مستقیما درون مرورگر با سرعت بوت خیره‌کننده.
🌐 Web Cloud L1L2
🚀
AntigravityBy Google
پلتفرم قدرتمند گوگل با ادغام عمیق مدل Gemini. ایده‌آل برای ساخت معماری‌های پیچیده، مدیریت APIهای حجیم و پرفورمنس سازمانی.
💻 Desktop ⬛ CLI L4L5
🏄
WindsurfBy Codeium
ادیتوری با مفهوم "Flow State". ایجنت هوشمند آن برخلاف سایر رقبا، به صورت مستقل و در پس‌زمینه فایل‌ها را بررسی و آپدیت می‌کند.
💻 Desktop L3L4
📦
ReplitBy Replit
محیط توسعه و هاستینگ همزمان. دارای ایجنت هوشمندی که مستقیما روی سرور ابری ریپلیت کدهای شما را توسعه می‌دهد.
🌐 Web L2L3
۴.۲ دستیارهای کدنویسی پیشرفته

دستیارهای کدنویسی مدرن صرفاً یک چت‌بات مثل ChatGPT نیستند؛ آن‌ها افزونه‌ها و ترمینال‌هایی هستند که تسلط عمیقی روی کل پروژه شما دارند:

  • Claude Code: یک ایجنت ترمینالی خالص (بدون محیط گرافیکی). به آن دسترسی می‌دهید و خودش مانند یک برنامه‌نویس ارشد فایل‌ها را پیدا کرده، می‌خواند، تغییر می‌دهد و دیباگ می‌کند.
  • GitHub Copilot: بیشتر به عنوان یک ابزار "تکمیل خودکار" (Autocompletion) پیشرفته در حین تایپ کردن کدهای دستی برای برنامه‌نویسان کلاسیک استفاده می‌شود، اما اخیرا ویژگی‌های Vibe Coding به آن اضافه شده است.
بخش پنجم

ورک‌فلو و هنر پرامپت‌نویسی

۵.۱ متدولوژی ساخت: T.D.D

در Vibe Coding کلمه TDD به معنای Tiny Driven Development (توسعه مبتنی بر قدم‌های بسیار کوچک) است. هرگز نگویید "یک سایت فروشگاهی بساز". تسک‌ها را خرد کنید: اول هدر، بعد کارت محصول، بعد دیتابیس، بعد سبد خرید. بعد از هر مرحله تست کنید و یک `git commit` بگیرید.

۵.۲ هنر مهندسی پرامپت (Prompt Engineering)

یک پرامپت اصولی که AI را گیج نکند، باید شامل ۴ ستون اصلی باشد:

  • ۱. Context (بستر): "پروژه من یک داشبورد Next.js با Tailwind است و داده‌ها از Supabase می‌آیند."
  • ۲. Task (وظیفه): "یک فرم ثبت‌نام بساز که نام، ایمیل و رمز عبور بگیرد."
  • ۳. Constraint (محدودیت): "از هیچ کتابخانه خارجی برای فرم‌ها استفاده نکن. حتماً ارورهای فرمت ایمیل را هندل کن."
  • ۴. Format (خروجی): "کد را به صورت یک کامپوننت ماژولار و جداگانه در فایل Register.tsx به من تحویل بده."
۵.۳ تزریق داکیومنت (Doc Injection)

هوش مصنوعی دیتای روز دنیا را ندارد. اگر از یک لایبرری استفاده می‌کنید که ماه پیش آپدیت شده، AI کد قدیمی و خراب تولید می‌کند. راه‌حل این است که در ابزاری مثل Cursor، با زدن @Docs لینک داکیومنت رسمی آن ابزار را وارد کنید تا AI آخرین قوانین آن را مستقیماً بخواند و سپس کد بزند.

۵.۴ مدیریت کانتکست (Context Window)

هر چت با هوش مصنوعی یک گنجایش حافظه (Context Window) دارد. اگر در یک چت ۱۰۰ پرامپت بدهید، AI توهم می‌زند، فایل‌های نامربوط را حذف می‌کند یا کدهای قدیمی را برمی‌گرداند. وقتی احساس کردید AI خنگ شده است، کار را متوقف کنید، یک خلاصه از آخرین وضعیت پروژه از او بخواهید، یک Chat جدید باز کنید و با اطلاعات تازه کار را ادامه دهید.

۵.۵ خروج از حلقه باطل (Death Loop)
🚨
وقتی AI در جا می‌زند چه کنیم؟
شما ارور را می‌دهید، AI کدی می‌دهد که کار نمی‌کند، دوباره ارور را می‌دهید و AI به کد اولش برمی‌گردد! این یعنی Death Loop.

راه‌حل خروج: ۱. چت را ببندید. ۲. در صورت نیاز با Git به وضعیت ۳۰ دقیقه پیش برگردید. ۳. در یک چت جدید، به جای پیست کردن ارور، به AI بگویید: "در فایل X به خطای Y می‌خوریم. فقط با استفاده از console.log لاجیک‌هایی بنویس تا بفهمیم داده در کدام خط گم می‌شود. کدی را تغییر نده."
۵.۶ بدهی فنی و بازنویسی (Refactoring)

هوش مصنوعی سریع کد می‌نویسد اما کدهایش کثیف است (Spaghetti Code). قانون مهم این است: بعد از پایان هر روز کاری یا اضافه کردن ۳ ویژگی بزرگ، به دستیار خود پرامپت دهید: "کدهای فایل X خیلی طولانی شده. بدون تغییر در عملکرد، آن را بررسی، تمیز، کامنت‌گذاری و به کامپوننت‌های کوچکتر تقسیم (Refactor) کن."

۵.۷ پروژه‌های عملیاتی (مرحله به مرحله)

📊 پروژه نمونه: فایل منیجر لوکال (بدون نیاز به بک‌اند)

یک اپلیکیشن کامل که در مرورگر کاربر ذخیره می‌شود. مراحل پرامپت‌نویسی متوالی به این شکل است:

💬 مرحله اول (UI پایه)
یک صفحه اپلیکیشن با React و Tailwind بساز که افکت Glassmorphism تیره داشته باشد. در مرکز صفحه یک بخش Drag & Drop بزرگ برای دریافت فایل‌ها قرار بده و پایین آن لیست فایل‌های آپلود شده را با آیکون‌های متناسب با نوع فایل نشان بده.
💬 مرحله دوم (اتصال منطق)
حالا لاجیک این برنامه را بنویس. به جای ارسال فایل‌ها به بک‌اند، از کتابخانه localforage (بر پایه IndexedDB مرورگر) استفاده کن تا وقتی کاربر فایلی رها کرد، مستقیما در حافظه مرورگر ذخیره شود و با رفرش صفحه پاک نشود. دکمه حذف هم برای هر فایل بگذار.
💬 مرحله سوم (قابلیت پیشرفته)
یک داشبورد کوچک در بالای صفحه اضافه کن که با استفاده از کتابخانه Recharts، یک نمودار دایره‌ای (Pie Chart) نشان دهد که چه نوع فرمت‌هایی (عکس، ویدیو، متن) چه درصدی از حجم ذخیره‌شده را اشغال کرده‌اند.
بخش ششم

پنج سطح تکامل و نردبان مهارت‌ها

۶.۱ مسیر منطقی رشد پروژه‌ها

بزرگترین اشتباه این است که در روز اول بخواهید "اسنپ" بسازید. مسیر صحیح این ۵ سطح است:

Level 1: اسباب‌بازی (Toy)

اپ‌های تک‌صفحه‌ای بدون دیتابیس (داده با رفرش پاک می‌شود).
مثال: ماشین‌حساب، بازی مار.
هدف: تمرینِ ساختن رابط کاربری (UI) با پرامپت.

Level 2: ابزار شخصی (Personal)

داده‌ها به صورت لوکال یا در یک دیتابیس ساده ذخیره می‌شود، اما فقط یک کاربر دارد (خودتان).
مثال: دفترچه خاطرات، ابزار ثبت هزینه‌ها.
هدف: درک مفاهیم دیتابیس و State.

Level 3: اپ مشترک (Shared)

ورود سیستم لاگین (Authentication). کاربران متعددی وارد می‌شوند.
مثال: یک تسک‌منیجر تیمی.
هدف: یادگیری سیستم‌های احراز هویت و امنیت داده (RLS) تا کسی اطلاعات دیگری را نبیند.

Level 4: محصول پولی (SaaS)

ادغام درگاه پرداخت اینترنتی، سیستم ایمیل خودکار و سطوح دسترسی (رایگان/پریمیوم).
مثال: تولیدکننده رزومه با هوش مصنوعی.
هدف: مدیریت Webhookها و یکپارچگی ابزارهای خارجی.

Level 5: سیستم Production (تجاری واقعی)

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

۶.۲ نردبان واقعی مهارت شما
سطحوقتی به این سطح رسیده‌ای که…
L1سه پروژه ساده و تک‌فایلی ساخته‌ای و با محیط‌های ابری آشنا شده‌ای.
L2یک اپلیکیشن شخصی با دیتابیس روی موبایل خودت کار می‌کند و از آن استفاده می‌کنی.
L3یک دوست غریبه اکانت ساخته و از اپلیکیشن تو بدون باگ و مسدود شدن استفاده کرده است.
L4یک غریبه بابت نرم‌افزاری که خلق کرده‌ای، پول پرداخت کرده است (اولین دلار/تومان).
L5یک قطعی ناگهانی سرور (Incident) را مدیریت کرده‌ای و مشکل را بدون از دست رفتن دیتای کاربران حل کرده‌ای.
بخش هفتم

استقرار (Deployment)، دیباگ و نقشه راه

۷.۱ استقرار پروژه‌ها و اتصال دامنه (Testing, Deploying & Shipping)

تا زمانی که کد شما روی کامپیوتر خودتان (localhost) اجرا می‌شود، برای دنیا وجود ندارد. فرآیند آنلاین کردن اپلیکیشن را Deployment می‌گویند.

  • هاستینگ‌های مدرن (Vercel / Netlify): بهترین گزینه برای پروژه‌های Next.js و React. مستقیماً به اکانت GitHub شما متصل می‌شوند و هر بار که کدی را کامیت می‌کنید، سایت شما در چند ثانیه به صورت خودکار و رایگان روی سرور آپدیت می‌شود (به این جادو CI/CD می‌گویند).
  • هاست‌های اشتراکی لینوکسی (cPanel): اگر اصرار دارید از هاست‌های سنتی داخلی استفاده کنید، چالش‌های زیادی دارید. باید از هوش مصنوعی بخواهید اسکریپت بیلد (Build) متناسب با هاست اشتراکی را تولید کند، فایل کانفیگ روتینگ (.htaccess) را بنویسد، و سپس فایل‌های نهایی را زیپ کرده و در File Manager سرور آپلود کنید. پرامپت شما باید بسیار دقیق باشد.
  • اتصال دامنه: در نهایت برای خروج از آدرس‌های تستی (مثل myapp.vercel.app)، یک دامنه می‌خرید و از طریق تنظیم DNS (تغییر Name Serverها یا رکوردهای A/CNAME) آن را به سرور خود متصل می‌کنید.
۷.۲ دیباگ حرفه‌ای (هنر خواندن Stack Trace)

وقتی پروژه شما بالا می‌آید، ارورها شروع می‌شوند. وقتی در ترمینال با یک صفحه کامل از ارورهای قرمز مواجه می‌شوید، وحشت نکنید! نیازی نیست ۱۰۰ خط ارور را بخوانید. ساختار Stack Trace مشخص است:

Terminal - Error Example
TypeError: Cannot read properties of undefined (reading 'map')
    at renderList (node_modules/some-library/index.js:45:12)
    at UserProfile (/src/components/UserProfile.tsx:28:15)
    at App (/src/App.tsx:10:5)

چطور بخوانیم؟ خط اول دقیقاً می‌گوید مشکل چیست (مشکل در خواندن ویژگی یک متغیر خالی). خطوط بعدی می‌گویند خطا از کجا نشات گرفته. خطی که نام فایل‌های پروژه خودتان در آن است (در اینجا UserProfile.tsx خط ۲۸) را پیدا کنید و همان قسمت را همراه با خط اول ارور به AI بدهید تا در ثانیه مشکل را حل کند.

👁️
نظارت در Production (سیستم Sentry)
وقتی کاربران واقعی در حال استفاده از سایت هستند و به ارور برمی‌خورند، به شما زنگ نمی‌زنند تا بگویند چه شد! با پرامپت دادن به AI برای نصب پکیج Sentry، هر زمان که کاربری خطایی دریافت کند، کد ارور، نوع مرورگر و خط کد خراب مستقیماً به پنل یا تلگرام شما ارسال می‌شود.
۷.۳ هزینه‌های راه‌اندازی (واقعیت مالی)

باور عمومی این است که Vibe Coding رایگان است، اما ابزارهای ابری محدودیت دارند. بودجه معقول ماه اول برای یک سازنده جدی حدود ۲۰ تا ۶۰ دلار است. این هزینه صرف خرید اشتراک پرو ابزارهایی مثل Claude، Cursor یا Lovable می‌شود. خوشبختانه زیرساخت‌ها (هاستینگ Vercel و دیتابیس Supabase) برای شروع کاملاً رایگان هستند.

۷.۴ اشتباهات مرگبار رایج (Common Mistakes)
۱
ایجاد API Key در سمت کلاینت

اگر کلید هوش مصنوعی را در فایل‌های فرانت‌اند بگذارید، هر کسی می‌تواند با F12 آن را بردارد و با اکانت شما هزاران دلار هزینه ایجاد کند.

۲
فراموشی امنیت داده‌ها (RLS)

در دیتابیس‌های مدرن مثل Supabase، اگر قوانینی به نام RLS (Row Level Security) را ننویسید، با اینکه سیستم لاگین دارید، هر کاربری می‌تواند دیتای حساب کاربران دیگر را ببیند یا پاک کند!

۳
تسک‌های هیولایی (Monster Prompts)

پرامپت‌هایی که ۵ صفحه توضیح دارند و از AI می‌خواهند کل سایت را یک‌جا با دیتابیس و پرداخت بنویسد، همیشه با شکست مواجه می‌شوند و کدی غیرقابل دیباگ تولید می‌کنند.

۷.۵ برنامه عملیاتی ۳۰ روزه شما
روز ۱ تا ۷ (فاز اکتشاف)
  • ثبت‌نام در GitHub.
  • ساخت ۳ بازی ساده یا ماشین‌حساب در Lovable یا Bolt.
  • تست مفاهیم پایه‌ای پرامپت‌نویسی.
روز ۸ تا ۱۴ (ورود به بک‌اند)
  • یادگیری ایجاد پروژه در Supabase.
  • ساخت یک اپ Personal (مثل Todo لیست) با قابلیت ذخیره دائم اطلاعات روی دیتابیس ابری.
روز ۱۵ تا ۲۱ (مهاجرت به لوکال)
  • نصب Node.js، Git و محیط Cursor.
  • انتقال پروژه ابری به کامپیوتر شخصی و اجرای آن به صورت لوکال با استفاده از ترمینال.
روز ۲۲ تا ۳۰ (انتشار محصول)
  • اضافه کردن احراز هویت (ورود کاربر).
  • دیپلوی کردن پروژه نهایی روی Vercel.
  • خرید دامنه و معرفی به دنیا.