The Punjab Fisheries – Digital Transformation Platform is the official modernization project for the Punjab Fisheries Department, developed to enhance public access, streamline internal workflows, and integrate AI-powered services.
It includes:
- GIS-enabled maps for fishery resources
- AI chatbot & FAQ powered by KurmaAI/AQUA-7B via Hugging Face API
- Content management for news, services, and resources
- SEO automation for better reach
- Role-based admin panel for departmental operations
Repository: punjabfisheries.gov.pk
Production Target: https://punjabfisheries.gov.pk
- Modern Laravel Stack (Laravel 12.x, PHP 8.4)
- PostgreSQL / MySQL support
- Redis for caching, queues, and sessions
- TailwindCSS + Alpine.js + Axios for reactive UI
- RBAC via Spatie Laravel Permission
- Admin Dashboard CMS ready
- AI Chat & FAQ powered by Hugging Face OpenAI Deep Seek AI
- API-ready with Laravel Sanctum
- SEO Automation
- GIS Mapping support with optional PostGIS
| Layer | Technology |
|---|---|
| Backend | Laravel 12.x (PHP 8.4) |
| Frontend | TailwindCSS, Alpine.js, Axios |
| Database | PostgreSQL / MySQL Optional |
| Caching/Queue | Redis |
| Auth | Laravel Breeze (Blade) + Sanctum |
| RBAC | Spatie Laravel Permission |
| AI | Hugging Face API – KurmaAI/AQUA-7B |
| Build Tool | Vite |
| Hosting | Nginx + PHP-FPM + Redis |
# Clone repository
git clone https://github.com/skdevelopers/punjabfisheries.gov.pk.git
cd punjabfisheries.gov.pk
# Install PHP dependencies
composer install
# Install JS dependencies
npm install
# Copy env & set key
cp .env.example .env
php artisan key:generate
# Configure .env for DB, Redis, Hugging Face, Open AI, Deep Seek API
nano .env
# Run migrations & seed
php artisan migrate --seed
# Build frontend
npm run dev
# Serve
php artisan serve
💬 AI Chatbot
Create a Hugging Face account.
Create an Open AI account.
Create a Deep Seek AI account.
Generate an Access Token.
Set in .env:
env
HUGGINGFACE_API_TOKEN=hf_xxx
HUGGINGFACE_MODEL_ID=KurmaAI/AQUA-7B Or OPenAI API
Login and visit /chat to interact with the AI bot.
📍 Admin Panel
URL: /admin/dashboard (after login)
Default Roles: admin, staff, viewer
RBAC managed by Spatie Laravel Permission
🗺 GIS Support
Optional PostGIS integration:
Install PostGIS on your PostgreSQL server
Use Laravel spatial data types for maps
Integrate with Leaflet.js or Mapbox
🛡 Security
Uses Laravel Sanctum for API token authentication
CSRF protection enabled
Redis-backed sessions for better security
RBAC limits access to sensitive modules
📜 License
This project is licensed under the MIT License. See LICENSE for details.
👥 Credits
Punjab Fisheries Department – Project Owner
Lead Developer: Mian Salman (CTO, TeqTronics Systems)
AI Model: KurmaAI/AQUA-7B
Framework: Laravel