🛠 مشکل واقعی یک برنامه‌نویس | Case Study #3

این کد Python رو ببین:

numbers = [1, 2, 3, 4]

for i in range(5):
print(numbers[i])

به نظرت چه اتفاقی میفته؟ 🤔

کد شروع به اجرا میکنه:

1
2
3
4

اما بعد...

💥 Error!

چرا؟

امروز میخوایم این خطا رو مثل یک Debugger بررسی کنیم. 👇

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🔍 بیایم قدم‌به‌قدم بررسی کنیم.
لیست ما فقط ۴ عضو داره:

numbers = [1, 2, 3, 4]

اندیس‌هاش:

0️⃣ → 1
1️⃣ → 2
2️⃣ → 3
3️⃣ → 4

اما:

range(5)

این اعداد رو تولید میکنه:

0, 1, 2, 3, 4

وقتی i به 4 میرسه، Python دنبال این میگرده:

numbers[4]

اما چنین عضوی وجود نداره!

💥 IndexError

یک راه‌حل:

for i in range(len(numbers)):
print(numbers[i])

یا ساده‌تر:

for number in numbers:
print(number)

📌 قبل از اینکه Error رو حفظ کنی، یاد بگیر علتشو پیدا کنی.

ارور، دشمن برنامه‌نویس نیست؛ یک سرنخه. 🕵️‍♀️

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🎯 حالا نوبت توئه!
اگر این خطا رو ببینی:

IndexError: list index out of range

اولین چیزی که بررسی میکنی چیه؟

1️⃣ تعداد اعضای لیست و Index مورد استفاده
2️⃣ نسخه Python
3️⃣ اتصال اینترنت
4️⃣ کل کد رو پاک میکنم و دوباره مینویسم 😅

👇 شماره گزینه رو بنویس.

💻 اگر تو هم روی پروژه‌ات با Error یا Bug درگیری، میتونی اطلاعات مشکلت رو برای ProgrammerCity بفرستی تا بررسی کنیم.

فقط این‌ها رو ارسال کن:

🔹 زبان یا تکنولوژی مورد استفاده
🔹 توضیح مشکل
🔹 متن کامل Error
🔹 بخش مرتبط کد

📩 گاهی فقط یک جزئیات کوچیک، علت مشکلیه که ساعت‌ها درگیرشی.

فردا میتونیم بریم سراغ یک موضوع جذاب‌تر:

🔐 یک اشتباه رایج در پروژه‌های واقعی که میتونه باعث مشکل امنیتی بشه!

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🛠 مشکل واقعی یک برنامه‌نویس | Case Study #4
🔐 «فقط برای تست»؛ یکی از خطرناک‌ترین جمله‌ها در برنامه‌نویسی!


فرض کن داری یک پروژه میسازی که به یک API وصل میشه.

برای تست، این اطلاعات رو داخل کدت میذاری:

API_KEY = "my-secret-key"

همه‌چیز درست کار میکنه. ✅

پروژه رو روی Git هم Push میکنی.

چند روز بعد متوجه میشی:

😐 «صبر کن... API Key هنوز داخل Git هست!»

و اینجاست که یک اشتباه خیلی ساده میتونه تبدیل به یک مشکل امنیتی واقعی بشه. 🚨

امروز ببینیم چرا نباید اطلاعات حساس رو مستقیم داخل کد قرار بدیم.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🔐 اطلاعات حساس مثل:

🔑 API Key
🔑 Password
🔑 Database Credentials
🔑 Access Token

نباید به شکل مستقیم داخل Source Code قرار بگیرن.

❌ بد:

API_KEY = "my-secret-key"

چرا؟

چون ممکنه:

📌 کد وارد Git بشه.

📌 Repository اشتباهی Public بشه.

📌 فرد دیگری به پروژه دسترسی پیدا کنه.

📌 حتی بعد از حذف کردن، اطلاعات حساس در History باقی بمونه.

راه بهتر استفاده از روش‌هایی مثل:

✅ Environment Variables
✅ Secret Management
✅ فایل‌های تنظیمات خارج از Repository

هست.

📌 یک قانون ساده:

اگر چیزی Secret است، نباید بخشی از Source Code معمولی باشه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🎯 یک سؤال مهم:

اگر متوجه بشی Password دیتابیس به اشتباه داخل GitHub قرار گرفته، اولین کار درست چیه؟

1️⃣ فقط Password رو از فایل پاک میکنم.
2️⃣ Repository رو Delete میکنم.
3️⃣ Credential رو تغییر/منقضی میکنم و بعد مشکل را بررسی میکنم.
4️⃣ کاری نمیکنم چون Repository خصوصی بوده.

👇 شماره گزینه رو بنویس.

📌 فردا میریم سراغ یک موضوع خیلی واقعی‌تر در کار تیمی:

🐞 کدی که کار میکنه، ولی هنوز خوب نیست!

میبینیم Code Review چطور میتونه چنین مشکلاتی رو پیدا کنه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🛠 مشکل واقعی یک برنامه‌نویس | Case Study #5
🐞 کد کار میکنه؛ پس چرا باید تغییرش بدیم؟

فرض کن این کدو نوشتی:

def calculate_total(price, quantity):
return price * quantity

تستش میکنی.

✅ جواب درسته.

پس Task رو انجام دادی.

پس میگی:

«تموم شد!»

اما وقتی Pull Request میسازی، هم‌تیمیت یک Comment میذاره:

💬 «Can we improve this?»

😐

«ولی کد که درست کار میکنه!»

دقیقاً اینجاست که Code Review اهمیت پیدا میکنه.

چون:

درست کار کردن ≠ بهترین راه‌حل ممکن

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

👀 در Code Review فقط دنبال Bug نمیگردیم.

ممکنه بررسی کنیم:

🔹 کد خواناست؟
🔹 اسم متغیرها واضح هست؟
🔹 منطق بیش از حد پیچیده نیست؟
🔹 کد تکراری وجود داره؟
🔹 خطاهای احتمالی مدیریت شدن؟
🔹 تست مناسب وجود داره؟

مثلاً این:

x = p * q

کار میکنه. ✅

ولی این:

total_price = product_price * quantity

برای کسی که فردا کدو میخونه، خیلی واضح‌تره.

📌 کدی که امروز مینویسی، فقط برای کامپیوتر نیست.

یک انسان دیگه هم باید بتونه اونو بفهمه.

و Code Review دقیقاً برای همین مهمه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🎯 چالش ProgrammerCity

کدوم یکی خواناتر و قابل‌فهم‌تره؟

1️⃣x = p * q

2️⃣total_price = product_price * quantity

3⃣فرقی نمیکنه؛ هر دو یک نتیجه میدن.

👇 شماره گزینه رو بنویس و اگر دوست داشتی بگو چرا.

💡 یک نکته مهم:

گاهی Code Review باعث میشه چیزی رو اصلاح کنیم که اصلاً Bug نیست؛ فقط باعث میشه کد خواناتر، قابل نگهداری‌تر و بهتر بشه.

📅 در قسمت بعدی میریم سراغ یک سؤال مهم:

اگر Code Review گرفتیم و با نظر Reviewer موافق نبودیم، چطور حرفه‌ای برخورد کنیم؟

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🛠 مشکل واقعی یک برنامه‌نویس | Case Study #6
💬 اگر با نظر Reviewer موافق نباشیم چی؟

میری Pull Request رو باز میکنی.

یکی از هم‌تیمی‌ها نوشته:

💬 «I think we should change this approach.»

اما تو مطمئنی روشی که استفاده کردی درسته.

😐 حالا چی؟

بگی:

«نه، روش من بهتره.»

یا بدون فکر نظرشو قبول کنی؟

هیچ‌کدوم!

چون یکی از مهارت‌های مهم کار تیمی اینه که بتونی درباره کدت گفت‌وگو کنی، نه اینکه ازش دفاع احساسی کنی.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

💡 وقتی با یک نظر در Code Review موافق نیستی، اول سعی کن بفهمی دلیل پیشنهاد چیه.

مثلاً به جای:

❌ «ولی این کد درست کار میکنه.»

بگو:

✅ «میشه بگی چه مشکلی ممکنه با این روش داشته باشیم؟»

یا:

✅ «من این روش رو به خاطر X انتخاب کردم؛ به نظرت روش پیشنهادی چه مزیتی داره؟»

حالا ممکنه یکی از این اتفاق‌ها بیفته:

🔹 متوجه میشی Reviewer نکته‌ای دیده که تو ندیدی.

🔹 متوجه میشی دو راه‌حل مختلف وجود داره.

🔹 یا حتی ممکنه بعد از توضیح، مشخص بشه پیشنهاد اولیه مناسب این شرایط نیست.

📌 پس Code Review مسابقه «چه کسی درست میگه؟» نیست.

هدفش اینه که بهترین تصمیم برای پروژه گرفته بشه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🎯 یک موقعیت واقعی:

یه Reviewer روی کدت Comment گذاشته و پیشنهاد داده یک بخشو تغییر بدی.

تو فکر میکنی روش فعلی بهتره.

چه کار میکنی؟

1️⃣ میگم «کد من مشکلی نداره.» 😐
2️⃣ بدون بررسی پیشنهادش رو انجام میدم.
3️⃣ دلیل انتخابمو توضیح میدم و نظرشو درباره راه‌حل‌ها میپرسم.
4️⃣ یا Comment رو نادیده میگیرم.

👇 شماره گزینه رو بنویس.

📅 فردا میخوایم یک قدم جدی‌تر برداریم:

🔎 یک قطعه کد واقعی رو با هم Code Review میکنیم و ببینیم چه ایرادهایی میشه از داخلش پیدا کرد.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🛠 مشکل واقعی یک برنامه‌نویس | Case Study #7
🔎 بیایم یک کد واقعی رو Code Review کنیم!

🔎 Code Review Challenge

فرض کن یکی از اعضای تیم این کد Python رو برای Pull Request فرستاده:

def get_user(users, id):
    for user in users:
        if user["id"] == id:
            return user
    return None


def show_user(users, id):
    user = get_user(users, id)
    print(user["name"])

کد اجرا میشه. ✅

اما آیا واقعاً مشکلی نداره؟

🤔 اگر Reviewer این کد باشی، چه چیزی توجهتو جلب میکنه؟

فعلاً جوابو نمیگیم.

خودت نگاهش کن و حداقل یک مشکل احتمالی پیدا کن. 👇

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🔎 جواب Code Review Challenge

یک مشکل مهم اینجاست:

اگر کاربر پیدا نشه، تابع get_user مقدار:

None

برمی‌گردونه.

اما در show_user بدون بررسی، این کارو انجام دادیم:

user["name"]

🚨 پس اگر کاربر وجود نداشته باشه، برنامه با خطا مواجه میشه.

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

مثلاً:

if user is not None:
    print(user["name"])
else:
    print("User not found")

📌 نکته:

یک Code Review خوب فقط دنبال Syntax Error نیست.

گاهی کد کاملاً اجرا میشه، اما در یک Edge Case رفتار درستی نداره.

و دقیقاً همین‌جاست که Review ارزش پیدا میکنه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

💻 حالا یک سؤال جدی‌تر:

اگر قرار باشه کدی که نوشتی قبل از تحویل پروژه توسط یک نفر دیگه بررسی بشه، دوست داری چه چیزهایی بررسی بشه؟

🔹 پیدا کردن Bug
🔹 خوانایی کد
🔹 ساختار و منطق
🔹 مشکلات احتمالی در شرایط خاص
🔹 بهینه‌سازی
🔹 امنیت
🔹 همه موارد

👇 شماره یا مورد موردنظرتو بنویس.

---

و اگر خودت الان یک پروژه داری که:

🐞 خطا داره
🔎 نمیدونی مشکل از کجاست
🧩 کدت درست اجرا میشه ولی مطمئن نیستی اصولی نوشته شده
📤 یا قبل از تحویل میخوای یک نفر کدتو بررسی کنه

میتونی برای بررسی و Code Review پروژه با ProgrammerCity در ارتباط باشی.

📩 برای شروع فقط توضیح کوتاهی از پروژه و مشکلت بفرست.

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

اینجا ProgrammerCity؛ از یادگیری تا حل مسئله واقعی. 💻🚀

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

💼 از دانشگاه تا شرکت | قسمت ۲۳

🆘 وقتی گیر کردی، چطور درست کمک بخوای؟

🎬 داستان امروز...

بالاخره تصمیم گرفتی از یکی از اعضای تیم کمک بگیری.

پیام میدی:

«سلام، این کدم کار نمیکنه، میشه کمکم کنی؟»

هم‌تیمی:
«مشکل چیه؟»

تو:
«نمیدونم، ارور میده! 😂»

و حالا باید ۲۰ دقیقه فقط توضیح بدی که دقیقاً چه اتفاقی افتاده.

مشکل از کمک گرفتن نیست؛
مشکل اینه که مسئله رو درست مطرح نکردی.

یک سؤال خوب میتونه خیلی سریع‌تر از یک سؤال مبهم به جواب برسه.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🧠 وقتی میخوای از یک برنامه‌نویس باتجربه کمک بگیری، این ۵ مورد رو آماده داشته باش:

1️⃣ دقیقاً چه مشکلی داری؟
2️⃣ انتظار داشتی چه اتفاقی بیفته؟
3️⃣ الان چه اتفاقی میفته؟
4️⃣ چه چیزهایی رو تا الان امتحان کردی؟

5️⃣بررسی کن Error یا کد مرتبط رو داری؟

مثلاً به جای:

❌ «Login کار نمی‌کنه.»
بگو:

✅ «در صفحه Login، وقتی Username و Password صحیح وارد میکنم، درخواست ارسال میشه ولی پاسخ 401 دریافت میکنم. طبق مستندات انتظار داشتم 200 دریافت کنم. Header مربوط به Authorization رو هم بررسی کردم.»

این دو سؤال، زمین تا آسمون فرق دارن.

📌 هرچه مسئله رو دقیق‌تر توضیح بدی، احتمال اینکه سریع‌تر به راه‌حل برسی بیشتره.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

🎯 چالش امشب ProgrammerCity

فرض کن این پیام رو از یک دوست برنامه‌نویس دریافت کردی:

❌ «داداش پروژه‌م اجرا نمیشه، یه نگاهی بنداز.»

اگر بخوای قبل از شروع بررسی ازش اطلاعات بگیری، ۳ سؤال اولت چی هست؟

سؤال‌هات رو بنویس. 👇

مثلاً:
🔹 دقیقاً چه خطایی دریافت میکنی؟

اما دو سؤال بعدی رو خودت پیدا کن. 😉

📅 فردا میریم سراغ یک موضوع مهم‌تر:

🔍 وقتی یک متخصص مشکل پروژه‌ات رو بررسی میکنه، چه کاری انجام میده و چرا فقط «جواب دادن» نیست؟

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━

💼 از دانشگاه تا شرکت | قسمت ۲۴

🔍 تا حالا به این فکر کردی وقتی کدتو برای یک برنامه‌نویس باتجربه میفرستی، اون دقیقاً از کجا شروع میکنه؟

قرار نیست کدو باز کنه و با یک نگاه بگه:

«مشکل اینجاست!» 😎

معمولاً باید مرحله‌به‌مرحله جلو بره:

🔹 مسئله رو بفهمه
🔹 شرایطی که Bug اتفاق میفته رو بررسی کنه
🔹 مشکلو دوباره ایجاد کنه
🔹 مسیر اجرای برنامه رو بررسی کنه
🔹 علت اصلیو پیدا کنه
🔹 راه‌حل مناسبو بررسی کنه
🔹 و در نهایت تغییرو تست کنه

این یعنی Problem Solving واقعی.

━━━━━━━━━━━━━━━━━━
°⋆⸜ 𝙋𝙧𝙤𝙜𝙧𝙖𝙢𝙢𝙚𝙧'𝙨 𝘾𝙞𝙩𝙮 ⸝⋆°
➤ Code • Learn • Build
➤ @programercity
━━━━━━━━━━━━━━━━━━