Usambishaji kwenye Shared Hosting (cPanel)
Store Console inapenda VPS (Docker au LEMP), lakini inaweza kukimbia kwenye shared host yenye uwezo unaohtosha. Shared hosting humaanishi hakuna ufikiaji wa root, MySQL ndio hutumika badala ya PostgreSQL kwa kawaida, hakuna Redis, wala hakuna michakato inayoendelea kwa muda mrefu — ukurasa huu unahusu hasa mabadiliko hayo.
Uwezo wa Minimum wa Hosti
- PHP 8.4 yenye extensions za kawaida za Laravel (wengi wa vichaguo vya PHP za cPanel huzijumuisha)
- MySQL 8.0+ au MariaDB 10.6+ (PostgreSQL inapendekea pale inapowekana)
- Kazi za cron (kila dakika moja angalau)
- Ufikiaji wa SSH unashauriwa kwa nguvu kwa
composernaartisan
Hatua ya 1: Pakua na Weka Document Root
Pakua na kutoa zip yako yenye leseni nje ya public_html, kisha onyesha document root ya (sub)domain kwenye public/ directory ya app kutoka cPanel → Domains. Usifichue kamwe application root yenyewe.
Hatua ya 2: Sanidi .env kwa Shared Hosting
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password
QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null
Drivers hizi zina kipaumbele: tables za queue, cache na session zinajumuisha katika migrations za default, hivyo Redis sio inahitajika.
Hatua ya 3: Hamisha na Jenga
php artisan migrate --seed
npm run build # or build locally and upload public/build
Hatua ya 4: Maingizo ya Cron (zinaletafuta Horizon na systemd)
Ongeza kazi mbili za cron cPanel → Cron Jobs:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
Kiingilio cha pili kinakila kila queue mara moja kwa dakika na kisha kinatoka, jambo salama kwa mipaka ya michakato ya shared host. Horizon na dashboard yake havitumikiwi kwenye shared hosting.
Kinachopungua — na Jinsi ya Kuchukua Hatua
- Vipengele vya AI za Kisemantiki (utafutaji wa vector, embeddings) vinahitaji PostgreSQL + pgvector — kwenye MySQL vinazimwa safi huku zana za AI chat, generation na report zinaendelea kufanya kazi kupitia provider uliyosanidiwa
- Mazungumzo ya Wakati Halisi na Arifa hutumia Reverb/WebSockets kwenye VPS — bila hivyo UI huingia kwa polling ya kipindi kwa njia (
BROADCAST_CONNECTION=null) - Kazi za Nyuma zinaweza kuendelea hadi dakika moja baada ya kukimbia kuliko dedicated worker — inakubalika kwa mail, invoices na reports; maduka makubwa yanapaswa kuhamia kwenye VPS
Wakati wa Kuhamia kwenye VPS
Hamia kwenye VPS unapowasha POS au usambishaji wa Delivery (unaotambua latency), unategemea AI search, au unashughulika na zaidi ya orders chache kwa dakika. Data yako itahamishwa kwa kutumia database dump ya kawaida — hakuna hitaji la kusanidi upya.

