# ivant04/craftlocal_flatform architecture

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

- Interactive diagram: https://gitdiagram.com/ivant04/craftlocal_flatform
- Repository: https://github.com/ivant04/craftlocal_flatform

## Overview

CraftLocal appears to combine local-workshop bookings and guided experiences with a product-shopping storefront. The visible runtime evidence covers tour-guide schedules, customer lists, check-in, trip completion, QR tickets, and workshop reviews; the model tree also shows booking, catalog, cart, order, and payment domains. Source for much of the storefront and commerce flow was not provided, and the supplied README excerpt is empty, so those capabilities are represented as domain components without speculative connections.

Main entry points: [`local-craft/backend/src/services/qr.service.ts`](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/services/qr.service.ts) (QR ticket service), [`local-craft/backend/src/controllers/tourGuide.controller.ts`](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/tourGuide.controller.ts) (Guide operations), [`local-craft/backend/src/controllers/review.controller.ts`](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/review.controller.ts) (Review management), [`local-craft/backend/src/models/booking.model.ts`](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/booking.model.ts) (Bookings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Workshop experience"]
  node_review_controller["Review management"]
  node_booking_ui["Booking experience"]
end

subgraph group_guide["Guide operations"]
  node_guide_routes["Guide routes"]
  node_guide_controller["Guide operations"]
  node_qr_service["QR ticket service<br/>[qr.service.ts]"]
  node_qr_generator["QR image generator<br/>[generateQRCode.ts]"]
end

subgraph group_commerce["Shop commerce"]
  node_product_model[("Products<br/>[product.model.ts]")]
  node_cart_model[("Shopping carts<br/>[cart.model.ts]")]
  node_order_model[("Orders<br/>[order.model.ts]")]
  node_payment_model[("Payments<br/>[payment.model.ts]")]
  node_shop_ui["Storefront"]
end

subgraph group_storage["Domain storage"]
  node_booking_model[("Bookings<br/>[booking.model.ts]")]
  node_timeslot_model[("Workshop timeslots<br/>[timeslot.model.ts]")]
  node_ticket_model[("QR tickets<br/>[ticket.model.ts]")]
  node_workshop_model[("Workshops<br/>[workshop.model.ts]")]
  node_review_model[("Reviews<br/>[review.model.ts]")]
  node_category_model[("Product categories<br/>[category.model.ts]")]
end

node_tourist(("Tourist"))
node_tour_guide(("Tour guide"))

node_tour_guide -->|"uses"| node_guide_routes
node_guide_routes -->|"dispatches"| node_guide_controller
node_guide_controller -->|"reads and updates"| node_timeslot_model
node_guide_controller -->|"reads and updates"| node_booking_model
node_guide_controller -->|"checks in"| node_qr_service
node_qr_service -->|"reads and updates"| node_booking_model
node_qr_service -->|"validates assignment"| node_timeslot_model
node_qr_service -->|"creates and updates"| node_ticket_model
node_qr_service -->|"generates image"| node_qr_generator
node_review_controller -->|"validates booking"| node_booking_model
node_review_controller -->|"creates and reads"| node_review_model
node_review_controller -->|"updates rating"| node_workshop_model

click node_guide_routes "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/routes/tourGuide.routes.ts"
click node_guide_controller "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/tourGuide.controller.ts"
click node_qr_service "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/services/qr.service.ts"
click node_qr_generator "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/utils/generateQRCode.ts"
click node_review_controller "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/review.controller.ts"
click node_booking_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/booking.model.ts"
click node_timeslot_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/timeslot.model.ts"
click node_ticket_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/ticket.model.ts"
click node_workshop_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/workshop.model.ts"
click node_review_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/review.model.ts"
click node_category_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/category.model.ts"
click node_product_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/product.model.ts"
click node_cart_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/cart.model.ts"
click node_order_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/order.model.ts"
click node_payment_model "https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/payment.model.ts"
click node_booking_ui "https://github.com/ivant04/craftlocal_flatform/tree/main/local-craft/frontend/src"
click node_shop_ui "https://github.com/ivant04/craftlocal_flatform/tree/main/local-craft/frontend/src"

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_review_controller,node_booking_ui toneBlue
class node_guide_routes,node_guide_controller,node_qr_service,node_qr_generator toneAmber
class node_product_model,node_cart_model,node_order_model,node_payment_model,node_shop_ui toneMint
class node_booking_model,node_timeslot_model,node_ticket_model,node_workshop_model,node_review_model,node_category_model toneRose
class node_tourist,node_tour_guide toneIndigo
```

## Components

### Workshop experience

- [Review management](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/review.controller.ts): `local-craft/backend/src/controllers/review.controller.ts`
- [Booking experience](https://github.com/ivant04/craftlocal_flatform/tree/main/local-craft/frontend/src): `local-craft/frontend/src`

### Guide operations

- [Guide routes](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/routes/tourGuide.routes.ts): `local-craft/backend/src/routes/tourGuide.routes.ts`
- [Guide operations](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/controllers/tourGuide.controller.ts): `local-craft/backend/src/controllers/tourGuide.controller.ts`
- [QR ticket service](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/services/qr.service.ts): `local-craft/backend/src/services/qr.service.ts`
- [QR image generator](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/utils/generateQRCode.ts): `local-craft/backend/src/utils/generateQRCode.ts`

### Shop commerce

- [Products](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/product.model.ts): `local-craft/backend/src/models/product.model.ts`
- [Shopping carts](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/cart.model.ts): `local-craft/backend/src/models/cart.model.ts`
- [Orders](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/order.model.ts): `local-craft/backend/src/models/order.model.ts`
- [Payments](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/payment.model.ts): `local-craft/backend/src/models/payment.model.ts`
- [Storefront](https://github.com/ivant04/craftlocal_flatform/tree/main/local-craft/frontend/src): `local-craft/frontend/src`

### Domain storage

- [Bookings](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/booking.model.ts): `local-craft/backend/src/models/booking.model.ts`
- [Workshop timeslots](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/timeslot.model.ts): `local-craft/backend/src/models/timeslot.model.ts`
- [QR tickets](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/ticket.model.ts): `local-craft/backend/src/models/ticket.model.ts`
- [Workshops](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/workshop.model.ts): `local-craft/backend/src/models/workshop.model.ts`
- [Reviews](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/review.model.ts): `local-craft/backend/src/models/review.model.ts`
- [Product categories](https://github.com/ivant04/craftlocal_flatform/blob/main/local-craft/backend/src/models/category.model.ts): `local-craft/backend/src/models/category.model.ts`

### Other components

- **Tourist**
- **Tour guide**

## Connections

- Tour guide → Guide routes: uses (evidence: `local-craft/backend/src/routes/tourGuide.routes.ts`)
- Guide routes → Guide operations: dispatches (evidence: `local-craft/backend/src/routes/tourGuide.routes.ts`)
- Guide operations → Workshop timeslots: reads and updates (evidence: `local-craft/backend/src/controllers/tourGuide.controller.ts`)
- Guide operations → Bookings: reads and updates (evidence: `local-craft/backend/src/controllers/tourGuide.controller.ts`)
- Guide operations → QR ticket service: checks in (evidence: `local-craft/backend/src/controllers/tourGuide.controller.ts`)
- QR ticket service → Bookings: reads and updates (evidence: `local-craft/backend/src/services/qr.service.ts`)
- QR ticket service → Workshop timeslots: validates assignment (evidence: `local-craft/backend/src/services/qr.service.ts`)
- QR ticket service → QR tickets: creates and updates (evidence: `local-craft/backend/src/services/qr.service.ts`)
- QR ticket service → QR image generator: generates image (evidence: `local-craft/backend/src/services/qr.service.ts`)
- Review management → Bookings: validates booking (evidence: `local-craft/backend/src/controllers/review.controller.ts`)
- Review management → Reviews: creates and reads (evidence: `local-craft/backend/src/controllers/review.controller.ts`)
- Review management → Workshops: updates rating (evidence: `local-craft/backend/src/controllers/review.controller.ts`)
