Readme.md

This is laravel project with inertiajs and reactjs
for authentication use inertia auth
Never update laravel default migration file
This is Open Source HRIS SAAS Project
Use Tailwind CSS for styling
Use shadcn ui for components
don't use axios we use inertiajs

Commit

Use conventional commit
Use commitlint
npm run lint first before commit
run vendor/bin/pint first before commit
Commit to gitlab and github
Update documentation first before commit

Handling Upload

Use Simple Excel from spatie https://github.com/spatie/simple-excel

Migration

scan schema first before create new migration
if possible merge migration avoid add column

Test

When run test check on factory associate with model
When run test check on controller associate with model
When run test check on view associate with model
When run test check on route associate with model
When run test check on middleware associate with model
When run test check on policy associate with model
When run test check on model associate with model
When run test check on database associate with model
When run test check on storage associate with model
When run test check on config associate with model
When run test check on package associate with model
use TestCase
don't use /** @test */ use #[Test] attribute instead
use PHPUnit\Framework\Attributes\Test;

Bug fixing

Create issue first before fix
Fix bug
check the issue till all check lists is checked
Close the issue

Organization

For Organization module hierarchy is company -> branch -> department -> division -> sub-division -> position -> level

Company Page
- Company can has multiple branches
- Company can has multiple brands
- user must have primary company
Branch Page
Department Page
Division Page
Sub-division Page
Position Page
Level Page
Brand Page
- user can associate with multiple brands

Employee

Rule

We don't use employees table, we use users -> user_details table. Employee is role
Employee must have company_id
One User can have multiple brands
One User can have multiple work schedules
One User can have one work shift in a day
We not use spatie permission we use role model instead
We don't use manager_id in application
Role use roles -> user_roles table because 1 users can have multiple roles
Employee Page

Documentation

I want to create documentaion for the application so please suggest what's best practice. The documentation is show markdown files from resources/docs folder
Because this is Open Source Base application someone can pull and install the application, so please add documentation on how to install the application.
If fresh install they should install the application set first company to be primary company.
Instalation must be step by step wizard

Input

Type username, password need autocomplete

Test

When run test check on factory associate with model

When run test check on controller associate with model

When run test check on view associate with model

When run test check on route associate with model

When run test check on middleware associate with model

When run test check on policy associate with model

When run test check on model associate with model

When run test check on database associate with model

When run test check on storage associate with model

When run test check on config associate with model

When run test check on package associate with model

use TestCase

don't use /** @test */ use #[Test] attribute instead

use PHPUnit\Framework\Attributes\Test;

Rule

We don't use employees table, we use users -> user_details table. Employee is role

Employee must have company_id

One User can have multiple brands

One User can have multiple work schedules

One User can have one work shift in a day

We not use spatie permission we use role model instead

We don't use manager_id in application

Role use roles -> user_roles table because 1 users can have multiple roles

Employee Page

Documentation

I want to create documentaion for the application so please suggest what's best practice. The documentation is show markdown files from resources/docs folder

Because this is Open Source Base application someone can pull and install the application, so please add documentation on how to install the application.

If fresh install they should install the application set first company to be primary company.

Instalation must be step by step wizard

Readme.md

Readme.md

Commit

Handling Upload

Migration

Test

Bug fixing

Organization

For Organization module hierarchy is company -> branch -> department -> division -> sub-division -> position -> level

Employee

Rule

Documentation

Input

Related Skills

Markdown Converter

Nano Banana Pro

1password

Readme.md

Commit

Handling Upload

Migration

Test

Bug fixing

Organization

For Organization module hierarchy is company -> branch -> department -> division -> sub-division -> position -> level

Employee

Rule

Documentation

Input