3776 maintenence Description field for rr

src/backend/src/controllers/reimbursement-requests.controllers.ts

@@ -83,7 +83,8 @@ export default class ReimbursementRequestsController {
         otherReimbursementProducts,
         wbsReimbursementProducts,
         accountCodeId,
-        totalCost
+        totalCost,
+        description
       } = req.body;
       const user = await getCurrentUserWithUserSettings(res);
 
@@ -96,7 +97,8 @@ export default class ReimbursementRequestsController {
         accountCodeId,
         totalCost,
         req.organization,
-        dateOfExpense
+        dateOfExpense,
+        description
       );
       res.status(200).json(createdReimbursementRequest);
     } catch (error: unknown) {
@@ -130,7 +132,8 @@ export default class ReimbursementRequestsController {
         totalCost,
         otherReimbursementProducts,
         wbsReimbursementProducts,
-        receiptPictures
+        receiptPictures,
+        description
       } = req.body;
 
       const updatedReimbursementRequestId = await ReimbursementRequestService.editReimbursementRequest(
@@ -144,7 +147,8 @@ export default class ReimbursementRequestsController {
         receiptPictures,
         req.currentUser,
         req.organization,
-        dateOfExpense
+        dateOfExpense,
+        description
       );
       res.status(200).json(updatedReimbursementRequestId);
     } catch (error: unknown) {

src/backend/src/prisma/migrations/20260112034057_add_description_to_reimbursement_request/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "Reimbursement_Request" ADD COLUMN     "description" TEXT;

src/backend/src/prisma/migrations/20260208090936_made_description_not_optional/migration.sql

@@ -0,0 +1,8 @@
+/*
+  Warnings:
+
+  - Made the column `description` on table `Reimbursement_Request` required. This step will fail if there are existing NULL values in that column.
+
+*/
+-- AlterTable
+ALTER TABLE "Reimbursement_Request" ALTER COLUMN "description" SET NOT NULL;

src/backend/src/prisma/schema.prisma

@@ -701,6 +701,7 @@ model Reimbursement_Request {
   dateCreated              DateTime                        @default(now())
   dateDeleted              DateTime?
   dateOfExpense            DateTime?
+  description              String
   reimbursementStatuses    Reimbursement_Status[]
   recipientId              String
   recipient                User                            @relation(name: "reimbursementRequestRecipient", fields: [recipientId], references: [userId])

src/backend/src/prisma/seed-data/reimbursement-requests.seed.ts

@@ -97,7 +97,8 @@ export const seedReimbursementRequests = async (
     accountCodes.equipment.accountCodeId,
     3500,
     organization,
-    new Date('2024-10-01')
+    new Date('2024-10-01'),
+    'Reimbursement request for high performance battery pack'
   );
   reimbursementRequests.push(rr1);
 

src/backend/src/services/reimbursement-requests.services.ts

@@ -228,6 +228,7 @@ export default class ReimbursementRequestService {
    * @param accountCodeId the id of the account code the user made
    * @param totalCost the total cost of the reimbursement with tax
    * @param organizationId the organization the user is currently in
+   * @param description the description of the reimbursement request
    * @returns the created reimbursement request
    */
   static async createReimbursementRequest(
@@ -239,7 +240,8 @@ export default class ReimbursementRequestService {
     acccountCodeId: string,
     totalCost: number,
     organization: Organization,
-    dateOfExpense?: Date
+    dateOfExpense?: Date,
+    description?: string
   ): Promise<ReimbursementRequest> {
     if (await userHasPermission(recipient.userId, organization.organizationId, isGuest))
       throw new AccessDeniedGuestException('create a reimbursement request');
@@ -280,7 +282,8 @@ export default class ReimbursementRequestService {
           }
         },
         identifier: numReimbursementRequests + 1,
-        organization: { connect: { organizationId: organization.organizationId } }
+        organization: { connect: { organizationId: organization.organizationId } },
+        description: description ?? ''
       }
     });
 
@@ -362,6 +365,7 @@ export default class ReimbursementRequestService {
    * @param receiptPictures the old receipts that haven't been deleted (new receipts must be separately uploaded)
    * @param submitter the person editing the reimbursement request
    * @param organizationId the organization the user is currently in
+   * @param description the updated description of the reimbursement request
    * @returns the edited reimbursement request
    */
   static async editReimbursementRequest(
@@ -375,7 +379,8 @@ export default class ReimbursementRequestService {
     receiptPictures: ReimbursementReceiptCreateArgs[],
     submitter: User,
     organization: Organization,
-    dateOfExpense?: Date
+    dateOfExpense?: Date,
+    description?: string
   ): Promise<Reimbursement_Request> {
     const oldReimbursementRequest = await prisma.reimbursement_Request.findUnique({
       where: { reimbursementRequestId: requestId },
@@ -414,6 +419,7 @@ export default class ReimbursementRequestService {
       where: { reimbursementRequestId: oldReimbursementRequest.reimbursementRequestId },
       data: {
         dateOfExpense: dateOfExpense ?? null,
+        description: description ?? '',
         indexCodeId,
         totalCost,
         accountCodeId: accountCode.accountCodeId,
@@ -490,6 +496,7 @@ export default class ReimbursementRequestService {
    * @param reimbursementId The id of the reimbursement to be edited
    * @param editor The user editing the reimbursement
    * @param amount The new amount of the reimbursement
+   * @param description The new description of the reimbursement
    * @param dateCreated The new date the reimbursement was created
    * @param organizationId The organization the user is currently in
    * @returns The updated reimbursement

src/backend/src/transformers/reimbursement-requests.transformer.ts

@@ -51,6 +51,7 @@ export const reimbursementRequestTransformer = (
     saboId: reimbursementRequest.saboId ?? undefined,
     dateCreated: reimbursementRequest.dateCreated,
     dateOfExpense: reimbursementRequest.dateOfExpense ?? undefined,
+    description: reimbursementRequest.description,
     reimbursementStatuses: reimbursementRequest.reimbursementStatuses.map(reimbursementStatusTransformer),
     recipient: userTransformer(reimbursementRequest.recipient),
     vendor: vendorTransformer(reimbursementRequest.vendor),

src/frontend/src/pages/FinancePage/EditReimbursementRequest/EditReimbursementRequestRenderedDefaultValues.tsx

@@ -41,6 +41,7 @@ const EditReimbursementRequestRenderedDefaultValues: React.FC<{
           vendorId: reimbursementRequest.vendor.vendorId,
           indexCodeId: reimbursementRequest.indexCode.indexCodeId,
           dateOfExpense: reimbursementRequest.dateOfExpense ? new Date(reimbursementRequest.dateOfExpense) : undefined,
+          description: reimbursementRequest.description ?? '',
           accountCodeId: reimbursementRequest.accountCode.accountCodeId,
           reimbursementProducts: reimbursementRequest.reimbursementProducts.map((product) => ({
             reason: (product.reimbursementProductReason as WBSElementData).wbsNum

src/frontend/src/pages/FinancePage/FinanceComponents/ReimbursementRequestInfo.tsx

@@ -1,4 +1,4 @@
-import { Box } from '@mui/material';
+import { Box, Tooltip, IconButton } from '@mui/material';
 import { useLocation, useHistory } from 'react-router-dom';
 import { useState } from 'react';
 import { isGuest, ReimbursementRequest } from 'shared';
@@ -21,6 +21,7 @@ import SidePage from './SidePagePopup';
 import ReimbursementRequestDetails from '../ReimbursementRequestDetailPage/ReimbursementRequestDetails';
 import NERDataGrid, { MapRowResult } from '../../../components/NERDataGrid';
 import { GridColDef, GridRenderCellParams } from '@mui/x-data-grid';
+import InfoOutlinedIcon from '@mui/icons-material/InfoOutlined';
 
 interface ReimbursementRequestInfoProps {
   userReimbursementRequests: ReimbursementRequest[];
@@ -171,6 +172,28 @@ const ReimbursementRequestInfo = ({
         flex: 0.7,
         minWidth: 180,
         valueGetter: (params: any) => dateUndefinedPipe(params.row.dateSubmittedToSabo)
+      },
+      {
+        field: 'description',
+        headerName: 'Description',
+        flex: 0.7,
+        minWidth: 180,
+        valueGetter: (params: any) => params.row.description,
+        renderCell: (params: any) => {
+          const { description } = params.row;
+
+          if (!description || description.trim() === '') {
+            return null;
+          }
+
+          return (
+            <Tooltip title={description} arrow placement="left">
+              <IconButton size="small" sx={{ p: 0.5, color: 'white' }}>
+                <InfoOutlinedIcon fontSize="small" />
+              </IconButton>
+            </Tooltip>
+          );
+        }
       }
     );
 
@@ -214,7 +237,8 @@ const ReimbursementRequestInfo = ({
         ('$' + centsToDollar((rowData as any).amount)).toLowerCase().includes(lowercase_query) ||
         ('' + (rowData as any).reimbursementProducts.map((product: any) => product.name))
           .toLowerCase()
-          .includes(lowercase_query)
+          .includes(lowercase_query) ||
+        ('' + (rowData as any).description).toLowerCase().includes(lowercase_query)
       );
     });
   };

src/frontend/src/pages/FinancePage/ReimbursementRequestDetailPage/ReimbursementRequestDetailsView.tsx

@@ -19,6 +19,7 @@ import LocalAtmIcon from '@mui/icons-material/LocalAtm';
 import StoreIcon from '@mui/icons-material/Store';
 import SellIcon from '@mui/icons-material/Sell';
 import CurrencyExchangeIcon from '@mui/icons-material/CurrencyExchange';
+import Description from '@mui/icons-material/Description';
 
 import { Typography, useTheme, Link, IconButton } from '@mui/material';
 import { Box } from '@mui/system';
@@ -435,7 +436,8 @@ const ReimbursementRequestDetailsView: React.FC<ReimbursementRequestDetailsViewP
     { label: 'SABO Number', icon: <SellIcon fontSize="small" /> },
     { label: 'Refund Source', icon: <CurrencyExchangeIcon fontSize="small" /> },
     { label: 'Expense Type', icon: <CurrencyExchangeIcon fontSize="small" /> },
-    { label: 'Assigned To', icon: <PersonOutlineIcon fontSize="small" /> }
+    { label: 'Assigned To', icon: <PersonOutlineIcon fontSize="small" /> },
+    { label: 'Description', icon: <Description fontSize="small" /> }
   ];
 
   // grab all unique refund source names
@@ -470,7 +472,8 @@ const ReimbursementRequestDetailsView: React.FC<ReimbursementRequestDetailsViewP
       content: refundSourceNames.join(', ')
     },
     { content: accountCodePipe(reimbursementRequest.accountCode) },
-    { content: fullNamePipe(reimbursementRequest.assignee) }
+    { content: fullNamePipe(reimbursementRequest.assignee) },
+    { content: reimbursementRequest.description }
   ];
 
   const { id } = useParams<{ id: string }>();

src/frontend/src/pages/FinancePage/ReimbursementRequestForm/ReimbursementFormView.tsx

@@ -626,6 +626,37 @@ const ReimbursementRequestFormView: React.FC<ReimbursementRequestFormViewProps>
             {/* Right Column */}
             <Grid item xs={12} md={6}>
               <Stack spacing={3}>
+                {/* Description */}
+                <FormControl sx={{ borderRadius: '25px', width: '100%' }}>
+                  <FormLabel
+                    sx={{
+                      color: '#dd524c',
+                      textShadow: '1.5px 0 #dd524c',
+                      letterSpacing: '0.5px',
+                      textDecoration: 'underline',
+                      textUnderlineOffset: '3.5px',
+                      textDecorationThickness: '0.6px',
+                      fontSize: 'x-large',
+                      fontWeight: 'bold'
+                    }}
+                  >
+                    Input Description
+                  </FormLabel>
+                  <Controller
+                    name="description"
+                    control={control}
+                    render={({ field: { onChange, value } }) => (
+                      <TextField
+                        value={value || ''}
+                        onChange={onChange}
+                        placeholder="Enter Description"
+                        multiline
+                        rows={3}
+                      />
+                    )}
+                  />
+                </FormControl>
+
                 {/* Account Code */}
                 <FormControl sx={{ borderRadius: '25px', width: '100%' }}>
                   <FormLabel

src/frontend/src/pages/FinancePage/ReimbursementRequestForm/ReimbursementRequestForm.tsx

@@ -30,6 +30,7 @@ export interface ReimbursementRequestInformation {
   receiptFiles: ReimbursementReceiptUploadArgs[];
   indexCodeId: string;
   secondaryAccount?: string;
+  description?: string;
 }
 export interface ReimbursementRequestFormInput extends ReimbursementRequestInformation {
   reimbursementProducts: ReimbursementProductFormArgs[];
@@ -96,6 +97,7 @@ const schema = yup.object().shape({
   }),
   dateOfExpense: yup.date().optional(),
   accountCodeId: yup.string().required('Account code is required'),
+  description: yup.string().optional(),
   reimbursementProducts: yup
     .array()
     .of(
@@ -158,6 +160,7 @@ const ReimbursementRequestForm: React.FC<ReimbursementRequestFormProps> = ({
       secondaryAccount: defaultValues?.secondaryAccount,
       dateOfExpense: defaultValues?.dateOfExpense,
       accountCodeId: defaultValues?.accountCodeId ?? '',
+      description: defaultValues?.description?.trim() || '',
       reimbursementProducts: defaultValues?.reimbursementProducts ?? ([] as ReimbursementProductFormArgs[]),
       receiptFiles: defaultValues?.receiptFiles ?? ([] as ReimbursementReceiptUploadArgs[])
     }

src/frontend/src/utils/reimbursement-request.utils.ts

@@ -207,7 +207,8 @@ export const createReimbursementRequestRowData = (reimbursementRequest: Reimburs
     vendor: reimbursementRequest.vendor,
     refundSource: reimbursementRequest.indexCode,
     financeMemberAssigned: reimbursementRequest.assignee,
-    reimbursementProducts: reimbursementRequest.reimbursementProducts
+    reimbursementProducts: reimbursementRequest.reimbursementProducts,
+    description: reimbursementRequest.description
   };
 };
 

src/shared/src/types/reimbursement-requests-types.ts

@@ -22,6 +22,7 @@ export interface ReimbursementRequestRow {
   refundSource: IndexCode;
   financeMemberAssigned: User | undefined;
   reimbursementProducts: ReimbursementProduct[];
+  description: string;
 }
 
 export enum ReimbursementStatusType {
@@ -54,6 +55,7 @@ export interface ReimbursementRequest {
   saboId?: number;
   dateCreated: Date;
   dateOfExpense?: Date;
+  description: string;
   reimbursementStatuses: ReimbursementStatus[];
   recipient: User;
   vendor: Vendor;