# moanwer/softstore architecture

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

- Interactive diagram: https://gitdiagram.com/moanwer/softstore
- Repository: https://github.com/moanwer/softstore

## Overview

1. **Overall shape**
   - SoftStore is a single Laravel 12 monolith, not a split frontend/backend app.
   - The same codebase serves two major surfaces: the customer-facing store and the Filament-based admin panel.

2. **Request entry and routing**
   - HTTP traffic enters through `public/index.php` and is routed via `routes/web.php`.
   - Most user-facing pages are Livewire components, so page navigation is largely server-driven with reactive updates rather than a separate SPA API.

3. **Storefront UI layer**
   - The storefront lives in `app/Livewire` with matching Blade views in `resources/views/livewire`.
   - Main pages include home, products listing, product details, categories, cart, checkout, order history/details, success, and cancel screens.
   - Shared UI pieces such as navbar and footer are split into partial Livewire components.

4. **Authentication and account flows**
   - Auth is implemented as Livewire pages for login, registration, forgot password, and reset password.
   - These flows sit in the same application boundary as the store, and they reuse Laravel’s auth, session, and password reset infrastructure.

5. **Commerce domain and persistence**
   - The main domain models are `User`, `Category`, `Brand`, `Product`, `Order`, `OrderItem`, and `Address`.
   - Database structure is defined through migrations under `database/migrations`, with SQLite as the primary database in the README.
   - The model layer is the central boundary between UI components and stored commerce data.

6. **Cart and checkout flow**
   - Cart behavior is encapsulated in `app/Helpers/CartMangement.php`, which appears to manage item state across requests.
   - The checkout flow likely turns cart contents into an `Order`, `OrderItem` records, and an `Address`.
   - `SuccessPage` and `CancelPage` suggest payment outcome handling, with Stripe support prepared but marked as in progress.

7. **Admin panel**
   - The back office is built with Filament v3 and configured through `app/Providers/Filament/AdminPanelProvider.php`.
   - Admin resources exist for brands, categories, products, users, and orders, each with create/edit/list pages.
   - Order and user resources also have relation managers, indicating nested admin views for related records.
   - Admin widgets such as `OrderStats` and `LatestOrders` provide dashboard-style summaries.

8. **Events, listeners, and mail**
   - The app includes a user registration event (`UserRegisterd.php`), a `SendWelcomeEmail` listener, and a `WelcomeEmail` mailable.
   - This is the main asynchronous/business side-effect boundary visible in the repo: after registration, the app can trigger email onboarding.

9. **UI/asset stack**
   - Presentation uses Blade templates, Tailwind CSS, Alpine.js, Preline UI, and Livewire v3.
   - Frontend assets are built with Vite, with source files in `resources/js` and `resources/css`, and compiled output under `public/`.
   - The README highlights `wire:navigate` for faster in-app navigation and Livewire Alert for user notifications.

10. **Infrastructure and runtime concerns**
   - Laravel’s standard storage, cache, sessions, logs, and queue configuration are present, but no separate infrastructure service is defined in the tree.
   - The repo includes Docker support, indicating the app can be containerized for local or deployment use.
   - Queue and mail configuration exist, so the architecture is prepared for background jobs and outbound email, even if the visible implementation is mostly synchronous.

11. **Testing and scaffolding**
   - The repo contains the default Laravel test structure plus a `UserFactory`, suggesting standard model/factory-based testing.
   - There is no separate microservice boundary or API layer visible; the architecture is centered on Laravel MVC + Livewire + Filament.

12. **How to draw it**
   - A good diagram would show:
     - Browser/users → Livewire storefront components → Eloquent models → SQLite database
     - Browser/admins → Filament admin resources → Eloquent models → SQLite database
     - Registration/auth events → listener → mailer
     - Cart/checkout → order persistence → success/cancel/payment outcomes
     - Shared support layer for auth, sessions, storage, notifications, and build assets

Main entry points: [`routes/web.php`](https://github.com/moanwer/softstore/blob/main/routes/web.php) (web routes), [`app/Models/Product.php`](https://github.com/moanwer/softstore/blob/main/app/Models/Product.php) (Eloquent models), [`app/Livewire/CheckoutPage.php`](https://github.com/moanwer/softstore/blob/main/app/Livewire/CheckoutPage.php) (Checkout), [`app/Providers/Filament/AdminPanelProvider.php`](https://github.com/moanwer/softstore/blob/main/app/Providers/Filament/AdminPanelProvider.php) (Admin panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime & entry"]
  node_public_index["index.php<br/>HTTP entrypoint<br/>[index.php]"]
  node_routes_web["web routes<br/>route map<br/>[web.php]"]
end

subgraph group_storefront["Storefront"]
  node_home_page["Home<br/>Livewire page<br/>[HomePage.php]"]
  node_products_page["Products<br/>Livewire page<br/>[ProductsPage.php]"]
  node_product_details["Product details<br/>Livewire page"]
  node_categories_page["Categories<br/>Livewire page<br/>[CategoriesPage.php]"]
  node_cart_page["Cart<br/>Livewire page<br/>[CartPage.php]"]
  node_checkout_page["Checkout<br/>Livewire page<br/>[CheckoutPage.php]"]
  node_my_orders["My orders<br/>Livewire page<br/>[MyOrdersPage.php]"]
  node_my_order_detail["Order detail<br/>Livewire page"]
  node_success_page["Success<br/>Livewire page<br/>[SuccessPage.php]"]
  node_cancel_page["Cancel<br/>Livewire page<br/>[CancelPage.php]"]
  node_navbar["Navbar<br/>Livewire partial<br/>[Navbar.php]"]
  node_footer["Footer<br/>Livewire partial<br/>[Footer.php]"]
end

subgraph group_auth["Account flows"]
  node_login_page["Login<br/>Livewire auth page<br/>[LoginPage.php]"]
  node_register_page["Register<br/>Livewire auth page<br/>[RegisterPage.php]"]
  node_forgot_page["Forgot password<br/>Livewire auth page"]
  node_reset_page["Reset password<br/>Livewire auth page"]
end

subgraph group_admin["Admin panel"]
  node_admin_panel["Admin panel<br/>Filament v3 panel"]
  node_catalog_resources["Catalog resources<br/>Filament resources"]
  node_people_orders_resources["Users & orders<br/>Filament resources<br/>[UserResource.php]"]
  node_admin_widgets["Dashboard widgets<br/>Filament widgets<br/>[LatestOrders.php]"]
end

subgraph group_domain["Domain & data"]
  node_models[("Eloquent models<br/>commerce models<br/>[Product.php]")]
  node_cart_helper["Cart helper<br/>state helper<br/>[CartMangement.php]"]
  node_order_schema["Schema<br/>migrations"]
  node_database[("SQLite DB<br/>primary storage")]
  node_register_event["User registered<br/>domain event<br/>[UserRegisterd.php]"]
  node_welcome_listener["Send welcome<br/>event listener"]
  node_welcome_mail["Welcome email<br/>Mailable<br/>[WelcomeEmail.php]"]
end

node_public_index -->|"boots"| node_routes_web
node_routes_web -->|"serves"| node_home_page
node_routes_web -->|"serves"| node_products_page
node_routes_web -->|"serves"| node_product_details
node_routes_web -->|"serves"| node_categories_page
node_routes_web -->|"serves"| node_cart_page
node_routes_web -->|"serves"| node_checkout_page
node_routes_web -->|"serves"| node_my_orders
node_routes_web -->|"serves"| node_my_order_detail
node_routes_web -->|"serves"| node_success_page
node_routes_web -->|"serves"| node_cancel_page
node_routes_web -->|"serves"| node_login_page
node_routes_web -->|"serves"| node_register_page
node_routes_web -->|"serves"| node_forgot_page
node_routes_web -->|"serves"| node_reset_page
node_home_page -->|"uses"| node_navbar
node_home_page -->|"uses"| node_footer
node_products_page -->|"reads"| node_models
node_product_details -->|"reads"| node_models
node_categories_page -->|"reads"| node_models
node_cart_page -->|"uses"| node_cart_helper
node_cart_page -->|"reads"| node_models
node_checkout_page -->|"uses"| node_cart_helper
node_checkout_page -->|"writes"| node_models
node_my_orders -->|"reads"| node_models
node_my_order_detail -->|"reads"| node_models
node_success_page -->|"reads"| node_models
node_cancel_page -->|"reads"| node_models
node_register_page -->|"emits"| node_register_event
node_register_event -->|"handled by"| node_welcome_listener
node_welcome_listener -->|"sends"| node_welcome_mail
node_welcome_mail -->|"references"| node_models
node_admin_panel -->|"contains"| node_catalog_resources
node_admin_panel -->|"contains"| node_people_orders_resources
node_admin_panel -->|"contains"| node_admin_widgets
node_catalog_resources -->|"manages"| node_models
node_people_orders_resources -->|"manages"| node_models
node_people_orders_resources -.->|"supports"| node_my_orders
node_models -->|"persists"| node_database
node_order_schema -->|"defines"| node_database
node_checkout_page -.->|"depends on"| node_order_schema

click node_public_index "https://github.com/moanwer/softstore/blob/main/public/index.php"
click node_routes_web "https://github.com/moanwer/softstore/blob/main/routes/web.php"
click node_home_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/HomePage.php"
click node_products_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/ProductsPage.php"
click node_product_details "https://github.com/moanwer/softstore/blob/main/app/Livewire/ProductDetailsPage.php"
click node_categories_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/CategoriesPage.php"
click node_cart_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/CartPage.php"
click node_checkout_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/CheckoutPage.php"
click node_my_orders "https://github.com/moanwer/softstore/blob/main/app/Livewire/MyOrdersPage.php"
click node_my_order_detail "https://github.com/moanwer/softstore/blob/main/app/Livewire/MyOrderDetailPage.php"
click node_success_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/SuccessPage.php"
click node_cancel_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/CancelPage.php"
click node_navbar "https://github.com/moanwer/softstore/blob/main/app/Livewire/Partials/Navbar.php"
click node_footer "https://github.com/moanwer/softstore/blob/main/app/Livewire/Partials/Footer.php"
click node_login_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/LoginPage.php"
click node_register_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/RegisterPage.php"
click node_forgot_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/ForgetPasswordPage.php"
click node_reset_page "https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/ResetPasswordPage.php"
click node_admin_panel "https://github.com/moanwer/softstore/blob/main/app/Providers/Filament/AdminPanelProvider.php"
click node_catalog_resources "https://github.com/moanwer/softstore/blob/main/app/Filament/Resources/ProductResource.php"
click node_people_orders_resources "https://github.com/moanwer/softstore/blob/main/app/Filament/Resources/UserResource.php"
click node_admin_widgets "https://github.com/moanwer/softstore/blob/main/app/Filament/Widgets/LatestOrders.php"
click node_models "https://github.com/moanwer/softstore/blob/main/app/Models/Product.php"
click node_cart_helper "https://github.com/moanwer/softstore/blob/main/app/Helpers/CartMangement.php"
click node_order_schema "https://github.com/moanwer/softstore/blob/main/database/migrations/2025_03_22_092618_create_categories_table.php"
click node_database "https://github.com/moanwer/softstore/blob/main/database/migrations/0001_01_01_000000_create_users_table.php"
click node_register_event "https://github.com/moanwer/softstore/blob/main/app/Events/UserRegisterd.php"
click node_welcome_listener "https://github.com/moanwer/softstore/blob/main/app/Listeners/SendWelcomeEmail.php"
click node_welcome_mail "https://github.com/moanwer/softstore/blob/main/app/Mail/WelcomeEmail.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_public_index,node_routes_web toneBlue
class node_home_page,node_products_page,node_product_details,node_categories_page,node_cart_page,node_checkout_page,node_my_orders,node_my_order_detail,node_success_page,node_cancel_page,node_navbar,node_footer toneAmber
class node_login_page,node_register_page,node_forgot_page,node_reset_page toneMint
class node_admin_panel,node_catalog_resources,node_people_orders_resources,node_admin_widgets toneRose
class node_models,node_cart_helper,node_order_schema,node_database,node_register_event,node_welcome_listener,node_welcome_mail toneIndigo
```

## Components

### Runtime & entry

HTTP entrypoint, bootstrap, and routing.

- [index.php](https://github.com/moanwer/softstore/blob/main/public/index.php): HTTP entrypoint · Front controller for incoming web requests. · `public/index.php`
- [web routes](https://github.com/moanwer/softstore/blob/main/routes/web.php): route map · Main web routing for storefront and account pages. · `routes/web.php`

### Storefront

Customer-facing Livewire pages and shared UI.

- [Home](https://github.com/moanwer/softstore/blob/main/app/Livewire/HomePage.php): Livewire page · Storefront landing page. · `app/Livewire/HomePage.php`
- [Products](https://github.com/moanwer/softstore/blob/main/app/Livewire/ProductsPage.php): Livewire page · Product listing and browsing surface. · `app/Livewire/ProductsPage.php`
- [Product details](https://github.com/moanwer/softstore/blob/main/app/Livewire/ProductDetailsPage.php): Livewire page · Single product view and purchase entry point. · `app/Livewire/ProductDetailsPage.php`
- [Categories](https://github.com/moanwer/softstore/blob/main/app/Livewire/CategoriesPage.php): Livewire page · Category browsing surface. · `app/Livewire/CategoriesPage.php`
- [Cart](https://github.com/moanwer/softstore/blob/main/app/Livewire/CartPage.php): Livewire page · Cart review and item state display. · `app/Livewire/CartPage.php`
- [Checkout](https://github.com/moanwer/softstore/blob/main/app/Livewire/CheckoutPage.php): Livewire page · Checkout flow that turns cart contents into an order. · `app/Livewire/CheckoutPage.php`
- [My orders](https://github.com/moanwer/softstore/blob/main/app/Livewire/MyOrdersPage.php): Livewire page · Customer order history. · `app/Livewire/MyOrdersPage.php`
- [Order detail](https://github.com/moanwer/softstore/blob/main/app/Livewire/MyOrderDetailPage.php): Livewire page · Customer view for a single order. · `app/Livewire/MyOrderDetailPage.php`
- [Success](https://github.com/moanwer/softstore/blob/main/app/Livewire/SuccessPage.php): Livewire page · Post-checkout success outcome screen. · `app/Livewire/SuccessPage.php`
- [Cancel](https://github.com/moanwer/softstore/blob/main/app/Livewire/CancelPage.php): Livewire page · Post-checkout cancellation outcome screen. · `app/Livewire/CancelPage.php`
- [Navbar](https://github.com/moanwer/softstore/blob/main/app/Livewire/Partials/Navbar.php): Livewire partial · Shared storefront navigation. · `app/Livewire/Partials/Navbar.php`
- [Footer](https://github.com/moanwer/softstore/blob/main/app/Livewire/Partials/Footer.php): Livewire partial · Shared storefront footer. · `app/Livewire/Partials/Footer.php`

### Account flows

Login, registration, and password reset pages.

- [Login](https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/LoginPage.php): Livewire auth page · Customer sign-in page. · `app/Livewire/Auth/LoginPage.php`
- [Register](https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/RegisterPage.php): Livewire auth page · Customer registration page. · `app/Livewire/Auth/RegisterPage.php`
- [Forgot password](https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/ForgetPasswordPage.php): Livewire auth page · Password reset request page. · `app/Livewire/Auth/ForgetPasswordPage.php`
- [Reset password](https://github.com/moanwer/softstore/blob/main/app/Livewire/Auth/ResetPasswordPage.php): Livewire auth page · Password reset confirmation page. · `app/Livewire/Auth/ResetPasswordPage.php`

### Admin panel

Filament back office and dashboard widgets.

- [Admin panel](https://github.com/moanwer/softstore/blob/main/app/Providers/Filament/AdminPanelProvider.php): Filament v3 panel · Back office configured through Filament. · `app/Providers/Filament/AdminPanelProvider.php`
- [Catalog resources](https://github.com/moanwer/softstore/blob/main/app/Filament/Resources/ProductResource.php): Filament resources · Brand, category, and product management. · `app/Filament/Resources/ProductResource.php`
- [Users & orders](https://github.com/moanwer/softstore/blob/main/app/Filament/Resources/UserResource.php): Filament resources · User and order management, including nested relation views. · `app/Filament/Resources/UserResource.php`
- [Dashboard widgets](https://github.com/moanwer/softstore/blob/main/app/Filament/Widgets/LatestOrders.php): Filament widgets · Admin summaries such as latest orders and order stats. · `app/Filament/Widgets/LatestOrders.php`

### Domain & data

Commerce models, cart state, events, mail, and persistence.

- [Eloquent models](https://github.com/moanwer/softstore/blob/main/app/Models/Product.php): commerce models · Core entities: users, catalog, orders, and addresses. · `app/Models/Product.php`
- [Cart helper](https://github.com/moanwer/softstore/blob/main/app/Helpers/CartMangement.php): state helper · Request-spanning cart management logic. · `app/Helpers/CartMangement.php`
- [Schema](https://github.com/moanwer/softstore/blob/main/database/migrations/2025_03_22_092618_create_categories_table.php): migrations · Database migrations for users, catalog, orders, and addresses. · `database/migrations/2025_03_22_092618_create_categories_table.php`
- [SQLite DB](https://github.com/moanwer/softstore/blob/main/database/migrations/0001_01_01_000000_create_users_table.php): primary storage · Primary persistence store for the monolith. · `database/migrations/0001_01_01_000000_create_users_table.php`
- [User registered](https://github.com/moanwer/softstore/blob/main/app/Events/UserRegisterd.php): domain event · Event fired after a new user registers. · `app/Events/UserRegisterd.php`
- [Send welcome](https://github.com/moanwer/softstore/blob/main/app/Listeners/SendWelcomeEmail.php): event listener · Listener that sends onboarding email. · `app/Listeners/SendWelcomeEmail.php`
- [Welcome email](https://github.com/moanwer/softstore/blob/main/app/Mail/WelcomeEmail.php): Mailable · Welcome message sent to new users. · `app/Mail/WelcomeEmail.php`

## Connections

- index.php → web routes: boots · HTTP entrypoint hands off to web routing.
- web routes → Home: serves · Routes resolve to storefront pages.
- web routes → Products: serves · Routes resolve to product browsing.
- web routes → Product details: serves · Routes resolve to product details.
- web routes → Categories: serves · Routes resolve to category browsing.
- web routes → Cart: serves · Routes resolve to cart view.
- web routes → Checkout: serves · Routes resolve to checkout.
- web routes → My orders: serves · Routes resolve to customer order history.
- web routes → Order detail: serves · Routes resolve to customer order details.
- web routes → Success: serves · Routes resolve to checkout success.
- web routes → Cancel: serves · Routes resolve to checkout cancellation.
- web routes → Login: serves · Routes resolve to login.
- web routes → Register: serves · Routes resolve to registration.
- web routes → Forgot password: serves · Routes resolve to password reset request.
- web routes → Reset password: serves · Routes resolve to password reset confirmation.
- Home → Navbar: uses · Storefront pages share navigation.
- Home → Footer: uses · Storefront pages share footer.
- Products → Eloquent models: reads · Catalog pages load product and category data.
- Product details → Eloquent models: reads · Detail pages load product data.
- Categories → Eloquent models: reads · Category page loads category data.
- Cart → Cart helper: uses · Cart UI relies on cart state helper.
- Cart → Eloquent models: reads · Cart display resolves product data.
- Checkout → Cart helper: uses · Checkout starts from current cart contents.
- Checkout → Eloquent models: writes · Checkout creates orders, order items, and addresses.
- My orders → Eloquent models: reads · Order history loads user orders.
- Order detail → Eloquent models: reads · Order detail loads order and items.
- Success → Eloquent models: reads · Success outcome may reference order state.
- Cancel → Eloquent models: reads · Cancel outcome may reference payment/order state.
- Register → User registered: emits · Registration raises a domain event.
- User registered → Send welcome: handled by · Welcome listener reacts to the registration event.
- Send welcome → Welcome email: sends · Listener dispatches welcome email.
- Welcome email → Eloquent models: references · Welcome onboarding is tied to the user domain.
- Admin panel → Catalog resources: contains · Admin panel exposes catalog management resources.
- Admin panel → Users & orders: contains · Admin panel exposes user and order management.
- Admin panel → Dashboard widgets: contains · Admin panel shows dashboard widgets.
- Catalog resources → Eloquent models: manages · Catalog resources operate on Eloquent models.
- Users & orders → Eloquent models: manages · User and order resources operate on Eloquent models.
- Users & orders → My orders: supports · Admin order views complement customer order data.
- Eloquent models → SQLite DB: persists · Models map to the primary database.
- Schema → SQLite DB: defines · Migrations define the schema stored in SQLite.
- Checkout → Schema: depends on · Checkout flow depends on order-related schema.
