feat(hr): Phase 107 — HR Announcements & Company Notices

Implements full HR Announcements module with migration, model (publish/archive/is_active), policy (hr.view/create/delete), controller (index/store/show/publish/archive/destroy), routes, HRServiceProvider registration, React pages (Index/Show), TypeScript types, sidebar link, and 10 Pest tests (all passing, total 1110).

https://claude.ai/code/session_01RdUGwo74JXChRCF88Yu27d

Author: claude

erp/app/Modules/HR/Http/Controllers/HrAnnouncementController.php

@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Modules\HR\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Modules\HR\Models\HrAnnouncement;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class HrAnnouncementController extends Controller
+{
+    public function index(Request $request): Response
+    {
+        $this->authorize('viewAny', HrAnnouncement::class);
+
+        $announcements = HrAnnouncement::with('createdBy')
+            ->when($request->target_audience, fn ($q) => $q->where('target_audience', $request->target_audience))
+            ->latest()
+            ->paginate(20)
+            ->withQueryString();
+
+        return Inertia::render('HR/Announcements/Index', [
+            'announcements' => $announcements,
+            'filters'       => $request->only(['target_audience']),
+        ]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $this->authorize('create', HrAnnouncement::class);
+
+        $validated = $request->validate([
+            'title'           => 'required|string|max:255',
+            'body'            => 'required|string',
+            'target_audience' => 'nullable|string|in:all,department,role',
+            'department_id'   => 'nullable|exists:departments,id',
+            'priority'        => 'nullable|string|in:low,normal,high,urgent',
+            'publish_at'      => 'nullable|date',
+            'expire_at'       => 'nullable|date',
+        ]);
+
+        $announcement = HrAnnouncement::create([
+            'tenant_id'       => auth()->user()->tenant_id,
+            'created_by'      => auth()->id(),
+            'title'           => $validated['title'],
+            'body'            => $validated['body'],
+            'target_audience' => $validated['target_audience'] ?? 'all',
+            'department_id'   => $validated['department_id'] ?? null,
+            'priority'        => $validated['priority'] ?? 'normal',
+            'publish_at'      => $validated['publish_at'] ?? null,
+            'expire_at'       => $validated['expire_at'] ?? null,
+        ]);
+
+        return redirect()->route('hr.announcements.show', $announcement);
+    }
+
+    public function show(HrAnnouncement $announcement): Response
+    {
+        $this->authorize('view', $announcement);
+
+        $announcement->load(['createdBy', 'department']);
+
+        return Inertia::render('HR/Announcements/Show', [
+            'announcement' => $announcement,
+        ]);
+    }
+
+    public function publish(HrAnnouncement $announcement): RedirectResponse
+    {
+        $this->authorize('update', $announcement);
+
+        $announcement->publish();
+
+        return redirect()->back()->with('success', 'Announcement published successfully.');
+    }
+
+    public function archive(HrAnnouncement $announcement): RedirectResponse
+    {
+        $this->authorize('update', $announcement);
+
+        $announcement->archive();
+
+        return redirect()->back()->with('success', 'Announcement archived successfully.');
+    }
+
+    public function destroy(HrAnnouncement $announcement): RedirectResponse
+    {
+        $this->authorize('delete', $announcement);
+
+        $announcement->delete();
+
+        return redirect()->route('hr.announcements.index');
+    }
+}

erp/app/Modules/HR/Models/HrAnnouncement.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Modules\HR\Models;
+
+use App\Models\User;
+use App\Modules\Core\Traits\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class HrAnnouncement extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    protected $fillable = [
+        'tenant_id', 'title', 'body', 'target_audience', 'department_id',
+        'is_published', 'publish_at', 'expire_at', 'created_by', 'priority',
+    ];
+
+    protected $casts = [
+        'is_published' => 'boolean',
+        'publish_at'   => 'datetime',
+        'expire_at'    => 'datetime',
+    ];
+
+    public function department(): BelongsTo
+    {
+        return $this->belongsTo(Department::class);
+    }
+
+    public function createdBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by');
+    }
+
+    public function publish(): void
+    {
+        $this->is_published = true;
+        $this->publish_at   = $this->publish_at ?? now();
+        $this->save();
+    }
+
+    public function archive(): void
+    {
+        $this->is_published = false;
+        $this->expire_at    = now();
+        $this->save();
+    }
+
+    public function getIsActiveAttribute(): bool
+    {
+        if (! $this->is_published) {
+            return false;
+        }
+        if ($this->expire_at !== null && $this->expire_at->isPast()) {
+            return false;
+        }
+        return true;
+    }
+}

erp/app/Modules/HR/Policies/HrAnnouncementPolicy.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Modules\HR\Policies;
+
+use App\Models\User;
+
+class HrAnnouncementPolicy
+{
+    public function viewAny(User $user): bool
+    {
+        return $user->hasPermissionTo('hr.view');
+    }
+
+    public function view(User $user, $model): bool
+    {
+        return $user->hasPermissionTo('hr.view');
+    }
+
+    public function create(User $user): bool
+    {
+        return $user->hasPermissionTo('hr.create');
+    }
+
+    public function update(User $user, $model): bool
+    {
+        return $user->hasPermissionTo('hr.create');
+    }
+
+    public function delete(User $user, $model): bool
+    {
+        return $user->hasPermissionTo('hr.delete');
+    }
+}

erp/app/Modules/HR/Providers/HRServiceProvider.php

@@ -64,6 +64,8 @@
 use App\Modules\HR\Models\SkillDefinition;
 use App\Modules\HR\Models\EmployeeSkill;
 use App\Modules\HR\Policies\EmployeeSkillPolicy;
+use App\Modules\HR\Models\HrAnnouncement;
+use App\Modules\HR\Policies\HrAnnouncementPolicy;
 use Illuminate\Support\Facades\Gate;
 use Illuminate\Support\ServiceProvider;
 
@@ -115,5 +117,6 @@ public function boot(): void
         Gate::policy(EmployeeDocument::class,      EmployeeDocumentPolicy::class);
         Gate::policy(SkillDefinition::class,       EmployeeSkillPolicy::class);
         Gate::policy(EmployeeSkill::class,         EmployeeSkillPolicy::class);
+        Gate::policy(HrAnnouncement::class,          HrAnnouncementPolicy::class);
     }
 }

erp/app/Modules/HR/routes/hr.php

@@ -220,3 +220,11 @@
     Route::resource('employee-skills',   EmployeeSkillController::class)->only(['index', 'store', 'show', 'destroy']);
     Route::resource('skill-definitions', SkillDefinitionController::class)->only(['index', 'store', 'destroy']);
 });
+
+// HR Announcements
+use App\Modules\HR\Http\Controllers\HrAnnouncementController;
+Route::middleware(['web', 'auth', 'verified'])->prefix('hr')->name('hr.')->group(function () {
+    Route::post('announcements/{announcement}/publish', [HrAnnouncementController::class, 'publish'])->name('announcements.publish');
+    Route::post('announcements/{announcement}/archive', [HrAnnouncementController::class, 'archive'])->name('announcements.archive');
+    Route::resource('announcements', HrAnnouncementController::class)->only(['index', 'store', 'show', 'destroy']);
+});

erp/database/migrations/2026_08_06_100001_create_hr_announcements_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('hr_announcements', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedBigInteger('tenant_id');
+            $table->string('title');
+            $table->text('body');
+            $table->string('target_audience')->default('all'); // all, department, role
+            $table->unsignedBigInteger('department_id')->nullable();
+            $table->boolean('is_published')->default(false);
+            $table->timestamp('publish_at')->nullable();
+            $table->timestamp('expire_at')->nullable();
+            $table->unsignedBigInteger('created_by')->nullable();
+            $table->string('priority')->default('normal'); // low, normal, high, urgent
+            $table->timestamps();
+            $table->softDeletes();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('hr_announcements');
+    }
+};

erp/resources/js/Components/Layout/Sidebar.tsx

@@ -187,6 +187,7 @@ const navItems: NavItem[] = [
             { label: 'Employee Benefits', href: '/hr/employee-benefits', icon: <span /> },
             { label: 'Skills', href: '/hr/employee-skills', icon: <span /> },
             { label: 'Skill Definitions', href: '/hr/skill-definitions', icon: <span /> },
+            { label: 'Announcements', href: '/hr/announcements', icon: <span /> },
         ],
     },
     {

erp/resources/js/Pages/HR/Announcements/Index.tsx

@@ -0,0 +1,97 @@
+import { Head, Link, router } from '@inertiajs/react';
+import AppLayout from '@/Layouts/AppLayout';
+import { Table } from '@/Components/Common/Table';
+import { Button } from '@/Components/Common/Button';
+import { Pagination } from '@/Components/Inventory/Pagination';
+import { usePermission } from '@/Hooks/usePermission';
+import type { PageProps } from '@/types';
+import type { Paginator } from '@/types/inventory';
+import type { HrAnnouncement } from '@/types/hr';
+
+interface Props extends PageProps {
+    announcements: Paginator<HrAnnouncement>;
+    filters: { target_audience?: string };
+}
+
+const PRIORITY_COLORS: Record<string, string> = {
+    low:    'bg-slate-100 text-slate-700',
+    normal: 'bg-blue-100 text-blue-700',
+    high:   'bg-yellow-100 text-yellow-700',
+    urgent: 'bg-red-100 text-red-700',
+};
+
+export default function AnnouncementsIndex({ announcements, filters }: Props) {
+    const { can } = usePermission();
+
+    function setAudience(audience: string) {
+        router.get('/hr/announcements', { ...filters, target_audience: audience || undefined }, { preserveState: true, replace: true });
+    }
+
+    return (
+        <AppLayout>
+            <Head title="Announcements" />
+            <div className="space-y-6">
+                <div className="flex items-center justify-between">
+                    <div>
+                        <h1 className="text-2xl font-semibold text-slate-900">HR Announcements</h1>
+                        <p className="text-sm text-slate-500 mt-1">{announcements.total} announcements</p>
+                    </div>
+                    {can('hr.create') && (
+                        <Button onClick={() => router.visit('/hr/announcements/create')}>
+                            New Announcement
+                        </Button>
+                    )}
+                </div>
+
+                <div className="rounded-lg border border-slate-200 bg-white shadow-sm">
+                    <Table
+                        columns={[
+                            {
+                                key: 'title',
+                                header: 'Title',
+                                render: (r) => (
+                                    <Link href={`/hr/announcements/${r.id}`} className="text-indigo-600 hover:underline font-medium">
+                                        {r.title}
+                                    </Link>
+                                ),
+                            },
+                            {
+                                key: 'target_audience',
+                                header: 'Audience',
+                                render: (r) => (
+                                    <span className="capitalize text-slate-700">{r.target_audience}</span>
+                                ),
+                            },
+                            {
+                                key: 'priority',
+                                header: 'Priority',
+                                render: (r) => (
+                                    <span className={`inline-flex items-center rounded px-2 py-0.5 text-xs font-medium capitalize ${PRIORITY_COLORS[r.priority] ?? 'bg-slate-100 text-slate-700'}`}>
+                                        {r.priority}
+                                    </span>
+                                ),
+                            },
+                            {
+                                key: 'is_published',
+                                header: 'Status',
+                                render: (r) => (
+                                    <span className={`inline-flex items-center rounded px-2 py-0.5 text-xs font-medium ${r.is_published ? 'bg-green-100 text-green-700' : 'bg-slate-100 text-slate-700'}`}>
+                                        {r.is_published ? 'Published' : 'Draft'}
+                                    </span>
+                                ),
+                            },
+                            {
+                                key: 'publish_at',
+                                header: 'Publish At',
+                                render: (r) => <span className="text-slate-600">{r.publish_at ?? '—'}</span>,
+                            },
+                        ]}
+                        rows={announcements.data}
+                    />
+                </div>
+
+                <Pagination paginator={announcements} />
+            </div>
+        </AppLayout>
+    );
+}