Development

.github/workflows/update-changelog.yml

@@ -0,0 +1,28 @@
+name: "Update Changelog"
+
+on:
+  release:
+    types: [released]
+
+jobs:
+  update:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          ref: main
+
+      - name: Update Changelog
+        uses: stefanzweifel/changelog-updater-action@v1
+        with:
+          latest-version: ${{ github.event.release.name }}
+          release-notes: ${{ github.event.release.body }}
+
+      - name: Commit updated CHANGELOG
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          branch: main
+          commit_message: Update CHANGELOG
+          file_pattern: CHANGELOG.md

README-contr.md

@@ -1 +1,10 @@
 todo
+
+
+
+```shell
+composer analyse
+composer test
+composer test-coverage
+composer format
+```

README-todo.md

@@ -0,0 +1,7 @@
+ - contract
+ - service
+ - trait
+ - config dosyası, status'ler, permissionlar, permiissoon policychecker
+ - publishler
+ - yetki konteolleri
+ - board

config/aissue.php

@@ -1,6 +1,14 @@
 <?php
 
 // config for AuroraWebSoftware/AIssue
-return [
 
+return [
+    'policyMethod' => fn ($permission): bool => true,
+    'issueTypes' => [
+        'task' => [
+            'todo' => ['sort' => 1, 'permission' => 'todo_perm'],
+            'in_progress' => ['sort' => 2, 'permission' => 'in_progress_perm'],
+            'done' => ['sort' => 3, 'permission' => 'done_perm'],
+        ],
+    ],
 ];

database/migrations/create_aissue_tables.php

@@ -6,40 +6,29 @@
 
 return new class extends Migration
 {
-    public function up()
+    public function up(): void
     {
         Schema::create('aissue_issues', function (Blueprint $table) {
             $table->bigIncrements('id');
-            $table->string('code')->nullable();
             $table->string('model_type');
-            $table->bigIncrements('model_id');
-            $table->bigIncrements('assignee_id');
-            $table->bigIncrements('creater_id');
-            $table->bigIncrements('issue_type_id');
+            $table->bigInteger('model_id');
+            $table->bigInteger('assignee_id');
+            $table->bigInteger('creater_id');
+            $table->string('issue_type');
             $table->string('summary');
-            $table->string('description');
-            $table->bigIncrements('priority');
+            $table->string('description')->nullable();
+            $table->bigInteger('priority')->default(1);
             $table->string('status');
-            $table->dateTime('duedate');
-            $table->boolean('archived');
-            $table->bigIncrements('archived_by');
-            $table->dateTime('archived_at');
+            $table->dateTime('duedate')->nullable();
+            $table->boolean('archived')->default(false);
+            $table->bigInteger('archived_by')->nullable();
+            $table->dateTime('archived_at')->nullable();
             $table->timestamps();
         });
-
-        Schema::create('aissue_issue_types', function (Blueprint $table) {
-            $table->bigIncrements('id');
-            $table->string('workflow');
-            $table->string('name');
-            $table->string('description');
-            $table->timestamps();
-        });
-
     }
 
-    public function down(){
+    public function down(): void
+    {
         Schema::dropIfExists('aissue_issues');
-        Schema::dropIfExists('aissue_issue_types');
     }
-
 };

docker-compose.yml

@@ -6,7 +6,7 @@ services:
     ports:
       - "33062:3306"
     volumes:
-      - ~/apps/mariadb-aissue:/var/lib/mysql
+      - ~/apps/mariadb-aissue2:/var/lib/mysql
     environment:
       - MYSQL_ROOT_PASSWORD=aissue
       - MYSQL_PASSWORD=aissue
@@ -17,4 +17,4 @@ networks:
     driver: bridge
     ipam:
       config:
-        - subnet: 172.16.57.0/24
+        - subnet: 172.16.54.0/24

phpstan.neon.dist

@@ -2,7 +2,7 @@ includes:
     - phpstan-baseline.neon
 
 parameters:
-    level: 4
+    level: 8
     paths:
         - src
         - config

src/AIssue.php

@@ -2,6 +2,64 @@
 
 namespace AuroraWebSoftware\AIssue;
 
+use AuroraWebSoftware\AIssue\Exceptions\TransitionPermissionException;
+
 class AIssue
 {
+    /**
+     * @param  array  $data
+     * @return Models\AIssue
+     */
+    public function createIssue(array $data): Models\AIssue
+    {
+        return Models\AIssue::create($data);
+    }
+
+    /**
+     * @param  Models\AIssue  $issue
+     * @param  string  $status
+     * @return bool
+     */
+    public function canMakeTransition(Models\AIssue $issue, string $status): bool
+    {
+        $permission = config('aissue')['issueTypes'][$issue->getIssueType()][$status]['permission'];
+        if (config('aissue')['policyMethod']($permission)) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * @param  Models\AIssue  $issue
+     * @param  string  $status
+     * @return Models\AIssue
+     *
+     * @throws TransitionPermissionException
+     */
+    public function makeTransition(Models\AIssue $issue, string $status): Models\AIssue
+    {
+        if ($this->canMakeTransition($issue, $status)) {
+            $issue->status = $status;
+            $issue->save();
+        }
+
+        throw new TransitionPermissionException();
+    }
+
+    /**
+     * @param  Models\AIssue  $issue
+     * @return array<string>
+     */
+    public function getTransitionableStatuses(Models\AIssue $issue): array
+    {
+        $statuses = [];
+        foreach (config('aissue')['issueTypes'][$issue->getIssueType()] as $index => $item) {
+            if ($this->canMakeTransition($issue, $index)) {
+                $statuses[] = $index;
+            }
+        }
+
+        return $statuses;
+    }
 }

src/AIssueServiceProvider.php

@@ -23,12 +23,14 @@ public function configurePackage(Package $package): void
         // ->hasCommand(AIssueCommand::class);
     }
 
-    public function boot()
+    public function boot(): void
     {
         parent::boot();
-
         // load packages migrations
-        $this->loadMigrationsFrom(__DIR__ . '/../database/migrations');
+        $this->loadMigrationsFrom(__DIR__.'/../database/migrations');
 
+        $this->publishes([
+            __DIR__.'/../config' => config_path(),
+        ], 'aissue-config');
     }
 }

src/Contracts/AIssueModelContract.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace AuroraWebSoftware\AIssue\Contracts;
+
+/**
+ * AIssueModelContract
+ */
+interface AIssueModelContract
+{
+    /**
+     * @param  string  $issueType
+     * @return string
+     */
+    public static function getAIssueDefaultStatus(string $issueType): string;
+
+    /**
+     * @return string
+     */
+    public static function getAIssueModelType(): string;
+
+    /**
+     * @return int
+     */
+    public function getAIssueModelId(): int;
+}

src/Exceptions/TransitionPermissionException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace AuroraWebSoftware\AIssue\Exceptions;
+
+use Illuminate\Auth\AuthenticationException;
+
+class TransitionPermissionException extends AuthenticationException
+{
+}

src/Exceptions/TransitionStatusNotFoundException.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace AuroraWebSoftware\AIssue\Exceptions;
+
+use Illuminate\Auth\AuthenticationException;
+
+class TransitionStatusNotFoundException extends AuthenticationException
+{
+}

src/Facades/AIssue.php

@@ -6,6 +6,11 @@
 
 /**
  * @see \AuroraWebSoftware\AIssue\AIssue
+ *
+ * @method static createIssue($data): \AuroraWebSoftware\AIssue\Models\AIssue
+ * @method static canMakeTransition(\AuroraWebSoftware\AIssue\Models\AIssue $issue, $status): bool
+ * @method static makeTransition(\AuroraWebSoftware\AIssue\Models\AIssue $issue, $status): \AuroraWebSoftware\AIssue\Models\AIssue
+ * @method static getTransitionableStatuses(\AuroraWebSoftware\AIssue\Models\AIssue $issue)
  */
 class AIssue extends Facade
 {

src/Models/AIssue.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace AuroraWebSoftware\AIssue\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * @property string $status
+ * @property-read string $issue_type
+ */
+class AIssue extends Model
+{
+    use HasFactory;
+
+    public $guarded = [];
+
+    protected $table = 'aissue_issues';
+
+    /**
+     * @return string
+     */
+    public function getIssueType(): string
+    {
+        return $this->issue_type;
+    }
+
+    /**
+     * @param  string  $status
+     * @return bool
+     */
+    public function canMakeTransition(string $status): bool
+    {
+        return \AuroraWebSoftware\AIssue\Facades\AIssue::canMakeTransition($this, $status);
+    }
+
+    /**
+     * @param  string  $status
+     * @return AIssue
+     */
+    public function makeTransition(string $status): AIssue
+    {
+        return \AuroraWebSoftware\AIssue\Facades\AIssue::makeTransition($this, $status);
+    }
+
+    /**
+     * @param  AIssue  $issue
+     * @return array
+     */
+    public function getTransitionableStatuses(AIssue $issue): array
+    {
+        return \AuroraWebSoftware\AIssue\Facades\AIssue::getTransitionableStatuses($this);
+    }
+}

src/Traits/AIssueModelTrait.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace AuroraWebSoftware\AIssue\Traits;
+
+use AuroraWebSoftware\AIssue\Facades\AIssue;
+use Illuminate\Support\Carbon;
+
+trait AIssueModelTrait
+{
+    /**
+     * @param  int  $assigneeId
+     * @param  int  $createrId
+     * @param  string  $issueType
+     * @param  string  $summary
+     * @param  string  $description
+     * @param  int  $priority
+     * @param  Carbon  $duedate
+     * @return \AuroraWebSoftware\AIssue\Models\AIssue
+     */
+    public function createIssue(
+        int $assigneeId,
+        int $createrId,
+        string $issueType,
+        string $summary,
+        string $description,
+        int $priority,
+        Carbon $duedate,
+    ): \AuroraWebSoftware\AIssue\Models\AIssue {
+        // todo issueType Kontrolü
+        // todo status yetki kontrolü
+
+        $data = [
+            'model_type' => static::getAIssueModelType(),
+            'model_id' => $this->getAIssueModelId(),
+            'assignee_id' => $assigneeId,
+            'creater_id' => $createrId,
+            'issue_type' => $issueType,
+            'summary' => $summary,
+            'description' => $description,
+            'priority' => $priority,
+            'status' => static::getAIssueDefaultStatus($issueType),
+            'duedate' => $duedate,
+        ];
+
+        return AIssue::createIssue($data);
+    }
+}