Software Engineer Encyclopedia
0%
Domain 07 · Frontend Engineering with Angular · Topic 7.4

Angular من الصفر لربط Dashboard بـ ASP.NET Core API

Angular — Practical Application Architecture and API Integration

Standalone components وtemplates وbinding وcontrol flow وsignals وservices وDI وrouting وguards وreactive forms وHttpClient وinterceptors وJWT/cookies وSwagger clients وerror handling.

  • Intermediate
  • ~20 min read
  • 22 sections
  • 18 code examples
  • 1 diagrams
  • 6 questions
  • Priority L2 · Essential
  • Angular 22 · TypeScript 5.x · RxJS 7.x · ASP.NET Core 10

المتطلبات قبل ما تبدأ

أساسيات البرمجة. الـ backend مش شرط لكن بيفيد في جزء الـ HTTP.

مستوى التعمق المطلوب

BASICSFocus on connecting a UI to your API, not becoming a frontend specialist.

01

Angular في الرحلة دي: اربط UI بالـ Backend

Build an API client, not a second backend
Deep dive

الهدف من Angular هنا إنك تبني واجهة عملية تستهلك ASP.NET Core APIs: login، عرض بيانات، forms، routing، loading/error states، authorization-aware navigation، وربط real-time updates لاحقًا. مش مطلوب تبقى Frontend specialist، لكن لازم تفهم lifecycle و state و HTTP والـ security boundaries؛ لأن أي خطأ فيهم يسبب bugs حتى لو backend ممتاز.

Angular framework متكامل: component model، template compiler، dependency injection، router، forms، HttpClient، testing tools. ابدأ بـ standalone components بدل افتراض NgModules في كل مثال جديد. الـ Angular CLI ينشئ workspace ويضبط build/test tooling؛ لا تنسخ project config من إصدار قديم دون مراجعة CLI الحالي.

تقسيم مسؤوليات مقترح: Component يعرض UI ويمسك local view state؛ Service يملك API access أو business orchestration الخاص بالواجهة؛ Router يدير navigation؛ Interceptor يطبق cross-cutting HTTP behavior؛ Server هو صاحب الحقيقة في authorization و business validation. لا تنقل business rules الحساسة إلى Angular.

02

تطبيق Angular في رسمة

Angular application structure
Basics
app.config.ts (providers)Router (lazy routes)Feature componentsignals, templateFeature componentreactive formService (inject) + HttpClientInterceptorsauth · errors · correlation id
Routes load standalone feature components; services hold state and HTTP; interceptors wrap every request
03

Standalone Components و Component Anatomy

A component is a reusable UI boundary
Deep dive

Component يتكون من TypeScript class و template و styles و metadata عبر @Component. standalone: true هو الاتجاه الحديث في Angular؛ standalone component يعلن dependencies التي يستخدمها في imports. في الإصدارات الحديثة standalone هو default في كثير من إعدادات CLI، لذلك قد لا ترى property صريحة. راجع إصدار المشروع بدل إضافة metadata قديمة تلقائيًا.

TypeScriptorders-page.component.ts
import { Component, signal } from '@angular/core';
import { OrderListComponent } from './order-list.component';

@Component({
  selector: 'app-orders-page',
  imports: [OrderListComponent],
  template: `
    <h1>Orders</h1>
    <p>Selected: {{ selectedCount() }}</p>
    <app-order-list />
  `
})
export class OrdersPageComponent {
  readonly selectedCount = signal(0);
}

Component tree يعبر عن composition. لا تجعل component واحدة تحتوي كل صفحة وكل HTTP calls وكل forms؛ قسم UI إلى components صغيرة عندما لها responsibility أو reuse أو test boundary واضح. لكن لا تعمل component لكل div. Input/Output أو signal inputs/events تربط parent-child contract حسب Angular version APIs المستخدمة.

Lifecycle hooks مثل ngOnInit و ngOnDestroy مرتبطة بدورة حياة component. لا تستخدم ngOnInit لمجرد أن constructor لا يعجبك؛ constructor لحقن dependencies وتهيئة بسيطة، و ngOnInit لتهيئة تعتمد على inputs أو lifecycle. نظف subscriptions/timers/listeners؛ استخدم takeUntilDestroyed أو async pipe أو signals حسب الحالة.

04

Templates و Data Binding و Control Flow

Connect state to the DOM declaratively
Deep dive

Angular templates تدعم interpolation {{ value }} لعرض النص، property binding [disabled]، event binding (click)، و two-way binding [(ngModel)] في template-driven forms. لا تخلط property binding مع string attribute؛ [disabled]="isBusy()" يربط boolean property، بينما disabled="false" قد يظل attribute موجودًا وبالتالي control disabled.

HTMLTemplate bindings and modern control flow
<section>
  <h2>{{ pageTitle() }}</h2>
  <button type="button"
          [disabled]="isLoading()"
          (click)="reload()">
    Reload
  </button>

  @if (errorMessage()) {
    <p role="alert">{{ errorMessage() }}</p>
  } @else if (isLoading()) {
    <p>Loading...</p>
  } @else {
    @for (order of orders(); track order.id) {
      <app-order-row [order]="order" />
    } @empty {
      <p>No orders found.</p>
    }
  }
</section>

في control flow الحديثة استخدم @if, @for, @switch بدل أمثلة *ngIf/*ngFor القديمة في code جديد، مع فهم إن directives القديمة ما زالت تظهر في codebases موجودة. track order.id مهم لتقليل DOM churn والحفاظ على identity. لا تستخدم array index كـ track key لو items يمكن reorder/insert/delete.

Angular يهرب النص interpolation افتراضيًا، لكن لا تستخدم [innerHTML] مع user-controlled HTML. Sanitization تقلل مخاطر لكنها لا تجعل كل HTML آمنًا؛ تجنب bypassSecurityTrust... إلا عند وجود reviewed trusted content وسبب واضح.

05

Signals: signal و computed و effect

Fine-grained reactive state
Deep dive

Signal wrapper لقيمة reactive؛ تقرأها باستدعاء function، وتحدثها بـ set/update. computed قيمة مشتقة read-only تتحدث عندما dependencies تتغير. effect side effect يتفاعل مع signals، وليس بديلًا عن computed أو مكان تنفيذ business logic عشوائي. استخدم computed للحسابات، و effect للتكامل مع APIs imperative أو logging عند الحاجة.

TypeScriptSignals for a simple orders view
import { computed, signal } from '@angular/core';

interface OrderRow { id: string; total: number; status: string; }

export class OrdersState {
  readonly orders = signal<readonly OrderRow[]>([]);
  readonly filter = signal('');
  readonly visibleOrders = computed(() => {
    const term = this.filter().trim().toLowerCase();
    return this.orders().filter(order =>
      order.id.toLowerCase().includes(term));
  });
  readonly totalValue = computed(() =>
    this.visibleOrders().reduce((sum, order) => sum + order.total, 0));
}

لا تعدل object/array داخل signal بطريقة mutation صامتة ثم تتوقع أن كل dependents تعرف التغيير. استخدم immutable update أو `update(current => [...current, item])`. Signal لا تعني server state cache تلقائيًا؛ لازم تحدد loading/error/refetch/invalidation semantics. لا تضع كل application state في signal واحدة global؛ حافظ على ownership واضح.

Angular الحديثة تدعم signals و interoperability مع RxJS. Zoneless change detection أصبح اتجاهًا حديثًا ومستقرًا وفق roadmap الحالية، و OnPush default في الإصدارات الحديثة حسب تحديثات الفريق؛ لكن سلوك التطبيق الفعلي يعتمد على version/configuration. لا تخلط أمثلة Angular قديمة وحديثة من غير توضيح.

06

Services و Dependency Injection

Keep HTTP and reusable logic outside templates
Deep dive

Service class مكان مناسب ل API access أو logic تشترك فيه عدة components. @Injectable({ providedIn: 'root' }) يسجل service في root injector غالبًا كـ app-wide singleton instance. تقدر تعمل providers على route/component scope لو lifetime محلي مطلوب. لا تفترض إن كل service لازم تكون singleton؛ provider scope يغير instance lifetime.

TypeScriptOrders API service
import { Injectable, inject } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';

export interface OrderDto {
  id: string;
  total: number;
  status: 'Pending' | 'Paid' | 'Cancelled';
}

@Injectable({ providedIn: 'root' })
export class OrdersApi {
  private readonly http = inject(HttpClient);

  getOrders(): Observable<OrderDto[]> {
    return this.http.get<OrderDto[]>('/api/orders');
  }

  getById(id: string): Observable<OrderDto> {
    return this.http.get<OrderDto>(`/api/orders/${encodeURIComponent(id)}`);
  }
}

Angular DI يشبه مفهوم DI في ‎.NET لكنه مختلف في runtime/provider tree. inject() يمكن استخدامه داخل injection context، مثل field initializer أو provider factory، وليس في أي function عادية. لا تستخدم service locator pattern في كل مكان؛ constructor injection أو field injection الواضح يجعل dependencies قابلة للفهم والاختبار.

Angular Dependency Injection: Hierarchical Injectors

Angular DI ليس مجرد service singleton عالمي. Provider في root غالبًا instance على مستوى application injector؛ provider في route أو component قد ينشئ instance ضمن child injector. هذا مفيد لعزل feature state أو wizard state، لكنه قد يسبب instance متعددة إذا سجلت نفس service في component providers. providedIn: 'root' مناسب لخدمات عامة طويلة العمر، بينما component provider مناسب state tied to component tree.

تجنب circular dependencies، ولا تجعل service عامة تخزن state لكل user/tenant دون lifecycle/reset. اختبر provider scope عبر component recreation و lazy routes. عند SSR انتبه إلى request-scoped state؛ singleton process-wide قد يسرّب بيانات بين المستخدمين إذا خزنت state خاصة في service مشتركة على server.

07

Routing و Lazy Loading و Route Parameters

URL is part of the application state
Deep dive

Router يربط URL بـ component ويتيح nested routes و route params و query params و lazy loading و resolvers. الـ URL state مفيد لأنه قابل لل bookmark والمشاركة والرجوع عبر browser history. استخدم route params للهوية مثل /orders/:id، و query params للفلترة/pagination/sort حسب الحاجة.

TypeScriptStandalone route configuration
import { Routes } from '@angular/router';

export const routes: Routes = [
  {
    path: 'orders',
    loadComponent: () => import('./orders/orders-page.component')
      .then(m => m.OrdersPageComponent)
  },
  {
    path: 'orders/:id',
    loadComponent: () => import('./orders/order-details.component')
      .then(m => m.OrderDetailsComponent)
  },
  { path: '', pathMatch: 'full', redirectTo: 'orders' },
  { path: '**', loadComponent: () => import('./not-found.component')
      .then(m => m.NotFoundComponent) }
];

Lazy loading يقلل initial bundle ويقسم features حسب الحاجة، لكنه لا يجعل code نفسه أصغر تلقائيًا. لا تضع كل route في root eagerly loaded imports لو feature نادر. راجع preloading strategy والـ bundle analyzer عند نمو التطبيق.

Route Guards: UX Navigation وليس Security Boundary

Guards مثل CanActivateFn تتحكم هل Angular تكمل navigation. مفيدة لتوجيه مستخدم غير مسجل إلى login أو منع الوصول إلى شاشة لا تناسب role. لكنها لا تحمي API؛ المستخدم يقدر يكتب URL أو يرسل HTTP request مباشرة. ASP.NET Core authorization policy هي enforcement الحقيقي.

TypeScriptFunctional route guard
import { inject } from '@angular/core';
import { CanActivateFn, Router } from '@angular/router';
import { AuthState } from './auth-state.service';

export const signedInGuard: CanActivateFn = (_route, state) => {
  const auth = inject(AuthState);
  const router = inject(Router);

  return auth.isSignedIn()
    ? true
    : router.createUrlTree(['/login'], { queryParams: { returnUrl: state.url } });
};

لا تثق في role مخزن في localStorage لتقرر صلاحية عملية. ممكن تعرض/تخفي navigation بناءً على claims للـ UX، لكن server يعيد التحقق من token/claims/ownership. تجنب open redirect: عند استخدام returnUrl، اسمح بمسارات داخلية فقط ولا تمرر URL خارجيًا مباشرة إلى navigateByUrl.

Angular Router: Lazy Routes و Guards و Resolvers

Router يربط URL بـ component tree، و lazy loading يقلل initial bundle. Guards مثل CanActivate تحسن UX وتمنع navigation غير المرغوب، لكنها لا تحمي API؛ المستخدم يستطيع استدعاء backend مباشرة. Resolvers تجلب data قبل تفعيل route، لكن قد تؤخر navigation؛ استخدمها عندما الصفحة لا معنى لها بلا data، وإلا اعرض skeleton/loading state.

TypeScriptLazy route with a UX guard
export const routes: Routes = [
  {
    path: 'admin',
    canActivate: [adminUiGuard],
    loadComponent: () => import('./admin/admin.page')
      .then(m => m.AdminPage)
  }
];

export const adminUiGuard: CanActivateFn = () => {
  const auth = inject(AuthState);
  const router = inject(Router);
  return auth.hasAdminRole() || router.createUrlTree(['/forbidden']);
};

لا تضع role claims غير موثوقة في local state وتعتبرها قرار backend. اختبر direct URL navigation، refresh، deep links، lazy chunk failures، unauthorized API response، و route parameter tampering. استخدم route data للـ metadata لا لتخزين secrets أو permissions authoritative.

08

Forms: Reactive Forms و Signal Forms

Validation and explicit form state
Deep dive

Angular توفر template-driven و reactive forms، ومع الإصدارات الحديثة Signal Forms. Reactive Forms مناسبة عندما form معقدة أو dynamic أو تحتاج validation واضحة واختبارات مباشرة. Template-driven مفيدة forms بسيطة. Signal Forms تقدم model-based signal reactivity وهي متاحة/مستقرة في Angular الحديثة؛ راجع API status/version في المشروع قبل اعتمادها. لا تخلط syntax من approaches مختلفة في نفس form بلا داعٍ.

TypeScriptReactive form with typed controls
import { FormControl, FormGroup, Validators } from '@angular/forms';

export class CreateOrderFormComponent {
  readonly form = new FormGroup({
  customerEmail: new FormControl('', {
    nonNullable: true,
    validators: [Validators.required, Validators.email]
  }),
  quantity: new FormControl(1, {
    nonNullable: true,
    validators: [Validators.min(1), Validators.max(100)]
  })
});

submit() {
  if (this.form.invalid) {
    this.form.markAllAsTouched();
    return;
  }
  const command = this.form.getRawValue();
  // Send command to the API; server validates again.
  }
}

Validation layers: HTML constraints لتحسين UX، Angular validators ل feedback سريع، ASP.NET Core validation و domain invariants للحماية. لا تعتبر Angular validation مصدر ثقة. server error مثل 409 conflict أو 422 validation يجب ينعكس في UI بطريقة مفهومة، مع الحفاظ على user input عند الفشل.

Reactive Forms: Validation و Cross-Field Rules

Reactive Forms مناسبة عندما تحتاج dynamic controls أو cross-field validation أو typed form state. ضع validators قريبة من control، و group validator للقواعد التي تعتمد على أكثر من field مثل password confirmation أو date range. لا تعتمد على client validation للأمان؛ server يجب يعيد التحقق من كل business rules.

TypeScriptTyped reactive form with cross-field validation
const dateRangeValidator: ValidatorFn = (control) => {
  const from = control.get('from')?.value as Date | null;
  const to = control.get('to')?.value as Date | null;
  return from && to && from > to ? { invalidRange: true } : null;
};

export class RangeFormComponent {
  readonly form = new FormGroup({
    from: new FormControl<Date | null>(null, Validators.required),
    to: new FormControl<Date | null>(null, Validators.required),
  }, { validators: dateRangeValidator });
}

اعرض errors بعد touched/submit وفق UX، ولا تعرض كل errors قبل أن يبدأ المستخدم. استخدم updateOn بحكمة (change أو blur أو submit). نظف subscriptions أو استخدم async pipe/signals interop. لا ترسل request لكل keypress بلا debounce/cancel policy.

09

HttpClient: Calling ASP.NET Core APIs

Typed requests, Observables and HTTP semantics
Deep dive

فعّل HttpClient في application providers عبر provideHttpClient(). HttpClient يرجع Observable؛ كل subscription عادة تنفذ request جديد. لذلك لا تعمل subscribe مرتين على نفس cold Observable وتتوقع request واحد. استخدم async pipe أو toSignal أو subscribe واحد مع lifecycle cleanup. لا تحول stream إلى shared cache من غير invalidation policy.

TypeScriptConfigure HttpClient in app.config.ts
import { ApplicationConfig } from '@angular/core';
import { provideHttpClient, withInterceptors } from '@angular/common/http';
import { authInterceptor } from './auth.interceptor';

export const appConfig: ApplicationConfig = {
  providers: [
    provideHttpClient(withInterceptors([authInterceptor]))
  ]
};

استخدم base URL من environment/config strategy حسب deployment. في نفس origin يمكن استخدام relative /api; مع separate origins تحتاج CORS في backend و HTTPS. لا hard-code localhost في production bundle. لا ترسل Content-Type: application/json ل GET بلا body؛ ولا ترسل credentials إلا عند الحاجة.

HTTP methods لها semantics: GET read-only/idempotent، PUT replace/idempotent غالبًا، DELETE idempotent semantics، POST create/action وقد لا يكون idempotent. لو create request يمكن أن يعاد بعد network timeout، فكر في idempotency key في backend. client timeout لا يثبت إن server لم ينفذ العملية.

10

HTTP Interceptors: Auth و Correlation و Error Mapping

Cross-cutting request behavior
Deep dive

Interceptor يلف HTTP request/response pipeline. استخدم functional interceptors في المشاريع الحديثة غالبًا. مناسب لإضافة correlation ID، auth header عند token-based design، mapping للأخطاء أو telemetry. لا تضع business-specific logic لكل endpoint في interceptor، ولا تعمل retry شامل لكل POST من غير idempotency.

TypeScriptFunctional interceptor with an explicit token provider
import { HttpInterceptorFn } from '@angular/common/http';
import { inject } from '@angular/core';
import { AuthState } from './auth-state.service';

export const authInterceptor: HttpInterceptorFn = (request, next) => {
  const auth = inject(AuthState);
  const token = auth.accessToken();

  if (!token || !request.url.startsWith('/api/')) {
    return next(request);
  }

  return next(request.clone({
    setHeaders: { Authorization: `Bearer ${token}` }
  }));
};

الـ URL check هنا مثال بسيط؛ في production استخدم trusted API base URL matching مضبوطًا حتى لا تسرب token إلى external origin. لو تستخدم HttpOnly cookie authentication، لا تحتاج JavaScript يقرأ token ولا تضف Bearer header؛ قد تحتاج withCredentials لل cross-origin cookies و CSRF defenses حسب architecture.

Refresh Interceptor: Single-Flight ومنع Retry Loop

لو خمس requests انتهت بـ 401 في نفس اللحظة، لا تجعل كل request تبدأ refresh منفصلة؛ قد تستخدم refresh token مرة واحدة ثم تفشل البقية. المطلوب single-flight: refresh واحد مشترك، والطلبات تنتظر نتيجته ثم تعيد المحاولة مرة واحدة. لازم تميّز endpoint refresh نفسه حتى لا يدخل في interceptor loop.

TypeScriptInterceptor design pseudocode — adapt to current Angular APIs
// Conceptual flow; exact interceptor syntax depends on Angular version.
if (request.url.includes('/auth/refresh')) {
  return next(request);
}
return next(request).pipe(
  catchError(error => {
    if (error.status !== 401 || request.context.get(RETRIED)) {
      return throwError(() => error);
    }
    return refreshOnce().pipe(
      switchMap(() => next(markAsRetried(request)))
    );
  })
);

الكود pseudo-flow وليس copy/paste implementation. مع HttpOnly cookie، browser يرسل credential وفق credentials/withCredentials و CORS allow-credentials، ولا يستطيع JavaScript قراءة cookie. احمِ refresh endpoint من CSRF حسب cookie SameSite و anti-CSRF design، وطبّق rotation/reuse detection في backend. عند refresh failure امسح local auth state ووجّه المستخدم لتسجيل الدخول، ولا تعِد المحاولة إلى ما لا نهاية.

Http Interceptors: Auth و Correlation و Error Mapping

Interceptor مناسب لإضافة correlation ID، auth header، telemetry، أو mapping موحد لأخطاء HTTP. لا تضع business logic أو endpoint-specific branching ضخم داخله. عند refresh token، امنع concurrent refresh storms باستخدام single-flight shared observable/promise، وتعامل مع refresh endpoint نفسه حتى لا يدخل في recursion. لا تعِد محاولة كل 401 بلا تمييز؛ قد تكون session انتهت أو user لا يملك credential.

لا تسجل request headers كاملة؛ Authorization و cookies أسرار. لا تضف bearer token إلى third-party absolute URLs. راجع redirect behavior و cross-origin requests. اختبر concurrent 401s، refresh success/failure، cancellation، logout أثناء refresh، و retry بعد token replacement.

11

Authentication Flow: JWT أو HttpOnly Cookies

Coordinate with the backend security model
Deep dive

اختيار token storage مش قرار UI منفصل. LocalStorage accessible to JavaScript، لذلك XSS قد يسرق tokens. HttpOnly Secure SameSite cookies تمنع JavaScript من قراءة cookie، لكنها لا تلغي CSRF، وتحتاج cookie policy و anti-forgery strategy مناسبة. في browser apps، راجع OAuth/OIDC Authorization Code with PKCE عندما يكون النظام identity provider خارجيًا. لا تخترع custom login protocol بلا threat model.

Refresh token rotation لازم يديره backend: token rotation، reuse detection، revocation، expiry، device/session tracking. Angular لا «تجدد» token بنفسها؛ interceptor يمكن أن يتعامل مع 401 بشكل منظم، لكن لا تجعل كل request متزامنة تطلق refresh requests كثيرة. استخدم single-flight refresh flow، امنع infinite retry loop، وتعامل مع failed refresh بإعادة المستخدم إلى login.

لو access token في memory فقط، reload قد يزيله؛ يمكن أن يكون هناك bootstrap session endpoint أو cookie-based session. لو تستخدم cookies، افهم SameSite=Lax/Strict/None، Secure، Domain، Path، CORS credentials، CSRF tokens. راجع دروس Identity و JWT و CORS في الموسوعة؛ Angular مجرد client للسياسة.

12

Error Handling و Environment Configuration

Make failures and deployment settings explicit
Deep dive

صنف الأخطاء: network/offline، 401 unauthenticated، 403 forbidden، 404 missing، 409 conflict، 422 validation، 429 rate limited، 5xx server failure. اعرض رسالة user-friendly واحتفظ بتفاصيل تقنية في telemetry بعد redaction. لا تعرض stack traces أو SQL errors. استخدم centralized error handling للمشترك، و component-specific state للتعامل مع validation و empty states.

Angular environment files مفيدة لبعض build-time configuration، لكنها ليست secrets؛ أي قيمة في frontend bundle يمكن للمستخدم قراءتها. API base URL و public feature flags قد تكون هناك، أما private API keys أو database passwords فلا توضع في Angular. في بعض deployments يمكن تحميل runtime config JSON حتى نفس artifact يعمل في environments متعددة.

TypeScriptRuntime configuration contract
export interface AppRuntimeConfig {
  apiBaseUrl: string;
  appVersion: string;
}

// Load this public configuration before app bootstrap.
// Never include secrets: browser users can read every delivered value.
13

Consuming Swagger-Generated Clients

Reduce contract drift with OpenAPI
Practical

OpenAPI contract يصف endpoints و schemas و status codes. تقدر تولد TypeScript client باستخدام NSwag أو OpenAPI Generator أو tooling آخر. ده يقلل drift بين backend/frontend، لكنه لا يلغي الحاجة لمراجعة generated output و runtime validation. ثبّت generator version، خزن generation command في repo، وشغل generation/check في CI حتى لا يتغير client بصمت.

راجع nullability، optional fields، enum representation، date formats، polymorphism، file upload/download، Problem Details، auth schemes و cancellation support. لا تعدل generated files يدويًا؛ عدّل schema/config أو ضع wrapper service حول client generated. لا تجعل generated DTO هو domain model لكل UI؛ mapping بسيط قد يحمي UI من API version churn.

14

اختبار Angular API Integration

Test UI behavior and HTTP contracts
Practical

اختبر component behavior: loading/success/empty/error، validation، navigation، authorization-aware UI. اختبر services باستخدام HttpTestingController للتحقق من method/url/body/headers والاستجابة. اختبر guards/interceptors منفصلة. E2E tests تتحقق من user journey عبر browser، لكنها لا تستبدل unit/integration tests.

TypeScriptHTTP service test sketch
it('loads orders from the API', () => {
  service.getOrders().subscribe(orders => {
    expect(orders.length).toBe(1);
    expect(orders[0].id).toBe('ORD-1');
  });

  const request = httpTestingController.expectOne('/api/orders');
  expect(request.request.method).toBe('GET');
  request.flush([{ id: 'ORD-1', total: 120, status: 'Pending' }]);
});

لا تعتمد على test واحد happy path. اختبر 401، 403، timeout/network failure، malformed response، duplicate submit، slow response بعد navigation، refresh token race، unauthorized deep link، و keyboard accessibility. لا تجعل tests تعتمد على real production API أو shared account.

15

Calling SignalR/SSE و Frontend Boundaries

Realtime updates without coupling the UI
Practical

لو backend يستخدم SignalR، Angular يقدر يستخدم @microsoft/signalr لإدارة HubConnection. لا تنشئ connection جديدة كل component render؛ ضع ownership في service، وأعد الاتصال وفق policy محددة، و cleanup عند logout/app teardown. SSE مناسب one-way server-to-client updates، بينما SignalR يدعم bidirectional messaging/transports abstraction.

Realtime message قد تصل duplicate أو out-of-order أو بعد reconnect؛ صمم event IDs/versions و idempotent UI updates. لا تعتبر WebSocket connection authorization بديلًا عن authorization لكل hub method/group membership. لا تضف user إلى group بناءً على client-provided tenant ID من غير server validation.

16

Feature-Based Architecture و State Ownership

Keep UI modules cohesive
Deep dive

نظم Angular حسب features: orders/, customers/, auth/, shared/, core/. ضع page components داخل feature، و API service/DTOs قرب feature owner. shared للمكونات العامة فعلًا، وليس مكانًا لكل class لا تعرف أين تضعها. core للخدمات singleton على مستوى التطبيق مثل auth/session/config، مع تجنب تضخمها.

حدد state ownership: component state للـ filter/dialog الحالي؛ feature service state لبيانات مشتركة بين صفحات feature؛ router state للـ URL filters/page؛ server state للبيانات التي يملكها backend. NgRx أو Signal Store قد يفيدان عند تعقيد transitions/debugging/cross-feature coordination، لكن لا تضف global store لمجرد أن المشروع يستخدم Angular. ابدأ بأبسط state holder قابل للاختبار.

Feature-Based Architecture و State Ownership

نظّم Angular حسب features أو business capabilities: features/orders, features/catalog, core للبنية العامة مثل auth/interceptors، و shared لمكونات عامة حقيقية. لا تجعل shared مجلدًا لكل شيء؛ لو component لا يستخدم إلا داخل orders فهو ملك orders. تجنب circular imports بين features؛ التواصل عبر facade أو event contract أو route boundary حسب الحاجة.

State محلي للـ component يظل local. State مشتركة بين components في feature يمكن أن تكون feature service أو signal store. State عبر التطبيق مثل identity/theme قد تكون core service. لا تنقل كل server data إلى global store تلقائيًا؛ cache/query libraries أو service layer قد تكون كافية. حدّد مصدر الحقيقة، stale policy، invalidation بعد mutation، و loading/error states.

Route guard يحسن navigation UX لكنه ليس security boundary؛ backend authorization هو الحماية. لا تخزن secrets في environment.ts؛ كل ما يدخل browser bundle قابل للاستخراج. لا تضع role checks في UI وتعتبرها حماية للـ API.

17

اختبر فهمك

Knowledge check
Practical
هل Route Guard يحمي API من request مباشر؟
لا؛ هو يتحكم في navigation داخل client فقط. ASP.NET Core authorization هو الحماية الحقيقية.
ما الفرق بين signal و computed؟
signal تحمل state قابلة للتحديث؛ computed قيمة مشتقة read-only من signals أخرى.
هل HttpClient.get<OrderDto> يتحقق من JSON وقت runtime؟
لا؛ generic للـ compiler. يلزم runtime validation لو response غير موثوقة أو حساسة.
لماذا subscription مرتين قد تسبب HTTP request مرتين؟
HttpClient Observable عادة cold؛ كل subscription تنفذ request جديدة.
هل Environment file مكان آمن لـ API secret؟
لا؛ كل frontend bundle يمكن للمستخدم قراءته. ضع secrets في backend/secret manager.
متى تختار Reactive Forms؟
عند forms معقدة أو dynamic أو تحتاج typed model و validation/testability واضحة؛ Signal Forms خيار حديث حسب version/project.
18

Template Performance و Pure Pipes

Keep rendering declarative and cheap
Practical

Angular template expression قد تُقيّم أثناء change detection؛ تجنب function ثقيلة أو getter ينشئ array/object جديدًا كل مرة. استخدم computed state أو pure pipe للحسابات المناسبة، و track identity في loops. لا تستخدم impure pipe إلا عند سبب واضح لأنها قد تعمل كثيرًا. قس component render cost بدل إضافة OnPush أو memoization عشوائيًا.

19

معمل متكامل: Feature لإدارة المنتجات من Angular إلى ASP.NET Core

End-to-end feature slice: contract first
Practical

هنبني feature اسمها products على أساس إن الـ Backend موجود. الهدف مش مجرد استدعاء HttpClient؛ المطلوب contract واضح، loading/error/empty states، وفصل UI عن transport، ومعالجة race conditions. العقد: GET /api/products?page=1&pageSize=10&search=phone للقائمة، و GET /api/products/{id} للتفاصيل، و POST للإضافة، و PUT للتعديل.

استخدم DTOs بدل إرسال EF entities مباشرة. الـ Backend هو مصدر الحقيقة للسعر والصلاحيات والـ business rules. TypeScript types تساعد أثناء التطوير لكنها لا تتحقق من JSON وقت runtime، لذلك تعامل مع response كبيانات خارجية عند الحدود الحساسة.

20

API Service: اجمع تفاصيل HTTP في مكان واحد

Typed API boundary and query parameters
Deep dive

الـ Component لا ينبغي أن يعرف URL construction أو query serialization. الـ Service يملك ذلك. استخدم HttpParams بدل تركيب query string يدويًا، ودع interceptor مسؤولًا عن cross-cutting concerns مثل correlation أو authentication وفق تصميمك.

TypeScriptproducts-api.service.ts
import { Injectable, inject } from '@angular/core';
import { HttpClient, HttpParams } from '@angular/common/http';
import { Observable } from 'rxjs';

export interface ProductDto {
  id: number;
  name: string;
  price: number;
  isActive: boolean;
}

export interface ProductPageDto {
  items: ProductDto[];
  page: number;
  pageSize: number;
  totalCount: number;
}

export interface ProductQuery {
  page: number;
  pageSize: number;
  search?: string;
}

@Injectable({ providedIn: 'root' })
export class ProductsApi {
  private readonly http = inject(HttpClient);
  private readonly baseUrl = '/api/products';

  list(query: ProductQuery): Observable<ProductPageDto> {
    let params = new HttpParams()
      .set('page', query.page)
      .set('pageSize', query.pageSize);

    if (query.search?.trim()) {
      params = params.set('search', query.search.trim());
    }

    return this.http.get<ProductPageDto>(this.baseUrl, { params });
  }

  getById(id: number): Observable<ProductDto> {
    return this.http.get<ProductDto>(`${this.baseUrl}/${id}`);
  }
}

الـ generic في `http.get` لا يعمل runtime validation. لو contract خارجي أو غير مضمون، استخدم schema validation أو تحقق يدويًا عند boundary. لا تخزن API secrets داخل environment files؛ أي قيمة تدخل browser bundle يمكن استخراجها.

21

قائمة المنتجات: Loading و Empty و Error و Race Conditions

Component state and cancellation
Practical

لو المستخدم كتب ph ثم phone، قد ترجع request الأولى بعد الثانية وتستبدل النتائج الأحدث. switchMap يلغي subscription السابقة عند query جديدة. استخدم state واضحة، ولا تخلط empty state مع network failure.

TypeScriptproducts-list.component.ts
import { Component, DestroyRef, inject, signal } from '@angular/core';
import { FormControl, ReactiveFormsModule } from '@angular/forms';
import { catchError, debounceTime, distinctUntilChanged, finalize, of, startWith, switchMap } from 'rxjs';
import { takeUntilDestroyed } from '@angular/core/rxjs-interop';

@Component({
  standalone: true,
  selector: 'app-products-list',
  imports: [ReactiveFormsModule],
  templateUrl: './products-list.component.html'
})
export class ProductsListComponent {
  private readonly api = inject(ProductsApi);
  private readonly destroyRef = inject(DestroyRef);
  readonly search = new FormControl('', { nonNullable: true });
  readonly items = signal<ProductDto[]>([]);
  readonly loading = signal(false);
  readonly errorMessage = signal<string | null>(null);

  constructor() {
    this.search.valueChanges.pipe(
      startWith(this.search.value),
      debounceTime(250),
      distinctUntilChanged(),
      switchMap(term => {
        this.loading.set(true);
        this.errorMessage.set(null);
        return this.api.list({ page: 1, pageSize: 20, search: term }).pipe(
          catchError(() => {
            this.errorMessage.set('تعذر تحميل المنتجات. حاول مرة أخرى.');
            return of({ items: [], page: 1, pageSize: 20, totalCount: 0 });
          }),
          finalize(() => this.loading.set(false))
        );
      }),
      takeUntilDestroyed(this.destroyRef)
    ).subscribe(page => this.items.set(page.items));
  }
}
HTMLproducts-list.component.html
<label for="product-search">بحث عن منتج</label>
<input id="product-search" type="search" [formControl]="search" autocomplete="off" />
@if (loading()) {
  <p role="status" aria-live="polite">جارٍ تحميل المنتجات…</p>
}
@if (errorMessage(); as message) {
  <p role="alert">{{ message }}</p>
} @else if (!loading() && items().length === 0) {
  <p>لا توجد منتجات مطابقة.</p>
} @else {
  <ul>
    @for (product of items(); track product.id) {
      <li>{{ product.name }} — {{ product.price }}</li>
    }
  </ul>
}

هنا استخدمنا Angular built-in control flow (@if و @for) بدل *ngIf و *ngFor. finalize يعمل عند completion أو error أو unsubscribe، ولذلك ينهي loading حتى لو ألغى switchMap الطلب السابق. في مشروع حقيقي أضف pagination state و retry policy مناسبة، ولا تعمل retry تلقائيًا لعمليات كتابة غير idempotent.

22

Create و Update: منع Double Submit ومعالجة Validation Errors

Mutation lifecycle and server-side validation
Practical

عطّل submit أثناء الطلب، وأعد تفعيله عند النجاح أو الفشل. افصل field validation errors عن general errors. ASP.NET Core قد يرجع ValidationProblemDetails بمفتاح لكل field؛ اعرض الخطأ قرب الحقل باستخدام mapping صريح لأسماء properties.

TypeScriptSave mutation flow — inside a component
export class ProductEditorComponent {
  readonly saving = signal(false);
  readonly formError = signal<string | null>(null);
  productId: number | null = null;

  constructor(
    private readonly form: FormGroup,
    private readonly api: ProductsApi,
    private readonly router: Router,
    private readonly destroyRef: DestroyRef
  ) {}

  save(): void {
  if (this.form.invalid || this.saving()) {
    this.form.markAllAsTouched();
    return;
  }

  this.saving.set(true);
  this.formError.set(null);
  const request = this.form.getRawValue();
  const operation = this.productId
    ? this.api.update(this.productId, request)
    : this.api.create(request);

  operation.pipe(
    finalize(() => this.saving.set(false)),
    takeUntilDestroyed(this.destroyRef)
  ).subscribe({
    next: () => this.router.navigate(['/products']),
    error: error => {
      if (error.status === 400 && error.error?.errors) {
        this.applyServerValidation(error.error.errors);
        return;
      }
      if (error.status === 409) {
        this.formError.set('تم تعديل المنتج في مكان آخر. حدّث البيانات ثم حاول.');
        return;
      }
      this.formError.set('حدث خطأ أثناء الحفظ. حاول مرة أخرى.');
    }
  });
  }
}

المقتطف يفترض وجود typed form و router و API methods و imports المناسبة. منع double click في UI لا يمنع تكرار الطلب من الشبكة؛ للعمليات الحساسة استخدم idempotency key أو unique business constraint في backend. وللتعديل المتزامن استخدم concurrency token أو ETag وسياسة واضحة للتعارض.

جرّب success، empty result، 400 validation، 401 ثم refresh، 403، 404، 409 concurrency، 500، timeout، offline، وعودة response قديمة بعد query أحدث. افحص keyboard navigation و screen reader announcements أيضًا.
↗

المراجع والقراءة الإضافية

References & further reading

الدرس بيشرح الفكرة نفسها؛ الروابط دي للتحقق والتعمق والرجوع لتفاصيل الـ API. (محتاجة إنترنت.)

خريطة التغطية: 17 عنصر من الـ Roadmap ومكان شرحه في الدرس
RoadmapComponents and Templates§01
RoadmapData Binding§01
RoadmapDirectives§01
RoadmapServices§01
RoadmapDependency Injection§01
RoadmapRouting§01
RoadmapForms§01
RoadmapHttpClient§01
RoadmapObservables and RxJS Basics§01
RoadmapHTTP Interceptors§01
RoadmapError Handling§01
RoadmapEnvironment Configuration§01
RoadmapAuthentication Flow§01
RoadmapCalling ASP.NET Core APIs§01
SuggestedStandalone components and signals basics§01
SuggestedRoute guards and JWT interceptor§01
SuggestedConsuming Swagger-generated clients§01

خلصت الدرس وحليت الأسئلة؟ علّم عليه عشان يتحسب في تقدّمك.

محتويات الدرس