GET /v2/core/changelogs

Core System Changelogs

این اندپوینت وظیفه ارائه نسخه‌بندی کامل تغییرات سیستم (Change Log) را بر اساس ساختار SemVer توسعه‌یافته (major.minor.patch) بر عهده دارد. داده‌ها از جدول change_logs دریافت می‌شوند، سپس در قالب گروه‌بندی‌شده بر اساس نسخه، بازگردانده می‌شوند.

Request Overview

Access Control

Database Query Logic

دریافت تمامی لاگ‌ها از جدول change_logs با مرتب‌سازی دقیق نسخه:

DB::table('change_logs')
    ->orderBy('major', 'DESC')
    ->orderBy('minor', 'DESC')
    ->orderBy('patches', 'DESC')
    ->orderBy('created_at')
    ->get();
  

Version Grouping Logic

هر رکورد داخل گروه مخصوص نسخه قرار می‌گیرد. کلید گروه نسخه برابر است با: major . minor . patches بدون نقطه (مثلاً 231 → نسخه 02.03.01).

نسخه نهایی با صفرهای سمت چپ فرمت می‌شود:

$changeLogs[$major.$minor.$patch]['version']
    = sprintf("%02d", major)
    . '.' . sprintf("%02d", minor)
    . '.' . sprintf("%02d", patch);
  

ساختار داده هر آیتم

[
  "title"       => row.title,
  "content"     => row.content,
  "created_at"  => CalendarUtils::strftime('Y/m/d', strtotime(row.created_at)),
  "tag"         => row.tag
]
  

Response (Success)

{
  "status": true,
  "time": 1710000000,
  "data": {
    "020301": {
      "version": "02.03.01",
      "data": [
        {
          "title": "Fix Accounting Issues",
          "content": "Detail text ...",
          "created_at": "1403/07/12",
          "tag": "fix"
        },
        ...
      ]
    },
    ...
  }
}
  

Response (Error)

در این متد try/catch وجود ندارد؛ هر خطای دیتابیس یا رانتایم به‌صورت Exception خام از طرف لاراول برگشته می‌شود (HTTP 500).

Flowchart