https://github.com/cryptedsnow/waste-collection

Web application using Filament (codes in Portuguese).
https://github.com/cryptedsnow/waste-collection

docker filament mysql postgresql

Last synced: 2 months ago
JSON representation

Web application using Filament (codes in Portuguese).

Host: GitHub
URL: https://github.com/cryptedsnow/waste-collection
Owner: CryptedSnow
Created: 2025-04-07T23:53:11.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2026-04-12T13:23:00.000Z (2 months ago)
Last Synced: 2026-04-13T00:43:04.514Z (2 months ago)
Topics: docker, filament, mysql, postgresql
Language: PHP
Homepage:
Size: 2.51 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## Local machine

Follow the steps to set the application on your local machine.

1 - Run the ```composer install``` command to create ```vendor``` folder (Check the existence of `Composer` on your machine).
```
composer install
```

2 - Create ```.env``` file:
```
cp .env.example .env
```

3 - Generate crypted key (Fill ```APP_KEY=``` to ```.env``` file):
```
php artisan key:generate
```

4 - In `.env` file set the following snippet to connect the application to your database.
```
# MySQL
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=waste-collection
DB_USERNAME=root
DB_PASSWORD=

# PostgreSQL
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=waste-collection
DB_USERNAME=postgres
DB_PASSWORD=
```

Before you perfomate the migrations, go to [notifications](https://github.com/CryptedSnow/waste-collection/blob/main/database/migrations/2024_11_30_113525_create_notifications_table.php) table to make a change in a specific line, it will avoid errors involving notifications and database.

```
# MySQL
$table->text('data');

# PostgreSQL
$table->json('data');
```

5 - Run the migrations.
```
php artisan migrate
```

Case you want to use ```MySQL``` database, you can import this [file](https://github.com/CryptedSnow/waste-collection/tree/main/database/imports) (It's not necessary to use ```migrations``` and ```seeders```, don't do step 6 and 7, go ahead to step 8):

6 - Use the commands to perfomate the Seeders:
```
php artisan db:seed
```

7 - Run the following command to install JavaScript dependencies (Check the existence of `Node` and `NPM` on your machine).
```
npm install
```

8 - Run the following command to compile and optimize JavaScript files for production.
```
npm run build
```

9 - Run the following command to start Apache to run the application.
```
php artisan serve
```

With help of **Laravel Spatie** and **Multi-tenancy**, exist two roles user: **Admin**, **User** and many companies. Making certains roles user has more privileges than others, it is very important you run the seeds to those users be created.

Panels (Admin and User)
- Admin: http://127.0.0.1:8000/admin/login
- User: http://127.0.0.1:8000/user/login

```
Name: Jonathan Joestar
Email: jonathan.joestar@email.com
Password: 12345678
Role: Admin
Permission: Many permissions
Companies: Scarlet Overdrive
```

```
Name: Dio Brando
Email: dio.brando@email.com
Password: 12345678
Role: Admin, User
Permission: Many permissions
Companies: Tusk, Ball Breaker, The World
```

```
Name: Johnny Joestar
Email: johnny.joestar@email.com
Password: 12345678
Role: User
Permission: Many permissions
Companies: Tusk
```

```
Name: Gyro Zeppeli
Email: gyro.zeppeli@email.com
Password: 12345678
Role: User
Permission: Many permissions
Companies: Ball Breaker
```

```
Name: Diego Brando
Email: diego.brando@email.com
Password: 12345678
Role: User
Permission: Many permissions
Companies: The World
```

## Docker environment

Before run containers, you can choose PHP version of your preference (```8.0```,```8.1```,```8.2```,```8.3```,```8.4```). In ```docker-compose.yml``` to ```context``` change the version:

```
// Example: Change version to 8.0
context: ./docker/version
```

1 - Power on the containers:
```
docker-compose up -d
```

2 - Run the ```composer install``` command to create ```vendor``` folder:
```
docker-compose exec app composer install
```

3 - Create ```.env``` file:
```
docker-compose exec app cp .env.example .env
```

4 - Generate crypted key (Fill ```APP_KEY=``` to ```.env``` file):
```
docker-compose exec app php artisan key:generate
```

You can't maintain two databases working at same time, it's necessary choose.
```
# Avoid conflict to mysql phpmyadmin
docker-compose stop pgsql pgadmin

# Avoid conflict to pgsql pgadmin
docker-compose stop mysql phpmyadmin
```

Remember, before you change of database, run ```docker-compose down```, modify the ```.env``` file snippet to connect the application to database container and run ```docker-compose up -d``` again.

5 - In ```.env``` file set the following snippet to connect the application to database container from **Docker**:
```
# MySQL
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=waste-collection
DB_USERNAME=user
DB_PASSWORD=password

# PostgreSQL
DB_CONNECTION=pgsql
DB_HOST=pgsql
DB_PORT=5432
DB_DATABASE=waste-collection
DB_USERNAME=postgres
DB_PASSWORD=secret
```

```
# MySQL
$table->text('data');

# PostgreSQL
$table->json('data');
```

Case you want to use ```MySQL``` database, you can import this [file](https://github.com/CryptedSnow/waste-collection/tree/main/database/imports) (It is not necessary use ```migrations``` and ```seeders```, don't do step 6 and 7, go ahead to step 8):

6 - To performate the migrations, you need use the command:
```
docker-compose exec app php artisan migrate
```

7 - Use the commands to perfomate the Seeders:
```
docker-compose exec app php artisan db:seed
```

8 - Run the following command to install Javascript dependencies.
```
docker-compose exec app npm install
```

9 - Run the following command to compile and optimize JavaScript files for production.
```
docker-compose exec app npm run build
```

10 - To power off the containers before exit from application, use the command:

```
docker-compose down
```

The user credentials are the same, panels to Admin and User also, click here to see.

### Docker environment addresses
- phpMyAdmin: http://localhost:8081
- pgAdmin: http://localhost:5050
- User: `admin@admin.com`
- Password: `admin`

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/cryptedsnow/waste-collection

Awesome Lists containing this project

README