POST /api/v2/colleagues/billing

Route Info

(Analysis) تحلیل عملکرد

مکانیسم کدگذاری شعبه

Actual Office ID = Input Branch Code - 1000
  

منطق اعتبارسنجی

(Inputs) ورودی‌ها

{
  "branch": 1050
}
  

(Outputs) خروجی‌ها

خروجی موفق:

{
  "status": true,
  "office": {
    "id": 50,
    "domain": "example.domain.ir",
    "title": "دفتر مرکزی"
  }
}
  

خروجی ناموفق:

{
  "status": false,
  "message": "کد شعبه معتبر نیست یا یافت نشد."
}
  

(Dependencies) وابستگی‌ها

(Testing & Usage) تست و استفاده

POST /api/auth/connect/branch
Content-Type: application/json

{
  "branch": 1050
}
  

(Typical Error Cases) موارد خطا

(Implementation Details) جزئیات پیاده‌سازی

public function connectBranch(Request $request)
{
    $branchCode = $request->branch;
    $actualId = $branchCode - 1000;
    $office = Office::find($actualId);

    if (!$office) {
        return response()->json(['status' => false, 'message' => 'کد شعبه معتبر نیست یا یافت نشد.']);
    }

    return response()->json([
        'status' => true,
        'office' => [
            'id' => $office->id,
            'domain' => $office->domain,
            'title' => $office->title,
        ]
    ]);
}
  

(Conclusion) نتیجه‌گیری

(Appendix) پیوست: نگهداری و امنیت