# Overview

**OnDelivery API** (OSAS - OnDelivery Smart Agent System) is a comprehensive multi-courier shipping logistics platform built with Node.js. The system enables:

- **Multi-courier aggregation** - Integrate and manage multiple shipping partners (JNE, Lion Parcel, JT Cargo, AnteRaja, etc.)
- **Real-time package tracking** - Track shipments from pickup to delivery
- **Dynamic pricing** - Calculate shipping fees based on origin, destination, weight, and service type
- **Warehouse operations** - Manage scanning, manifesting, handovers, and quality control
- **Financial management** - Handle billing, commissions, and VIP customer pricing
- **Driver mobile app** - Support delivery drivers with marketplace integration
- **Marketplace integration** - Connect with multiple e-commerce platforms

**Project Name:** ondelivery-api  
**Version:** 1.0.0  
**Main Entry Point:** `ondeliv-backend.js`  
**Default Port:** 4220  
**License:** ISC

---

## Architecture & Technology Stack

### Core Technologies

| Technology | Version | Purpose |
|------------|---------|---------|
| **Node.js** | - | Runtime environment |
| **Express.js** | 5.2.1 | Web application framework |
| **PostgreSQL** | - | Primary database (dual setup: OSAS + ONMART) |
| **Sequelize** | 6.37.7 | ORM for database operations |

### Key Dependencies

**Authentication & Security:**
- `jsonwebtoken` (9.0.2) - JWT token generation and verification
- `passport` (0.7.0) - Authentication middleware
- `passport-http` (0.3.0) - HTTP Basic authentication
- `bcryptjs` (3.0.3) - Password hashing
- `helmet` (8.1.0) - Security headers
- `express-rate-limit` (8.2.1) - Rate limiting protection

**Data Validation & Processing:**
- `ajv` (8.17.1) - JSON schema validation
- `ajv-formats` (3.0.1) - Additional format validators
- `ajv-keywords` (5.1.0) - Extended validation keywords

**HTTP & External APIs:**
- `axios` (1.13.2) - HTTP client for external API calls
- `cors` (2.8.5) - Cross-origin resource sharing

**File Processing:**
- `multer` (2.0.2) - File upload handling
- `sharp` (0.34.5) - Image processing and optimization
- `exceljs` (4.4.0) - Excel file generation
- `pdfmake` (0.2.20) - PDF document generation
- `xlsx` (0.20.3) - Excel file parsing

**Utilities:**
- `moment` (2.30.1) / `dayjs` (1.11.19) - Date/time manipulation
- `lodash` (4.17.21) - Utility functions
- `node-cron` (4.2.1) - Scheduled tasks
- `nodemailer` (7.0.11) - Email sending
- `nanoid` (5.1.6) - Unique ID generation
- `morgan` (1.10.1) - HTTP request logging
- `cli-color` (2.0.4) - Colorized console output