# shawncastaneda11-commits/anihow-backend architecture

> Architecture diagram of the GitHub repository shawncastaneda11-commits/anihow-backend, 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/shawncastaneda11-commits/anihow-backend
- Repository: https://github.com/shawncastaneda11-commits/anihow-backend

## Overview

AniHow is a Laravel API and Filament-administered farmers’ marketplace for mobile buyers and sellers. The main buyer workflow is browsing listings, maintaining a cart, checking out into orders, and reviewing completed orders; farmers manage listings and advance incoming orders. Admin capabilities include accounts, farms and crop taxonomy, pricing guardrails, content, moderation, and analytics. Some subsystems are represented from the README and file tree rather than sampled implementation, so their edges are documented only where supported or marked unverified.

Main entry points: [`app/Services/CheckoutService.php`](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/CheckoutService.php) (Checkout service), [`app/Models/Listing.php`](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Listing.php) (Listings), [`app/Models/Order.php`](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Order.php) (Orders), [`app/Http/Controllers/Api/Marketplace/MarketplaceController.php`](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Marketplace/MarketplaceController.php) (Marketplace API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market["Marketplace API"]
  node_market_api["Marketplace API"]
  node_listing_api["Listing management"]
end

subgraph group_commerce["Orders and commerce"]
  node_cart_api["Cart API<br/>[CartController.php]"]
  node_checkout["Checkout service"]
  node_buyer_orders["Buyer orders"]
  node_farmer_orders["Farmer orders"]
  node_state_machine["Order state machine"]
  node_reviews["Review API"]
  node_walkin["Walk-in sales"]
end

subgraph group_domain["Domain and pricing"]
  node_listing_model["Listings<br/>[Listing.php]"]
  node_cart_model["Cart items<br/>[CartItem.php]"]
  node_order_model["Orders<br/>[Order.php]"]
  node_user_model["Accounts and roles<br/>[User.php]"]
  node_farm_model["Farms<br/>[Farm.php]"]
  node_crop_model["Crop types<br/>[CropType.php]"]
  node_review_model["Reviews<br/>[Review.php]"]
  node_pricing["Pricing guardrails"]
  node_storage["Listing image storage<br/>[ListingStorage.php]"]
end

subgraph group_admin["Admin and content"]
  node_admin_panel["Filament panel"]
  node_farm_pricing["Farm price overrides"]
  node_stranded["Stranded listings"]
  node_crop_care["Crop-care content"]
  node_analytics["Sales analytics"]
end

node_buyer(("Buyer"))
node_farmer(("Farmer seller"))
node_administrator(("Admin staff"))
node_database[("MySQL database")]
node_email["Email service"]

node_buyer -->|"browses"| node_market_api
node_market_api -->|"queries listings"| node_listing_model
node_market_api -->|"renders listings"| node_listing_model
node_farmer -->|"manages listings"| node_listing_api
node_listing_api -->|"creates and updates"| node_listing_model
node_buyer -.->|"manages cart"| node_cart_api
node_cart_api -->|"reads and writes"| node_cart_model
node_buyer -.->|"checks out"| node_checkout
node_checkout -->|"loads and clears"| node_cart_model
node_checkout -->|"checks stock"| node_listing_model
node_checkout -->|"creates orders"| node_order_model
node_checkout -->|"uses buyer"| node_user_model
node_buyer -.->|"tracks orders"| node_buyer_orders
node_farmer -->|"manages orders"| node_farmer_orders
node_farmer_orders -->|"transitions orders"| node_state_machine
node_farmer_orders -->|"loads orders"| node_order_model
node_buyer -->|"writes review"| node_reviews
node_reviews -->|"creates review"| node_review_model
node_reviews -->|"checks completed order"| node_order_model
node_farmer -->|"records walk-in"| node_walkin
node_walkin -->|"creates sale"| node_order_model
node_listing_model -->|"deletes image"| node_storage
node_listing_model -->|"resolves price guard"| node_pricing
node_administrator -->|"administers"| node_admin_panel
node_admin_panel -->|"sets farm overrides"| node_farm_pricing
node_farm_pricing -->|"updates guardrails"| node_pricing
node_farm_pricing -->|"flags listings"| node_stranded
node_administrator -->|"manages content"| node_crop_care
node_administrator -->|"views analytics"| node_analytics
node_analytics -.->|"reads totals"| node_database
node_checkout -.->|"persists orders"| node_database
node_email -->|"sends verification"| node_buyer

click node_market_api "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Marketplace/MarketplaceController.php"
click node_listing_api "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Listings/ListingController.php"
click node_cart_api "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Cart/CartController.php"
click node_checkout "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/CheckoutService.php"
click node_buyer_orders "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Orders/BuyerOrderController.php"
click node_farmer_orders "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Orders/FarmerOrderController.php"
click node_state_machine "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/OrderStateMachine.php"
click node_reviews "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Reviews/ReviewController.php"
click node_walkin "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Orders/RecordWalkInSaleAction.php"
click node_listing_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Listing.php"
click node_cart_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/CartItem.php"
click node_order_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Order.php"
click node_user_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/User.php"
click node_farm_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Farm.php"
click node_crop_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/CropType.php"
click node_review_model "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Review.php"
click node_pricing "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Support/Pricing/PriceGuardResolver.php"
click node_storage "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Support/ListingStorage.php"
click node_admin_panel "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Providers/Filament/AdminPanelProvider.php"
click node_farm_pricing "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Pricing/SetFarmPriceOverrideAction.php"
click node_stranded "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Pricing/FlagStrandedListingsAction.php"
click node_crop_care "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/CropCare/CropCareArticleController.php"
click node_analytics "https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/AnalyticsService.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_market_api,node_listing_api toneBlue
class node_cart_api,node_checkout,node_buyer_orders,node_farmer_orders,node_state_machine,node_reviews,node_walkin,node_database toneAmber
class node_listing_model,node_cart_model,node_order_model,node_user_model,node_farm_model,node_crop_model,node_review_model,node_pricing,node_storage toneMint
class node_admin_panel,node_farm_pricing,node_stranded,node_crop_care,node_analytics toneRose
class node_buyer,node_farmer,node_administrator,node_email toneIndigo
```

## Components

### Marketplace API

- [Marketplace API](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Marketplace/MarketplaceController.php): `app/Http/Controllers/Api/Marketplace/MarketplaceController.php`
- [Listing management](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Listings/ListingController.php): `app/Http/Controllers/Api/Listings/ListingController.php`

### Orders and commerce

- [Cart API](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Cart/CartController.php): `app/Http/Controllers/Api/Cart/CartController.php`
- [Checkout service](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/CheckoutService.php): `app/Services/CheckoutService.php`
- [Buyer orders](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Orders/BuyerOrderController.php): `app/Http/Controllers/Api/Orders/BuyerOrderController.php`
- [Farmer orders](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Orders/FarmerOrderController.php): `app/Http/Controllers/Api/Orders/FarmerOrderController.php`
- [Order state machine](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/OrderStateMachine.php): `app/Services/OrderStateMachine.php`
- [Review API](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/Reviews/ReviewController.php): `app/Http/Controllers/Api/Reviews/ReviewController.php`
- [Walk-in sales](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Orders/RecordWalkInSaleAction.php): `app/Actions/Orders/RecordWalkInSaleAction.php`

### Domain and pricing

- [Listings](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Listing.php): `app/Models/Listing.php`
- [Cart items](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/CartItem.php): `app/Models/CartItem.php`
- [Orders](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Accounts and roles](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/User.php): `app/Models/User.php`
- [Farms](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Farm.php): `app/Models/Farm.php`
- [Crop types](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/CropType.php): `app/Models/CropType.php`
- [Reviews](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Models/Review.php): `app/Models/Review.php`
- [Pricing guardrails](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Support/Pricing/PriceGuardResolver.php): `app/Support/Pricing/PriceGuardResolver.php`
- [Listing image storage](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Support/ListingStorage.php): `app/Support/ListingStorage.php`

### Admin and content

- [Filament panel](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Providers/Filament/AdminPanelProvider.php): `app/Providers/Filament/AdminPanelProvider.php`
- [Farm price overrides](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Pricing/SetFarmPriceOverrideAction.php): `app/Actions/Pricing/SetFarmPriceOverrideAction.php`
- [Stranded listings](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Actions/Pricing/FlagStrandedListingsAction.php): `app/Actions/Pricing/FlagStrandedListingsAction.php`
- [Crop-care content](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Http/Controllers/Api/CropCare/CropCareArticleController.php): `app/Http/Controllers/Api/CropCare/CropCareArticleController.php`
- [Sales analytics](https://github.com/shawncastaneda11-commits/anihow-backend/blob/main/app/Services/AnalyticsService.php): `app/Services/AnalyticsService.php`

### Other components

- **Buyer**
- **Farmer seller**
- **Admin staff**
- **MySQL database**
- **Email service**

## Connections

- Buyer → Marketplace API: browses (evidence: `README.md`)
- Marketplace API → Listings: queries listings (evidence: `app/Http/Controllers/Api/Marketplace/MarketplaceController.php`)
- Marketplace API → Listings: renders listings (evidence: `app/Http/Controllers/Api/Marketplace/MarketplaceController.php`)
- Farmer seller → Listing management: manages listings (evidence: `README.md`)
- Listing management → Listings: creates and updates (evidence: `app/Http/Controllers/Api/Listings/ListingController.php`)
- Buyer → Cart API: manages cart
- Cart API → Cart items: reads and writes (evidence: `app/Http/Controllers/Api/Cart/CartController.php`)
- Buyer → Checkout service: checks out
- Checkout service → Cart items: loads and clears (evidence: `app/Services/CheckoutService.php`)
- Checkout service → Listings: checks stock (evidence: `app/Services/CheckoutService.php`)
- Checkout service → Orders: creates orders (evidence: `app/Services/CheckoutService.php`)
- Checkout service → Accounts and roles: uses buyer (evidence: `app/Services/CheckoutService.php`)
- Buyer → Buyer orders: tracks orders
- Farmer seller → Farmer orders: manages orders (evidence: `README.md`)
- Farmer orders → Order state machine: transitions orders (evidence: `app/Http/Controllers/Api/Orders/FarmerOrderController.php`)
- Farmer orders → Orders: loads orders (evidence: `app/Http/Controllers/Api/Orders/FarmerOrderController.php`)
- Buyer → Review API: writes review (evidence: `README.md`)
- Review API → Reviews: creates review (evidence: `app/Http/Controllers/Api/Reviews/ReviewController.php`)
- Review API → Orders: checks completed order (evidence: `app/Http/Controllers/Api/Reviews/ReviewController.php`)
- Farmer seller → Walk-in sales: records walk-in (evidence: `README.md`)
- Walk-in sales → Orders: creates sale (evidence: `app/Models/Order.php`)
- Listings → Listing image storage: deletes image (evidence: `app/Models/Listing.php`)
- Listings → Pricing guardrails: resolves price guard (evidence: `app/Models/Listing.php`)
- Admin staff → Filament panel: administers (evidence: `README.md`)
- Filament panel → Farm price overrides: sets farm overrides
- Farm price overrides → Pricing guardrails: updates guardrails (evidence: `app/Actions/Pricing/SetFarmPriceOverrideAction.php`)
- Farm price overrides → Stranded listings: flags listings (evidence: `app/Actions/Pricing/SetFarmPriceOverrideAction.php`)
- Admin staff → Crop-care content: manages content (evidence: `README.md`)
- Admin staff → Sales analytics: views analytics (evidence: `README.md`)
- Sales analytics → MySQL database: reads totals
- Checkout service → MySQL database: persists orders
- Email service → Buyer: sends verification (evidence: `README.md`)
