المراجع العام

git commit -m "fix"
git commit -m "updates"
git commit -m "WIP"
git commit -m "asdfasdf"

رسائل الالتزام الغامضة تجعل السجل عديم الفائدة

git commit -m "fix(auth): handle expired token refresh"
git commit -m "feat(api): add pagination to users endpoint"
git commit -m "docs: update README with new env vars"
git commit -m "refactor(db): extract query builders"

اتبع الالتزامات التقليدية للحصول على سجل واضح

src/
  UserComponent.tsx
  userUtils.ts
  USER_CONSTANTS.ts
  user-types.ts
  userApi.tsx      # لماذا .tsx للـ API؟
  UserHelpers.ts

تسمية غير متسقة وهيكل مسطح

src/features/users/
  components/
    UserCard.tsx
    UserList.tsx
  hooks/
    useUser.ts
  api/
    users.api.ts
  types/
    user.types.ts
  constants/
    user.constants.ts

اتبع التنظيم القائم على الميزات مع تسمية متسقة

// متناثرة في قاعدة الكود
const API_URL = process.env.API_URL || 'http://localhost:3000'

// في ملف آخر
const apiBase = process.env.NEXT_PUBLIC_API_URL

// في ملف آخر أيضاً
if (process.env.NODE_ENV === 'production') {
  baseUrl = 'https://api.example.com'
}

متغيرات البيئة متناثرة والتعامل غير متسق

// src/config/env.ts
export const config = {
  api: {
    baseUrl: requiredEnv('API_URL'),
    timeout: optionalEnv('API_TIMEOUT', 5000),
  },
  features: {
    analytics: boolEnv('ENABLE_ANALYTICS', false),
  },
} as const

// الاستخدام في كل مكان
import { config } from '@/config/env'
fetch(config.api.baseUrl + '/users')

تكوين مركزي مع وصول آمن للأنواع