Merge branch 'announcement-backend' into 'development'

Announcement backend See merge request CIEFWorldwideSdnBhd/shipping-portal!92
2026-08-21 13:34:08 +00:00 · 2021-12-19 05:19:09 +00:00
parent 4a7c4f51a5 624df67ca5
commit 12a51722b3
33 changed files with 1295 additions and 0 deletions
@@ -0,0 +1,61 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+
+use App\Classes\Modules\Announcements\Services\FetchesAnnouncement;
+use App\Classes\Modules\Announcements\Processors\AssignAnnouncementToSegmentProcessor;
+
+use App\Http\Resources\AnnouncementResource;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AssignAnnouncementToSegmentLogic extends AbstractControllerLogic
+{
+
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Assign Announcement To Segment',
+            'message' => 'You have successfully assigned Announcement to segment'
+        ];
+    }
+
+    /** @var FetchesAnnouncement */
+    private $fetchesAnnouncement;
+
+    /** @var AssignAnnouncementToSegmentProcessor */
+    private $assignAnnouncementToSegmentProcessor;
+
+    /**
+     * AssignAnnouncementToSegmentLogic constructor.
+     * @param FetchesAnnouncement $fetchesAnnouncement
+     * @param AssignAnnouncementToSegmentProcessor $assignAnnouncementToSegmentProcessor
+     */
+    public function __construct(FetchesAnnouncement $fetchesAnnouncement, AssignAnnouncementToSegmentProcessor $assignAnnouncementToSegmentProcessor)
+    {
+        $this->fetchesAnnouncement = $fetchesAnnouncement;
+        $this->assignAnnouncementToSegmentProcessor = $assignAnnouncementToSegmentProcessor;
+    }
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+        $announcement = $this->fetchesAnnouncement->execute(['id' => $request->route('id')]);
+
+        $this->assignAnnouncementToSegmentProcessor->execute($announcement, $request->input('segment_id'));
+
+        return $this->resourceResponse(new AnnouncementResource($announcement));
+    }
+}
@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+use App\Classes\Modules\Announcements\Standards\Rules\CanCreateAnnouncement;
+use App\Classes\Modules\Announcements\Services\CreatesAnnouncement;
+use App\Classes\Modules\Announcements\Processors\AssignAnnouncementToSegmentProcessor;
+
+use App\Http\Resources\AnnouncementResource;
+
+use ErrorException;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CreateAnnouncementLogic extends AbstractControllerLogic
+{
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Created Annoucement',
+            'message' => 'You have successfully created a new Annoucements'
+        ];
+    }
+
+    /** @var CanCreateAnnouncement */
+    private $canCreateAnnouncement;
+
+    /** @var CreatesAnnoucement */
+    private $createsAnnoucement;
+
+    /** @var AssignAnnouncementToSegmentProcessor */
+    private $assignAnnouncementToSegmentProcessor;
+
+
+    /**
+     * CreateAnnouncementLogic constructor.
+     * @param CanCreateAnnoucement $canCreateAnnoucement
+     * @param CreatesAnnoucement $createsAnnoucement
+     * @param AssignAnnouncementToSegmentProcessor $assignAnnouncementToSegmentProcessor
+     */
+    public function __construct(
+        CanCreateAnnouncement $canCreateAnnouncement,
+        CreatesAnnouncement $createsAnnoucement,
+        AssignAnnouncementToSegmentProcessor $assignAnnouncementToSegmentProcessor
+    ) {
+        $this->canCreateAnnouncement = $canCreateAnnouncement;
+        $this->createsAnnoucement = $createsAnnoucement;
+        $this->assignAnnouncementToSegmentProcessor = $assignAnnouncementToSegmentProcessor;
+    }
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+        $annoucement_object = new AnnouncementObject(
+            $request->input('title'),
+            $request->input('description'),
+            $request->input('starting_on'),
+            $request->input('ending_on')
+        );
+
+        $this->canCreateAnnouncement->passes($annoucement_object);
+
+        $announcement = $this->createsAnnoucement->execute($annoucement_object);
+
+        $this->assignAnnouncementToSegmentProcessor->execute($announcement);
+
+        return $this->resourceResponse(new AnnouncementResource($announcement));
+    }
+}
@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+
+use App\Classes\Modules\Announcements\Standards\Rules\CanDeleteAnnouncement;
+use App\Classes\Modules\Announcements\Services\FetchesAnnouncement;
+use App\Classes\Modules\Announcements\Services\DeletesAnnouncement;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class DeleteAnnouncementLogic extends AbstractControllerLogic
+{
+
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Delete Announcement',
+            'message' => 'You have successfully deleted the Announcement'
+        ];
+    }
+
+    /** @var CanDeleteAnnouncement */
+    private $canDeleteAnnouncement;
+
+    /** @var FetchesAnnouncement */
+    private $fetchesAnnouncement;
+
+    /** @var DeletesAnnouncement */
+    private $deletesAnnouncement;
+
+    /**
+     * DeleteAnnouncementLogic constructor.
+     * @param CanDeleteAnnouncement $canDeleteAnnouncement
+     * @param FetchesAnnouncement $fetchesAnnouncement
+     * @param DeletesAnnouncement $deletesAnnouncement
+     */
+    public function __construct(
+        CanDeleteAnnouncement $canDeleteAnnoucement,
+        FetchesAnnouncement $fetchesAnnoucement,
+        DeletesAnnouncement $deletesAnnoucement
+    ) {
+        $this->canDeleteAnnoucement = $canDeleteAnnoucement;
+        $this->fetchesAnnoucement = $fetchesAnnoucement;
+        $this->deletesAnnoucement = $deletesAnnoucement;
+    }
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+
+        $this->canDeleteAnnoucement->passes();
+
+        $annoucement = $this->fetchesAnnoucement->execute(['id' => $request->route('id')]);
+
+        $this->deletesAnnoucement->execute($annoucement);
+
+        return $this->response([]);
+    }
+}
@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+use App\Classes\Modules\Announcements\Services\ListsAnnouncements;
+use App\Classes\Modules\Announcements\Standards\Rules\CanListAnnouncements;
+use App\Http\Resources\AnnouncementResource;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ListAnnouncementsLogic extends AbstractControllerLogic
+{
+
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Retrieve Announcements',
+            'message' => 'You have successfully retrieved a list of Announcements'
+        ];
+    }
+
+    /** @var CanListAnnouncements */
+    private $canListAnnouncements;
+
+    /** @var ListsAnnouncements */
+    private $listsAnnouncements;
+
+    /**
+     * ListAnnouncementsLogic constructor.
+     * @param CanListAnnouncements $canListAnnouncements
+     * @param ListsAnnouncements $listsAnnouncements
+     */
+    public function __construct(CanListAnnouncements $canListAnnouncements, ListsAnnouncements $listsAnnouncements)
+    {
+        $this->canListAnnouncements = $canListAnnouncements;
+        $this->listsAnnouncements = $listsAnnouncements;
+    }
+
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+
+        $this->canListAnnouncements->passes();
+
+        $annoucements = $this->listsAnnouncements->execute($this->listsAnnouncements->deserializeFilters($request->input('filters')));
+
+        return $this->collectionResponse(AnnouncementResource::collection($annoucements));
+    }
+}
@@ -0,0 +1,68 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+
+use App\Classes\Modules\Announcements\Services\FetchesAnnouncement;
+use App\Classes\Modules\Segments\Services\FetchesSegment;
+use App\Classes\Modules\Announcements\Services\RemovesAnnouncementFromSegment;
+
+use App\Http\Resources\AnnouncementResource;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class RemoveSegmentFromAnnouncementLogic extends AbstractControllerLogic
+{
+
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Detach Announcement From Segment',
+            'message' => 'You have successfully detached Announcement from segment'
+        ];
+    }
+
+    /** @var FetchesAnnouncement */
+    private $fetchesAnnnouncement;
+
+    /** @var FetchesSegment */
+    private $fetchesSegment;
+
+    /** @var RemovesAnnouncementFromSegment */
+    private $removesAnnouncementFromSegment;
+
+    /**
+     * RemoveSegmentFromAnnouncementLogic constructor.
+     * @param FetchesAnnouncement $fetchesAnnnouncement
+     * @param FetchesSegment $fetchesSegment
+     * @param RemovesAnnouncementFromSegment $removesAnnouncementFromSegment
+     */
+    public function __construct(FetchesAnnouncement $fetchesAnnnouncement, FetchesSegment $fetchesSegment, RemovesAnnouncementFromSegment $removesAnnouncementFromSegment)
+    {
+        $this->fetchesAnnnouncement = $fetchesAnnnouncement;
+        $this->fetchesSegment = $fetchesSegment;
+        $this->removesAnnouncementFromSegment = $removesAnnouncementFromSegment;
+    }
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+
+        $announcement = $this->fetchesAnnnouncement->execute(['id' => $request->route('id')]);
+
+        $segment = $this->fetchesSegment->execute(['id' => $request->route('segment_id')]);
+
+        $this->removesAnnouncementFromSegment->execute($announcement, $segment);
+
+        return $this->resourceResponse(new AnnouncementResource($announcement));
+    }
+}
@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\ControllersLogic;
+
+use App\Classes\General\Abstracts\AbstractControllerLogic;
+
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+use App\Classes\Modules\Announcements\Standards\Rules\CanUpdateAnnouncement;
+use App\Classes\Modules\Announcements\Services\FetchesAnnouncement;
+use App\Classes\Modules\Announcements\Services\UpdatesAnnouncement;
+
+use App\Http\Resources\AnnouncementResource;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+
+class UpdateAnnouncementLogic extends AbstractControllerLogic
+{
+
+    /**
+     * @return array
+     */
+    protected function notification(): array
+    {
+        return [
+            'title' => 'Update Announcement',
+            'message' => 'You have successfully updated the Announcement'
+        ];
+    }
+
+    /** @var CanUpdateAnnouncement */
+    private $canUpdateAnnouncement;
+
+    /** @var FetchesAnnouncement */
+    private $fetchesAnnouncement;
+
+    /** @var UpdatesAnnouncement */
+    private $updatesAnnouncement;
+
+    /**
+     * UpdateAnnouncementLogic constructor.
+     * @param CanUpdateAnnouncement $canUpdateAnnouncement
+     * @param FetchesAnnouncement $fetchesAnnouncement
+     * @param UpdatesAnnouncement $updatesAnnouncement     
+     */
+    public function __construct(
+        CanUpdateAnnouncement $canUpdateAnnouncement,
+        FetchesAnnouncement $fetchesAnnouncement,
+        UpdatesAnnouncement $updatesAnnouncement        
+    ) {
+        $this->canUpdateAnnouncement = $canUpdateAnnouncement;
+        $this->fetchesAnnouncement = $fetchesAnnouncement;
+        $this->updatesAnnouncement = $updatesAnnouncement;        
+    }
+
+    /**
+     * @param Request $request
+     * @return JsonResponse
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function logic(Request $request): JsonResponse
+    {
+        $annoucement_object = new AnnouncementObject(
+            $request->input('title'),
+            $request->input('description'),
+            $request->input('starting_on'),
+            $request->input('ending_on')
+        );
+
+        $this->canUpdateAnnouncement->passes($annoucement_object);
+
+        $annoucement = $this->fetchesAnnouncement->execute(['id' => $request->route('id')]);
+
+        $announcement_query = $this->updatesAnnouncement->execute($annoucement, $annoucement_object);
+
+        //$announcement_query->segments()->sync($request->input('segment_id'));
+
+        return $this->resourceResponse(new AnnouncementResource($announcement_query));
+    }
+}
@@ -0,0 +1,73 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\DataTransferObjects;
+
+use App\Classes\General\Interfaces\DataTransferObject;
+use Carbon\Carbon;
+
+class AnnouncementObject implements DataTransferObject
+{
+
+    /** @var string */
+    private $title;
+
+    /** @var string */
+    private $description;
+
+    /** @var string */
+    private $starting_on;
+
+    /** @var string */
+    private $ending_on;
+
+
+    /**
+     * AnnouncementObject constructor.
+     * @param string $title
+     * @param string $description
+     * @param string $start_date
+     * @param string $end_date
+     */
+
+    public function __construct(string $title, string $description, string $starting_on, string $ending_on)
+    {
+        $this->title = $title;
+        $this->description = $description;
+        $this->starting_on = $starting_on;
+        $this->ending_on = $ending_on;
+    }
+
+    /**
+     * @return string
+     */
+    public function getTitle(): string
+    {
+        return $this->title;
+    }
+
+    /**
+     * @return string
+     */
+    public function getDescription(): string
+    {
+        return $this->description;
+    }
+
+    /**
+     * @return Carbon
+     */
+    public function getStartingOn(): Carbon
+    {
+//        return $this->starting_on;
+        return Carbon::parse($this->starting_on);
+    }
+
+    /**
+     * @return Carbon
+     */
+    public function getEndingOn(): Carbon
+    {
+//        return $this->ending_on;
+        return Carbon::parse($this->ending_on);
+    }
+}
@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Processors;
+
+use App\Classes\Modules\Announcements\Services\AssignsAnnouncementToSegment;
+use App\Classes\Modules\Announcements\Standards\Rules\CanAssignSegment;
+use App\Classes\Modules\Segments\Services\FetchesSegment;
+use App\Classes\ValueObjects\Constants\SegmentConstants;
+use App\Models\Announcement;
+use Illuminate\Database\Eloquent\Model;
+
+class AssignAnnouncementToSegmentProcessor
+{
+
+    /** @var CanAssignSegment */
+    private $canAssignSegment;
+
+    /** @var FetchesSegment */
+    private $fetchesSegment;
+
+    /** @var AssignAnnouncementToSegment */
+    private $assignsAnnouncementToSegment;
+
+
+
+    /**
+     * AssignAnnouncementToSegmentProcessor constructor.
+     * @param CanAssignSegment $canAssignSegment
+     * @param AssignAnnouncementToSegment $assignsAnnouncementToSegment
+     * @param FetchesSegment $fetchesSegment
+     */
+    public function __construct(CanAssignSegment $canAssignSegment, FetchesSegment $fetchesSegment, AssignsAnnouncementToSegment $assignsAnnouncementToSegment)
+    {
+        $this->canAssignSegment = $canAssignSegment;
+        $this->assignsAnnouncementToSegment = $assignsAnnouncementToSegment;
+        $this->fetchesSegment = $fetchesSegment;
+    }
+
+
+    /**
+     * @param Announcement $announcement
+     * @param int|null $segmentId
+     * @return Model
+     * @throws \App\Classes\Exceptions\AccessForbiddenException
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    public function execute(Announcement $announcement, ?int $segmentId = SegmentConstants::STANDARD_SEGMENT): Model
+    {
+        $this->canAssignSegment->passes();
+
+        $segment = $this->fetchesSegment->execute(['id' => $segmentId]);
+
+        return $this->assignsAnnouncementToSegment->execute($announcement, $segment);
+    }
+}
@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\Exceptions\MalformedRequestException;
+use App\Classes\General\Eloquent\AbstractUpdateRecord;
+use App\Models\Announcement;
+use App\Models\Segment;
+use Illuminate\Database\QueryException;
+
+class AssignsAnnouncementToSegment extends AbstractUpdateRecord
+{
+    /**
+     * @param Announcement $announcement
+     * @param Segment $segment
+     * @return \Illuminate\Database\Eloquent\Model
+     * @throws MalformedRequestException
+     */
+    public function execute(Announcement $announcement, Segment $segment)
+    {
+        try {
+
+            $announcement->segments()->attach($segment);
+
+            return $announcement;
+
+        } catch (QueryException $exception){
+            throw new MalformedRequestException($exception);
+        }
+
+
+    }
+}
@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\General\Eloquent\AbstractUpdateRecord;
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+use App\Models\Announcement;
+
+class CreatesAnnouncement extends AbstractUpdateRecord
+{
+    /**
+     * @param AnnouncementObject $object
+     * @return \Illuminate\Database\Eloquent\Model
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     */
+    public function execute(AnnouncementObject $object)
+    {
+        $model = new Announcement();
+        $model->title = $object->getTitle();
+        $model->description = $object->getDescription();
+        $model->starting_on = $object->getStartingOn();
+        $model->ending_on = $object->getEndingOn();
+
+        return $this->handler($model);
+    }
+}
@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\General\Eloquent\AbstractDeleteRecord;
+use App\Models\Announcement;
+
+class DeletesAnnouncement extends AbstractDeleteRecord
+{
+
+    /**
+     * @param Announcement $model
+     * @return mixed
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     */
+    public function execute(Announcement $model) {
+        return $this->handler($model);
+    }
+}
@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+
+use App\Classes\General\Eloquent\AbstractFetchRecord;
+use Illuminate\Database\Eloquent\Builder;
+use App\Models\Announcement;
+
+class FetchesAnnouncement extends AbstractFetchRecord
+{
+
+    /** @var Announcement */
+    private $repository;
+
+
+    /**
+     * FetchesAnnouncement constructor.
+     * @param Announcement $repository
+     */
+    public function __construct(Announcement $repository)
+    {
+        $this->repository = $repository;
+    }
+
+
+    /**
+     * @return Builder
+     */
+    public function getRepository(): Builder
+    {
+        return $this->repository->newQuery();
+    }
+}
@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\General\Eloquent\AbstractListRecord;
+use Illuminate\Database\Eloquent\Builder;
+use App\Models\Announcement;
+
+class ListsAnnouncements extends AbstractListRecord
+{
+
+    /** @var Announcement */
+    private $repository;
+
+    /**
+     * ListsAnnouncement constructor.
+     * @param Announcement $repository
+     */
+    public function __construct(Announcement $repository)
+    {
+        $this->repository = $repository;
+    }
+
+
+    /**
+     * @return Builder
+     */
+    function getRepository(): Builder
+    {
+        return $this->repository->newQuery();
+    }
+}
@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\Exceptions\MalformedRequestException;
+use App\Classes\General\Eloquent\AbstractUpdateRecord;
+use App\Models\Announcement;
+use App\Models\Segment;
+use Illuminate\Database\QueryException;
+
+class RemovesAnnouncementFromSegment extends AbstractUpdateRecord
+{
+    /**
+     * @param Announcement $announcement
+     * @param Segment $segment
+     * @return \Illuminate\Database\Eloquent\Model
+     * @throws MalformedRequestException
+     */
+    public function execute(Announcement $announcement, Segment $segment)
+    {
+        try {
+
+            $announcement->segments()->detach($segment);
+
+            return $announcement;
+
+        } catch (QueryException $exception){
+            throw new MalformedRequestException($exception);
+        }
+
+
+    }
+}
@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Services;
+
+use App\Classes\General\Eloquent\AbstractUpdateRecord;
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+use App\Models\Announcement;
+
+class UpdatesAnnouncement extends AbstractUpdateRecord
+{
+
+    /**
+     * @param Announcement $model
+     * @param AnnouncementObject $object
+     * @return \Illuminate\Database\Eloquent\Model
+     * @throws \App\Classes\Exceptions\MalformedRequestException
+     */
+    public function execute(Announcement $model, AnnouncementObject $object)
+    {
+        $model->title = $object->getTitle();
+        $model->description = $object->getDescription();
+        $model->starting_on = $object->getStartingOn();
+        $model->ending_on = $object->getEndingOn();
+
+        return $this->handler($model);
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Rules;
+
+
+use App\Classes\General\Abstracts\AbstractRule;
+use App\Classes\Modules\SegmentConstants\DataTransferObjects\SegmentConstantObject;
+use App\Classes\Modules\Segments\DataTransferObjects\ConstantObject;
+
+class CanAssignSegment extends AbstractRule
+{
+
+    /**
+     * @return bool
+     */
+    protected function authorized(): bool
+    {
+        // TODO  Set Authorization rules
+        return true;
+    }
+
+    /**
+     * @param ConstantObject $object
+     * @return bool
+     */
+    protected function validators($object): bool
+    {
+        return true;
+    }
+
+    /**
+     * @param ConstantObject $object
+     * @return bool
+     */
+    protected function criteria($object): bool
+    {
+        return true;
+    }
+
+}
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Rules;
+
+use App\Classes\General\Abstracts\AbstractRule;
+use App\Classes\Modules\Announcements\Standards\Validators\AnnouncementValidation;
+use App\Classes\Modules\Companies\DataTransferObjects\AnnouncementObject;
+
+class CanCreateAnnouncement extends AbstractRule
+{
+
+    /** @var AnnouncementValidation */
+    private $AnnouncementValidation;
+
+    /**
+     * CanCreateAnnouncement constructor.
+     * @param AnnouncementValidation $AnnouncementValidation
+     */
+    public function __construct(AnnouncementValidation $AnnouncementValidation)
+    {
+        $this->AnnouncementValidation = $AnnouncementValidation;
+    }
+
+    /**
+     * @return bool
+     */
+    protected function authorized(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    protected function validators($object): bool
+    {
+        return $this->AnnouncementValidation->validate($object);
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function criteria($object): bool
+    {
+        return true;
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Rules;
+
+use App\Classes\General\Abstracts\AbstractRule;
+use App\Classes\Modules\Announcement\DataTransferObjects\AnnouncementObject;
+
+class CanDeleteAnnouncement extends AbstractRule
+{
+    /**
+     * @return bool
+     */
+    protected function authorized(): bool
+    {
+        // TODO  Set Authorization rules
+        return true;
+
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function validators($object): bool
+    {
+        return true;
+
+    }
+
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function criteria($object): bool
+    {
+        return true;
+    }
+
+}
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Rules;
+
+use App\Classes\General\Abstracts\AbstractRule;
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+
+class CanListAnnouncements extends AbstractRule
+{
+
+    /**
+     * @return bool
+     */
+    protected function authorized(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function validators($object): bool
+    {
+        return true;
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function criteria($object): bool
+    {
+        return true;
+    }
+}
@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Rules;
+
+
+use App\Classes\General\Abstracts\AbstractRule;
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+use App\Classes\Modules\Announcements\Standards\Validators\AnnouncementValidation;
+
+class CanUpdateAnnouncement extends AbstractRule
+{
+
+    /** @var AnnouncementValidation */
+    private $AnnouncementValidation;
+
+
+    /**
+     * CanUpdateAnnouncement constructor.
+     * @param AnnouncementValidation $AnnouncementValidation
+     */
+    public function __construct(AnnouncementValidation $AnnouncementValidation)
+    {
+        $this->AnnouncementValidation = $AnnouncementValidation;
+    }
+
+    /**
+     * @return bool
+     */
+    protected function authorized(): bool
+    {
+        // TODO  Set Authorization rules
+        return true;
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     * @throws \App\Classes\Exceptions\RequestValidationException
+     */
+    protected function validators($object): bool
+    {
+        return $this->AnnouncementValidation->validate($object);
+    }
+
+    /**
+     * @param AnnouncementObject $object
+     * @return bool
+     */
+    protected function criteria($object): bool
+    {
+        return true;
+    }
+
+}
@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Classes\Modules\Announcements\Standards\Validators;
+
+use App\Classes\General\Abstracts\AbstractValidation;
+use App\Classes\Modules\Announcements\DataTransferObjects\AnnouncementObject;
+
+class AnnouncementValidation extends AbstractValidation
+{
+    /**
+     * @param AnnouncementObject $object
+     * @return array
+     */
+    protected function data($object): array 
+    {
+        return [
+            'title' => $object->getTitle(),
+            'description' => $object->getDescription(),
+            'starting_on' => $object->getStartingOn(),
+            'ending_on' => $object->getEndingOn()
+        ];
+    }
+
+    /**
+     * @return array
+     */
+    protected function rules(): array 
+    {
+        return [
+            'title' => 'required',
+            'description' => 'required',
+            'starting_on' => 'required',
+            'ending_on' => 'required'
+        ];
+    }
+
+    /**
+     * @return array
+     */
+    protected function messages(): array 
+    {
+        return [];
+    }
+}
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\AssignAnnouncementToSegmentLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class AssignAnnouncementToSegmentController
+{
+    /**
+     * @param Request $request
+     * @param AssignCompanyToSegmentLogic $logic
+     * @return JsonResponse
+     */
+    public function assign(Request $request, AssignAnnouncementToSegmentLogic $logic): JsonResponse {
+        return $logic->execute($request);
+    }
+
+}
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\CreateAnnouncementLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class CreateAnnouncementController
+{
+    /**
+     * @param Request $request
+     * @param CreateAnnouncementLogic $logic
+     * @return JsonResponse
+     */
+    public function create(Request $request, CreateAnnouncementLogic $logic): JsonResponse
+    {
+        return $logic->execute($request);
+    }
+}
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\DeleteAnnouncementLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class DeleteAnnouncementController
+{
+    /**
+     * @param Request $request
+     * @param DeleteAnnouncementLogic $logic
+     * @return JsonResponse
+     */
+    public function delete(Request $request, DeleteAnnouncementLogic $logic): JsonResponse
+    {
+        return $logic->execute($request);
+    }
+}
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\ListAnnouncementsLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ListAnnouncementsController
+{
+    /**
+     * @param Request $request
+     * @param ListAnnouncementsLogic $logic
+     * @return JsonResponse
+     */
+    public function list(Request $request, ListAnnouncementsLogic $logic): JsonResponse
+    {
+        return $logic->execute($request);
+    }
+}
@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\RemoveSegmentFromAnnouncementLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class RemoveSegmentFromAnnouncementController
+{
+    /**
+     * @param Request $request
+     * @param RemoveCompanyFromSegmentLogic $logic
+     * @return JsonResponse
+     */
+    public function detach(Request $request, RemoveSegmentFromAnnouncementLogic $logic): JsonResponse {
+        return $logic->execute($request);
+    }
+
+}
@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Http\Controllers\Announcements;
+
+use App\Classes\Modules\Announcements\ControllersLogic\UpdateAnnouncementLogic;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class UpdateAnnouncementController
+{
+    /**
+     * @param Request $request
+     * @param UpdateAnnouncementLogic $logic
+     * @return JsonResponse
+     */
+    public function update(Request $request, UpdateAnnouncementLogic $logic): JsonResponse
+    {
+        return $logic->execute($request);
+    }
+}
+
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+use Carbon\Carbon;
+
+class AnnouncementResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'id' => $this->id,
+            'title' => $this->title,
+            'description' => $this->description,
+            'segments' => $this->segments,
+            'starting_on' => Carbon::parse($this->starting_on)->format('Y-m-d'),
+            'ending_on' => Carbon::parse($this->ending_on)->format('Y-m-d'),
+            'created_at' => Carbon::parse($this->created_at)->format('d-m-Y'),
+        ];
+    }
+}
@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * Class Announcement
+ * @package App\Models
+ *
+ */
+class Announcement extends AbstractModel
+{
+    use SoftDeletes;
+
+    protected $table = 'announcements';
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsToMany
+     **/
+    public function segments(): BelongsToMany
+    {
+        return $this->BelongsToMany(Segment::class);
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateAnnouncementsTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('announcements', function (Blueprint $table) {
+            $table->id();
+            $table->string('title', 50);
+            $table->longText('description');
+            $table->timestamp('starting_on')->nullable();
+            $table->timestamp('ending_on')->nullable();
+            $table->boolean('is_all_day')->default(false);
+            $table->integer('duration')->default(0);
+            $table->boolean('is_recurring')->default(false);
+            $table->string('recurrence_pattern')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('announcements');
+    }
+}
@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class CreateAnnouncementSegmentTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::create('announcement_segment', function (Blueprint $table) {
+
+            $table->primary(['announcement_id', 'segment_id']);
+            $table->bigInteger('announcement_id')->unsigned();
+            $table->bigInteger('segment_id')->unsigned();
+            $table->timestamps();
+            $table->foreign('announcement_id')
+                ->references('id')
+                ->on('announcements')->onDelete('cascade');
+            $table->foreign('segment_id')
+                ->references('id')
+                ->on('segments')->onDelete('cascade');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::dropIfExists('announcement_segment');
+    }
+}
@@ -0,0 +1,16 @@
+<?php
+
+use Illuminate\Support\Facades\Route;
+
+Route::group(['prefix' => 'announcement', 'as' => 'announcement.', 'namespace' => 'Announcements'], function () {
+    Route::get('/list', 'ListAnnouncementsController@list')->name('list');
+    Route::post('/create', 'CreateAnnouncementController@create')->name('create');
+    Route::put('/update/{id}', 'UpdateAnnouncementController@update')->name('update');
+    Route::delete('/delete/{id}', 'DeleteAnnouncementController@delete')->name('delete');
+
+    Route::group(['prefix' => '/{id}/segment', 'as' => 'segment.'], function () {
+        Route::post('/assign', 'AssignAnnouncementToSegmentController@assign')->name('assign');
+        Route::delete('/detach/{segment_id}', 'RemoveSegmentFromAnnouncementController@detach')->name('detach');
+    });
+
+});
@@ -59,4 +59,6 @@ Route::group(['middleware' => 'api', 'prefix' => 'v1', 'as' => 'api.'], function
        Route::get('/report/service', 'Reports\MonthlyReportController@serviceReport')->name('report.service');

    });
+
+    require __DIR__ . '/announcement.php';
 });