لاگ کاری لحظه‌ای توسعه‌دهنده

راهنمای حرفه‌ای لاگ کاری لحظه‌ای توسعه‌دهنده

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

هدف

ثبت دقیق و قابل استناد تمام فعالیت‌های توسعه شامل کدنویسی، دیباگ، تست، جلسات، تغییرات دیتابیس، کامیت‌ها و تصمیمات فنی.

نحوه استفاده

1. دکمه «شروع کار» → تاریخ و زمان شروع به صورت خودکار ثبت می‌شود.
2. در طول کار، توضیحات، وابستگی‌ها، تست‌ها و سایر اطلاعات را تکمیل کنید.
3. دکمه «پایان کار» → زمان پایان و مدت کار به صورت خودکار محاسبه می‌شود.
4. قبل از تولید JSON، کامیت‌ها، تغییرات دیتابیس، تست‌ها و یادداشت‌های فنی را وارد کنید.

توضیح فیلدها

• تاریخ: به صورت خودکار پر می‌شود.
• زمان شروع: هنگام شروع کار ثبت می‌شود، قابل ویرایش.
• زمان پایان: هنگام پایان کار ثبت می‌شود، قابل ویرایش.
• مدت زمان: به صورت خودکار محاسبه می‌شود.
• تسک / فعالیت: عنوان کوتاه و توصیفی فعالیت.
• توضیحات: شرح فنی و دقیق کار انجام شده.
• وضعیت Code Review: Pending / Approved / Changes Requested.
• تست‌ها: یونیت، اینتگریشن، API، تست دستی — همه را ذکر کنید.
• وابستگی‌ها: سرویس‌ها، APIها یا تیم‌های مرتبط.
• تغییرات دیتابیس: جدول جدید، اصلاح ستون، Migrationها.
• کامیت‌ها: پیام‌های کامیت و نام برنچ.
• نتایج جلسات: تصمیمات، رفع موانع، تاییدیه‌ها.
• تگ‌ها: Feature، Bugfix، Hotfix، Refactor، DB، API و غیره.
• چالش‌ها: مشکلات و راه‌حل‌ها.

نکات مهم

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

📌 قالب JSON

{
  "Date": "yyyy-mm-dd",
  "StartTime": "HH:MM",
  "EndTime": "HH:MM",
  "DurationHours": 0.0,
  "TaskName": "",
  "Description": "",
  "CodeReviewStatus": "Pending | Approved | ChangesRequested",
  "Dependencies": ["Service X", "API Y"],
  "DecisionNotes": ["Meeting result A"],
  "DatabaseChanges": ["Added column X"],
  "Commits": ["feat: add login API"],
  "TestsPerformed": ["Unit Test A"],
  "Tags": ["Feature", "API", "Auth"],
  "Challenges": ["Cache issue", "Race condition"]
}

📌 نمونه JSON

[
  {
    "Date": "2025-01-18",
    "StartTime": "09:12",
    "EndTime": "11:45",
    "DurationHours": 2.55,
    "TaskName": "Implement Login API",
    "Description": "Added JWT, fixed refresh token issue, improved validation.",
    "CodeReviewStatus": "Approved",
    "Dependencies": ["Redis Cache", "Auth Service"],
    "DecisionNotes": ["Use short-lived JWT", "Add blacklist strategy"],
    "DatabaseChanges": ["Added LastLogin column", "Created index on Email"],
    "Commits": ["feat(auth): login endpoint", "fix(token): refresh bug"],
    "TestsPerformed": ["Unit test", "API integration test"],
    "Tags": ["Feature", "Auth", "API"],
    "Challenges": ["Race condition in refresh pipeline"]
  }
]