feat: interest posting

src/app/interest-posting-report/interest-posting-report.service.ts

@@ -12,6 +12,9 @@ import { Observable } from 'rxjs';
 
 export type InterestPostingReportStatus = 'GENERATED' | 'APPROVED' | 'POSTED' | 'SUPERSEDED';
 
+/** Which branches a list covers: the user's own, or (head office only) every other branch. */
+export type ReportScope = 'own' | 'others';
+
 export interface InterestPostingReport {
   id: number;
   productId: number;
@@ -32,6 +35,8 @@ export interface InterestPostingReport {
   failureReason: string | null;
   /** Whether the signed-in user may regenerate or approve it: their own branch, or the head office for a branch that did not open. */
   canAct: boolean;
+  /** Why not, where canAct is false. */
+  blockedReason: string | null;
 }
 
 export interface InterestPostingReportLine {
@@ -60,6 +65,8 @@ export interface InterestPostingDue {
   officeId: number;
   officeName: string;
   postingDate: string;
+  canAct: boolean;
+  blockedReason: string | null;
 }
 
 export interface InterestPostingSummaryRow {
@@ -78,6 +85,22 @@ export interface InterestPostingSummaryRow {
   postedAt: string | null;
 }
 
+export interface InterestPreviewRow {
+  officeId: number;
+  officeName: string;
+  productId: number;
+  productName: string;
+  savingsAccountId: number;
+  accountNo: string;
+  clientName: string;
+  balance: number;
+  rate: number;
+  cycleStart: string;
+  postingDate: string;
+  asOf: string;
+  interest: number;
+}
+
 /**
  * The savings interest posting reports, one per branch and product: generated at noon on a posting
  * date, approved by the branch, posted when the branch closes the day.
@@ -87,8 +110,15 @@ export class InterestPostingReportService {
   private http = inject(HttpClient);
   private readonly base = '/savingsinterestpostingreports';
 
-  list(postingDate?: string, status?: string, officeId?: number): Observable<InterestPostingReport[]> {
+  /** scope 'own' is the user's own branch; 'others' (head office only) every other branch. */
+  list(
+    postingDate?: string,
+    status?: string,
+    officeId?: number,
+    scope?: ReportScope
+  ): Observable<InterestPostingReport[]> {
     let params = new HttpParams();
+    if (scope) params = params.set('scope', scope);
     if (postingDate) params = params.set('postingDate', postingDate);
     if (status) params = params.set('status', status);
     if (officeId) params = params.set('officeId', String(officeId));
@@ -96,12 +126,18 @@ export class InterestPostingReportService {
   }
 
   /** Branch and product pairs with interest due by the date and no report yet, that this user may generate. */
-  dueWithoutReport(postingDate?: string): Observable<InterestPostingDue[]> {
+  dueWithoutReport(postingDate?: string, scope?: ReportScope): Observable<InterestPostingDue[]> {
     let params = new HttpParams();
+    if (scope) params = params.set('scope', scope);
     if (postingDate) params = params.set('postingDate', postingDate);
     return this.http.get<InterestPostingDue[]>(`${this.base}/due-without-report`, { params });
   }
 
+  /** The signed-in user's branch, and whether it is the head office. */
+  context(): Observable<{ officeId: number; officeName: string; headOffice: boolean }> {
+    return this.http.get<{ officeId: number; officeName: string; headOffice: boolean }>(`${this.base}/context`);
+  }
+
   detail(reportId: number): Observable<InterestPostingReportDetail> {
     return this.http.get<InterestPostingReportDetail>(`${this.base}/${reportId}`);
   }
@@ -126,6 +162,13 @@ export class InterestPostingReportService {
     );
   }
 
+  /** Interest each account has earned so far this cycle, as if posted today. View only. */
+  preview(officeId?: number): Observable<InterestPreviewRow[]> {
+    let params = new HttpParams();
+    if (officeId) params = params.set('officeId', String(officeId));
+    return this.http.get<InterestPreviewRow[]>(`${this.base}/preview`, { params });
+  }
+
   /** The head office's branch-wise view over a date range. */
   summary(fromDate?: string, toDate?: string, productId?: number): Observable<InterestPostingSummaryRow[]> {
     let params = new HttpParams();