FleetHub दस्तावेज़

सिंहावलोकन

FleetHub कॉर्पोरेट फ्लीट प्रबंधन प्रणाली है जो आंतरिक कंपनी वाहनों (50–200 वाहन) के लिए है। Laravel 11, Vue 3 और Tailwind CSS पर बना — वाहन, ड्राइवर, रिक्विजिशन, डैमेज मैप के साथ हैंडओवर, ईंधन लॉग, खर्च, TCO विश्लेषण, अनुपालन ट्रैकिंग और फ्लीट स्वास्थ्य स्कोर शामिल है। टैक्सी या कार किराए के लिए नहीं।

सर्वर की आवश्यकता है

• PHP 8.2 या उच्चतर (8.3 अनुशंसित)
• MySQL 5.7+ या MariaDB 10.3+
• संगीतकार 2.x (केवल स्थानीय विकास - साझा होस्टिंग पर आवश्यक नहीं)
• Node.js 18+ और npm 9+ (केवल स्थानीय फ्रंटएंड बिल्ड के लिए)
• वेब सर्वर: अपाचे या नग्नेक्स

आवश्यक PHP एक्सटेंशन

• OpenSSL, PDO, PDO_MySQL, Mbstring, Tokenizer, XML, Ctype, JSON, GD, Fileinfo

ड्राइव क्षमता

न्यूनतम ~200 एमबी. वाहन फोटो, ईंधन रसीदें, हैंडओवर फोटो और अनुपालन दस्तावेजों के लिए अतिरिक्त प्रावधान।

सेटिंग

विकल्प ए - वेब इंस्टालर (अनुशंसित)

1. वेब सर्वर पर प्रोजेक्ट फ़ाइलें अपलोड करें।
2. दस्तावेज़ रूट को फ़ोल्डर public/ पर इंगित करें।
3. अनुमति असाइनमेंट: storage/ और bootstrap/cache/ लिखने योग्य होना चाहिए (chmod 775)।
4. .env.example को .env पर कॉपी करें और APP_KEY सेट करें (यदि SSH उपलब्ध है तो php artisan key:generate चलाएँ, या cPanel सेटिंग्स → चरण 5 देखें)।
5. अपने ब्राउज़र में https://yourdomain.com/install तक पहुंचें।
6. विज़ार्ड का पालन करें - आवश्यकताएँ → डेटाबेस → माइग्रेट → व्यवस्थापक खाता → हो गया। नमूना डेटा लोड करने के लिए डेमो डेटा शामिल करें चुनें (देखें उपयोगकर्ता और भूमिका)।

विकल्प बी - सीएलआई स्थापित करें

# 1. निर्भरताएँ स्थापित करें
composer install --no-dev --optimize-autoloader
npm install
npm run build

# 2. पर्यावरण को कॉन्फ़िगर करें
cp .env.example .env
php artisan key:generate

# 3. DB जानकारी सेट करने के लिए .env संपादित करें
# DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD

# 4. तालिका बनाएं और प्रारंभिक डेटा सीड करें
php artisan migrate --seed

# 5. अपलोड के लिए सिम्लिंक स्टोरेज बनाएं
php artisan storage:link

# 6. उत्पादन के लिए कैश कॉन्फ़िगरेशन
php artisan config:cache
php artisan route:cache
php artisan view:cache

# 7. स्थापित चिह्न
echo "Installed" > storage/installed.lock

विज़ार्ड चरण 2 - डेटाबेस कॉन्फ़िगरेशन

जब विज़ार्ड चरण 2 पर पहुंचता है, तो आपको होस्टिंग कंट्रोल पैनल में बनाए गए डेटाबेस की MySQL कनेक्शन जानकारी दर्ज करनी होगी। डेटाबेस पहले से मौजूद होना चाहिए (खाली हो सकता है - अगला चरण तालिकाएँ बनाएगा)।

प्रत्येक प्रकार की होस्टिंग के अनुसार DB जानकारी कहाँ से प्राप्त करें

• Hostinger: hPanel → डेटाबेस → प्रबंधन → डेटाबेस पर क्लिक करें। विवरण पृष्ठ नाम, उपयोगकर्ता नाम और "पासवर्ड दिखाएँ" बटन प्रदर्शित करता है।
• cPanel: cPanel → MySQL डेटाबेस। डेटाबेस सूची ऊपर, उपयोगकर्ता सूची नीचे। यदि आवश्यक हो तो "पासवर्ड बदलें" का उपयोग करें।
• Plesk: Plesk → डेटाबेस → डेटाबेस नाम पर क्लिक करें। विवरण पृष्ठ क्रेडेंशियल दिखाता है और इसमें एक पासवर्ड रीसेट बटन है।
• DirectAdmin: DirectAdmin → MySQL प्रबंधन → डेटाबेस पर क्लिक करें। क्रेडेंशियल और पासवर्ड रीसेट विवरण पृष्ठ पर हैं।
• बाहरी/प्रबंधित डीबी: AWS RDS, DigitalOcean प्रबंधित डेटाबेस, आदि। क्लाउड कंसोल से कस्टम होस्टनाम, पोर्ट (आमतौर पर 3306 लेकिन जांचना चाहिए), DB नाम, उपयोगकर्ता और पासवर्ड का उपयोग करें। Make sure the server's IP is whitelisted in the DB firewall.

सामान्य त्रुटियाँ और उन्हें कैसे ठीक करें

लोकलहोस्ट (स्थानीय विकास)

उत्पादन में तैनात करने से पहले परीक्षण या विकास उद्देश्यों के लिए आपके कंप्यूटर पर फ्लीटहब चलाने के लिए एक त्वरित मार्गदर्शिका। अपने ऑपरेटिंग सिस्टम के लिए उपयुक्त वातावरण चुनें.

विकल्प 1 - लारवेल हर्ड (अनुशंसित, macOS और Windows)

Laravel Herd Laravel टीम का आधिकारिक स्थानीय वातावरण है - मुफ़्त, देशी, कोई डॉकर नहीं। PHP 8.2/8.3/8.4, Nginx, और (हर्ड प्रो में) MySQL/Redis शामिल है।

1. herd.laravel.com से Laravel Herd डाउनलोड और इंस्टॉल करें।
2. फ्लीटहब प्रोजेक्ट फ़ोल्डर को ~/Herd/ (macOS) या %USERPROFILE%\Herd\ (विंडोज़) पर सेट करें। हर्ड डोमेन .test बनाता है - उदाहरण के लिए http://fleethub.test।
3. Herd → Sites खोलें और पुष्टि करें कि PHP संस्करण 8.2 या 8.3 है। HTTPS सक्षम करने के लिए साइट → Secure पर राइट-क्लिक करें (QR स्कैनर के लिए आवश्यक)।
4. MySQL डेटाबेस बनाएं. Herd Pro के साथ, Services → MySQL → TablePlus में खोलें पर जाएं। यदि आपके पास प्रो नहीं है, तो MySQL समुदाय इंस्टॉल करें या SQLite (DB_CONNECTION=sqlite, touch database/database.sqlite) का उपयोग करें।
5. .env.example को .env पर कॉपी करें, DB जानकारी भरें, फिर प्रोजेक्ट रूट पर php artisan key:generate चलाएँ।
6. अपने ब्राउज़र में http://fleethub.test/install खोलें और विज़ार्ड का पालन करें।

विकल्प 2 - एक्सएएमपीपी (विंडोज, मैकओएस, लिनक्स)

XAMPP Apache, MySQL/MariaDB और PHP को बंडल करता है। मुफ़्त, क्रॉस-प्लेटफ़ॉर्म. संस्करण PHP 8.2 या उच्चतर चुनना सुनिश्चित करें।

1. apachefriends.org से XAMPP 8.2+ डाउनलोड करें और इंस्टॉल करें।
2. फ्लीटहब प्रोजेक्ट को C:\xampp\htdocs\FleetHub\ (विंडोज़) या /Applications/XAMPP/htdocs/FleetHub/ (macOS) पर कॉपी करें।
3. XAMPP कंट्रोल पैनल खोलें और Apache और MySQL शुरू करें। यदि पोर्ट पर कब्जा है, तो Apache को 8080 पर स्विच करने के लिए Config → service.conf पर जाएं।
4. http://localhost/phpmyadmin → New पर जाएं → कोलेशन utf8mb4 के साथ fleethub नामक डेटाबेस बनाएं।
5. प्रोजेक्ट फ़ोल्डर में: .env.example को .env पर कॉपी करें, DB_DATABASE=fleethub, DB_USERNAME=root सेट करें, DB_PASSWORD को खाली छोड़ दें (XAMPP डिफ़ॉल्ट)। php artisan key:generate चलाएँ।
6. इंस्टॉलेशन विज़ार्ड चलाने के लिए http://localhost/FleetHub/public/install तक पहुंचें।

विकल्प 3 - लैरागॉन (विंडोज़)

Laragon Laravel के लिए डिज़ाइन किया गया एक पोर्टेबल Windows स्टैक है — ऑटो vhost, संक्षिप्त URL, MySQL/MariaDB और HeidiSQL शामिल।

1. larago.org से Laragon Full डाउनलोड करें और इंस्टॉल करें।
2. लैरागॉन में: मेनू → PHP → Version — PHP 8.2 या 8.3 पर स्विच करें।
3. फ्लीटहब प्रोजेक्ट को C:\laragon\www\FleetHub\ पर कॉपी करें।
4. सभी प्रारंभ करें दबाएँ। लैरागॉन अपना स्वयं का vhost बनाता है: http://fleethub.test (फ़ोल्डर public/ की ओर इंगित करता है)।
5. HeidiSQL खोलें (शामिल) → डेटाबेस बनाएं fleethub। डिफ़ॉल्ट जानकारी: उपयोगकर्ता root, पासवर्ड रिक्त है।
6. डीबी जानकारी के साथ .env संपादित करें, php artisan key:generate चलाएं, फिर http://fleethub.test/install तक पहुंचें।

विकल्प 4 - पहले से मौजूद PHP सर्वर (कोई वेब सर्वर आवश्यक नहीं)

सबसे सरल विकल्प: लारवेल artisan serve के साथ आता है, जो एक PHP डेवलपमेंट सर्वर शुरू करता है। Apache या Nginx की कोई आवश्यकता नहीं। त्वरित परीक्षण के लिए सर्वोत्तम.

# निर्भरताएँ स्थापित करें और कॉन्फ़िगर करें
cd /path/to/FleetHub
composer install
cp .env.example .env
php artisan key:generate

# माइग्रेशन चलाएँ और प्रारंभिक डेटा सीड करें
php artisan migrate --seed

# डेव सर्वर प्रारंभ करें
php artisan serve
# फिर पहुंचें: http://127.0.0.1:8000/install

लोकलहोस्ट चलाते समय सामान्य समस्याएँ

क्यूआर स्कैनर http:// पर कैमरा नहीं खोलता है

ब्राउज़र कैमरा एपीआई को HTTPS की आवश्यकता होती है, एक अपवाद के साथ: http://localhost और http://127.0.0.1 को सुरक्षित संदर्भ माना जाता है। यदि आप LAN IP (जैसे http://192.168.1.10) के माध्यम से फ्लीटहब तक पहुंचते हैं, तो कैमरा अस्वीकार कर दिया जाएगा। डेव के लिए localhost का उपयोग करें, या हर्ड / mkcert के माध्यम से HTTPS सक्षम करें।

भंडारण पर अनुमति अस्वीकृत (macOS / Linux)

यदि ऐप लॉग या कैश करते समय आपको कोई त्रुटि आती है, तो अनुमति ठीक करें: chmod -R 775 storage bootstrap/cache। विंडोज़ पर आमतौर पर इसकी कोई आवश्यकता नहीं होती है।

पोर्ट उपयोग में है

यदि पोर्ट 8000 पर पहले से ही किसी अन्य ऐप का कब्जा है, तो दूसरे पोर्ट का उपयोग करें:

php artisan serve --port=8001

स्थानीय स्तर पर ईमेल का परीक्षण करें

ट्रू SMTP आमतौर पर लोकलहोस्ट पर उपलब्ध नहीं होता है। दो सुरक्षित विकल्प: (1) .env में MAIL_MAILER=log डालें - ईमेल भेजने के बजाय storage/logs/laravel.log में लॉग इन किया गया है; या (2) आउटगोइंग ईमेल को नकली इनबॉक्स में कैप्चर करने के लिए Mailtrap / MailHog का उपयोग करें।

MAIL_MAILER=log
# सभी ईमेल स्टोरेज/लॉग्स/लारवेल.लॉग पर लॉग किए गए हैं

फ्रंटएंड एसेट्स (वाइट/टेलविंड)

फ्लीटहब का Vue/टेलविंड फ्रंटएंड पहले से ही पैकेज में बनाया गया है। यदि आप Vue घटक या टेलविंड कॉन्फ़िगरेशन संपादित करते हैं, तो आपको Node.js 18+ की आवश्यकता होगी:

npm install
npm run dev    # विकास करते समय हॉट-रीलोड करें
npm run build  # उत्पादन बनाएँ (तैनाती से पहले चलाएँ)

होस्टिंगर सिंगल (साझा होस्टिंग) पर तैनाती

यह उन लोगों के लिए अनुशंसित है जिनके पास वीपीएस या तकनीकी अनुभव नहीं है। फ्लीटहब सबसे सस्ते होस्टिंगर सिंगल वेब होस्टिंग प्लान (~$2.99/माह) के साथ पूरी तरह से संगत है। SSH, कंपोज़र या कमांड लाइन की कोई ज़रूरत नहीं - सिंगल नेटिव क्रॉन जॉब्स, PHP 8.3 और मुफ़्त SSL के साथ आता है।

चरण 1 - होस्टिंग तैयार करें

1. Hostinger hPanel में लॉग इन करें।
2. अपने डोमेन नाम के लिए Hosting → Management पर जाएं।
3. PHP संस्करण को उन्नत → PHP कॉन्फ़िगरेशन के माध्यम से 8.2 या 8.3 पर सेट करें।
4. सुनिश्चित करें कि ये PHP एक्सटेंशन सक्षम हैं (आमतौर पर डिफ़ॉल्ट रूप से):
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo

चरण 2 - MySQL डेटाबेस बनाएँ

1. hPanel में, डेटाबेस → MySQL डेटाबेस पर जाएं।
2. नया डेटाबेस बनाएं दबाएँ।
3. इन 3 मानों को रिकॉर्ड करें:
   • डेटाबेस का नाम — उदाहरण के लिए u123_FleetHub
   • लॉगिन नाम — उदाहरण के लिए u123_admin
   • पासवर्ड — स्वयं निर्मित और सावधानी से रखा गया

चरण 3 - फ़ाइलें अपलोड करें

1. hPanel में फ़ाइल → फ़ाइल प्रबंधक पर जाएँ।
2. public_html/ पर नेविगेट करें (यह डोमेन नाम का मूल है)।
3. इस फ़ोल्डर में किसी भी डिफ़ॉल्ट index.html या default.php फ़ाइलों को हटा दें।
4. फ़ाइलें अपलोड करें पर क्लिक करें और इंस्टॉलेशन पैकेज से सभी source.zip डाउनलोड करें।
   या यदि आप चाहें तो फ़ोल्डर /source/ की सामग्री को सीधे एफ़टीपी के माध्यम से डाउनलोड करें।
5. यदि ज़िप अपलोड कर रहे हैं, तो राइट क्लिक करें → Extract। डीकंप्रेसन के बाद, सभी फ़ाइलें रूट public_html/ पर होनी चाहिए।
6. पुष्टि करें public_html/ में शामिल हैं: app/, public/, vendor/, .htaccess, index.php (public/ में), .env, आदि।

चरण 4 - इंस्टॉलर चलाएँ

1. अपना ब्राउज़र खोलें और https://yourdomain.com/install पर जाएं।
2. आपको फ्लीटहब इंस्टालर दिखाई देगा।
3. चरण 1: आवश्यकताएँ - सभी आइटम पास होने चाहिए (हरा)। यदि त्रुटियां हैं, तो लापता PHP एक्सटेंशन को सक्षम करने के लिए होस्टिंगर समर्थन से संपर्क करें।
4. चरण 2: डेटाबेस — ऊपर चरण 2 से जानकारी दर्ज करें:
   • मेज़बान: localhost
   • पत्तन: 3306
   • डेटाबेस: u123_FleetHub
   • उपयोगकर्ता नाम: u123_admin
   • पासवर्ड: (होस्टिंगर द्वारा उत्पन्न)
5. चरण 3: माइग्रेट — "रन माइग्रेशन और सीड" पर क्लिक करें। ~10 सेकंड लगते हैं। ताज़ा मत करो.
6. चरण 4: व्यवस्थापक — एक व्यवस्थापक खाता बनाएँ। मजबूत पासवर्ड का प्रयोग करें.
7. हो गया! — आपको क्रॉन यूआरएल (सहेजें!) और एक लॉगिन बटन दिखाई देगा।

चरण 5 - होस्टिंगर क्रॉन के माध्यम से स्वचालित ईमेल अलर्ट सेट करें

फ्लीटहब लारवेल शेड्यूलर का उपयोग करता है: अनुपालन अलर्ट, रखरखाव अनुस्मारक, अतिदेय अनुरोध, ड्राइवर लाइसेंस, वाहन मूल्य अपडेट और बेड़े स्वास्थ्य स्कोर पुनर्गणना। hPanel पर a cron कॉन्फ़िगर करें।

1. hPanel में, Advanced → Cron Jobs पर जाएं।
2. Create Cron job पर क्लिक करें।
3. प्रकार चुनें: Custom ("PHP" नहीं - क्योंकि पैरामीटर को पारित करने की आवश्यकता है)।
4. निम्नलिखित कमांड दर्ज करें (uXXXXXX को अपने होस्टिंगर उपयोगकर्ता नाम से बदलें):

   /usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

   युक्ति: फ़ाइल प्रबंधक खोलें, फ़ाइल artisan (प्रोजेक्ट रूट) ढूंढें, पूर्ण पथ की प्रतिलिपि बनाने के लिए → Properties पर राइट क्लिक करें।
5. शेड्यूल को हर मिनट पर सेट करें - सभी पांच फ़ील्ड (मिनट, घंटा, दिन, महीना, सप्ताह का दिन) * पर सेट करें।
6. Save दबाएँ.

फ्लीटहब अतिदेय दावा अनुस्मारक, रखरखाव, अनुपालन और लाइसेंस अलर्ट, मूल्यह्रास अपडेट और स्वचालित बेड़े स्वास्थ्य स्कोर पुनर्गणना भेजेगा।

चरण 6 - ईमेल कॉन्फ़िगर करें (एसएमटीपी)

होस्टिंगर प्रत्येक योजना के साथ ईमेल खाते प्रदान करता है। फ्लीटहब सूचनाओं के लिए:

1. एचपैनल में, ईमेल → ईमेल अकाउंट पर जाएं और एक खाता बनाएं (उदाहरण के लिए noreply@yourdomain.com)।
2. फ़ाइल प्रबंधक के माध्यम से फ़ाइल .env को public_html/ में संपादित करें:

   MAIL_MAILER=smtp
   MAIL_HOST=smtp.hostinger.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. फ़ाइल सहेजें।
4. फ्लीटहब में लॉग इन करें → सेटिंग्स → ईमेल टैब → टेस्ट ईमेल भेजें। यदि आप इसे प्राप्त कर लेते हैं, तो आपका काम हो गया।

होस्टिंगर सिंगल पर सामान्य समस्याएं

अपलोड के बाद "500 आंतरिक सर्वर त्रुटि"।

• सत्यापित करें कि .htaccess मूल public_html/ पर मौजूद है और इसमें पुनर्लेखन नियम शामिल हैं।
• पुष्टि करें कि PHP संस्करण hPanel में 8.2 या 8.3 पर सेट है।
• वास्तविक त्रुटि देखने के लिए फ़ाइल प्रबंधक के माध्यम से storage/logs/laravel.log की जाँच करें।

अपलोड करते समय "अनुमति अस्वीकृत"।

होस्टिंगर आमतौर पर अपने आप सही अनुमतियाँ सेट करता है, लेकिन यदि नहीं:

• फ़ाइल मैनेजर में storage/ पर राइट क्लिक करें → Permissions → पुनरावर्ती रूप से 755 पर सेट करें।
• bootstrap/cache/ के साथ भी ऐसा ही।

क्यूआर स्कैनर कैमरा खोलने में विफल रहता है

ब्राउज़र कैमरा एपीआई के लिए HTTPS की आवश्यकता होती है। होस्टिंगर लेट्स एनक्रिप्ट के माध्यम से मुफ्त एसएसएल प्रदान करता है - SSL → Manage के तहत hPanel में सक्षम करें।

शेड्यूल किए गए ईमेल नहीं भेजे जाते

• एचपैनल में → क्रॉन जॉब्स → क्रॉन प्रविष्टि में कॉलम अंतिम रन जांचें। यदि खाली है, तो क्रॉन नहीं चल रहा है - पुष्टि करें कि कारीगर पथ सही है।
• मैन्युअल रूप से कमांड का परीक्षण करें: hPanel में Terminal खोलें (यदि उपलब्ध हो) और cron कमांड चलाएँ। यदि कोई त्रुटि है, तो त्रुटि संदेश स्पष्ट रूप से समस्या (गलत PHP संस्करण, गलत पथ, आदि) का संकेत देगा।
• पुष्टि करें कि एसएमटीपी सही ढंग से कॉन्फ़िगर किया गया है (सेटिंग्स → ईमेल → टेस्ट भेजें)।
• शेड्यूलर त्रुटियों के लिए storage/logs/laravel.log जांचें।

धीमा प्रदर्शन

होस्टिंगर सिंगल सीपीयू/रैम साझा करता है। यदि आपके समूह में 20 से अधिक लोग हैं, तो विचार करें:

• प्रीमियम (~$3.99/माह) पर अपग्रेड करें - तेज़ सर्वर, अधिक संसाधन, अधिक डेटाबेस।
• या Business (~$5.99/माह) - समर्पित संसाधन, दैनिक बैकअप, स्टेजिंग वातावरण।

cPanel पर परिनियोजन (साझा होस्टिंग)

यह गाइड मानक cPanel साझा होस्टिंग (नेमसस्ते, ब्लूहोस्ट, GoDaddy और सबसे सस्ते होस्ट) के लिए है। फ्लीटहब के पास पहले से ही vendor/ और फ्रंटएंड बिल्ड है - सर्वर पर कंपोजर, एनपीएम या टर्मिनल की कोई आवश्यकता नहीं है। यदि cPanel में टर्मिनल नहीं है, तो SSH Access या नीचे फ़ाइल प्रबंधक में विधियों का उपयोग करें।

चरण 1 - PHP संस्करण और एक्सटेंशन सेट करें

1. cPanel में लॉग इन करें।
2. MultiPHP प्रबंधक खोलें (या PHP संस्करण चुनें) और डोमेन के लिए PHP 8.2 या 8.3 चुनें।
3. MultiPHP INI एडिटर या PHP एक्सटेंशन खोलें और पुष्टि करें कि निम्नलिखित एक्सटेंशन सक्षम हैं:
   • OpenSSL, PDO, PDO_MySQL, Mbstring, GD, Tokenizer, XML, Ctype, JSON, Fileinfo
4. यदि एक्सटेंशन गायब है, तो इसे सूची से सक्षम करें या होस्ट समर्थन से संपर्क करें।

चरण 2 - एसएसएल (एचटीटीपीएस) सक्षम करें

1. SSL/TLS स्टेटस पर जाएं (या आइए SSL / AutoSSL एन्क्रिप्ट करें)।
2. AutoSSL चलाएँ या डोमेन के लिए एक निःशुल्क प्रमाणपत्र स्थापित करें।
3. ब्राउज़र कैमरा खोलने के लिए QR स्कैनर के लिए HTTPS आवश्यक है।

चरण 3 - MySQL डेटाबेस और उपयोगकर्ता बनाएं

1. मेरे डेटाबेस प्रबंधित करें खोलें (डेटाबेस अनुभाग में)।
2. Create New Database में, एक नाम दर्ज करें (जैसे fleethub) और बनाएं। cPanel स्वचालित रूप से फॉर्म cpaneluser_fleethub में एक उपसर्ग - पूरा नाम जोड़ता है।
3. MySQL Users में, एक मजबूत पासवर्ड वाला उपयोगकर्ता बनाएं। उपयोक्तानाम को उपसर्ग के साथ कॉपी करें.
4. डेटाबेस में उपयोगकर्ता जोड़ें में, उपयोगकर्ता और डेटाबेस का चयन करें, जोड़ें, फिर सभी विशेषाधिकार प्रदान करें। इस चरण को छोड़ना आसान है - इसे चूकने पर त्रुटि Access denied (1045) होगी।
5. CPanel में प्रदर्शित बिल्कुल 3 मान रिकॉर्ड करें:
   • डेटाबेस का नाम — उदाहरण के लिए u123_FleetHub
   • लॉगिन नाम — उदाहरण के लिए u123_admin
   • पासवर्ड — स्वयं निर्मित और सावधानी से रखा गया

चरण 4 - फ़ाइलें अपलोड करें

1. फ़ाइल प्रबंधक खोलें, public_html/ (दस्तावेज़ रूट) पर जाएँ।
2. .htaccess और .env देखने के लिए सेटिंग्स → छुपी फ़ाइलें दिखाएं चालू करें।
3. यदि मौजूद है तो public_html/ में डिफ़ॉल्ट index.html को हटा दें।
4. source.zip और Extract अपलोड करें, या FTP के माध्यम से फ़ोल्डर /source/ की सामग्री अपलोड करें।
5. डीकंप्रेसन के बाद, public_html/ में app/, public/, vendor/, .htaccess रूट और artisan समान स्तर पर होना चाहिए।

चरण 5 - इंस्टॉलर चलाने से पहले .env तैयार करें

/install खोलते समय इस चरण को पहले पूरा करें। लारवेल को वैध होने के लिए APP_KEY और .env में DB कॉन्फ़िगरेशन सही होने की आवश्यकता है।

1. फ़ाइल प्रबंधक में, .env.example को .env (artisan के समान फ़ोल्डर) में कॉपी करें।
2. .env संपादित करें और न्यूनतम सेट करें:

   APP_NAME=FleetHub
   APP_ENV=production
   APP_DEBUG=false
   APP_URL=https://yourdomain.com
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=cpaneluser_fleethub
   DB_USERNAME=cpaneluser_admin
   DB_PASSWORD="your_password"
   
   SESSION_DRIVER=file
   CACHE_STORE=file

3. SQLite का उपयोग करने के लिए DB_CONNECTION=mysql - .env.example डिफ़ॉल्ट सेट करें; साझा होस्टिंग के लिए MySQL की आवश्यकता होती है।
4. पहले माइग्रेशन से पहले SESSION_DRIVER=file और CACHE_STORE=file लगाएं (सत्र तालिका त्रुटियों से बचें)।
5. यदि पासवर्ड में विशेष अक्षर (#, $, !, आदि) हैं तो DB_PASSWORD को उद्धरण चिह्नों में लपेटें।

APP_KEY जनरेट करें (टर्मिनल की कोई आवश्यकता नहीं)

कई cPanel योजनाओं में वेब टर्मिनल शामिल नहीं होता है। निम्न विधियों में से किसी एक का उपयोग करें:

• SSH Access (cPanel → Security → SSH Access): पुटी/पॉवरशेल कनेक्शन, cd ~/public_html && php artisan key:generate चलाएँ।
• फ़ाइल प्रबंधक - अस्थायी public/genkey.php बनाएं, ब्राउज़र खोलें, परिणामों को APP_KEY= पर कॉपी करें, फिर फ़ाइल को तुरंत हटा दें।

  <?php
  echo 'base64:' . base64_encode(random_bytes(32));

• PC पर - यदि PHP लोकल है: php -r "echo 'base64:'.base64_encode(random_bytes(32));" तो .env पेस्ट करें।

• यदि इंस्टॉलर लेखन त्रुटि की रिपोर्ट करता है तो अनुमतियाँ storage/ और bootstrap/cache/ को 755 (पुनरावर्ती) पर सेट करें।

चरण 6 - वेब इंस्टॉलर चलाएँ

1. ब्राउज़र में https://yourdomain.com/install खोलें।
2. चरण 1: आवश्यकताएँ - सभी को उत्तीर्ण होना चाहिए (हरा)। चरण 1 में PHP एक्सटेंशन गायब होने पर उसे ठीक करें।
3. चरण 2: डेटाबेस — चरण 3 से उपसर्ग के साथ नाम दर्ज करें:
   • मेज़बान: 127.0.0.1 or localhost
   • पत्तन: 3306
   • डेटाबेस: cpaneluser_fleethub
   • उपयोगकर्ता नाम: cpaneluser_admin
   • पासवर्ड: (your MySQL password)
4. चरण 3: माइग्रेट — "रन माइग्रेशन और सीड" पर क्लिक करें। ~10 सेकंड. पेज को रीफ़्रेश न करें.
5. यदि स्वच्छ उत्पादन स्थापित किया जा रहा है तो डेमो डेटा शामिल करें को अनचेक करें।
6. चरण 4: एडमिन — एक एडमिन अकाउंट बनाएं।
7. हो गया! — अंतिम स्क्रीन में क्रॉन यूआरएल सहेजें।

चरण 7 - ईमेल अलर्ट के लिए क्रॉन जॉब्स कॉन्फ़िगर करें

लैरावेल को अनुपालन अलर्ट, रखरखाव अनुस्मारक, अतिदेय अनुरोध और अन्य निर्धारित ईमेल भेजने के लिए फ्लीटहब को हर मिनट चलने वाले क्रॉन की आवश्यकता होती है।

1. CPanel में, Advanced → Cron Jobs पर जाएं।
2. नया क्रॉन जॉब जोड़ें में, शेड्यूल को हर मिनट (* * * * *) पर सेट करें।
3. कमांड दर्ज करें (सामान्य जानकारी में CPANELUSER को cPanel उपयोगकर्ता नाम से बदलें):

   /usr/local/bin/php /home/CPANELUSER/public_html/artisan schedule:run

   युक्ति: PHP पथ /usr/local/bin/php या /usr/bin/php हो सकता है। कारीगर पथ आमतौर पर /home/CPANELUSER/public_html/artisan होता है।
4. सहेजने के लिए नया क्रॉन जॉब जोड़ें पर क्लिक करें।

चरण 8 - ईमेल कॉन्फ़िगरेशन (एसएमटीपी)

आउटगोइंग सूचनाओं के लिए एक cPanel ईमेल खाता बनाएँ:

1. ईमेल अकाउंट पर जाएं → उदाहरण बनाएं। noreply@yourdomain.com.
2. फ़ाइल प्रबंधक में .env संपादित करें:

   MAIL_MAILER=smtp
   MAIL_HOST=mail.yourdomain.com
   MAIL_PORT=587
   MAIL_USERNAME=noreply@yourdomain.com
   MAIL_PASSWORD=your_email_password
   MAIL_ENCRYPTION=tls
   MAIL_FROM_ADDRESS=noreply@yourdomain.com
   MAIL_FROM_NAME="Your Company Name"

3. सेव करें, फिर फ्लीटहब में: सेटिंग्स → ईमेल → टेस्ट ईमेल भेजें।

CPanel पर सामान्य समस्याएँ

"उपयोगकर्ता के लिए प्रवेश निषेध" (SQLSTATE 1045)

• डेटाबेस नाम और उपयोगकर्ता नाम बिल्कुल को cPanel से कॉपी करें - उपसर्ग सहित।
• सभी विशेषाधिकारों के साथ डेटाबेस में उपयोगकर्ता जोड़ें की पुष्टि करें।
• CPanel में MySQL पासवर्ड रीसेट करें और .env अपडेट करें - यदि विशेष वर्ण हैं तो DB_PASSWORD के आसपास ब्रैकेट का उपयोग करें।

डेटाबेस चरण बीत जाने के बाद माइग्रेशन विफल हो जाता है

• विज़ार्ड फॉर्म से परीक्षण करता है, लेकिन माइग्रेट .env पढ़ता है। सुनिश्चित करें कि वे मेल खाते हों.
• यदि कोई है तो bootstrap/cache/config.php हटाएं, फिर पुनः प्रयास करें।
• सुनिश्चित करें कि .env में DB_CONNECTION=mysql हो (एसक्लाइट नहीं)।

माइग्रेट करते समय "अमान्य डिफ़ॉल्ट मान" (1067)

साझा होस्टिंग पर MySQL का सख्त मोड कुछ कॉलमों के लिए डिफ़ॉल्ट मानों को अस्वीकार कर सकता है। storage/logs/laravel.log देखें और सभी एक्सटेंशन के साथ PHP 8.2+ सुनिश्चित करें।

अपलोड के बाद "500 आंतरिक सर्वर त्रुटि"।

• मूल .htaccess और PHP 8.2+ देखें।
• वास्तविक त्रुटि के लिए storage/logs/laravel.log देखें।
• पुष्टि करें कि APP_KEY .env में सेट है - खाली कुंजी त्रुटि 500 ​​का कारण बनती है।

CPanel में कोई टर्मिनल नहीं है

कई साझा पैकेजों पर सामान्य। SSH Access (यदि सक्षम है), genkey.php अस्थायी रूप से चरण 5 में उपयोग करें, या स्थानीय पीसी पर कुंजी उत्पन्न करें।

क्यूआर स्कैनर कैमरा नहीं खोलता है

SSL/TLS स्थिति → AutoSSL के माध्यम से SSL सक्षम करें और https:// के साथ एक्सेस करें।

विन्यास

.env फ़ाइल

ऐप में इंस्टॉल करें

अधिकांश गैर-संवेदनशील विकल्प एडमिन → सेटिंग्स पर कॉन्फ़िगर किए गए हैं:

• सामान्य: कंपनी का नाम/ईमेल/फोन, ब्रांड
• वाहन बेड़ा: वाहन कोड उपसर्ग, हैंडओवर चेकलिस्ट टेम्पलेट, रखरखाव डिफ़ॉल्ट, सार्वजनिक वाहन पृष्ठ मोड
• Email: SMTP का परीक्षण करने के लिए एक परीक्षण ईमेल भेजें
• सूचनाएं: अनुपालन अलर्ट, रखरखाव, वाहन आवश्यकताएं, लाइसेंस सक्षम/अक्षम करें
• बहुभाषी: समय क्षेत्र, दिनांक प्रारूप, मुद्रा - पूरे ऐप पर लागू
• अनुपालन: अनुपालन प्रकार प्रीसेट प्रबंधित करें (बीमा, पंजीकरण, सड़क कर...)
• ब्रांड: ऐप का नाम और लोगो - अपडेट किया गया लॉगिन, पादलेख, टैब शीर्षक
• उपस्थिति: प्रकाश/अंधेरे के लिए ब्रांड रंग, स्थिति और पाठ को अनुकूलित करें - FAQ में रीब्रांडिंग गाइड देखें

बहुभाषी समर्थन

फ्लीटहब अरबी (आरटीएल) और हिंदी सहित 11 भाषाओं में उपलब्ध है। उपयोगकर्ता ऊपरी दाएं कोने में फ़्लैग ड्रॉपडाउन के माध्यम से भाषा बदलते हैं।

उपलब्ध भाषाएँ

भाषा कैसे बदलें

1. ड्रॉपडाउन खोलने के लिए ऊपरी दाएं कोने में ध्वज आइकन पर क्लिक करें।
2. सूची से भाषा चुनें.
3. पृष्ठ पुनः लोड होगा; सभी यूआई लेबल, तिथियां और मुद्रा प्रारूप आगे बढ़ते हैं।
4. विकल्प उपयोगकर्ता खाते और कुकीज़ (1 वर्ष) दोनों में सहेजे जाते हैं।

कस्टम भाषा जोड़ें (व्यवस्थापक)

प्रशासन → अनुवाद पर जाएं (व्यवस्थापक के पास अनुमति है अनुवाद प्रबंधित करें):

• "स्थान जोड़ें" पर क्लिक करें - अनुवाद की प्रतिलिपि बनाने के लिए कोड (उदाहरण के लिए मैसेडोनियन के लिए mk), प्रदर्शन नाम, स्थान नाम, एसवीजी ध्वज फ़ाइल नाम, दिशा (एलटीआर/आरटीएल), और मूल स्थान दर्ज करें।
• नया स्थान सेटिंग्स → स्थानीयकरण पर भाषा स्विचर और डिफ़ॉल्ट भाषा सूची में दिखाई देता है।
• DB अनुवाद स्वचालित रूप से lang/{code}/ में फ़ाइल को ओवरराइड करता है।

अनुवाद संपादक

संपादक सभी अनुवाद कुंजियों को फ़ाइल (संपत्ति, नेविगेशन, सेटिंग्स...) के अनुसार सूचीबद्ध करता है। प्रत्येक कुंजी बेसलाइन फ़ाइल प्रदर्शित करती है और DB (यदि कोई हो) को ओवरराइड करती है।

• स्थान, अनुवाद समूह, या पाठ खोज के आधार पर फ़िल्टर करें।
• इनलाइन संपादित करने के लिए मान पर क्लिक करें; अभी DB में सहेजें.
• बेसलाइन फ़ाइल पर लौटने के लिए कुंजी रीसेट करें।
• लोकेल बिल्ट-इन (en, vi, es...) को संपादित किया जा सकता है; डीबी से पूरी तरह से कस्टम लोकेल।
• केवल अनुवाद प्रबंधित करें अनुमति वाले उपयोगकर्ता ही इस पृष्ठ तक पहुंच सकते हैं।

सीएसवी आयात/निर्यात

• Export - किसी लोकेल की सभी कुंजियों को CSV (group,key,value) के रूप में डाउनलोड करें।
• Import — उसी कॉलम में CSV अपलोड करें; ओवरराइड डीबी अद्यतन किया गया, नई कुंजी जोड़ी गई।

उपयोगकर्ता के अनुसार डिफ़ॉल्ट स्थान

प्रत्येक उपयोगकर्ता के पास कॉलम locale है। लारवेल के HasLocalePreference अनुबंध के कारण अधिसूचना ईमेल प्राप्तकर्ता की भाषा के अनुसार स्वचालित रूप से भेजे जाते हैं।

साइट की डिफ़ॉल्ट भाषा सेटिंग्स → स्थानीयकरण → डिफ़ॉल्ट भाषा पर स्थित है। व्यक्तिगत उपयोगकर्ता हेडर पर भाषा स्विचर के माध्यम से ओवरराइड करते हैं।

फ़ीचर सूची (15 मॉड्यूल समूह)

उपयोगकर्ता एवं भूमिकाएँ

फ्लीटहब के पास आंतरिक बेड़े संचालन के लिए 5 भूमिकाएँ उपलब्ध हैं:

डेमो अकाउंट (पासवर्ड: password): admin@fleethub.test, manager@fleethub.test, dept@fleethub.test, accountant@fleethub.test, driver@fleethub.test। इंस्टॉल या सीडिंग करते समय डेमो डेटा सक्षम करें। स्पैटी अनुमतियाँ - व्यवस्थापक प्रत्येक अनुमति को ठीक कर सकते हैं।

वाहन प्रबंधन

नई कार बनाएं

1. वाहन → नए वाहन पर नेविगेट करें।
2. लाइसेंस प्लेट नंबर, मेक, मॉडल, वर्ष, ईंधन प्रकार, श्रेणी और विभाग भरें।
3. खरीद की तारीख और कीमत जोड़ें (मूल्यह्रास और टीसीओ के लिए आवश्यक)।
4. फ़ोटो अपलोड करें (एकाधिक फ़ाइलें, प्रत्येक अधिकतम 5 एमबी - मोबाइल पर स्वचालित रूप से संपीड़ित)।
5. सहेजें - वाहन कोड और क्यूआर कोड स्वचालित रूप से उत्पन्न होते हैं।

वाहन कोड प्रारूप

डिफ़ॉल्ट: {PREFIX}-{YEAR}-{NNNN}, उदाहरण के लिए VH-2026-0001। सेटिंग्स → फ्लीट → वाहन कोड उपसर्ग पर कॉन्फ़िगर करें।

थोक आयात

1. वाहन पृष्ठ पर आयात दबाएँ।
2. एक्सेल टेम्प्लेट डाउनलोड करें.
3. डेटा भरें - आवश्यक कॉलम: license_plate, make, model, category_name।
4. फाइलें अपलोड करें।

क्यूआर कोड और त्वरित स्कैन

बनाए जाने पर प्रत्येक वाहन में स्वचालित रूप से एक क्यूआर कोड होता है। सार्वजनिक वाहन पृष्ठ खोलने के लिए स्कैन करें या लॉग इन ड्राइवरों के लिए ऐप में त्वरित कार्रवाई करें।

QR लेबल प्रिंट करें

• सिंगल लेबल: वाहन पर प्रिंटर आइकन पर क्लिक करें।
• बैच प्रिंटिंग: एकाधिक वाहनों का चयन करें → क्यूआर लेबल प्रिंट करें। A4 आकार, 2 लेबल/पंक्ति।

ऐप में स्कैन करें

वाहन पृष्ठ पर Scan QR पर क्लिक करें। कैमरे की अनुमति दें. HTTPS या लोकलहोस्ट वाले आधुनिक ब्राउज़र पर काम करता है।

सार्वजनिक कार पृष्ठ

प्रत्येक वाहन का /v/{vehicle_code} पर एक सार्वजनिक यूआरएल होता है - जो लॉग इन किए बिना त्वरित पहचान के लिए उपयोगी है।

• सेटिंग्स → फ्लीट → सार्वजनिक वाहन पेज पर कॉन्फ़िगर करें: सार्वजनिक, लॉगिन की आवश्यकता है या बंद।
• अतिथि मोड केवल बुनियादी जानकारी (लाइसेंस प्लेट, मेक/मॉडल) देखता है। त्वरित कार्रवाई के लिए लॉग इन करना आवश्यक है.
• APP_URL बदलने के बाद, सेटिंग्स में Regenerate all QR Code दबाएँ।

प्रक्रिया

एक कार का अनुरोध करें

कर्मचारी उपयोग के लिए वाहन के लिए अनुरोध भेजता है। स्ट्रीम: requested → approved → returned (या rejected)। बेड़े प्रबंधक या अनुमोदन विभाग के प्रमुख. कैलेंडर पूरे बेड़े के लिए वाहन आरक्षण प्रदर्शित करता है। विलंबित वाहन लौटाएँ और एक चेतावनी ईमेल भेजें।

कार सौंपना

1. जब अनुरोध स्वीकृत हो जाए, तो ड्राइवर द्वारा वाहन लेने से पहले Exit Handover बनाएं।
2. घड़ी रिकॉर्ड करें, चेकलिस्ट पूरी करें, 2डी आरेखों पर क्षति को चिह्नित करें, फ़ोटो और डिजिटल हस्ताक्षर संलग्न करें।
3. अपने रिकॉर्ड के लिए पीडीएफ डिलीवरी रिपोर्ट सहेजें और डाउनलोड करें।
4. वाहन वापस करते समय, हैंडओवर बनाएं - स्थिति की तुलना करें, मीटर अपडेट करें, ड्राइवर असाइनमेंट हटाएं।
5. इनबाउंड हैंडओवर पूरा करने पर रिक्विजिशन वापसी के रूप में चिह्नित होती है और वाहन उपलब्ध स्थिति में सेट होता है।

मूल्यह्रास और टीसीओ

फ्लीटहब तीन तरीकों में से एक का उपयोग करके वाहन मूल्यह्रास की गणना करता है। मूल्यह्रास को ईंधन और व्यय लॉग के साथ टीसीओ तालिका में शामिल किया गया है।

डिफ़ॉल्ट वाहन श्रेणी से प्राप्त होता है. current_value fleethub:update-vehicle-values के माध्यम से स्वयं को मासिक रूप से अपडेट करता है। टीसीओ = खरीद मूल्य + चयनित अवधि में वाहन की कुल लागत।

तटकर क्षेत्र

व्यवस्थापक → कस्टम फ़ील्ड वाहनों में असीमित संपत्तियाँ जोड़ने की अनुमति देते हैं:

• Type: टेक्स्ट, संख्या, दिनांक, चयन, टेक्स्टक्षेत्र, फ़ाइल, चेकबॉक्स
• स्कोप: सभी श्रेणियों या विशिष्ट वाहन श्रेणियों पर लागू होता है
• Arrange: ड्रैग-ड्रॉप हैंडल
• वाहन को सहेजते समय अनिवार्य फ़ील्ड की जाँच की जाती है

प्रतिवेदन

सात एकीकृत बेड़े रिपोर्ट, रिपोर्ट मेनू से पहुंच योग्य:

1. कुल TCO - वाहन और पूरे बेड़े द्वारा स्वामित्व की कुल लागत
2. मूल्यह्रास अनुसूची- वाहन द्वारा मूल्यह्रास, फ़ाइल निर्यात के साथ
3. रखरखाव लागत—वाहन, प्रकार और महीने के अनुसार खर्च
4. ईंधन की खपत और लागत—किमी/लीटर प्रवृत्ति, अनियमित अंकन
5. वाहन अनुरोध उपयोग—समय के साथ वाहन बुकिंग दर
6. अनुपालन की समाप्ति—वाहन दस्तावेज़ और चालक का लाइसेंस समाप्त होने वाला है
7. विभाग द्वारा वाहन आवंटन—विभाग द्वारा वाहन और उपयोग

सभी रिपोर्ट पृष्ठ के शीर्ष पर बटन के माध्यम से Excel और PDF निर्यात करने का समर्थन करती हैं।

वेबहुक एकीकरण

महत्वपूर्ण फ़्लीट इवेंट होने पर फ़्लीटहब बाहरी सेवाओं को सूचित कर सकता है।

उपलब्धता घटनाएँ

• vehicle.created, vehicle.updated, vehicle.deleted
• requisition.approved, requisition.rejected, requisition.overdue, requisition.returned
• handover.completed
• compliance.expiring, compliance.expired
• maintenance.due, maintenance.overdue, maintenance.completed
• fleet_health_score.dropped

पेलोड प्रारूप

{
  "event": "handover.completed",
  "timestamp": "2026-06-23T08:00:00+00:00",
  "data": {
    "vehicle_id": 1,
    "vehicle_code": "VH-2026-0001",
    "license_plate": "51A-12345",
    "handover_id": 12,
    "direction": "outgoing",
    "driver_id": 4
  }
}

हस्ताक्षर सत्यापित करें

यदि गुप्त के रूप में कॉन्फ़िगर किया गया है, तो अनुरोध में हेडर X-FleetHub-Signature है जिसमें मुख्य भाग का HMAC-SHA256 शामिल है। अपना पक्ष सत्यापित करें:

$expected = hash_hmac('sha256', $rawBody, $secret);
if (hash_equals($expected, $request->header('X-FleetHub-Signature'))) {
  // वैध
}

नीति पुनः प्रयास करें

डिलीवरी विफल हो जाती है और प्रत्येक 200 एमएस में 3 बार पुनः प्रयास किया जाता है। लगातार 10 विफलताओं के बाद, वेबहुक स्वयं बंद हो जाता है।

नियत कार्य

फ्लीटहब पृष्ठभूमि कार्यों के लिए लारवेल शेड्यूलर का उपयोग करता है। बस one क्रॉन - लारवेल प्रत्येक fleethub: कमांड को समय पर चलाता है।

साझा होस्टिंग (क्रॉन जॉब्स cPanel / Hostinger)

देखें cPanel इंस्टॉल करें → चरण 7 या होस्टिंगर इंस्टॉल करें → चरण 5। संक्षेप में: उन्नत → क्रॉन जॉब्स, कमांड:

/usr/bin/php /home/uXXXXXX/public_html/artisan schedule:run

कैलेंडर: हर मिनट (सभी पांच क्षेत्रों में *)।

cPanel क्रॉन कमांड

CPANELUSER को अपने cPanel उपयोगकर्ता नाम से बदलें:

/usr/local/bin/php /home/CPANELUSER/public_html/artisan schedule:run

वीपीएस/निजी सर्वर (क्रोंटैब)

वेब उपयोगकर्ता के साथ crontab -e चलाएँ और जोड़ें:

* * * * * cd /path/to/FleetHub && php artisan schedule:run >> /dev/null 2>&1

फ़ॉलबैक: बाहरी URL पिंग करें

यदि होस्ट के पास क्रॉन नहीं है, तो ऐप में क्रॉन यूआरएल (सेटिंग्स → सिस्टम) का उपयोग cron-job.org (निःशुल्क, हर 15 मिनट में) के साथ करें।

कार्य स्वचालित रूप से चलता है

अपग्रेड गाइड

FleetHub v1.0.0 CodeCanyon पर प्रारंभिक रिलीज़ है।

समस्या निवारण

भंडारण पर "अनुमति अस्वीकृत"।

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

क्यूआर स्कैनर कैमरा नहीं खोलता है

ब्राउज़र कैमरा एपीआई के लिए HTTPS की आवश्यकता होती है। परीक्षण करते समय एसएसएल स्थापित करें या localhost का उपयोग करें।

ईमेल प्राप्त नहीं हुआ

त्रुटियों के लिए storage/logs/laravel.log जाँचें। SMTP जानकारी की पुष्टि करने के लिए सेटिंग्स → ईमेल → टेस्ट ईमेल भेजें का उपयोग करें। सुनिश्चित करें कि एसएमटीपी सर्वर आईपी भेजने की अनुमति देता है।

cPanel पर डेटाबेस "एक्सेस अस्वीकृत" (1045)।

गलत उपयोगकर्ता/पासवर्ड, उपयोगकर्ता को डेटाबेस को असाइन नहीं किया गया है, या पासवर्ड में विशेष वर्ण दूषित .env हैं। देखें सीपीनल स्थापित करना→ सामान्य समस्याएं।

माइग्रेशन त्रुटि 1067 (अमान्य डिफ़ॉल्ट मान)

साझा होस्टिंग पर MySQL सख्त मोड एकाधिक timestamp NOT NULL कॉलम को अस्वीकार करता है। v2.1.0+ से ठीक किया गया। पैकेज को अपडेट करने या माइग्रेशन में yêu cầu xe_date / expected_return_date को dateTime में बदलने के लिए xes की आवश्यकता होती है।

APP_KEY अनुपलब्ध / स्थापना से पहले त्रुटि 500

ऐप चलने से पहले लारवेल को .env में APP_KEY की आवश्यकता होती है। यदि cPanel में टर्मिनल नहीं है, तो देखें cPanel इंस्टॉल करें → चरण 5 (SSH, genkey.php या PC पर बनाएं)।

सेटिंग्स फिर से करिए

storage/installed.lock हटाएं और /install दोबारा एक्सेस करें। यदि माइग्रेशन दोबारा चलाया जाता है तो मौजूदा डेटा हटा दिया जाएगा।

प्रदर्शन - धीमी कार सूची

php artisan optimize चलाएँ. सुनिश्चित करें कि MySQL इंडेक्स vehicles.vehicle_code, vehicles.license_plate, vehicles.status पर है।

लॉग बदलें

v1.0.0 — पहली रिलीज़ (2026-06)

• स्व-निर्मित क्यूआर कोड और सार्वजनिक पेज के साथ वाहन को सीआरयूडी करें /v/{vehicle_code}
• 5 भूमिकाएँ (एडमिन, फ्लीट मैनेजर, मैनेजर, अकाउंटेंट, ड्राइवर)
• ड्राइवरों को प्रबंधित करें, ड्राइवर के लाइसेंस की समाप्ति को अनुपालन अनुभाग के साथ सिंक्रनाइज़ करें
• शेड्यूल और अतिदेय अलर्ट के साथ वाहन अनुरोध प्रक्रिया
• वाहन को 2डी क्षति आरेख, चेकलिस्ट, हस्ताक्षर और पीडीएफ के साथ सौंपें
• ईंधन लॉग, एंटी-मीटर धोखाधड़ी, स्वचालित व्यय सिंक्रनाइज़ेशन
• लागत/किमी विश्लेषण के साथ वाहन लागत और टीसीओ तालिका
• मूल्यह्रास - सीधी रेखा, घटता हुआ संतुलन, उत्पादन की इकाइयाँ (किमी)
• आइटम 30/14/7/1 दिन की समाप्ति चेतावनी का अनुपालन करता है
• शेड्यूल रखरखाव, निवारक स्व-नवीनीकरण, ट्रैक लागत
• बेड़े का स्वास्थ्य स्कोर, दैनिक पुनर्गणना और विस्तृत मोडल
• 7 बेड़े रिपोर्ट, एक्सेल और पीडीएफ निर्यात
• वाहन श्रेणी के अनुसार कस्टम फ़ील्ड (7 प्रकार)।
• वेबहुक HMAC (X-FleetHub-Signature) पर हस्ताक्षर करें और पुनः प्रयास करें
• स्पैटी एक्टिविटीलॉग ऑडिट लॉग अंतर के साथ
• बहुभाषी यूआई: अरबी आरटीएल और हिंदी सहित 11 स्थान
• कंपनी, बेड़ा, ईमेल, अधिसूचना, अनुपालन पूर्व निर्धारित सेटिंग्स
• डेमो डेटा सीडर के साथ वेब इंस्टॉलर
• डार्क मोड, यूआई मोबाइल-फर्स्ट, अपलोड करते समय छवियों को संपीड़ित करें

टिप्पणी

ओपन सोर्स लाइब्रेरी का उपयोग किया गया

• Laravel 11 — MIT
• Vue 3 — MIT
• Inertia.js — MIT
• Tailwind CSS — MIT
• Spatie Permission, Media Library, Activitylog — MIT
• Phosphor Icons — MIT (duotone weight)
• ApexCharts — MIT
• html5-qrcode — Apache 2.0
• Simple QrCode — MIT
• Laravel Excel — MIT
• Laravel DomPDF — MIT