Amr-7 Platform — Copilot Instructions

🎯 Project Overview

Amr-7 is a business & legal operations platform built with Laravel 11 + Livewire + TailwindCSS.
Its goal is to automate company formation, ticketing, and client service workflows, while maintaining high code clarity and scalability.

🧩 Core Modules

Ticket Management
- Livewire components for creating, updating, and tracking service tickets.
- Each ticket includes department, status, and client association.
- Notifications handled via events + queues.
Client Management
- Separate client model and table.
- Optional linking to tickets and company accounts.
- Import/export Excel support.
Department & Roles
- Role-based access (admin, manager, support, visitor).
- Authorization through policies and gates.
Reporting Dashboard
- Timeline tracking per ticket.
- Aggregated analytics using Eloquent relationships.
WhatsApp API Integration
- Linked to client or ticket conversation ID.
- Supports manual and automated replies.

💻 Development Standards

Follow PSR-12 PHP coding style.
Use Eloquent relationships efficiently (
```
with
```
,
```
load
```
,
```
lazy
```
).
Prefer Blade directives (
```
@foreach
```
,
```
@if
```
) instead of inline PHP.
Use Livewire events and computed properties instead of direct JS.
Keep components small: one component per UI responsibility.
For UI, follow Tailwind utility-first approach with semantic class naming.

🧠 AI Agent Guidelines

When asked to “create”, generate full Laravel-compliant classes (Model + Migration + Livewire + View + Route).
When asked to “optimize”, apply lazy loading, query scopes, and caching.
When asked to “refactor”, ensure no functionality loss.
Always include localization awareness (Arabic / English).

⚙️ Testing

Use PestPHP for feature/unit tests.

Each Livewire component must have at least:

```
renders_successfully
```
```
updates_data_correctly
```
```
emits_events_properly
```

Example:

test('ticket dashboard renders', function () {
    Livewire::test(TicketDashboard::class)
        ->assertSee('Tickets');
});

🧩 Core Modules

Ticket Management

Livewire components for creating, updating, and tracking service tickets.
Each ticket includes department, status, and client association.
Notifications handled via events + queues.

Client Management

Separate client model and table.
Optional linking to tickets and company accounts.
Import/export Excel support.

Department & Roles

Role-based access (admin, manager, support, visitor).
Authorization through policies and gates.

Reporting Dashboard

Timeline tracking per ticket.
Aggregated analytics using Eloquent relationships.

WhatsApp API Integration

Linked to client or ticket conversation ID.
Supports manual and automated replies.

💻 Development Standards

Follow PSR-12 PHP coding style.

Use Eloquent relationships efficiently (

with

load

lazy

Prefer Blade directives (

@foreach

@if

) instead of inline PHP.

Use Livewire events and computed properties instead of direct JS.

Keep components small: one component per UI responsibility.

For UI, follow Tailwind utility-first approach with semantic class naming.

🧠 AI Agent Guidelines

When asked to “create”, generate full Laravel-compliant classes (Model + Migration + Livewire + View + Route).

When asked to “optimize”, apply lazy loading, query scopes, and caching.

When asked to “refactor”, ensure no functionality loss.

Always include localization awareness (Arabic / English).

Amr-7 Platform — Copilot Instructions

Amr-7 Platform — Copilot Instructions

🎯 Project Overview

🧩 Core Modules

💻 Development Standards

🧠 AI Agent Guidelines

⚙️ Testing

Related Skills

Nano Banana Pro

Markdown Converter

1password

Amr-7 Platform — Copilot Instructions

🎯 Project Overview

🧩 Core Modules

💻 Development Standards

🧠 AI Agent Guidelines

⚙️ Testing