How shawncastaneda11-commits/anihow-backend works
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: CheckoutService.php Checkout service · Listing.php Listings · Order.php Orders · MarketplaceController.php Marketplace API
Components 28
Marketplace API
- Marketplace API
app/Http/Controllers/Api/Marketplace/MarketplaceController.php - Listing management
app/Http/Controllers/Api/Listings/ListingController.php
Orders and commerce
- Cart API
app/Http/Controllers/Api/Cart/CartController.php - Checkout service
app/Services/CheckoutService.php - Buyer orders
app/Http/Controllers/Api/Orders/BuyerOrderController.php - Farmer orders
app/Http/Controllers/Api/Orders/FarmerOrderController.php - Order state machine
app/Services/OrderStateMachine.php - Review API
app/Http/Controllers/Api/Reviews/ReviewController.php - Walk-in sales
app/Actions/Orders/RecordWalkInSaleAction.php
Domain and pricing
- Listings
app/Models/Listing.php - Cart items
app/Models/CartItem.php - Orders
app/Models/Order.php - Accounts and roles
app/Models/User.php - Farms
app/Models/Farm.php - Crop types
app/Models/CropType.php - Reviews
app/Models/Review.php - Pricing guardrails
app/Support/Pricing/PriceGuardResolver.php - Listing image storage
app/Support/ListingStorage.php
Admin and content
- Filament panel
app/Providers/Filament/AdminPanelProvider.php - Farm price overrides
app/Actions/Pricing/SetFarmPriceOverrideAction.php - Stranded listings
app/Actions/Pricing/FlagStrandedListingsAction.php - Crop-care content
app/Http/Controllers/Api/CropCare/CropCareArticleController.php - Sales analytics
app/Services/AnalyticsService.php
Other components
- Buyer
- Farmer seller
- Admin staff
- MySQL database
- Email service
Connections 32
- Buyer → Marketplace API: browses
README.md - Marketplace API → Listings: queries listings
app/Http/Controllers/Api/Marketplace/MarketplaceController.php - Marketplace API → Listings: renders listings
app/Http/Controllers/Api/Marketplace/MarketplaceController.php - Farmer seller → Listing management: manages listings
README.md - Listing management → Listings: creates and updates
app/Http/Controllers/Api/Listings/ListingController.php - Buyer → Cart API: manages cart
- Cart API → Cart items: reads and writes
app/Http/Controllers/Api/Cart/CartController.php - Buyer → Checkout service: checks out
- Checkout service → Cart items: loads and clears
app/Services/CheckoutService.php - Checkout service → Listings: checks stock
app/Services/CheckoutService.php - Checkout service → Orders: creates orders
app/Services/CheckoutService.php - Checkout service → Accounts and roles: uses buyer
app/Services/CheckoutService.php - Buyer → Buyer orders: tracks orders
- Farmer seller → Farmer orders: manages orders
README.md - Farmer orders → Order state machine: transitions orders
app/Http/Controllers/Api/Orders/FarmerOrderController.php - Farmer orders → Orders: loads orders
app/Http/Controllers/Api/Orders/FarmerOrderController.php - Buyer → Review API: writes review
README.md - Review API → Reviews: creates review
app/Http/Controllers/Api/Reviews/ReviewController.php - Review API → Orders: checks completed order
app/Http/Controllers/Api/Reviews/ReviewController.php - Farmer seller → Walk-in sales: records walk-in
README.md - Walk-in sales → Orders: creates sale
app/Models/Order.php - Listings → Listing image storage: deletes image
app/Models/Listing.php - Listings → Pricing guardrails: resolves price guard
app/Models/Listing.php - Admin staff → Filament panel: administers
README.md - Filament panel → Farm price overrides: sets farm overrides
- Farm price overrides → Pricing guardrails: updates guardrails
app/Actions/Pricing/SetFarmPriceOverrideAction.php - Farm price overrides → Stranded listings: flags listings
app/Actions/Pricing/SetFarmPriceOverrideAction.php - Admin staff → Crop-care content: manages content
README.md - Admin staff → Sales analytics: views analytics
README.md - Sales analytics → MySQL database: reads totals
- Checkout service → MySQL database: persists orders
- Email service → Buyer: sends verification
README.md