# thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung architecture

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

- Interactive diagram: https://gitdiagram.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung
- Repository: https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung

## Overview

This is a pet-care management application: its Laravel code models owners, pets, and appointments, with CRUD controllers for pets and appointments and an unimplemented owner controller. The clearest runtime workflow is an API request routed to a controller, which reads or changes its Eloquent model and returns a response. Laravel’s web entry point and Blade views form a separate presentation surface. The README gives no further product detail; the large dashboard and other views were not inspected, so their specific capabilities and connections are left unspecified.

Main entry points: [`petcare-app/FRONTEND/app/Models/Pet.php`](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Pet.php) (Pet model), [`petcare-app/FRONTEND/routes/api.php`](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/routes/api.php) (API routes), [`petcare-app/FRONTEND/app/Models/Appointment.php`](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Appointment.php) (Appointment model), [`petcare-app/FRONTEND/app/Models/Owner.php`](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Owner.php) (Owner model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Laravel runtime"]
  node_entry["HTTP entry<br/>[index.php]"]
  node_application["App bootstrap<br/>[app.php]"]
  node_api_routes["API routes<br/>[api.php]"]
  node_web_routes["Web routes<br/>[web.php]"]
  node_pet_controller["Pet controller<br/>[PetController.php]"]
  node_owner_controller["Owner controller"]
  node_appointment_controller["Appointment controller"]
  node_controller_base["Controller base<br/>[Controller.php]"]
end

subgraph group_domain["Pet-care domain"]
  node_pet["Pet model<br/>[Pet.php]"]
  node_owner["Owner model<br/>[Owner.php]"]
  node_appointment["Appointment model<br/>[Appointment.php]"]
  node_user["User model<br/>[User.php]"]
end

subgraph group_presentation["Web presentation"]
  node_dashboard["Dashboard view"]
  node_login["Login view<br/>[login.blade.php]"]
  node_index_view["Index view<br/>[index.blade.php]"]
  node_welcome["Welcome view<br/>[welcome.blade.php]"]
end

node_client(("API client"))
node_webuser(("Web user"))
node_node_service["Node service<br/>[server.js]"]

node_client -.->|"sends request"| node_api_routes
node_entry -->|"boots"| node_application
node_application -->|"loads routes"| node_web_routes
node_api_routes -->|"routes to"| node_pet_controller
node_api_routes -->|"routes to"| node_owner_controller
node_api_routes -->|"routes to"| node_appointment_controller
node_pet_controller -->|"reads/writes"| node_pet
node_appointment_controller -->|"reads/writes"| node_appointment
node_appointment -->|"belongs to"| node_pet
node_appointment -->|"belongs to"| node_owner
node_pet -->|"belongs to"| node_owner
node_owner -->|"has many"| node_pet
node_pet -->|"has many"| node_appointment
node_webuser -.->|"opens site"| node_entry
node_web_routes -->|"references"| node_pet
node_webuser -.->|"views"| node_dashboard

click node_entry "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/public/index.php"
click node_application "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/bootstrap/app.php"
click node_api_routes "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/routes/api.php"
click node_web_routes "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/routes/web.php"
click node_pet_controller "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/PetController.php"
click node_owner_controller "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/OwnerController.php"
click node_appointment_controller "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/AppointmentController.php"
click node_controller_base "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/Controller.php"
click node_pet "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Pet.php"
click node_owner "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Owner.php"
click node_appointment "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Appointment.php"
click node_user "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/User.php"
click node_dashboard "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/dashboard.blade.php"
click node_login "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/login.blade.php"
click node_index_view "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/index.blade.php"
click node_welcome "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/welcome.blade.php"
click node_node_service "https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/BACKEND/petcare-backend/server.js"

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_entry,node_application,node_api_routes,node_web_routes,node_pet_controller,node_owner_controller,node_appointment_controller,node_controller_base,node_client,node_webuser toneBlue
class node_pet,node_owner,node_appointment,node_user toneAmber
class node_dashboard,node_login,node_index_view,node_welcome toneMint
class node_node_service toneTeal
```

## Components

### Laravel runtime

- [HTTP entry](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/public/index.php): `petcare-app/FRONTEND/public/index.php`
- [App bootstrap](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/bootstrap/app.php): `petcare-app/FRONTEND/bootstrap/app.php`
- [API routes](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/routes/api.php): `petcare-app/FRONTEND/routes/api.php`
- [Web routes](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/routes/web.php): `petcare-app/FRONTEND/routes/web.php`
- [Pet controller](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/PetController.php): `petcare-app/FRONTEND/app/Http/Controllers/PetController.php`
- [Owner controller](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/OwnerController.php): `petcare-app/FRONTEND/app/Http/Controllers/OwnerController.php`
- [Appointment controller](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/AppointmentController.php): `petcare-app/FRONTEND/app/Http/Controllers/AppointmentController.php`
- [Controller base](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Http/Controllers/Controller.php): `petcare-app/FRONTEND/app/Http/Controllers/Controller.php`

### Pet-care domain

- [Pet model](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Pet.php): `petcare-app/FRONTEND/app/Models/Pet.php`
- [Owner model](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Owner.php): `petcare-app/FRONTEND/app/Models/Owner.php`
- [Appointment model](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/Appointment.php): `petcare-app/FRONTEND/app/Models/Appointment.php`
- [User model](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/app/Models/User.php): `petcare-app/FRONTEND/app/Models/User.php`

### Web presentation

- [Dashboard view](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/dashboard.blade.php): `petcare-app/FRONTEND/resources/views/dashboard.blade.php`
- [Login view](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/login.blade.php): `petcare-app/FRONTEND/resources/views/login.blade.php`
- [Index view](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/index.blade.php): `petcare-app/FRONTEND/resources/views/index.blade.php`
- [Welcome view](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/FRONTEND/resources/views/welcome.blade.php): `petcare-app/FRONTEND/resources/views/welcome.blade.php`

### Other components

- **API client**
- **Web user**
- [Node service](https://github.com/thucquyen248/tran_ngoc_thuc_quyen-24ct2_quan_ly_thu_cung/blob/main/petcare-app/BACKEND/petcare-backend/server.js): `petcare-app/BACKEND/petcare-backend/server.js`

## Connections

- API client → API routes: sends request
- HTTP entry → App bootstrap: boots (evidence: `petcare-app/FRONTEND/public/index.php`)
- App bootstrap → Web routes: loads routes (evidence: `petcare-app/FRONTEND/bootstrap/app.php`)
- API routes → Pet controller: routes to (evidence: `petcare-app/FRONTEND/routes/api.php`)
- API routes → Owner controller: routes to (evidence: `petcare-app/FRONTEND/routes/api.php`)
- API routes → Appointment controller: routes to (evidence: `petcare-app/FRONTEND/routes/api.php`)
- Pet controller → Pet model: reads/writes (evidence: `petcare-app/FRONTEND/app/Http/Controllers/PetController.php`)
- Appointment controller → Appointment model: reads/writes (evidence: `petcare-app/FRONTEND/app/Http/Controllers/AppointmentController.php`)
- Appointment model → Pet model: belongs to (evidence: `petcare-app/FRONTEND/app/Models/Appointment.php`)
- Appointment model → Owner model: belongs to (evidence: `petcare-app/FRONTEND/app/Models/Appointment.php`)
- Pet model → Owner model: belongs to (evidence: `petcare-app/FRONTEND/app/Models/Pet.php`)
- Owner model → Pet model: has many (evidence: `petcare-app/FRONTEND/app/Models/Owner.php`)
- Pet model → Appointment model: has many (evidence: `petcare-app/FRONTEND/app/Models/Pet.php`)
- Web user → HTTP entry: opens site
- Web routes → Pet model: references (evidence: `petcare-app/FRONTEND/routes/web.php`)
- Web user → Dashboard view: views
