website·Indexed 30 days ago
https://kargho-us-documentation.vercel.appTechnical guides, resources, and API references for developing the Kargho App, Backend, and Backoffice. Includes documentation on onboarding document uploads, load assignment, push notifications, background location tracking, and integrations with external services like Peruse and Safer. Built with React JS and TypeScript.
Kargho is a mobile application for transport and logistics designed for truck drivers and carriers to manage loads. Key features include real-time load collection, trip tracking, carrier-driver relationship management, and 24/7 virtual assistance.
The project is built using the following technology stack:
{
"entity_type": "CARRIER",
"legal_name": "SNOW TRUCKING LLC",
"dba_name": "",
"physical_address": "1301 AVIATION BLVD GAINESVILLE, GA 30501-6827",
"phone": "(470) 592-0497",
"mailing_address": "6327 HULSEY RD CLERMONT, GA 30527-1705",
"usdot": "2939308",
"state_carrier_id": "",
"mc_mx_ff_numbers": "MC-7533",
"duns_number": null,
"power_units": 26,
"drivers": 26,
"mcs_150_form_date": "03/05/2024",
"mcs_150_mileage_year": { "mileage": "1231881", "year": "2023" },
"out_of_service_date": null,
"operating_status": "AUTHORIZED FOR Property",
"operation_classification": ["Auth. For Hire"],
"carrier_operation": ["Interstate"],
"cargo_carried": [
"General Freight",
"Fresh Produce",
"Meat",
"Refrigerated Food",
"Paper Products"
],
"united_states_inspections": {
"vehicle": {
"inspections": "29",
"out_of_service": "8",
"out_of_service_percent": "27.6%",
"national_average": "22.26%"
},
"driver": {
"inspections": "57",
"out_of_service": "4",
"out_of_service_percent": "7%",
"national_average": "6.67%"
},
"hazmat": {
"inspections": "0",
"out_of_service": "0",
"out_of_service_percent": "%",
"national_average": "4.44%"
},
"iep": {
"inspections": "0",
"out_of_service": "0",
"out_of_service_percent": "0%",
"national_average": "N/A"
}
},
"united_states_crashes": { "tow": 1, "fatal": 0, "injury": 1, "total": 2 },
"canada_inspections": {
"driver": {
"out_of_service": 0,
"out_of_service_percent": "0%",
"inspections": 0
},
"vehicle": {
"out_of_service": 0,
"out_of_service_percent": "0%",
"inspections": 0
}
},
"canada_crashes": { "tow": 0, "fatal": 0, "injury": 0, "total": 0 },
"safety_rating_date": null,
"safety_review_date": null,
"safety_rating": null,
"safety_type": null,
"latest_update": "03/05/2024",
"us_inspections": {
"driver": {
"out_of_service": 4,
"out_of_service_percent": "7%",
"national_average": "6.67%",
"inspections": 57
},
"vehicle": {
"out_of_service": 8,
"out_of_service_percent": "27.6%",
"national_average": "22.26%",
"inspections": 29
},
"hazmat": {
"out_of_service": 0,
"out_of_service_percent": "%",
"national_average": "4.44%",
"inspections": 0
},
"iep": {
"out_of_service": 0,
"out_of_service_percent": "0%",
"national_average": "N/A",
"inspections": 0
}
},
"url": "http://safer.fmcsa.dot.gov/query.asp?searchtype=ANY&query_type=queryCarrierSnapshot&query_param=USDOT&original_query_param=NAME&query_string=2939308"
}1. Clone the app, backoffice, and backend projects to your machine.
2. Open one of the projects in VS Code.
3. Go to File > Add Folder to Workspace and add the other two project folders.
4. Go to File > Save Workspace As to save the configuration file.
5. Open this workspace file in the future to resume work on the feature/fix.driver_license). This document type requires both sides to be uploaded (RequiresBothSides: 1). The system extracts several key fields from the document for validation, including the driver's first name, last name, address, sex, license class, and the driver's license number.{
"Description": "Driver License",
"Code": "driver_license",
"RequiresBothSides": 1,
"requirement_fields": [
{ "FieldName": "first_name", "ColumnName": "FirstName" },
{ "FieldName": "last_name", "ColumnName": "LastName" },
{ "FieldName": "address", "ColumnName": "Address" },
{ "FieldName": "sex", "ColumnName": "Sex" },
{ "FieldName": "class", "ColumnName": "Class" },
{ "FieldName": "dl_number", "ColumnName": "LicenseNumber" }
]
}The recommendation engine matches available loads to trucks in 'Stand By' status. The process follows these validation steps:
Recommendation Lifecycle: Recommendations are assigned to one carrier at a time. If a recommendation expires without action from the carrier, the system must generate a new recommendation for another eligible carrier.
-- Recommendation Table Schema
Table recommendations {
id: UUID/Int,
idload: ForeignKey,
idcarrier: ForeignKey,
idequipment: ForeignKey,
fecha_hora_recomendacion: DateTime,
fecha_hora_vencimiento: DateTime,
estado: String
}-- 1. Delete images and values
DELETE FROM LoadDataTransitionValueImage WHERE IdLoadDataTransitionValue=52
DELETE FROM LoadDataTransitionValue WHERE IdLoadDataTransition=116
-- 2. Delete data transitions
DELETE FROM LoadDataTransition WHERE IdLoadStepTransition=114
-- 3. Delete step transitions and components
DELETE FROM LoadStepTransitionComponent WHERE IdLoadStepTransition=120
DELETE FROM LoadStepTransition WHERE IdLoad='376F7F7E-D9D6-4448-B299-AC0698F46402'
-- 4. Delete recommendations and loads
DELETE FROM Recommendation WHERE IdLOAD='376F7F7E-D9D6-4448-B299-AC0698F46402'
DELETE FROM [Load] WHERE Id='376F7F7E-D9D6-4448-B299-AC0698F46402'
-- 5. Delete core entities
DELETE FROM [equipment] WHERE Id=9
DELETE FROM [driver] WHERE Id='1D110CCC-CDDC-4FCD-BB67-CB34E3419FFC'
DELETE FROM [user] WHERE email='pabloierino.kargho@gmail.com'The system uses specific internal codes to identify required documents during the onboarding process. Common requirement codes include:
driver_license: Driver's License (may require both sides).driver_license_back: Back side of the Driver's License.medical_card: Medical Card.form_w9: W9 Form.When uploading onboarding documents, ensure the following constraints are met to avoid automatic rejection:
IdDriver value to the User, and create a record in CarrierDriver. The driver created should inherit the same data previously held by the carrier.