src/app/features/groups/group-form.component.ts

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

import { Component, OnInit, inject } from '@angular/core';
import { CommonModule } from '@angular/common';
import { ActivatedRoute, Router } from '@angular/router';
import { FormsModule } from '@angular/forms';
import { TranslateModule } from '@ngx-translate/core';
import { MatCardModule } from '@angular/material/card';
import { MatFormFieldModule } from '@angular/material/form-field';
import { MatInputModule } from '@angular/material/input';
import { MatSelectModule } from '@angular/material/select';
import { MatButtonModule } from '@angular/material/button';
import { MatCheckboxModule } from '@angular/material/checkbox';
import { MatTooltipModule } from '@angular/material/tooltip';
import { MatIconModule } from '@angular/material/icon';
import { MatDatepickerModule } from '@angular/material/datepicker';
import { MatNativeDateModule } from '@angular/material/core';
import {
  GroupsService,
  OfficesService,
  PostGroupsRequest,
  PostGroupsGroupIdRequest,
  PutGroupsGroupIdRequest,
  GetOfficesResponse,
} from '../../api';

/**
 * Component for creating and editing self-help groups.
 *
 * This component manages group lifecycle operations, including mandatory
 * activation date handling for new active groups.
 */
@Component({
  selector: 'app-group-form',
  standalone: true,
  imports: [
    CommonModule,
    FormsModule,
    TranslateModule,
    MatCardModule,
    MatFormFieldModule,
    MatInputModule,
    MatSelectModule,
    MatButtonModule,
    MatCheckboxModule,
    MatTooltipModule,
    MatIconModule,
    MatDatepickerModule,
    MatNativeDateModule,
  ],
  template: `
    <div class="form-container">
      <mat-card>
        <mat-card-header>
          <mat-card-title>
            {{
              isEditMode ? ('GROUPS.EDIT_GROUP' | translate) : ('GROUPS.CREATE_GROUP' | translate)
            }}
          </mat-card-title>
        </mat-card-header>

        <mat-card-content>
          <form #groupForm="ngForm" (ngSubmit)="onSubmit()" class="group-form">
            <div class="form-grid">
              <!-- Name -->
              <mat-form-field
                appearance="outline"
                [matTooltip]="'HELP.GROUP_NAME_DESC' | translate"
              >
                <mat-label>{{ 'GROUPS.NAME' | translate }}</mat-label>
                <input matInput name="name" [(ngModel)]="group.name" required />
              </mat-form-field>

              <!-- Office -->
              <mat-form-field appearance="outline" [matTooltip]="'HELP.OFFICE_DESC' | translate">
                <mat-label>{{ 'COMMON.OFFICE' | translate }}</mat-label>
                <mat-select
                  name="officeId"
                  [(ngModel)]="group.officeId"
                  required
                  [disabled]="isEditMode"
                >
                  @for (office of offices; track office.id) {
                    <mat-option [value]="office.id">{{ office.name }}</mat-option>
                  }
                </mat-select>
              </mat-form-field>

              <!-- Activation Date -->
              @if (!isEditMode) {
                <mat-form-field
                  appearance="outline"
                  [matTooltip]="'HELP.ACTIVATION_DATE_DESC' | translate"
                >
                  <mat-label>{{ 'COMMON.ACTIVATION_DATE' | translate }}</mat-label>
                  <input
                    matInput
                    [matDatepicker]="picker"
                    name="activationDate"
                    [(ngModel)]="activationDate"
                    [required]="!!group.active"
                  />
                  <mat-datepicker-toggle matSuffix [for]="picker"></mat-datepicker-toggle>
                  <mat-datepicker #picker></mat-datepicker>
                </mat-form-field>
              }

              <!-- Active -->
              <div class="checkbox-container">
                <mat-checkbox name="active" [(ngModel)]="group.active" [disabled]="isEditMode">
                  {{ 'COMMON.ACTIVE' | translate }}
                </mat-checkbox>
                <mat-icon [matTooltip]="'HELP.ACTIVE_DESC' | translate" class="help-icon"
                  >help_outline</mat-icon
                >
              </div>
            </div>

            <div class="form-actions">
              <button mat-button type="button" (click)="onCancel()">
                {{ 'COMMON.CANCEL' | translate }}
              </button>
              @if (isEditMode && !originalActive) {
                <button
                  mat-raised-button
                  color="accent"
                  type="button"
                  (click)="onActivate()"
                  [disabled]="isSaving || !activationDate"
                >
                  {{ isSaving ? ('COMMON.SAVING' | translate) : 'Activate Group' }}
                </button>
              }
              <button
                mat-raised-button
                color="primary"
                type="submit"
                [disabled]="groupForm.invalid || isSaving"
              >
                {{ isSaving ? ('COMMON.SAVING' | translate) : ('COMMON.SAVE' | translate) }}
              </button>
            </div>
          </form>
        </mat-card-content>
      </mat-card>
    </div>
  `,
  styles: [
    `
      .form-container {
        padding: 24px;
        max-width: 900px;
        margin: 0 auto;
      }
      .group-form {
        display: flex;
        flex-direction: column;
        gap: 16px;
      }
      .form-grid {
        display: grid;
        grid-template-columns: repeat(2, 1fr);
        gap: 16px;
      }
      mat-form-field {
        width: 100%;
      }
      .checkbox-container {
        display: flex;
        align-items: center;
        gap: 8px;
        height: 60px;
      }
      .form-actions {
        display: flex;
        justify-content: flex-end;
        gap: 12px;
        margin-top: 16px;
      }
      .help-icon {
        font-size: 18px;
        width: 18px;
        height: 18px;
        color: #7f8c8d;
        cursor: help;
      }
    `,
  ],
})
export class GroupFormComponent implements OnInit {
  /** Service for group management API calls */
  private readonly groupsService = inject(GroupsService);
  /** Service for office data retrieval */
  private readonly officesService = inject(OfficesService);
  /** Router for navigation */
  private readonly router = inject(Router);
  /** Activated route for parameter access */
  private readonly route = inject(ActivatedRoute);

  /** Constant for Fineract date format */
  private readonly DATE_FORMAT = 'yyyy-MM-dd';
  /** Path for redirection */
  private readonly LIST_PATH = '/groups';

  /** Group ID in edit mode */
  groupId: number | null = null;
  /** Edit mode flag */
  isEditMode = false;
  /** Save state */
  isSaving = false;
  /** Initial active state */
  originalActive = false;

  /** Strictly typed request model from OpenAPI */
  group: PostGroupsRequest = {
    active: true,
  };

  /** Activation date for new groups */
  activationDate: Date = new Date();
  /** Office options */
  offices: GetOfficesResponse[] = [];

  /**
   * Initializes the component.
   */
  ngOnInit(): void {
    this.loadOffices();
    this.route.paramMap.subscribe((params) => {
      const id = params.get('id');
      if (id) {
        this.groupId = +id;
        this.isEditMode = true;
        this.loadGroupData();
      }
    });
  }

  /**
   * Retrieves the list of available offices.
   */
  private loadOffices(): void {
    this.officesService.retrieveOffices(true).subscribe((offices) => {
      this.offices = offices;
    });
  }

  /**
   * Loads group data for editing.
   */
  private loadGroupData(): void {
    if (!this.groupId) return;
    this.groupsService.retrieveOne15(this.groupId).subscribe((data) => {
      this.originalActive = !!(data as Record<string, unknown>)['active'];
      this.group = {
        name: data.name,
        officeId: data.officeId,
        active: this.originalActive,
      };
    });
  }

  onActivate(): void {
    if (!this.groupId || !this.activationDate) return;
    this.isSaving = true;

    const formattedDate = `${this.activationDate.getFullYear()}-${String(
      this.activationDate.getMonth() + 1,
    ).padStart(2, '0')}-${String(this.activationDate.getDate()).padStart(2, '0')}`;

    const payload = {
      activationDate: formattedDate,
      dateFormat: this.DATE_FORMAT,
      locale: 'en',
    };

    this.groupsService
      .activateOrGenerateCollectionSheet(
        this.groupId,
        payload as PostGroupsGroupIdRequest,
        'activate',
      )
      .subscribe({
        next: () => {
          this.isSaving = false;
          this.originalActive = true;
          this.group.active = true;
        },
        error: () => (this.isSaving = false),
      });
  }

  /**
   * Submits the form, ensuring mandatory activationDate is formatted correctly.
   */
  onSubmit(): void {
    this.isSaving = true;

    if (this.isEditMode && this.groupId) {
      const payload: PutGroupsGroupIdRequest = {
        name: this.group.name,
      };
      this.groupsService.update13(this.groupId, payload).subscribe({
        next: () => this.router.navigate([this.LIST_PATH]),
        error: () => (this.isSaving = false),
      });
    } else {
      const formattedDate = `${this.activationDate.getFullYear()}-${String(
        this.activationDate.getMonth() + 1,
      ).padStart(2, '0')}-${String(this.activationDate.getDate()).padStart(2, '0')}`;

      // Assert as Record to include mandatory undocumented fields for activation
      const payload: Record<string, unknown> = {
        ...this.group,
        activationDate: formattedDate,
        dateFormat: this.DATE_FORMAT,
        locale: 'en',
      };

      this.groupsService.create8(payload as PostGroupsRequest).subscribe({
        next: () => this.router.navigate([this.LIST_PATH]),
        error: () => (this.isSaving = false),
      });
    }
  }

  /**
   * Navigates back to the group list.
   */
  onCancel(): void {
    this.router.navigate([this.LIST_PATH]);
  }
}