# gnoubis/waspi-rewards architecture

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

- Interactive diagram: https://gitdiagram.com/gnoubis/waspi-rewards
- Repository: https://github.com/gnoubis/waspi-rewards

## Overview

WASPI Rewards is a Laravel API and Vue feed where users log in or register, browse posts, comment and like, then earn milestone points and derived badges. A separate token-gated endpoint lists and filters user rewards. The graph preserves the documented auth, feed, reward, and reviewer-API branches. Some framework event dispatch and browser-to-route wiring is not shown in the excerpts, so those links are dashed rather than asserted as observed calls.

Main entry points: [`routes/api.php`](https://github.com/gnoubis/waspi-rewards/blob/main/routes/api.php) (API routes), [`app/Models/User.php`](https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/User.php) (User and points), [`resources/js/App.vue`](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/App.vue) (Feed app), [`app/Http/Controllers/Api/RewardUserController.php`](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/RewardUserController.php) (Reward listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Vue user experience"]
  node_app["Feed app<br/>[App.vue]"]
  node_session["Session state<br/>[useSession.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_post_card["Post interactions<br/>[PostCard.vue]"]
  node_session_switcher["Session controls"]
end

subgraph group_api["Laravel API"]
  node_routes["API routes<br/>[api.php]"]
  node_auth["Authentication<br/>[AuthController.php]"]
  node_comments["Comment actions"]
  node_likes["Like actions<br/>[LikeController.php]"]
  node_posts["Post feed<br/>[PostController.php]"]
  node_reward_endpoint["Reward listing"]
  node_provider["Observer registration"]
  node_comment_resource["Comment response"]
  node_reward_resource["Reward response"]
end

subgraph group_rewards["Reward domain"]
  node_comment_observer["Comment rewards hook"]
  node_like_observer["Like rewards hook<br/>[LikeObserver.php]"]
  node_reward_service["Milestone awards<br/>[RewardService.php]"]
  node_badge_service["Badge thresholds<br/>[BadgeService.php]"]
end

subgraph group_data["Domain data"]
  node_user_model["User and points<br/>[User.php]"]
  node_post_model["Posts<br/>[Post.php]"]
  node_comment_model["Comments<br/>[Comment.php]"]
  node_like_model["Likes<br/>[Like.php]"]
  node_database[("SQLite database")]
end

node_user(("Feed user"))
node_reviewer(("API reviewer"))

node_user -->|"uses"| node_app
node_app -->|"loads posts"| node_api_client
node_app -->|"renders"| node_post_card
node_app -->|"renders"| node_session_switcher
node_session_switcher -->|"uses"| node_session
node_session -->|"sends auth requests"| node_api_client
node_post_card -.->|"submits interactions"| node_api_client
node_api_client -.->|"calls API"| node_routes
node_routes -->|"routes to"| node_auth
node_routes -->|"routes to"| node_comments
node_routes -->|"routes to"| node_likes
node_routes -->|"routes to"| node_posts
node_routes -->|"routes to"| node_reward_endpoint
node_auth -->|"looks up and creates"| node_user_model
node_comments -->|"creates or deletes"| node_comment_model
node_comments -->|"returns"| node_comment_resource
node_likes -->|"returns"| node_comment_resource
node_posts -->|"queries"| node_post_model
node_reward_endpoint -->|"filters users"| node_user_model
node_reward_endpoint -->|"serializes"| node_reward_resource
node_provider -->|"registers"| node_comment_observer
node_provider -->|"registers"| node_like_observer
node_comment_observer -->|"awards on creation"| node_reward_service
node_like_observer -->|"awards on creation"| node_reward_service
node_comment_model -.->|"triggers lifecycle hook"| node_comment_observer
node_like_model -.->|"triggers lifecycle hook"| node_like_observer
node_reward_service -->|"updates points"| node_user_model
node_user_model -->|"derives badge"| node_badge_service
node_post_model -.->|"persists"| node_database
node_comment_model -.->|"persists"| node_database
node_like_model -.->|"persists"| node_database
node_user_model -.->|"persists"| node_database
node_reviewer -->|"requests filtered rewards"| node_reward_endpoint

click node_app "https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/App.vue"
click node_session "https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/composables/useSession.js"
click node_api_client "https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/api.js"
click node_post_card "https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/components/PostCard.vue"
click node_session_switcher "https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/components/SessionSwitcher.vue"
click node_routes "https://github.com/gnoubis/waspi-rewards/blob/main/routes/api.php"
click node_auth "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/AuthController.php"
click node_comments "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/CommentController.php"
click node_likes "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/LikeController.php"
click node_posts "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/PostController.php"
click node_reward_endpoint "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/RewardUserController.php"
click node_comment_observer "https://github.com/gnoubis/waspi-rewards/blob/main/app/Observers/CommentObserver.php"
click node_like_observer "https://github.com/gnoubis/waspi-rewards/blob/main/app/Observers/LikeObserver.php"
click node_reward_service "https://github.com/gnoubis/waspi-rewards/blob/main/app/Services/RewardService.php"
click node_badge_service "https://github.com/gnoubis/waspi-rewards/blob/main/app/Services/BadgeService.php"
click node_provider "https://github.com/gnoubis/waspi-rewards/blob/main/app/Providers/AppServiceProvider.php"
click node_user_model "https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/User.php"
click node_post_model "https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Post.php"
click node_comment_model "https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Comment.php"
click node_like_model "https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Like.php"
click node_comment_resource "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Resources/CommentResource.php"
click node_reward_resource "https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Resources/UserRewardResource.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_app,node_session,node_api_client,node_post_card,node_session_switcher,node_user,node_reviewer toneBlue
class node_routes,node_auth,node_comments,node_likes,node_posts,node_reward_endpoint,node_provider,node_comment_resource,node_reward_resource toneAmber
class node_comment_observer,node_like_observer,node_reward_service,node_badge_service toneMint
class node_user_model,node_post_model,node_comment_model,node_like_model,node_database toneRose
```

## Components

### Vue user experience

- [Feed app](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/App.vue): `resources/js/App.vue`
- [Session state](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/composables/useSession.js): `resources/js/composables/useSession.js`
- [API client](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/api.js): `resources/js/api.js`
- [Post interactions](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/components/PostCard.vue): `resources/js/components/PostCard.vue`
- [Session controls](https://github.com/gnoubis/waspi-rewards/blob/main/resources/js/components/SessionSwitcher.vue): `resources/js/components/SessionSwitcher.vue`

### Laravel API

- [API routes](https://github.com/gnoubis/waspi-rewards/blob/main/routes/api.php): `routes/api.php`
- [Authentication](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/AuthController.php): `app/Http/Controllers/Api/AuthController.php`
- [Comment actions](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/CommentController.php): `app/Http/Controllers/Api/CommentController.php`
- [Like actions](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/LikeController.php): `app/Http/Controllers/Api/LikeController.php`
- [Post feed](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/PostController.php): `app/Http/Controllers/Api/PostController.php`
- [Reward listing](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Controllers/Api/RewardUserController.php): `app/Http/Controllers/Api/RewardUserController.php`
- [Observer registration](https://github.com/gnoubis/waspi-rewards/blob/main/app/Providers/AppServiceProvider.php): `app/Providers/AppServiceProvider.php`
- [Comment response](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Resources/CommentResource.php): `app/Http/Resources/CommentResource.php`
- [Reward response](https://github.com/gnoubis/waspi-rewards/blob/main/app/Http/Resources/UserRewardResource.php): `app/Http/Resources/UserRewardResource.php`

### Reward domain

- [Comment rewards hook](https://github.com/gnoubis/waspi-rewards/blob/main/app/Observers/CommentObserver.php): `app/Observers/CommentObserver.php`
- [Like rewards hook](https://github.com/gnoubis/waspi-rewards/blob/main/app/Observers/LikeObserver.php): `app/Observers/LikeObserver.php`
- [Milestone awards](https://github.com/gnoubis/waspi-rewards/blob/main/app/Services/RewardService.php): `app/Services/RewardService.php`
- [Badge thresholds](https://github.com/gnoubis/waspi-rewards/blob/main/app/Services/BadgeService.php): `app/Services/BadgeService.php`

### Domain data

- [User and points](https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/User.php): `app/Models/User.php`
- [Posts](https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Post.php): `app/Models/Post.php`
- [Comments](https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Comment.php): `app/Models/Comment.php`
- [Likes](https://github.com/gnoubis/waspi-rewards/blob/main/app/Models/Like.php): `app/Models/Like.php`
- **SQLite database**

### Other components

- **Feed user**
- **API reviewer**

## Connections

- Feed user → Feed app: uses
- Feed app → API client: loads posts (evidence: `resources/js/App.vue`)
- Feed app → Post interactions: renders (evidence: `resources/js/App.vue`)
- Feed app → Session controls: renders (evidence: `resources/js/App.vue`)
- Session controls → Session state: uses (evidence: `resources/js/components/SessionSwitcher.vue`)
- Session state → API client: sends auth requests (evidence: `resources/js/composables/useSession.js`)
- Post interactions → API client: submits interactions
- API client → API routes: calls API
- API routes → Authentication: routes to (evidence: `routes/api.php`)
- API routes → Comment actions: routes to (evidence: `routes/api.php`)
- API routes → Like actions: routes to (evidence: `routes/api.php`)
- API routes → Post feed: routes to (evidence: `routes/api.php`)
- API routes → Reward listing: routes to (evidence: `routes/api.php`)
- Authentication → User and points: looks up and creates (evidence: `app/Http/Controllers/Api/AuthController.php`)
- Comment actions → Comments: creates or deletes (evidence: `app/Http/Controllers/Api/CommentController.php`)
- Comment actions → Comment response: returns (evidence: `app/Http/Controllers/Api/CommentController.php`)
- Like actions → Comment response: returns (evidence: `app/Http/Controllers/Api/LikeController.php`)
- Post feed → Posts: queries (evidence: `app/Http/Controllers/Api/PostController.php`)
- Reward listing → User and points: filters users (evidence: `app/Http/Controllers/Api/RewardUserController.php`)
- Reward listing → Reward response: serializes (evidence: `app/Http/Controllers/Api/RewardUserController.php`)
- Observer registration → Comment rewards hook: registers (evidence: `app/Providers/AppServiceProvider.php`)
- Observer registration → Like rewards hook: registers (evidence: `app/Providers/AppServiceProvider.php`)
- Comment rewards hook → Milestone awards: awards on creation (evidence: `app/Observers/CommentObserver.php`)
- Like rewards hook → Milestone awards: awards on creation (evidence: `app/Observers/LikeObserver.php`)
- Comments → Comment rewards hook: triggers lifecycle hook (evidence: `app/Observers/CommentObserver.php`)
- Likes → Like rewards hook: triggers lifecycle hook (evidence: `app/Observers/LikeObserver.php`)
- Milestone awards → User and points: updates points (evidence: `app/Services/RewardService.php`)
- User and points → Badge thresholds: derives badge (evidence: `app/Models/User.php`)
- Posts → SQLite database: persists
- Comments → SQLite database: persists
- Likes → SQLite database: persists
- User and points → SQLite database: persists
- API reviewer → Reward listing: requests filtered rewards
