منبع‌بستهمنتشر شده2026

کاژه

کاژه هتل بوتیکی در رشت هست. من وب‌سایتش رو، به‌همراه سیستم رزرو آنلاین، از طراحی تا اجرا ساختم.

کارفرما
هتل بوتیک
نقش
توسعه‌دهنده فول‌استک
مدت
۶۵ روز
زبان‌ها
انگلیسی، فارسی
  • Next.js
  • React
  • PostgreSQL
  • i18n
تصویری از اولین بخش صفحه اصلی سایت
اولین بخش صفحه اصلی.

سفارش

با توجه به شرایط نامطمئن کشور، کارفرما می‌خواست بدون وابستگی به سرویس‌های خارجی هم در اینترنت دیده‌شه، و سایتش همیشه در دسترس باشه. رزرو آنلاین هم می‌خواستند تا بیشترِ کارهایی که تا اون زمان با اکسل، تماس تلفنی و واتساپ انجام می‌شد، به صورت مدرن توسط سایت انجام بشه.

تصمیم گرفتم همه‌چیز رو از صفر با Next.js بسازم؛ هم برای کسب تجربه، و هم برای اینکه هر بخش منحصربه‌فرد و دقیقاً مناسب با نیاز کاژه باشه.

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

روند کار

پروژه در ابتدا حدود ۴۵ روز قرار بود طول بکشه. کارهای اداری، عکاسی، فیلمبرداری و چند اتفاق دیگر در حین ساخت، باعث شد ۶۵ روز زمان ببره.

  1. هفته اول

    برنامه‌ریزی و اولین طرح‌ها

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

    اولین نسخه صفحه اصل.
    اولین نسخه صفحه اصلی.
  2. هفته دوم تا سوم

    صفحه اتاق‌ها

    تو این زمان صفحه اصلی آماده شد و طراحیش توسط کارفرما تأیید شد. بعد من سراغ صفحه اتاق‌ها رفتم. تصمیم گرفتیم از فلورپلن هتل در این صفحه استفاده کنیم.

    اولین نسخه صفحه اتاق‌ها سایت کاژه.
    اولین نسخه صفحه اتاق‌‌ها و صفحه هر اتاق.
  3. هفته سوم تا چهارم

    صفحات هر اتاق

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

  4. هفته چهارم تا ششم

    زیرساخت پشت صحنه

    دیتابیس PostgreSQL رو راه‌اندازی کردم و بَک‌‌اند یعنی جایی که رزروها و قیمت‌ها ذخیره و پردازش می‌شند، رو توسعه دادم. رو صفحات سمت مهمان‌ها تغییراتی انجام شد و کار روی پنل مدیریت شروع شد.

  5. هفته ششم تا هشتم

    پنل مدیریت و جای‌گزاری محتوا‌ها

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

  6. از هفته هشتم تا انتشار

    انتشار و تحویل

    هفته‌های آخر صرف تست، تمیز کردن کد، نهایی کردن طراحی، آماده‌کردن محتوا و تست دوباره شد. همه‌چیز به‌جز پرداخت آنلاین اجرا شد؛ برای پرداخت انلاین منتظر مدارک کارفرما هستیم.

چه انتخاباتی کردم و چرا

در طول کار تصمیمات زیادی باید می‌گرفتم. دلایل چندتاش رو اینجا نوشتم.

  • فریم‌ورک

    انتخاب‌شدهNext.js

    Next.js اجازه می‌داد همه بخش‌های سایت رو سریع و در یک چارچوب واحد بسازم و از امکانات مدرنش مثل Server Actions استفاده کنم. برنامه‌نویس های زیادی هم باهاش آشنا هستن، پس لازم نبود کارفرما به یک نفر خاص وابسته بمونه برای سایت.

    گزینه‌های دیگر: ASP.NET Core

  • دِیتابِیس

    انتخاب‌شدهPostgreSQL

    PostgreSQL انتخاب مناسبی بود.این امکان رو می‌داد تا جلوی رزرو یک اتاق در یک تاریخ توسط چند نفر رو حتی در سطح دیتابیس هم بگیره، هنگام ثبت هر رزرو اون اتاق قفل می‌شه تا دو درخواست هم‌زمان با هم تداخل نکنن. هاست ما هم از اون پشتیبانی می‌کرد.

    گزینه‌های دیگر: SQLite

  • هاست

    انتخاب‌شدهلیارا

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

    گزینه‌های دیگر: Vercel، هاست ایران

مشکلات و مسائل در طول کار

در طول کار مسائل و مشکلات زیادی پیش اومد. مهم‌ترین‌ها رو ادامه میخونید.

سیستم وضعیت رزرو

مشکل

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

چطور حلش کردم

عکس زیر نشون می‌ده این سیستم چطور کار می‌کنه.

نمودار سیستم وضعیت رزرو
نمایش تصویری از سیستم وضعیت رزرو.

داده‌های متغیر، سرعت کمتر بارگزاری صفحات

مشکل

وقتی تقویم‌ها رو به رزرو اتاق‌ها وصل کردم، Next.js صفحه‌ها رو «داینامیک» حساب کرد و سرعت بارگزاری صفحات به‌صورت محسوسی کند شد.

چطور حلش کردم

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

جابه‌جایی کارمند‌ها از اکسل به سایت

مشکل

کارمند‌ها رزروها رو با اکسل مدیریت می‌کردن. باید روش کارشون رو به سایت منتقل می‌کردم، طوری که آشنا براشون باشه اما ساده‌تر و مناسب سیستم جدید.

چطور حلش کردم

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

تغییر دوباره عکس‌ها و ویدیوها

مشکل

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

چطور حلش کردم

به‌جای یک سرویس ذخیره‌سازی ابری جدا، از دیسکی که با پلن‌های لیارا همراه‌ هست استفاده کردم تا در هزینه نگهداری سایت صرفه‌جویی شه. کارمند‌ها تصاویر و ویدیو‌ها رو از پنل مدیریت بارگذاری و جایگزین می‌کنن، و دِیتابِیس دخیره میکنه که کدوم فایل برای کدوم جا هست.

انتشار بدون درگاه پرداخت

مشکل

پرداخت آنلاین به درگاه پرداخت اینترنتی نیاز داره و گرفتن اون نیاز به اینماد داره. چون کافرما کارش رو تازه تاسیس کرده بود، هنوز مدارک لازم صادر تشده و انتظار می‌ره این کار حدود تابستان ۱۴۰۶ انجام بشه.

چطور حلش کردم

پرداخت وقتی درگاه اماده شد به روند رزرو اضافه میشه. فعلا مهمون‌ها سایت رو مشاهده میکنن، موجودی اتاق ها رو از سایت میبینن‌، با پذیرش تماس می‌گیرن و رزرو میکنن. پذیرش، رزرو رو در پنل مدیریت ثبت می‌کنه و تقویم اتاق‌ها همون لحظه به‌روز می‌شه.

قسمت‌های که ارزش دیدن دارن

توضیحاتی راجب به قسمت هایی از سایت که وقت زیادی گرفتن.

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

پنل مدیریت

پنل مدیریت ستون پنهان سایت هست. علاوه بر مدیریت رزروها و تصویر‌ها، کارمند‌ها با اون قیمت‌ها رو تنظیم می‌کنن، تخفیف‌ها رو مدیریت می‌کنن و می‌تونن آمار و نمودار عملکرد هتل رو هم ببینن.

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

تقویم مدیریت

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

  • تقویم خورشیدی با اسکرول بی‌نهایت
  • رنگ‌بندی وضعیت رزروها
  • مدیریت جمعی رزرو‌ها
تصویری از بخش موقعیت
نقشه رشت در بخش موقعیت.
دیزاین

نقشه رشت

نقشه نشون دادن مکان هتل

  • نقشه خیابان‌های رشت، بر اساس OpenStreetMap
  • هزاران مسیر بهینه‌سازی شده که روان می‌چرخن
  • همراه با نقاط دیدنی برای گردشگرها، هر کدوم همراه با توضیحات

تجرباتی که کسب کردم

این اولین کار فریلنس من بود. چیزهای زیادی یاد گرفتم..

  • برنامه‌ریزی پروژه

    در پروژه های بعدی با جزئیات بیشتری برنامه‌ریزی می‌کنم. مثلاً صفحه گالری برنامه‌ریزی‌نشده بود. تعریف دقیق‌تر کار از همون ابتدا به من اجازه می‌داد زمان‌بندی دقیق‌تری ارائه کنم.

  • نرم‌افزار، برای یک کسب‌وکار

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

  • فرق رندر صفحه روی سرور (SSR) و روی دستگاه کاربر (CSR)

    بعد از حل مشکل داده‌های داینامیک، چند روش رو بررسی و آزمایش کردم و حالا راجب این موضوع اطلاعات و تجربه خوبی دارم.

  • کار حرفه‌ای با دِیتابِیس

    این اولین تحربه جدی من با دیتابیس بود، باعث شد SQL و PostgreSQL رو بیشتر یاد بگیرم. حالا آشنایی خوبی با اینها دارم، اما هنوز مشتاق یادگرفتن بیشترم.

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