Tabulation System for Miss Bato (Camarines Sur)

Here are the steps to set up the development environment for this project:

1. Download and install XAMPP and NodeJS, if you haven't already.

2. Start Apache and MySQL through XAMPP if not already running.

3. Clone or download this repository to your XAMPP htdocs folder. The final path should be path_to/xampp/htdocs/missbato.

4. Copy app/config/database.example.php to app/config/database.php, then modify the database connection settings in the new file.

5. Inside phpMyAdmin, create a MySQL database named missbato and import missbato.sql into it.

6. Open the terminal and navigate to the project directory missbato.

7. Execute the following commands to install the required dependencies:

   npm install

8. Compile and run the development server with hot reloading:

   npm run dev

9. Open your web browser and access http://localhost:5186/missbato/ to view the application.

This guide will walk you through the process of testing the backend models.

Before getting started, ensure that you have Composer installed.

1. Copy tests/backend/config/test-database.example.php to tests/backend/config/test-database.php, then modify the database connection settings in the new file.

2. Inside phpMyAdmin, create a MySQL database named test-missbato and import missbato.sql into it.

3. Run the following command to install the required dependencies.

   composer install

   If this command does not work, try running composer update instead.

To write your tests, simply add your Unit Tests to the tests/backend/unit directory and your Feature Tests to the tests/backend/feature directory.

1. Open a terminal window and navigate to the root directory of the project.

2. Run the following command to execute your tests:

   • all tests

   phpunit

   • unit tests only

   phpunit --testsuite unit

   • feature tests only

   phpunit --testsuite feature

   If phpunit command does not work, try running vendor\bin\phpunit instead.

Here's how to compile the project for production deployment:

1. Generate the public folder by running the following command:

   npm run build

2. Access the application by visiting http://[host_name]/missbato, where host_name is the IP address or host name of the server in the network. For example:

   • http://localhost/missbato
   • http://192.168.1.99/missbato

Access the admin dashboard at http://localhost/missbato/app. The default username and password is admin.

For printing results, click the print button in your browser or press CTRL + P, then properly set up the page for printing.

A blazing-fast dashboard inspired by bullet trains gikan sa Japan!

1. Download and run github.com/aclc-iriga/tabulation-ws.
2. Copy app/config/websocket.example.php to app/config/websocket.php. Then update the WebSocket server URL in the new config file.
3. Access localhost/missbato/app/dashboard