refactor: application

Author: mahatmamahardhikach

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[docker-compose.yml]
+indent_size = 4

.env.example

@@ -0,0 +1,64 @@
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_TIMEZONE=UTC
+APP_URL=http://localhost
+
+APP_LOCALE=en
+APP_FALLBACK_LOCALE=en
+APP_FAKER_LOCALE=en_US
+
+APP_MAINTENANCE_DRIVER=file
+APP_MAINTENANCE_STORE=database
+
+BCRYPT_ROUNDS=12
+
+LOG_CHANNEL=stack
+LOG_STACK=single
+LOG_DEPRECATIONS_CHANNEL=null
+LOG_LEVEL=debug
+
+DB_CONNECTION=sqlite
+# DB_HOST=127.0.0.1
+# DB_PORT=3306
+# DB_DATABASE=laravel
+# DB_USERNAME=root
+# DB_PASSWORD=
+
+SESSION_DRIVER=database
+SESSION_LIFETIME=120
+SESSION_ENCRYPT=false
+SESSION_PATH=/
+SESSION_DOMAIN=null
+
+BROADCAST_CONNECTION=log
+FILESYSTEM_DISK=local
+QUEUE_CONNECTION=database
+
+CACHE_STORE=database
+CACHE_PREFIX=
+
+MEMCACHED_HOST=127.0.0.1
+
+REDIS_CLIENT=phpredis
+REDIS_HOST=127.0.0.1
+REDIS_PASSWORD=null
+REDIS_PORT=6379
+
+MAIL_MAILER=log
+MAIL_HOST=127.0.0.1
+MAIL_PORT=2525
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="[email protected]"
+MAIL_FROM_NAME="${APP_NAME}"
+
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=us-east-1
+AWS_BUCKET=
+AWS_USE_PATH_STYLE_ENDPOINT=false
+
+VITE_APP_NAME="${APP_NAME}"

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto eol=lf
+
+*.blade.php diff=html
+*.css diff=css
+*.html diff=html
+*.md diff=markdown
+*.php diff=php
+
+/.github export-ignore
+CHANGELOG.md export-ignore
+.styleci.yml export-ignore

.husky/commit-msg

@@ -0,0 +1,9 @@
+#!/bin/sh
+if ! head -1 "$1" | grep -qE "^(feat|fix|chore|docs|test|style|refactor|perf|build|ci|revert)(\(.+?\))?: .{1,}$"; then
+    echo "Aborting commit. Your commit message is invalid." >&2
+    exit 1
+fi
+if ! head -1 "$1" | grep -qE "^.{1,88}$"; then
+    echo "Aborting commit. Your commit message is too long." >&2
+    exit 1
+fi

.husky/pre-commit

@@ -0,0 +1,37 @@
+# Code of Conduct
+
+## Introduction
+
+In the interest of fostering an open, welcoming, and respectful community, we pledge to respect all contributors and maintainers of the HRIS by Programing Live Community project.
+
+This Code of Conduct applies to all community spaces, including GitHub, mailing lists, issue trackers, and any other forums created by the community, used for or to communicate about the project.
+
+## Expected Behavior
+
+We expect all members of our community to:
+
+- Use welcoming and inclusive language
+- Be respectful of differing viewpoints and experiences
+- Gracefully accept constructive criticism
+- Focus on what is best for the community
+- Show empathy towards other community members
+
+## Unacceptable Behavior
+
+Examples of unacceptable behavior include:
+
+- The use of serialized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Any other conduct that could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances.
+
+Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

CODE_OF_CONDUCT.md

@@ -0,0 +1,34 @@
+# Contributing Guidelines
+
+Hello! We're really excited that you are interested in contributing to HRIS by Programing Live Community. Before you start, please take the time to read these guidelines. They will give you the direction you need to get started on contributing effectively and efficiently.
+
+## Code of Conduct
+
+We have adopted a Code of Conduct that we expect all contributors and maintainers to uphold. Please read the [Code of Conduct](CODE_OF_CONDUCT.md) before you start contributing.
+
+## Getting Started
+
+- Ensure you have the latest version of PHP, SQLite and Laravel setup properly on your development machine.
+- Fork the repository on GitHub.
+- Clone the forked repository to your machine.
+
+## Submitting Changes
+
+- Create a new branch for each issue you're working on. Ensure the branch name clearly related to the issue at hand.
+- Write clear, concise commit messages that explain the changes.
+- Ensure your changes do not break any existing functionality.
+
+## Submitting A Pull Request
+
+- Push your changes to your forked repository.
+- Create a new pull request and reference the issue number in the pull request message.
+
+## Reporting A Bug
+
+If you find a bug, please create an issue in our repository on GitHub. Describe the problem with as many details as possible.
+
+## Proposing Features
+
+We welcome ideas for project enhancements. If you have an idea for a new feature, please create an issue providing as much detail as possible.
+
+Thank you for your interest in contributing to HRIS by Programing Live Community. We look forward to your involvement!

CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# HRIS By ProgramingLive Community
+
+Welcome to our community-driven Human Resource Information System (HRIS) project.
+This open-source project is initiated and actively maintained by the Programing Live Community.
+
+## Overview
+
+Our HRIS solution is designed to support multiple tenants,
+allowing different organizations
+to manage their respective human resource requirements in isolated instances within the same HRIS.
+This improves the utility and efficiency of our system,
+making it a suitable choice for software service providers, organizational franchises,
+large scale corporations with semi-independent branches, and more.
+
+<details>
+<summary>Minimum Viable Product (MVP)</summary>
+
+The primary feature set we aim to achieve for our MVP includes:
+
+1. **Company Registration:** Companies need to be able to register themselves to use this application. This process would involve providing company details, setting up an administrator account, and agreeing to any applicable terms and conditions. Once registered, the company should have its own isolated space within the application to operate independently.
+2. **Sister Company Management:** Aside from operating their own space, registered companies should be able to add and manage sister companies within their system. This facilitates centralized HR management for business conglomerates or franchises having multiple sister companies.
+
+</details>
+
+## Features
+
+- Employee Management: Manage all details of your employees in one place.
+- Payroll System: Seamless payroll process with accurate computations.
+- Recruitment: Streamlined hiring process from job posting to onboarding.
+- Training: Keep track of employee training and professional development.
+- Compliance: Ensure your organization is compliant with labor laws and regulations.
+
+## Getting Started
+
+To get started contributing to this project, please see the [CONTRIBUTING.md](CONTRIBUTING.md) guide.
+
+## Tech Stack
+
+This project uses various technologies:
+
+- PHP 8.2 with Laravel Framework v11.10.0
+- Laravel Livewire for real-time interfaces
+- SQLite for database
+- PHPUnit for testing
+- Various Composer and JavaScript packages
+
+## Installation Instructions
+
+Make sure you have PHP, Composer, Node.js and Yarn installed on your machine before starting the installation.
+
+```shell
+# Clone the repository using git
+git clone https://github.com/programinglive/hris.git
+# Navigate into the directory
+cd hris
+# Install PHP dependencies with Composer
+composer install
+# Install Node.js dependencies with Yarn
+yarn install
+# Copy .env.example file to .env
+cp .env.example .env
+# Generate a fresh app key
+php artisan key:generate
+# Run the database migrations and seeders
+php artisan migrate --seed
+# Compile the frontend assets
+yarn dev
+# Serve the application
+php artisan serve
+```
+
+The application should now be running at `http://localhost:8000`.
+
+## User Testing
+```
+Username: [email protected]
+Password: hrisproject
+```
+
+## Contributions
+
+We value your contributions!
+Whether it's a bug report, new feature, correction, or additional documentation, we greatly appreciate any improvements.
+
+We hope you enjoy exploring our project, and we're excited to have you here!
+
+## License
+
+This project is licensed under the MIT License.

README.md

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+
+class SetDeleted extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'app:set-deleted {model}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Command description';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): void
+    {
+        $model = $this->argument('model');
+        $model = app('App\Models\\' . ucfirst($model) );
+
+        $models = $model->withTrashed()->get();
+        
+        foreach($models as $data) {
+            if($data->deleted_at){
+                $data->code = $data->code . '-deleted-';
+                $data->save();
+                $this->info($data->code . ' deleted');
+            }
+        }
+
+    }
+}

app/Console/Commands/SetDeleted.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Console;
+
+use Illuminate\Console\Scheduling\Schedule;
+use Illuminate\Foundation\Console\Kernel as ConsoleKernel;
+
+class Kernel extends ConsoleKernel
+{
+    /**
+     * Define the application's command schedule.
+     */
+    protected function schedule(Schedule $schedule): void
+    {
+        // $schedule->command('inspire')->hourly();
+    }
+
+    /**
+     * Register the commands for the application.
+     */
+    protected function commands(): void
+    {
+        $this->load(__DIR__.'/Commands');
+
+        require base_path('routes/console.php');
+    }
+}

app/Console/Kernel.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Exceptions;
+
+use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
+use Throwable;
+
+class Handler extends ExceptionHandler
+{
+    /**
+     * The list of the inputs that are never flashed to the session on validation exceptions.
+     *
+     * @var array<int, string>
+     */
+    protected $dontFlash = [
+        'current_password',
+        'password',
+        'password_confirmation',
+    ];
+
+    /**
+     * Register the exception handling callbacks for the application.
+     */
+    public function register(): void
+    {
+        $this->reportable(function (Throwable $e) {
+            //
+        });
+    }
+}