forked from Yara724/api
112 lines
4.7 KiB
Markdown
112 lines
4.7 KiB
Markdown
---
|
|
last_updated: 2026-08-08
|
|
tags: [fanavaran, constants, config]
|
|
source: fanavaran-module-docs
|
|
---
|
|
|
|
# 03 — Constants
|
|
|
|
Legend for **Varies by company?**
|
|
✅ = different per insurer tenant · ❌ = shared across tenants in current code
|
|
|
|
Secrets are **not** printed here — read from Mongo `fanavaranClientConfigs` or seed profiles.
|
|
|
|
---
|
|
|
|
## Auth (tenant)
|
|
|
|
| Name | Example (Parsian) | Where used | Why | Varies? |
|
|
|------|-------------------|------------|-----|---------|
|
|
| `appName` | `ParsianService` | GetAppToken | App identity | ✅ |
|
|
| `secret` | *(config)* | GetAppToken | App secret | ✅ |
|
|
| `username` | `ParsianServiceUser` | Login | User | ✅ |
|
|
| `password` | *(config)* | Login | Password | ✅ |
|
|
| `corpId` | `543` | All business calls | Corp scope | ✅ |
|
|
| `contractId` | `28` | All business calls | Contract | ✅ |
|
|
| `location` | `210050` | All business calls / OpBUId | Branch/location | ✅ |
|
|
|
|
Seed: `SEED_FANAVARAN_CLIENT_PROFILES` · Runtime: `getFanavaranClientProfile(key)`.
|
|
|
|
---
|
|
|
|
## Payload defaults (tenant profile.defaults)
|
|
|
|
| Name | Shared seed | Parsian override | Tejaratno | Moallem | Varies? |
|
|
|------|-------------|------------------|-----------|---------|---------|
|
|
| `AccidentCityId` | 701 | same | same | same | usually ❌ |
|
|
| `AccidentReportTypeId` | 155 | same | same | same | usually ❌ |
|
|
| `AccidentVehicleUsedId` | 1 | same | same | same | usually ❌ |
|
|
| `ClaimExpertId` (GEN.03) | 4543092 | **154** | 4543092 | shared TBD | ✅ |
|
|
| `ExpertiseClaimExpertId` (GEN.08) | 2709 | **29** | **2709** | shared TBD | ✅ |
|
|
| `CompensationReferenceId` | 167 | same | same | same | usually ❌ |
|
|
| `CulpritLicenceTypeId` | 2 | same | same | same | usually ❌ |
|
|
| `CulpritTypeId` | 337 | same | same | same | usually ❌ |
|
|
| `DmgCaseTypeId` | 175 | same | same | same | may ✅ |
|
|
| `DmgHistoryStatus` | 5214 | same | same | same | may ✅ |
|
|
| `PlaqueKindId` | 8 | same | same | same | may ✅ |
|
|
| `PlaqueSampleId` | 10 | same | same | same | may ✅ |
|
|
| `DriverIsOwner` | 0 | same | same | same | ❌ |
|
|
| `FaultPercent` | 100 | same | same | same | ❌ |
|
|
| `ClaimFileTypeId` (GEN.07) | 23 | **63** | 23 | 23 TBD | ✅ |
|
|
|
|
**Never swap** GEN.03 `ClaimExpertId` with GEN.08 `ExpertiseClaimExpertId` — different Fanavaran roles.
|
|
|
|
---
|
|
|
|
## Code-level shared constants
|
|
|
|
File: `claim-request-management.service.ts`
|
|
|
|
| Name | Value | Where | Why | Varies? |
|
|
|------|-------|-------|-----|---------|
|
|
| `FANAVARAN_SUBMIT_URL` | `.../third-party-car-financial-claims` | All stage posts | API root | ❌ (same host) |
|
|
| `FANAVARAN_ACCIDENT_LOCATION_ADDRESS` | `استان تهران شهر تهران` | GEN.03 | Provisional address | currently ❌ |
|
|
| `FANAVARAN_DEFAULT_ACCIDENT_CAUSE_ID` | `6` | GEN.03 | Default cause | may ✅ later |
|
|
| `FANAVARAN_DEFAULT_ACCIDENT_LEVEL` | `5456` | GEN.08 sections | Default severity | may ✅ |
|
|
| `FANAVARAN_PROVISIONAL_ESTIMATE_AMOUNT` | `1000` | GEN.03/12 early | Positive estimate | ❌ |
|
|
| `FANAVARAN_DUMMY_LICENCE_NO` | env or `9705463515` | Licence fields | Never empty | env override |
|
|
| `InspectionPlaceId` (expertise) | `282` | GEN.08 | Hardcoded today | should verify ✅ |
|
|
| `DropAmountStatus` (expertise) | `5458` | GEN.08 | Hardcoded today | should verify ✅ |
|
|
| Auth URLs | apimanager.iraneit.com | Auth service | Host | ❌ |
|
|
| Lookup base | same host `/BimeApi/v2.0` | Lookups | Host | ❌ |
|
|
|
|
---
|
|
|
|
## Env / activation
|
|
|
|
| Name | Example | Where | Why | Varies? |
|
|
|------|---------|-------|-----|---------|
|
|
| `FANAVARAN_CLIENT` | `parsian` | `resolveFanavaranClientKey` | Active tenant | ✅ per deploy |
|
|
| `CLIENT_ID` | `8` → parsian | Fallback hint | Legacy deploy map | ✅ |
|
|
| `INSURANCE_CORP_ID` | Persian caption | Damage `InsuranceCorpId` | Match lookup Caption | ✅ |
|
|
| `FANAVARAN_DUMMY_LICENCE_NO` | digits | Licence fallback | Test/prod dummy | optional |
|
|
|
|
---
|
|
|
|
## Enums / claim types (YARA)
|
|
|
|
| Name | Relevant values | Fanavaran use |
|
|
|------|-----------------|---------------|
|
|
| Claim type | `THIRD_PARTY` only | Fanavaran path enabled |
|
|
| | `CAR_BODY` | **Not** submitted to Fanavaran |
|
|
| `ClaimCaseStatus` | local workflow | Triggers stages indirectly |
|
|
| History event types | `FANAVARAN_*_SUCCEEDED/FAILED` | Audit trail on claim |
|
|
|
|
---
|
|
|
|
## Retry / backoff constants
|
|
|
|
| Name | Value | Where |
|
|
|------|-------|-------|
|
|
| `FANAVARAN_RETRY_DELAY_MS` | 5 min | Stage retry |
|
|
| `FANAVARAN_TRANSIENT_RETRY_DELAY_MS` | 10 min | “Try again later” stage retry |
|
|
| `FANAVARAN_MAX_RETRIES` | 2 | Per stage |
|
|
| `TRANSIENT_BACKOFF_MS` | 5 min | Tenant-wide auth backoff |
|
|
| Token TTL | Until Tehran midnight | Auth cache |
|
|
|
|
---
|
|
|
|
## Plate letter codes
|
|
|
|
`FANAVARAN_PLATE_LETTER_CODE` maps Persian plate letters → Fanavaran middle codes (shared mapping table in claim service).
|