# rfcabingan/iam_ecomm architecture

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

- Interactive diagram: https://gitdiagram.com/rfcabingan/iam_ecomm
- Repository: https://github.com/rfcabingan/iam_ecomm

## Overview

This is a cross-platform Flutter e-commerce application. The apparent customer journey is browsing products, managing a cart, checking out, and viewing orders, alongside account, profile, and referral features. The tree also shows a shared API layer with services for these domains. However, no Dart implementation or product-specific README documentation was provided, so domain links below are dashed and unverified; the sampled native files only establish how desktop and mobile hosts start or register Flutter plugins.

Main entry points: [`lib/utils/api/core`](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/core) (API client), [`lib/utils/api/services`](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/services) (Account APIs), [`lib/features/shop/screens`](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens) (Product catalog), [`lib/features/shop/screens/product_details`](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/product_details) (Product details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_flutter["Flutter app<br/>[main.dart]"]
end

subgraph group_shop["Shopping"]
  node_home["Home"]
  node_catalog["Product catalog"]
  node_product["Product details"]
  node_wishlist["Wishlist"]
  node_cart["Cart"]
  node_checkout["Checkout"]
  node_orders["Orders"]
end

subgraph group_account["Account"]
  node_auth["Authentication"]
  node_profile["Profile and addresses"]
  node_referrals["Referrals and rewards"]
end

subgraph group_services["API services"]
  node_api["API client"]
  node_product_api["Product APIs<br/>[products_api.dart]"]
  node_cart_api["Cart and checkout APIs"]
  node_orders_api["Orders API<br/>[orders_api.dart]"]
  node_account_api["Account APIs"]
end

node_customer(("Customer"))
node_backend[("Backend services")]

node_customer -.->|"opens"| node_flutter
node_flutter -.->|"shows"| node_home
node_home -.->|"browses"| node_catalog
node_catalog -.->|"opens"| node_product
node_product -.->|"saves to"| node_wishlist
node_product -.->|"adds to"| node_cart
node_cart -.->|"continues to"| node_checkout
node_checkout -.->|"creates"| node_orders
node_customer -.->|"signs in"| node_auth
node_customer -.->|"manages"| node_profile
node_customer -.->|"views"| node_referrals
node_catalog -.->|"requests products"| node_product_api
node_cart -.->|"uses"| node_cart_api
node_checkout -.->|"submits checkout"| node_cart_api
node_orders -.->|"requests orders"| node_orders_api
node_auth -.->|"uses"| node_account_api
node_profile -.->|"uses"| node_account_api
node_referrals -.->|"uses"| node_account_api
node_product_api -.->|"uses"| node_api
node_cart_api -.->|"uses"| node_api
node_orders_api -.->|"uses"| node_api
node_account_api -.->|"uses"| node_api
node_api -.->|"requests"| node_backend

click node_flutter "https://github.com/rfcabingan/iam_ecomm/blob/main/lib/main.dart"
click node_home "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/screens/home"
click node_catalog "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens"
click node_product "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/product_details"
click node_wishlist "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/wishlist"
click node_cart "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/cart"
click node_checkout "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/checkout"
click node_orders "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/order"
click node_auth "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/authentication"
click node_profile "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/personalization/screens"
click node_referrals "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/personalization/screens/referrals"
click node_api "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/core"
click node_product_api "https://github.com/rfcabingan/iam_ecomm/blob/main/lib/utils/api/services/products_api.dart"
click node_cart_api "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/services"
click node_orders_api "https://github.com/rfcabingan/iam_ecomm/blob/main/lib/utils/api/services/orders_api.dart"
click node_account_api "https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/services"

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_flutter toneBlue
class node_home,node_catalog,node_product,node_wishlist,node_cart,node_checkout,node_orders,node_backend toneAmber
class node_auth,node_profile,node_referrals toneMint
class node_api,node_product_api,node_cart_api,node_orders_api,node_account_api toneRose
class node_customer toneIndigo
```

## Components

### App entry

- [Flutter app](https://github.com/rfcabingan/iam_ecomm/blob/main/lib/main.dart): `lib/main.dart`

### Shopping

- [Home](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/screens/home): `lib/features/screens/home`
- [Product catalog](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens): `lib/features/shop/screens`
- [Product details](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/product_details): `lib/features/shop/screens/product_details`
- [Wishlist](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/wishlist): `lib/features/shop/screens/wishlist`
- [Cart](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/cart): `lib/features/shop/screens/cart`
- [Checkout](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/checkout): `lib/features/shop/screens/checkout`
- [Orders](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/shop/screens/order): `lib/features/shop/screens/order`

### Account

- [Authentication](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/authentication): `lib/features/authentication`
- [Profile and addresses](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/personalization/screens): `lib/features/personalization/screens`
- [Referrals and rewards](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/features/personalization/screens/referrals): `lib/features/personalization/screens/referrals`

### API services

- [API client](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/core): `lib/utils/api/core`
- [Product APIs](https://github.com/rfcabingan/iam_ecomm/blob/main/lib/utils/api/services/products_api.dart): `lib/utils/api/services/products_api.dart`
- [Cart and checkout APIs](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/services): `lib/utils/api/services`
- [Orders API](https://github.com/rfcabingan/iam_ecomm/blob/main/lib/utils/api/services/orders_api.dart): `lib/utils/api/services/orders_api.dart`
- [Account APIs](https://github.com/rfcabingan/iam_ecomm/tree/main/lib/utils/api/services): `lib/utils/api/services`

### Other components

- **Customer**
- **Backend services**

## Connections

- Customer → Flutter app: opens
- Flutter app → Home: shows
- Home → Product catalog: browses
- Product catalog → Product details: opens
- Product details → Wishlist: saves to
- Product details → Cart: adds to
- Cart → Checkout: continues to
- Checkout → Orders: creates
- Customer → Authentication: signs in
- Customer → Profile and addresses: manages
- Customer → Referrals and rewards: views
- Product catalog → Product APIs: requests products
- Cart → Cart and checkout APIs: uses
- Checkout → Cart and checkout APIs: submits checkout
- Orders → Orders API: requests orders
- Authentication → Account APIs: uses
- Profile and addresses → Account APIs: uses
- Referrals and rewards → Account APIs: uses
- Product APIs → API client: uses
- Cart and checkout APIs → API client: uses
- Orders API → API client: uses
- Account APIs → API client: uses
- API client → Backend services: requests
