Backend
Backend documentation
Introduction
Overview
OnDelivery API (OSAS - OnDelivery Smart Agent System) is a comprehensive multi-courier shipping l...
Getting Started
Prerequisites Node.js (v14+ recommended) PostgreSQL (v15+ recommended) npm or yarn package ma...
Core Features
1. Waybill Management Create Waybills - Generate shipping labels with unique AWB (Air Waybill) ...
Directory Structure
ondelivery-api/ ├── ondeliv-backend.js # Main application entry point ├── package.json ...
Database Architecture
The application uses two PostgreSQL databases: OSAS Database (Primary) Main operational databa...
Authentication and security
Authentication Methods 1. JWT Token Authentication (Primary) Usage: Protected API endpoints for a...
API Endpoints
Authentication Endpoints Method Endpoint Auth Description POST /api/auth/signup None Regis...
Courier Partner Integrations
Supported Courier Partners The system integrates with multiple courier partners in Indonesia: 1. ...
External API Integrations
Configured External APIs 1. Agent Management System Purpose: Manage agent locations and configura...
Environment Variables
Required Environment Variables Database Configuration # PostgreSQL - OSAS Database DB_HOST=localh...
Development Guidelines
Development Guidelines
Code Structure Conventions Controller Pattern // controllers/<feature>/<feature>.controller.js e...
Troubleshooting
Common Issues and Solutions 1. Database Connection Failed Error: Unable to connect Osas database:...
Additional Resources
Key Files for Reference ondeliv-backend.js - Main application entry point app/models/index.js ...