incadev/core

Core package implementing Incadev's business domain

v1.0.0 2025-11-01 13:11 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0||^12.0
• laravel/sanctum: ^4.2
• spatie/laravel-package-tools: ^1.16
• spatie/laravel-permission: ^6.22

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.0.0||^9.0.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• Jose Vasquez Ramos

• laravel
• core
• incadev

README

This package provides the single source of truth for the Incadev business domain, modeling the shared database schema, and Eloquent models. It ensures all projects built on this platform share the same data structure.

Requirements

• PHP ^8.2
• Laravel ^12.0

Installation

Installing this package is a multi-step process. Please follow these instructions carefully.

1. Install the Package

First, install the incadev/core package via Composer:

composer require incadev/core

2. Install Dependencies

This package relies on Laravel Sanctum and Spatie's Laravel-Permission. You must install and configure them first.

Publish Sanctum's configuration and migration

php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"

Publish Spatie/Permission's configuration and migration

php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"

3. Run Core Migrations

This package will add all core domain tables and modify your existing users table.

You must run the migrations:

php artisan migrate

4. Configure Your User Model

This is the most critical step. Your app/Models/User.php model must be updated to use the traits and fields provided by this package and its dependencies.

A. Add Traits

Import and use the HasIncadevCore, HasApiTokens, and HasRoles traits.

<?php

namespace App\Models;

// ...
use Illuminate\Foundation\Auth\User as Authenticatable;
use Laravel\Sanctum\HasApiTokens;        // <-- 1. Import Laravel Sanctum
use Spatie\Permission\Traits\HasRoles;   // <-- 2. Import Spatie Permission
use Incadev\Core\Traits\HasIncadevCore;  // <-- 3. Import Incadev Core

class User extends Authenticatable
{
    use // ...
        HasApiTokens,
        HasRoles,
        HasIncadevCore;                  // <-- 4. Use all traits

    // ...

B. Update $fillable Array

Our migration adds dni, fullname, avatar, and phone to your users table. You must add these to the $fillable array to allow mass assignment.

protected $fillable = [
    'name',
    'email',
    'password',
    
    // --- Add these new fields ---
    'dni',
    'fullname',
    'avatar',
    'phone',
    // ----------------------------
];

Usage

The primary purpose of this package is to provide a unified set of Eloquent models and traits.

Accessing Relations from the User

Once you have configured the HasIncadevCore trait on your User model, you can instantly access all related data:

$user = Auth::user();

// Get user profiles
$studentProfile = $user->studentProfile;
$teacherProfile = $user->teacherProfile;

// Get academic data
$enrollments = $user->enrollments;
$certificates = $user->certificates;

// Get community data
$threads = $user->threads;
$comments = $user->comments;

// Get support data
$tickets = $user->tickets;

// Get HR data
$contracts = $user->contracts;
$applications = $user->applications;

// Get appointments
$apptsAsStudent = $user->appointmentsAsStudent;
$apptsAsTeacher = $user->appointmentsAsTeacher;

Using Polymorphic Traits

This package provides powerful traits to add behavior to any model.

• CanBeAudited: Allows all actions on a model to be audited.
• CanBeRated: Allows a model to be rated using the core Survey system.
• CanBeVoted: Allows a model to be upvoted or downvoted.

Testing

composer test

Credits

• Jose Vasquez Ramos
• All Contributors

License

The MIT License (MIT). Please see License File for more information.