# lindaopolo7896/iap_voluntrack_grp_a13 architecture

> Architecture diagram of the GitHub repository lindaopolo7896/iap_voluntrack_grp_a13, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lindaopolo7896/iap_voluntrack_grp_a13
- Repository: https://github.com/lindaopolo7896/iap_voluntrack_grp_a13

## Overview

This Laravel API supports a volunteer-opportunity platform: people and organisations register, verify and authenticate; organisations publish opportunities; volunteers apply; organisations review applications; and participation, evidence, notifications, galleries and reports support ongoing activity. API routes dispatch to controllers, which own the domain operations and access Eloquent models; membership lookup is shared through MembershipService. The tree also includes role-specific frontend layouts, but their runtime connections are not shown. The README is empty, so capability coverage and relationships here rely on the file tree and supplied source index/excerpts; some controller details are unsampled.

Main entry points: [`backend/routes/api.php`](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/routes/api.php) (API routes), [`backend/app/Http/Controllers/UserController.php`](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/UserController.php) (Accounts and auth), [`backend/app/Http/Controllers/MembershipController.php`](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/MembershipController.php) (Membership management), [`backend/app/Http/Controllers/ApplicationController.php`](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ApplicationController.php) (Application workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and membership"]
  node_users["Accounts and auth<br/>[UserController.php]"]
  node_memberships["Membership management"]
  node_membership_service["Membership lookup"]
  node_user_model[("User records<br/>[User.php]")]
  node_org_model[("Organisation records<br/>[Organisation.php]")]
  node_volunteer_model[("Volunteer records<br/>[Volunteer.php]")]
  node_otp_model[("OTP records<br/>[OtpCode.php]")]
end

subgraph group_opportunities["Opportunities and applications"]
  node_opportunities_api["Opportunity management"]
  node_applications_api["Application workflow"]
  node_opportunity_model[("Opportunity records<br/>[Opportunity.php]")]
  node_application_model[("Application records<br/>[Application.php]")]
  node_application_mail["Decision emails"]
end

subgraph group_activity["Participation and evidence"]
  node_participation_api["Participation tracking"]
  node_evidence_api["Evidence management"]
  node_participation_model[("Participation records<br/>[Participation.php]")]
  node_evidence_model[("Evidence records<br/>[Evidence.php]")]
end

subgraph group_community["Community and reporting"]
  node_gallery_api["Gallery management"]
  node_notifications_api["Notifications"]
  node_reports_api["Reports"]
  node_gallery_model[("Gallery records<br/>[Gallery.php]")]
  node_notification_model[("Notification records<br/>[Notification.php]")]
  node_report_model[("Report records<br/>[Report.php]")]
end

node_actors(("Platform users"))
node_api["API routes<br/>[api.php]"]
node_mail_service["Email delivery"]

node_actors -->|"send requests"| node_api
node_api -->|"routes auth"| node_users
node_api -->|"routes membership"| node_memberships
node_api -->|"routes opportunities"| node_opportunities_api
node_api -->|"routes applications"| node_applications_api
node_api -->|"routes participation"| node_participation_api
node_api -->|"routes evidence"| node_evidence_api
node_api -->|"routes galleries"| node_gallery_api
node_api -->|"routes notifications"| node_notifications_api
node_api -->|"routes reports"| node_reports_api
node_users -->|"creates and queries"| node_user_model
node_users -->|"creates membership"| node_org_model
node_users -->|"creates membership"| node_volunteer_model
node_users -->|"stores OTPs"| node_otp_model
node_users -->|"looks up membership"| node_membership_service
node_users -->|"sends verification and OTP"| node_mail_service
node_memberships -->|"queries accounts"| node_user_model
node_memberships -->|"queries organisations"| node_org_model
node_memberships -->|"queries volunteers"| node_volunteer_model
node_memberships -->|"counts opportunities"| node_opportunity_model
node_memberships -->|"counts applicants"| node_application_model
node_memberships -->|"resolves memberships"| node_membership_service
node_membership_service -->|"queries by user"| node_org_model
node_membership_service -->|"queries by user"| node_volunteer_model
node_opportunities_api -->|"manages records"| node_opportunity_model
node_opportunities_api -->|"resolves membership"| node_membership_service
node_applications_api -->|"creates and updates"| node_application_model
node_applications_api -->|"checks opportunities"| node_opportunity_model
node_applications_api -->|"resolves membership"| node_membership_service
node_applications_api -->|"sends decisions"| node_mail_service
node_applications_api -->|"builds decision email"| node_application_mail
node_participation_api -->|"manages records"| node_participation_model
node_evidence_api -->|"manages records"| node_evidence_model
node_gallery_api -->|"manages records"| node_gallery_model
node_notifications_api -->|"manages records"| node_notification_model
node_reports_api -->|"manages records"| node_report_model

click node_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/routes/api.php"
click node_users "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/UserController.php"
click node_memberships "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/MembershipController.php"
click node_membership_service "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Services/MembershipService.php"
click node_user_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/User.php"
click node_org_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Organisation.php"
click node_volunteer_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Volunteer.php"
click node_otp_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/OtpCode.php"
click node_opportunities_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/OpportunityController.php"
click node_applications_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ApplicationController.php"
click node_opportunity_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Opportunity.php"
click node_application_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Application.php"
click node_application_mail "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Mail/ApplicationAcceptedEmail.php"
click node_participation_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ParticipationController.php"
click node_evidence_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/EvidenceController.php"
click node_participation_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Participation.php"
click node_evidence_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Evidence.php"
click node_gallery_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/GalleryController.php"
click node_notifications_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/NotificationController.php"
click node_reports_api "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ReportController.php"
click node_gallery_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Gallery.php"
click node_notification_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Notification.php"
click node_report_model "https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Report.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_users,node_memberships,node_membership_service,node_user_model,node_org_model,node_volunteer_model,node_otp_model,node_actors toneBlue
class node_opportunities_api,node_applications_api,node_opportunity_model,node_application_model,node_application_mail toneAmber
class node_participation_api,node_evidence_api,node_participation_model,node_evidence_model,node_api toneMint
class node_gallery_api,node_notifications_api,node_reports_api,node_gallery_model,node_notification_model,node_report_model toneRose
class node_mail_service toneIndigo
```

## Components

### Identity and membership

- [Accounts and auth](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/UserController.php): `backend/app/Http/Controllers/UserController.php`
- [Membership management](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/MembershipController.php): `backend/app/Http/Controllers/MembershipController.php`
- [Membership lookup](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Services/MembershipService.php): `backend/app/Services/MembershipService.php`
- [User records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`
- [Organisation records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Organisation.php): `backend/app/Models/Organisation.php`
- [Volunteer records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Volunteer.php): `backend/app/Models/Volunteer.php`
- [OTP records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/OtpCode.php): `backend/app/Models/OtpCode.php`

### Opportunities and applications

- [Opportunity management](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/OpportunityController.php): `backend/app/Http/Controllers/OpportunityController.php`
- [Application workflow](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ApplicationController.php): `backend/app/Http/Controllers/ApplicationController.php`
- [Opportunity records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Opportunity.php): `backend/app/Models/Opportunity.php`
- [Application records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Application.php): `backend/app/Models/Application.php`
- [Decision emails](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Mail/ApplicationAcceptedEmail.php): `backend/app/Mail/ApplicationAcceptedEmail.php`

### Participation and evidence

- [Participation tracking](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ParticipationController.php): `backend/app/Http/Controllers/ParticipationController.php`
- [Evidence management](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/EvidenceController.php): `backend/app/Http/Controllers/EvidenceController.php`
- [Participation records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Participation.php): `backend/app/Models/Participation.php`
- [Evidence records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Evidence.php): `backend/app/Models/Evidence.php`

### Community and reporting

- [Gallery management](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/GalleryController.php): `backend/app/Http/Controllers/GalleryController.php`
- [Notifications](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/NotificationController.php): `backend/app/Http/Controllers/NotificationController.php`
- [Reports](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Http/Controllers/ReportController.php): `backend/app/Http/Controllers/ReportController.php`
- [Gallery records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Gallery.php): `backend/app/Models/Gallery.php`
- [Notification records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Notification.php): `backend/app/Models/Notification.php`
- [Report records](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/app/Models/Report.php): `backend/app/Models/Report.php`

### Other components

- **Platform users**
- [API routes](https://github.com/lindaopolo7896/iap_voluntrack_grp_a13/blob/main/backend/routes/api.php): `backend/routes/api.php`
- **Email delivery**

## Connections

- Platform users → API routes: send requests
- API routes → Accounts and auth: routes auth (evidence: `backend/routes/api.php`)
- API routes → Membership management: routes membership (evidence: `backend/routes/api.php`)
- API routes → Opportunity management: routes opportunities (evidence: `backend/routes/api.php`)
- API routes → Application workflow: routes applications (evidence: `backend/routes/api.php`)
- API routes → Participation tracking: routes participation (evidence: `backend/routes/api.php`)
- API routes → Evidence management: routes evidence (evidence: `backend/routes/api.php`)
- API routes → Gallery management: routes galleries (evidence: `backend/routes/api.php`)
- API routes → Notifications: routes notifications (evidence: `backend/routes/api.php`)
- API routes → Reports: routes reports (evidence: `backend/routes/api.php`)
- Accounts and auth → User records: creates and queries (evidence: `backend/app/Http/Controllers/UserController.php`)
- Accounts and auth → Organisation records: creates membership (evidence: `backend/app/Http/Controllers/UserController.php`)
- Accounts and auth → Volunteer records: creates membership (evidence: `backend/app/Http/Controllers/UserController.php`)
- Accounts and auth → OTP records: stores OTPs (evidence: `backend/app/Http/Controllers/UserController.php`)
- Accounts and auth → Membership lookup: looks up membership (evidence: `backend/app/Http/Controllers/UserController.php`)
- Accounts and auth → Email delivery: sends verification and OTP (evidence: `backend/app/Http/Controllers/UserController.php`)
- Membership management → User records: queries accounts (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership management → Organisation records: queries organisations (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership management → Volunteer records: queries volunteers (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership management → Opportunity records: counts opportunities (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership management → Application records: counts applicants (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership management → Membership lookup: resolves memberships (evidence: `backend/app/Http/Controllers/MembershipController.php`)
- Membership lookup → Organisation records: queries by user (evidence: `backend/app/Services/MembershipService.php`)
- Membership lookup → Volunteer records: queries by user (evidence: `backend/app/Services/MembershipService.php`)
- Opportunity management → Opportunity records: manages records (evidence: `backend/app/Http/Controllers/OpportunityController.php`)
- Opportunity management → Membership lookup: resolves membership (evidence: `backend/app/Http/Controllers/OpportunityController.php`)
- Application workflow → Application records: creates and updates (evidence: `backend/app/Http/Controllers/ApplicationController.php`)
- Application workflow → Opportunity records: checks opportunities (evidence: `backend/app/Http/Controllers/ApplicationController.php`)
- Application workflow → Membership lookup: resolves membership (evidence: `backend/app/Http/Controllers/ApplicationController.php`)
- Application workflow → Email delivery: sends decisions (evidence: `backend/app/Http/Controllers/ApplicationController.php`)
- Application workflow → Decision emails: builds decision email (evidence: `backend/app/Http/Controllers/ApplicationController.php`)
- Participation tracking → Participation records: manages records (evidence: `backend/app/Http/Controllers/ParticipationController.php`)
- Evidence management → Evidence records: manages records (evidence: `backend/app/Http/Controllers/EvidenceController.php`)
- Gallery management → Gallery records: manages records (evidence: `backend/app/Http/Controllers/GalleryController.php`)
- Notifications → Notification records: manages records (evidence: `backend/app/Http/Controllers/NotificationController.php`)
- Reports → Report records: manages records (evidence: `backend/app/Http/Controllers/ReportController.php`)
