Administrative dashboard

Administrative dashboard made with PHP

The first version of the dashboard will be to serve VoIP enterprise customers.

There are 2 types of users: administrators and users associated with customers.

Users should log in to the system and view invoices and recording audios of all customers they have.

The project needs to be internationalized. Do not display any text to the user that cannot be translated.

Instructions to getting run

Make sure port 3306 and 80 are free.

Create .env file from .env.example Create docker-compose.yml file from docker-compose-example.yml

PS: If you don't use internal database, remove the db service.

In first time run:

docker-compose up
docker-compose down
docker-compose up

open http://localhost

Run in production

• Remove the mailhog service from docker-compose.yml
• Remove environment of xdebug from docker-compose.yml
• Remove instalation xdebug lines from .docker/php7/Dockerfile

Customize

Images

Look images in this folders and change:

• public/image/
• public/material/image/

Assets: CSS

NOTE: Read the concept first: https://laravel.com/docs/6.x/mix

Change the file public/material/scss/material-dashboard/variables/_brand.scss

using the vars from

• public/material/scss/material-dashboard/variables/_colors.scss
• public/material/scss/material-dashboard/bootstrap/scss/_variables.scss

If you want more CSS customizations, change the file resources/sass/app.scss

Invoice customizations:

• resources/sass/invoice.scss

After make all customizations, restart nodejs container to build assets:

docker-compose restart nodejs

Translation

Define the default locale in .env file changing the environment APP_LOCALE to default app locale.

If don't exist, create a json file following instructions from https://laravel.com/docs/6.x/localization

If there is a word that is used in more than one place and it must have different translations in each place, look for that word or phrase in the project and change the word or phrase in each place to be different and apply the translation to each of the sentences. created.

NOTE: When making a translation, please submit a pull request.

Contributing

Read the contributing file first.

Look the project issues and the tasks board