Merge branch 'main' of git.targo.ca:Targo/targo_backend

src/modules/expenses/controllers/expense.controller.ts

@@ -1,10 +1,21 @@
-import { Controller } from "@nestjs/common";
+import { Body, Controller, Param, ParseIntPipe, Post } from "@nestjs/common";
 import { PrismaService } from "src/prisma/prisma.service";
+import { ExpenseDto } from "../dtos/expense.dto";
+import { CreateResult, ExpenseUpsertService } from "../services/expense-upsert.service";
 
 
 @Controller('expense')
 export class ExpenseController {
-    constructor(private readonly prisma: PrismaService){}
+    constructor(
+        private readonly prisma: PrismaService,
+        private readonly upsert_service: ExpenseUpsertService,
+    ){}
 
 
+    // @Post(':timesheet_id')
+    // create(
+    // @Param('timesheet_id', ParseIntPipe) timesheet_id: number,
+    // @Body() dto: ExpenseDto): Promise<CreateResult>{
+    //     return this.upsert_service.createExpense(timesheet_id, dto);
+    // }
 }

src/modules/expenses/dtos/expense.dto.ts

@@ -0,0 +1,14 @@
+import { IsBoolean, IsInt, IsOptional, IsString, MaxLength } from "class-validator";
+
+export class ExpenseDto {
+    @IsInt()    bank_code_id!: number;
+    @IsInt()    timesheet_id!: number;
+    @IsString() @IsOptional() attachment?: string;
+    
+    @IsString()  date!: string;
+    @IsInt()     @IsOptional()   amount?:  number;
+    @IsInt()     @IsOptional()   mileage?: number;
+    @IsString()  @MaxLength(280) comment!: string;
+    @IsBoolean() is_approved!:  boolean;
+    @IsString()  @MaxLength(280)  @IsOptional() supervisor_comment?: string
+}

src/modules/expenses/dtos/get-expense.dto.ts

@@ -0,0 +1,11 @@
+export class GetExpenseDto {
+    timesheet_id: number;
+    bank_code_id: number;
+    attachment?:  string;
+    date:         string;
+    comment:      string;
+    mileage?:     number;
+    amount?:      number;
+    supervisor_comment?: string;
+    is_approved:  boolean;
+}

src/modules/expenses/dtos/update-expense.dto.ts

@@ -0,0 +1,6 @@
+import { OmitType, PartialType } from "@nestjs/swagger";
+import { ExpenseDto } from "./expense.dto";
+
+export class updateExpenseDto extends PartialType (
+    OmitType(ExpenseDto, ['is_approved', 'timesheet_id'] as const)
+){}

src/modules/expenses/helpers/expenses-date-time-helpers.ts

@@ -0,0 +1,3 @@
+export const  toDateFromString = (ymd: string): Date => {
+  return new Date(`${ymd}T00:00:00:000Z`); 
+}

src/modules/expenses/services/expense-upsert.service.ts

@@ -0,0 +1,46 @@
+import { Injectable } from "@nestjs/common";
+import { PrismaService } from "src/prisma/prisma.service";
+import { GetExpenseDto } from "../dtos/get-expense.dto";
+import { updateExpenseDto } from "../dtos/update-expense.dto";
+import { ExpenseDto } from "../dtos/expense.dto";
+import { toDateFromString } from "../helpers/expenses-date-time-helpers";
+
+type Normalized = { date: Date; comment: string; supervisor_comment: string; };
+
+export type CreateResult  = { ok: true;   data: GetExpenseDto } | { ok: false; error: any };
+export type UpdatePayload = { id: number; dto: updateExpenseDto };
+export type UpdateResult  = { ok: true;   id: number; data: GetExpenseDto } | { ok: false; id: number; error: any };
+export type DeleteResult  = { ok: true;   id: number; } | { ok: false; id: number; error: any };
+
+type NormedOk  = { dto: GetExpenseDto; normed: Normalized };
+type NormedErr = { error: any };
+
+@Injectable()
+export class ExpenseUpsertService {
+    constructor(private readonly prisma: PrismaService){}
+
+    //_________________________________________________________________
+    //                              CREATE
+    //_________________________________________________________________
+    //normalized frontend data to match DB
+    async createExpense(timesheet_id: number, dto: ExpenseDto){
+        const normed_expense = this.normalizeExpenseDto(dto)
+        
+
+    }
+
+    //_________________________________________________________________
+    //                         LOCAL HELPERS
+    //_________________________________________________________________
+    private normalizeExpenseDto(dto: ExpenseDto): Normalized {
+        const date    = toDateFromString(dto.date);
+        const comment = this.truncate280(dto.comment);
+        const supervisor_comment = this.truncate280(dto.supervisor_comment? dto.supervisor_comment : '');
+        return { date, comment, supervisor_comment };
+    }
+
+    //makes sure that a string cannot exceed 280 chars
+    private truncate280 = (input: string): string => {
+        return input.length > 280 ? input.slice(0, 280) : input;
+    }
+}

src/modules/shifts/services/shifts-upsert.service.ts

@@ -333,7 +333,7 @@ export class ShiftsUpsertService {
     //_________________________________________________________________
     //                              DELETE
     //_________________________________________________________________
-    //finds shift using shit_ids
+    //finds shifts using shit_ids
     //recalc overtime shifts after delete
     //blocs deletion if approved
 	    async deleteShift(shift_id: number) {

src/modules/timesheets/helpers/timesheets-date-time-helpers.ts

@@ -1,3 +1,11 @@
+export function weekStartSunday(date_local: Date): Date {
+  const start = new Date(Date.UTC(date_local.getFullYear(), date_local.getMonth(), date_local.getDate()));
+  const dow = start.getDay();
+  start.setDate(start.getDate() - dow);
+  start.setHours(0, 0, 0, 0);
+  return start;
+}
+
 export const toDateFromString = ( date: Date | string):Date => {
     const d = new Date(date);
     return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
@@ -10,6 +18,7 @@ export const sevenDaysFrom = (date: Date | string): Date[] => {
         return d;
     });
 }
+
 export const toStringFromDate = (date: Date | string): string => {
     const d     = toDateFromString(date);
     const year  = d.getUTCFullYear();
@@ -24,3 +33,4 @@ export const toHHmmFromDate = (input: Date | string): string => {
     const mm = String(date.getUTCMinutes()).padStart(2, '0');
     return `${hh}:${mm}`;
 }
+

src/modules/timesheets/services/timesheet-get-overview.service.ts

@@ -19,22 +19,42 @@ type TotalExpenses = {
     mileage: number;
 };
 
+const NUMBER_OF_TIMESHEETS_TO_RETURN = 2;
+
 @Injectable()
 export class GetTimesheetsOverviewService {
     constructor(private readonly prisma: PrismaService) { }
 
+    //-----------------------------------------------------------------------------------
+    //                     GET TIMESHEETS FOR A SELECTED EMPLOYEE
+    //-----------------------------------------------------------------------------------
     async getTimesheetsForEmployeeByPeriod(employee_id: number, pay_year: number, pay_period_no: number) {
         //find period using year and period_no
-        const period = await this.prisma.payPeriods.findFirst({
-            where: { pay_year, pay_period_no },
-        });
+        const period = await this.prisma.payPeriods.findFirst({ where: { pay_year, pay_period_no } });
         if (!period) throw new NotFoundException(`Pay period ${pay_year}-${pay_period_no} not found`);
 
         //loads the timesheets related to the fetched pay-period
-        const rows = await this.loadTimesheets({
-            employee_id,
-            start_date: { gte: period.period_start, lte: period.period_end },
-        });
+        const timesheet_range = { employee_id, start_date: { gte: period.period_start, lte: period.period_end } };
+        let rows = await this.loadTimesheets(timesheet_range);
+
+        //Normalized dates from pay-period
+        const normalized_start = toDateFromString(period.period_start);
+        const normalized_end   = toDateFromString(period.period_end);
+        
+        //creates empty timesheet to make sure to return desired amount of timesheet 
+        for (let i = 0; i < NUMBER_OF_TIMESHEETS_TO_RETURN; i++) {
+            const week_start = new Date(normalized_start);
+                  week_start.setUTCDate(week_start.getUTCDate() + i * 7);
+
+            if (week_start.getTime() > normalized_end.getTime()) break;
+
+            const exists = rows.some(
+                (row) => toDateFromString(row.start_date).getTime() === week_start.getTime()
+            );
+            if (!exists) await this.ensureTimesheet(employee_id, week_start);
+        }
+        rows = await this.loadTimesheets(timesheet_range);
+
 
         //find user infos using the employee_id
         const employee = await this.prisma.employees.findUnique({
@@ -56,6 +76,7 @@ export class GetTimesheetsOverviewService {
     //-----------------------------------------------------------------------------------
     //                                MAPPERS & HELPERS
     //-----------------------------------------------------------------------------------
+
     //fetch timesheet's infos
     private async loadTimesheets(where: any) {
         return this.prisma.timesheets.findMany({
@@ -172,6 +193,38 @@ export class GetTimesheetsOverviewService {
             weekly_expenses,
         };
     }
+
+    private ensureTimesheet = async (employee_id: number, start_date: Date | string) => {
+        const start = toDateFromString(start_date);
+
+        let row = await this.prisma.timesheets.findFirst({
+            where: { employee_id, start_date: start },
+            include: {
+                employee: { include: { user: true } },
+                shift: { include: { bank_code: true } },
+                expense: { include: { bank_code: true, attachment_record: true } },
+            },
+        });
+        if (row) return row;
+
+        await this.prisma.timesheets.create({
+            data: {
+                employee_id,
+                start_date: start,
+                is_approved: false
+            },
+        });
+
+        row = await this.prisma.timesheets.findFirst({
+            where: { employee_id, start_date: start },
+            include: {
+                employee: { include: { user: true } },
+                shift: { include: { bank_code: true } },
+                expense: { include: { bank_code: true, attachment_record: true } },
+            },
+        });
+        return row!;
+    }
 }
 
 //filled array with default values