# ossinkichi/questcheck architecture

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

- Interactive diagram: https://gitdiagram.com/ossinkichi/questcheck
- Repository: https://github.com/ossinkichi/questcheck

## Overview

QuestCheck is a task-management platform with a React client and Laravel API. The intended workflow is user registration or login, quest creation and listing, then quest completion or failure; the README also describes points and redeemable items. The sampled backend implements user and quest endpoints, while the README says the frontend is unfinished. The graph shows evidenced calls and route wiring; rewards are included as a documented capability, but their implementation and connection to the quest workflow are not established by the sampled source.

Main entry points: [`frontend/src/routes.jsx`](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/routes.jsx) (Client router), [`backend/app/Http/Controllers/QuestController.php`](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/QuestController.php) (Quest endpoints), [`backend/app/Http/Controllers/UserController.php`](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/UserController.php) (User endpoints), [`backend/routes/api.php`](https://github.com/ossinkichi/questcheck/blob/main/backend/routes/api.php) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_router["Client router<br/>[routes.jsx]"]
  node_auth_forms["Sign-in and registration<br/>[SignInForm.jsx]"]
  node_signup_form["Registration form<br/>[SignUpForm.jsx]"]
  node_task_form["Quest form"]
  node_task_list["Quest list<br/>[TaskList.jsx]"]
  node_quest_service["Quest service<br/>[quest.service.js]"]
  node_auth_service["Authentication service<br/>[auth.service.js]"]
end

subgraph group_api["Laravel API"]
  node_api_routes["API routes<br/>[api.php]"]
  node_quest_controller["Quest endpoints"]
  node_user_controller["User endpoints<br/>[UserController.php]"]
  node_base_controller["Controller base<br/>[Controller.php]"]
  node_quest_resource["Quest response<br/>[QuestResource.php]"]
  node_user_resource["User response<br/>[UserResource.php]"]
end

subgraph group_domain["Domain data"]
  node_quest_model["Quest model<br/>[Quest.php]"]
  node_user_model["User model<br/>[User.php]"]
  node_database[("Configured database<br/>[database.php]")]
end

subgraph group_rewards["Rewards"]
  node_points["Points and items"]
end

node_user(("User"))

node_user -->|"uses"| node_router
node_router -->|"routes to"| node_auth_forms
node_router -->|"routes to"| node_signup_form
node_router -->|"routes to"| node_task_form
node_router -->|"routes through"| node_task_list
node_auth_forms -->|"authenticates via"| node_auth_service
node_signup_form -.->|"registers via"| node_user_controller
node_task_form -->|"creates via"| node_quest_service
node_task_list -->|"loads quests via"| node_quest_service
node_quest_service -.->|"requests quests"| node_api_routes
node_auth_service -.->|"requests login"| node_api_routes
node_api_routes -->|"dispatches to"| node_quest_controller
node_api_routes -->|"dispatches to"| node_user_controller
node_quest_controller -->|"queries and updates"| node_quest_model
node_quest_controller -->|"formats responses"| node_quest_resource
node_user_controller -->|"queries and updates"| node_user_model
node_user_controller -->|"formats response"| node_user_resource
node_quest_controller -->|"extends"| node_base_controller
node_user_controller -->|"extends"| node_base_controller
node_quest_model -.->|"persists through"| node_database
node_user_model -.->|"persists through"| node_database
node_user -->|"earns and redeems"| node_points
node_quest_controller -.->|"awards on completion"| node_points

click node_router "https://github.com/ossinkichi/questcheck/blob/main/frontend/src/routes.jsx"
click node_auth_forms "https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/SignInForm.jsx"
click node_signup_form "https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/SignUpForm.jsx"
click node_task_form "https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/FormTaskRegister.jsx"
click node_task_list "https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/TaskList.jsx"
click node_quest_service "https://github.com/ossinkichi/questcheck/blob/main/frontend/services/quest.service.js"
click node_auth_service "https://github.com/ossinkichi/questcheck/blob/main/frontend/services/auth.service.js"
click node_api_routes "https://github.com/ossinkichi/questcheck/blob/main/backend/routes/api.php"
click node_quest_controller "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/QuestController.php"
click node_user_controller "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/UserController.php"
click node_base_controller "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/Controller.php"
click node_quest_resource "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Resources/QuestResource.php"
click node_user_resource "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Resources/UserResource.php"
click node_quest_model "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Models/Quest.php"
click node_user_model "https://github.com/ossinkichi/questcheck/blob/main/backend/app/Models/User.php"
click node_database "https://github.com/ossinkichi/questcheck/blob/main/backend/config/database.php"
click node_points "https://github.com/ossinkichi/questcheck/tree/main/backend/app"

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_router,node_auth_forms,node_signup_form,node_task_form,node_task_list,node_quest_service,node_auth_service,node_user toneBlue
class node_api_routes,node_quest_controller,node_user_controller,node_base_controller,node_quest_resource,node_user_resource toneAmber
class node_quest_model,node_user_model,node_database toneMint
class node_points toneRose
```

## Components

### React client

- [Client router](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/routes.jsx): `frontend/src/routes.jsx`
- [Sign-in and registration](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/SignInForm.jsx): `frontend/src/components/Form/SignInForm.jsx`
- [Registration form](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/SignUpForm.jsx): `frontend/src/components/Form/SignUpForm.jsx`
- [Quest form](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/Form/FormTaskRegister.jsx): `frontend/src/components/Form/FormTaskRegister.jsx`
- [Quest list](https://github.com/ossinkichi/questcheck/blob/main/frontend/src/components/TaskList.jsx): `frontend/src/components/TaskList.jsx`
- [Quest service](https://github.com/ossinkichi/questcheck/blob/main/frontend/services/quest.service.js): `frontend/services/quest.service.js`
- [Authentication service](https://github.com/ossinkichi/questcheck/blob/main/frontend/services/auth.service.js): `frontend/services/auth.service.js`

### Laravel API

- [API routes](https://github.com/ossinkichi/questcheck/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Quest endpoints](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/QuestController.php): `backend/app/Http/Controllers/QuestController.php`
- [User endpoints](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/UserController.php): `backend/app/Http/Controllers/UserController.php`
- [Controller base](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Controllers/Controller.php): `backend/app/Http/Controllers/Controller.php`
- [Quest response](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Resources/QuestResource.php): `backend/app/Http/Resources/QuestResource.php`
- [User response](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Http/Resources/UserResource.php): `backend/app/Http/Resources/UserResource.php`

### Domain data

- [Quest model](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Models/Quest.php): `backend/app/Models/Quest.php`
- [User model](https://github.com/ossinkichi/questcheck/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`
- [Configured database](https://github.com/ossinkichi/questcheck/blob/main/backend/config/database.php): `backend/config/database.php`

### Rewards

- [Points and items](https://github.com/ossinkichi/questcheck/tree/main/backend/app): `backend/app`

### Other components

- **User**

## Connections

- User → Client router: uses (evidence: `frontend/src/routes.jsx`)
- Client router → Sign-in and registration: routes to (evidence: `frontend/src/routes.jsx`)
- Client router → Registration form: routes to (evidence: `frontend/src/routes.jsx`)
- Client router → Quest form: routes to (evidence: `frontend/src/routes.jsx`)
- Client router → Quest list: routes through (evidence: `frontend/src/routes.jsx`)
- Sign-in and registration → Authentication service: authenticates via (evidence: `frontend/src/components/Form/SignInForm.jsx`)
- Registration form → User endpoints: registers via
- Quest form → Quest service: creates via (evidence: `frontend/src/components/Form/FormTaskRegister.jsx`)
- Quest list → Quest service: loads quests via (evidence: `frontend/src/components/TaskList.jsx`)
- Quest service → API routes: requests quests
- Authentication service → API routes: requests login
- API routes → Quest endpoints: dispatches to (evidence: `backend/routes/api.php`)
- API routes → User endpoints: dispatches to (evidence: `backend/routes/api.php`)
- Quest endpoints → Quest model: queries and updates (evidence: `backend/app/Http/Controllers/QuestController.php`)
- Quest endpoints → Quest response: formats responses (evidence: `backend/app/Http/Controllers/QuestController.php`)
- User endpoints → User model: queries and updates (evidence: `backend/app/Http/Controllers/UserController.php`)
- User endpoints → User response: formats response (evidence: `backend/app/Http/Controllers/UserController.php`)
- Quest endpoints → Controller base: extends (evidence: `backend/app/Http/Controllers/QuestController.php`)
- User endpoints → Controller base: extends (evidence: `backend/app/Http/Controllers/UserController.php`)
- Quest model → Configured database: persists through
- User model → Configured database: persists through
- User → Points and items: earns and redeems
- Quest endpoints → Points and items: awards on completion (evidence: `backend/app/Http/Controllers/QuestController.php`)
