# httpsjmdv/basta_velure architecture

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

- Interactive diagram: https://gitdiagram.com/httpsjmdv/basta_velure
- Repository: https://github.com/httpsjmdv/basta_velure

## Overview

Loved-IT is a multi-role Philippine marketplace: its React website and Android app use a Laravel API for commerce, reviews, payments, messaging, and delivery operations. The principal workflow is a buyer browsing products, placing and paying for an order, then tracking delivery; sellers and logistics participants manage the resulting order and parcel lifecycle. The graph preserves the separate commerce, marketplace, and logistics stages plus shared account and notification layers. Some backend subsystems are represented by their exact directories because their implementation files were not sampled; edges are limited to README or source-index evidence.

Main entry points: [`backend/routes/api.php`](https://github.com/httpsjmdv/basta_velure/blob/main/backend/routes/api.php) (REST API routes), [`backend/app/Http/Controllers/Api/V1`](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1) (Order workflow), [`backend/app/Models`](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Models) (Marketplace data), [`backend/app/Http/Controllers/Api/V1/BuyerReviewController.php`](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Http/Controllers/Api/V1/BuyerReviewController.php) (Buyer and shop reviews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client applications"]
  node_website["Marketplace website<br/>[App.tsx]"]
  node_android["Android app<br/>[MainActivity.kt]"]
  node_api_client["API client<br/>[client.ts]"]
end

subgraph group_marketplace["Marketplace and accounts"]
  node_accounts[("Accounts and roles<br/>[User.php]")]
  node_catalog["Product catalog"]
  node_seller_tools["Seller tools"]
  node_reviews["Buyer and shop reviews"]
end

subgraph group_commerce["Commerce and payments"]
  node_order_api["Order workflow"]
  node_order_state["Order status model<br/>[OrderStatus.php]"]
  node_payments["Payments and refunds"]
  node_settlements["Payouts and settlements"]
end

subgraph group_logistics["Delivery operations"]
  node_parcels["Parcel tracking"]
  node_courier_ops["Courier and hub operations"]
  node_rider_ops["Rider operations"]
end

subgraph group_shared["Shared platform"]
  node_api_routes["REST API routes<br/>[api.php]"]
  node_messaging["Messaging"]
  node_notifications["Notifications<br/>[Notifier.php]"]
  node_market_data[("Marketplace data")]
end

node_buyers(("Buyers"))
node_sellers(("Sellers"))
node_ops(("Platform and logistics staff"))

node_buyers -->|"browse and order"| node_website
node_sellers -->|"manage shop"| node_website
node_ops -->|"operate platform"| node_website
node_website -->|"uses"| node_api_client
node_android -.->|"uses shared API"| node_api_client
node_api_client -->|"requests API"| node_api_routes
node_api_routes -->|"routes products"| node_catalog
node_api_routes -->|"routes orders"| node_order_api
node_api_routes -->|"routes payments"| node_payments
node_api_routes -->|"routes reviews"| node_reviews
node_api_routes -->|"routes messaging"| node_messaging
node_api_routes -->|"routes seller tools"| node_seller_tools
node_api_routes -->|"routes logistics"| node_courier_ops
node_api_routes -->|"routes rider operations"| node_rider_ops
node_catalog -->|"reads products"| node_market_data
node_catalog -->|"reads product reviews"| node_reviews
node_reviews -->|"stores review records"| node_market_data
node_reviews -->|"notifies on review"| node_notifications
node_order_api -->|"uses statuses"| node_order_state
node_order_api -.->|"persists orders"| node_market_data
node_order_api -.->|"coordinates payment"| node_payments
node_order_api -.->|"creates delivery tracking"| node_parcels
node_parcels -.->|"supports parcel handling"| node_courier_ops
node_courier_ops -.->|"assigns delivery work"| node_rider_ops
node_payments -.->|"supports payouts"| node_settlements
node_seller_tools -.->|"manages shop data"| node_market_data
node_messaging -.->|"notifies participants"| node_notifications
node_accounts -->|"relates marketplace records"| node_market_data

click node_website "https://github.com/httpsjmdv/basta_velure/blob/main/frontend/src/App.tsx"
click node_android "https://github.com/httpsjmdv/basta_velure/blob/main/mobile/android/app/src/main/kotlin/shop/lovedit/loved_it/MainActivity.kt"
click node_api_client "https://github.com/httpsjmdv/basta_velure/blob/main/frontend/src/api/client.ts"
click node_api_routes "https://github.com/httpsjmdv/basta_velure/blob/main/backend/routes/api.php"
click node_accounts "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Models/User.php"
click node_catalog "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Http/Controllers/Api/V1/PublicProductController.php"
click node_seller_tools "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1"
click node_reviews "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Http/Controllers/Api/V1/BuyerReviewController.php"
click node_order_api "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1"
click node_order_state "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Enums/OrderStatus.php"
click node_payments "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1"
click node_settlements "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services"
click node_parcels "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Services/ParcelTrackingService.php"
click node_courier_ops "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services/Courier"
click node_rider_ops "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services"
click node_messaging "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1"
click node_notifications "https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Services/Notifier.php"
click node_market_data "https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Models"

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_website,node_android,node_api_client toneBlue
class node_accounts,node_catalog,node_seller_tools,node_reviews toneAmber
class node_order_api,node_order_state,node_payments,node_settlements toneMint
class node_parcels,node_courier_ops,node_rider_ops toneRose
class node_api_routes,node_messaging,node_notifications,node_market_data,node_buyers,node_sellers,node_ops toneIndigo
```

## Components

### Client applications

- [Marketplace website](https://github.com/httpsjmdv/basta_velure/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Android app](https://github.com/httpsjmdv/basta_velure/blob/main/mobile/android/app/src/main/kotlin/shop/lovedit/loved_it/MainActivity.kt): `mobile/android/app/src/main/kotlin/shop/lovedit/loved_it/MainActivity.kt`
- [API client](https://github.com/httpsjmdv/basta_velure/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### Marketplace and accounts

- [Accounts and roles](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Models/User.php): `backend/app/Models/User.php`
- [Product catalog](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Http/Controllers/Api/V1/PublicProductController.php): `backend/app/Http/Controllers/Api/V1/PublicProductController.php`
- [Seller tools](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1): `backend/app/Http/Controllers/Api/V1`
- [Buyer and shop reviews](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Http/Controllers/Api/V1/BuyerReviewController.php): `backend/app/Http/Controllers/Api/V1/BuyerReviewController.php`

### Commerce and payments

- [Order workflow](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1): `backend/app/Http/Controllers/Api/V1`
- [Order status model](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Enums/OrderStatus.php): `backend/app/Enums/OrderStatus.php`
- [Payments and refunds](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1): `backend/app/Http/Controllers/Api/V1`
- [Payouts and settlements](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services): `backend/app/Services`

### Delivery operations

- [Parcel tracking](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Services/ParcelTrackingService.php): `backend/app/Services/ParcelTrackingService.php`
- [Courier and hub operations](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services/Courier): `backend/app/Services/Courier`
- [Rider operations](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Services): `backend/app/Services`

### Shared platform

- [REST API routes](https://github.com/httpsjmdv/basta_velure/blob/main/backend/routes/api.php): `backend/routes/api.php`
- [Messaging](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Http/Controllers/Api/V1): `backend/app/Http/Controllers/Api/V1`
- [Notifications](https://github.com/httpsjmdv/basta_velure/blob/main/backend/app/Services/Notifier.php): `backend/app/Services/Notifier.php`
- [Marketplace data](https://github.com/httpsjmdv/basta_velure/tree/main/backend/app/Models): `backend/app/Models`

### Other components

- **Buyers**
- **Sellers**
- **Platform and logistics staff**

## Connections

- Buyers → Marketplace website: browse and order (evidence: `README.md`)
- Sellers → Marketplace website: manage shop (evidence: `README.md`)
- Platform and logistics staff → Marketplace website: operate platform (evidence: `README.md`)
- Marketplace website → API client: uses (evidence: `frontend/src/App.tsx`)
- Android app → API client: uses shared API
- API client → REST API routes: requests API (evidence: `README.md`)
- REST API routes → Product catalog: routes products (evidence: `backend/routes/api.php`)
- REST API routes → Order workflow: routes orders (evidence: `backend/routes/api.php`)
- REST API routes → Payments and refunds: routes payments (evidence: `backend/routes/api.php`)
- REST API routes → Buyer and shop reviews: routes reviews (evidence: `backend/routes/api.php`)
- REST API routes → Messaging: routes messaging (evidence: `backend/routes/api.php`)
- REST API routes → Seller tools: routes seller tools (evidence: `backend/routes/api.php`)
- REST API routes → Courier and hub operations: routes logistics (evidence: `backend/routes/api.php`)
- REST API routes → Rider operations: routes rider operations (evidence: `backend/routes/api.php`)
- Product catalog → Marketplace data: reads products (evidence: `backend/app/Http/Controllers/Api/V1/PublicProductController.php`)
- Product catalog → Buyer and shop reviews: reads product reviews (evidence: `backend/app/Http/Controllers/Api/V1/PublicProductController.php`)
- Buyer and shop reviews → Marketplace data: stores review records (evidence: `backend/app/Http/Controllers/Api/V1/BuyerReviewController.php`)
- Buyer and shop reviews → Notifications: notifies on review (evidence: `backend/app/Http/Controllers/Api/V1/BuyerReviewController.php`)
- Order workflow → Order status model: uses statuses (evidence: `backend/app/Enums/OrderStatus.php`)
- Order workflow → Marketplace data: persists orders (evidence: `backend/app/Http/Controllers/Api/V1/ShopReviewController.php`)
- Order workflow → Payments and refunds: coordinates payment
- Order workflow → Parcel tracking: creates delivery tracking
- Parcel tracking → Courier and hub operations: supports parcel handling
- Courier and hub operations → Rider operations: assigns delivery work
- Payments and refunds → Payouts and settlements: supports payouts (evidence: `backend/app/Http/Controllers/Api/V1/ShopReviewController.php`)
- Seller tools → Marketplace data: manages shop data (evidence: `backend/app/Http/Controllers/Api/V1/ShopReviewController.php`)
- Messaging → Notifications: notifies participants (evidence: `backend/app/Http/Controllers/Api/V1/ShopReviewController.php`)
- Accounts and roles → Marketplace data: relates marketplace records (evidence: `backend/app/Models/User.php`)