24 referral submission

[suesuee]

Developer: Camila and Sue

Closes #24

Pull Request Summary

This PR implements the submission logic for the ReferralForm component, making sure the member data is retrieved from the URL and submitted to the backend. It extracts referral details from the query parameters and processes user input to create a new referral instance in the database.

Modifications

1. src/components/ReferralForm/ReferralForm.tsx

• Extracts referrer data (name, email, referral code) from the URL using useSearchParams.
• Updates hidden fields dynamically as the URL changes.
• Implements error handling to ensure prospect fields (email, first name, last name) are filled before submission.
• Formats and sends a POST request to /api/referral with the structured referral data.
• Includes logging for debugging.

2. src/app/api/referral/route.ts

• Receives and processes referral data submitted from the frontend.
• Ensures all required fields (member details, referral code, and at least one prospect) are present.
• Uses Prisma transactions to store multiple prospect referrals in the database.
• Includes logging for debugging.

Testing Considerations

• Verified that the referrer data is correctly extracted from the URL.
• Ensured the form does not submit if required fields are missing (error messages appear).
• Confirmed that the correct payload is sent to /api/referral via the network request in DevTools.
• Checked that multiple prospects can be added and submitted in the same request.
• Ensured that successful submissions create referral records in the database.

Pull Request Checklist

• Code is neat, readable, and works
• Comments are appropriate
• The commit messages follows our guidelines
• The developer name is specified
• The summary is completed
• Assign reviewers

Screenshots/Screencast

The URL used: http://localhost:3000/?nm=John%20Michael%20Doe&[email protected]&ref=ABC123

If the referrer enters two prospects in the same form

If the referrer miss any of the prospect's fields

[IvanA673]

You both did an amazing job on this issue! Thanks for your work and thorough testing.