medigo

Medigo - Medical Management System

A modern medical management application built with Laravel 12, Vue.js 3, Inertia.js, Jetstream, Filament Admin Panel, and PostgreSQL.

🚀 Tech Stack

• Backend: Laravel 12
• Frontend: Vue.js 3 + Inertia.js
• Authentication: Laravel Jetstream + Fortify
• Admin Panel: Filament v4
• Database: PostgreSQL
• Build Tool: Vite 6
• Styling: Tailwind CSS

📋 Prerequisites

Before you begin, ensure you have the following installed on your system:

• PHP >= 8.2
• Composer (PHP package manager)
• Node.js >= 18.x and npm
• PostgreSQL >= 12
• Git

🔧 Installation

1. Clone the Repository

git clone <repository-url>
cd medigo

2. Install PHP Dependencies

composer install

3. Environment Configuration

Copy the .env.example file to .env:

cp .env.example .env

Generate the application key:

php artisan key:generate

4. Configure Database

Edit the .env file and update your PostgreSQL credentials:

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=medigo
DB_USERNAME=postgres
DB_PASSWORD=your_password

5. Create PostgreSQL Database

Connect to PostgreSQL and create the database:

psql -U postgres -c "CREATE DATABASE medigo;"

Or if you’re already in psql:

CREATE DATABASE medigo;

6. Run Database Migrations

php artisan migrate

This will create all necessary tables including:

• Users table (with Jetstream authentication)
• Sessions, cache, and jobs tables
• Two-factor authentication columns

7. Install Frontend Dependencies

npm install --legacy-peer-deps

🎯 Running the Application

Option 1: Run Both Servers Together (Recommended)

Start both Laravel and Vite dev server with a single command:

npm run start

This will start:

• Laravel server on http://127.0.0.1:8000
• Vite dev server for frontend assets

Option 2: Use Composer Dev Script

composer dev

This runs Laravel server, queue worker, logs, and Vite all together.

Option 3: Run Servers Separately

Terminal 1 - Laravel Server:

php artisan serve

Terminal 2 - Vite Dev Server:

npm run dev

👤 Creating Admin Users

Method 1: Using Artisan Command (Recommended)

php artisan make:filament-user

Follow the interactive prompts to create your admin user:

• Name
• Email
• Password
• Super admin status

Method 2: Using Tinker

php artisan tinker

Then run:

$user = \App\Models\User::create([
    'name' => 'Admin User',
    'email' => 'admin@example.com',
    'password' => bcrypt('password'),
]);
$user->email_verified_at = now();
$user->save();

🌐 Accessing the Application

• Admin Panel: http://127.0.0.1:8000/admin
• Root URL: http://127.0.0.1:8000/ (redirects to admin panel)

Log in with the credentials you created using one of the methods above.

📁 Project Structure

medigo/
├── app/
│   ├── Actions/              # Jetstream actions (user management)
│   ├── Filament/              # Filament admin resources, pages, widgets
│   ├── Http/
│   │   ├── Controllers/
│   │   └── Middleware/
│   ├── Models/
│   └── Providers/
│       └── Filament/          # Filament admin panel configuration
├── config/                    # Configuration files
├── database/
│   ├── migrations/           # Database migrations
│   └── seeders/              # Database seeders
├── public/                    # Public assets
├── resources/
│   ├── css/                   # CSS files
│   ├── js/                    # Vue.js components and pages
│   │   ├── Components/       # Reusable Vue components
│   │   ├── Layouts/          # Inertia layouts
│   │   └── Pages/            # Inertia pages
│   └── views/                # Blade templates (minimal, mainly for Inertia)
├── routes/
│   ├── web.php               # Web routes
│   └── api.php               # API routes
└── storage/                   # Storage for logs, cache, etc.

🎨 Admin Panel Features

The Filament admin panel includes:

• Light theme by default
• Full-width layout for better space utilization
• Dashboard with widgets
• User management (via Jetstream)
• Resource management (create your own resources in app/Filament/Admin/Resources)

🔐 Authentication

The application uses:

• Laravel Jetstream for authentication UI (Vue.js components)
• Laravel Fortify for authentication backend
• Laravel Sanctum for API token authentication
• Two-factor authentication support

🛠️ Development Commands

Build for Production

npm run build

Run Tests

php artisan test

Clear Caches

php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear

Code Formatting

composer pint

📝 Key Configuration Files

• .env - Environment variables
• config/database.php - Database configuration
• app/Providers/Filament/AdminPanelProvider.php - Filament admin panel settings
• vite.config.js - Vite build configuration
• tailwind.config.js - Tailwind CSS configuration

🐛 Troubleshooting

npm Permission Errors

sudo chown -R 501:20 "/Users/bindeshpandya/.npm"

Database Connection Issues

1. Verify PostgreSQL is running
2. Check .env database credentials
3. Ensure database exists: psql -U postgres -l

Vite Assets Not Loading

1. Ensure npm run dev is running
2. Check browser console for errors
3. Clear browser cache

Filament Panel Not Accessible

1. Verify user has canAccessPanel() returning true in User model
2. Check app/Providers/Filament/AdminPanelProvider.php is registered
3. Clear config cache: php artisan config:clear

📚 Additional Resources

• Laravel Documentation
• Vue.js Documentation
• Inertia.js Documentation
• Filament Documentation
• Jetstream Documentation

📄 License

This project is open-sourced software licensed under the MIT license.

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

Happy Coding! 🚀