Skip to content

Deep analysis of checkout flow (@explore subagent)

Field Value
Source opencode CLI/web
Session ses_29207a8fbffek1cnovfjtCArhy
Started 2026-04-08 16:41
Messages 6
Parts 32 (text+patch+tool) · 5 reasoning · 13 tool calls
Model —
Directory /home/sambasene/Downloads/TStore-Firebase-main

Analyze the checkout flow in depth. Read and analyze:

  1. lib/features/checkout/checkout_injection.dart - Checkout dependency injection
  2. lib/features/checkout/data/datasources/checkout_remote_data_source.dart - Checkout data source
  3. lib/features/checkout/presentation/cubits/checkout_cubit.dart - Checkout cubit
  4. lib/features/checkout/domain/usecases/checkout_usecases.dart - Checkout use cases
  5. lib/features/checkout/presentation/pages/order_review_screen.dart - Order review screen

Explain the complete checkout flow from cart to order creation.

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/checkout_injection.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/checkout_injection.dart</path>
<type>file</type>
<content>
1: import 'package:get_it/get_it.dart';
2: import 'package:t_store/features/checkout/data/datasources/checkout_remote_data_source.dart';
3: import 'package:t_store/features/checkout/data/repositories/checkout_repository_impl.dart';
4: import 'package:t_store/features/checkout/domain/repositories/checkout_repository.dart';
5: import 'package:t_store/features/checkout/domain/usecases/checkout_usecases.dart';
6: import 'package:t_store/features/checkout/domain/usecases/create_order_draft_usecase.dart';
7: import 'package:t_store/features/checkout/domain/usecases/
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/data/datasources/checkout_remote_data_source.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/data/datasources/checkout_remote_data_source.dart</path>
<type>file</type>
<content>
1: import 'package:cloud_firestore/cloud_firestore.dart';
2: import 'package:t_store/core/firebase_collections/collections.dart';
3: import 'package:t_store/features/checkout/data/models/checkout_model.dart';
4: import 'package:t_store/features/checkout/data/models/order_model.dart';
5: import 'package:t_store/features/personalization/pages/address/data/models/address_model.dart';
6: import 'package:t_store/features/shop/features/all_products/data/models/product_model.dart';
7: import 'package:t_store/features/shop/features/cart/data/
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_cubit.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_cubit.dart</path>
<type>file</type>
<content>
1: import 'package:flutter_bloc/flutter_bloc.dart';
2: import 'package:t_store/core/config/service_locator.dart';
3: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
4: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
5: import 'package:t_store/features/checkout/domain/usecases/checkout_usecases.dart';
6: import 'package:t_store/features/personalization/pages/address/domain/entities/address_entity.dart';
7: import 'package:t_store/features/personalization/pages/address/domain/usecases
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/checkout_usecases.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/checkout_usecases.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/checkout/domain/usecases/create_order_draft_usecase.dart';
2: import 'package:t_store/features/checkout/domain/usecases/sync_cart_with_server_usecase.dart';
3: import 'package:t_store/features/checkout/domain/usecases/update_order_payment_status_usecase.dart';
4:
5: class CheckoutUsecases {
6: final SyncCartWithServerUseCase syncCartWithServerUseCase;
7: final UpdateOrderPaymentStatusUsecase updateOrderPaymentStatusUsecase;
8: final CreateOrderDraftUsecase createOrderDraftUsecase;
9:
10: CheckoutUsecases({
1
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/pages/order_review_screen.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/pages/order_review_screen.dart</path>
<type>file</type>
<content>
1: import 'package:flutter/material.dart';
2: import 'package:flutter_bloc/flutter_bloc.dart';
3: import 'package:t_store/common/widgets/appbar/t_appbar.dart';
4: import 'package:t_store/core/config/service_locator.dart';
5: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
6: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
7: import 'package:t_store/features/shop/features/cart/presentation/widgets/cart_item_card.dart';
8: import 'package:t_store/features/checkout/prese
…[truncated]

Let me also look at some related entities and use cases to get a complete picture of the data flow:

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/entities/checkout_entity.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/entities/checkout_entity.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/checkout/domain/entities/order_summary_entity.dart';
2: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
3: import 'package:t_store/core/utils/constants/enums.dart';
4:
5: class CheckoutEntity {
6: final String?
7: orderId; // created draft id from server (nullable until draft created)
8: final List<CartItemEntity> items;
9: final double subtotal;
10: final double shipping;
11: final double discount;
12: final double total;
13: final OrderStatus? status;
14:
15: Order
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/entities/order_entity.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/entities/order_entity.dart</path>
<type>file</type>
<content>
1: import 'package:cloud_firestore/cloud_firestore.dart';
2: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
3: import 'package:t_store/features/personalization/pages/address/domain/entities/address_entity.dart';
4:
5: class OrderEntity {
6: final String
7: orderId; // created draft id from server (nullable until draft created)
8: final String userId;
9: final CheckoutEntity checkoutModel;
10: final String? paymentIntentId;
11: final String? transactionId;
12: final AddressEntity? shippingAddress;
13: final String pa
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/sync_cart_with_server_usecase.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/sync_cart_with_server_usecase.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
2: import 'package:t_store/features/checkout/domain/repositories/checkout_repository.dart';
3: import 'package:t_store/features/shop/features/cart/domain/entities/cart_item_entity.dart';
4:
5: class SyncCartWithServerUseCase {
6: final CheckoutRepository _checkoutRepository;
7:
8: SyncCartWithServerUseCase(this._checkoutRepository);
9:
10: Future<CheckoutEntity> call(List<CartItemEntity> itemsPayload) async {
11: return await _checkoutRepository.sy
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/create_order_draft_usecase.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/domain/usecases/create_order_draft_usecase.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
2: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
3: import 'package:t_store/features/checkout/domain/repositories/checkout_repository.dart';
4:
5: class CreateOrderDraftUsecase {
6: final CheckoutRepository _checkoutRepository;
7:
8: CreateOrderDraftUsecase(this._checkoutRepository);
9:
10: Future<OrderEntity> call(CheckoutEntity checkoutData) async {
11: return await _checkoutRepository.createOrderDraft(
12: checkoutDa
…[truncated]

Let me also look at the repository implementation and checkout state to complete the picture:

glob — {"pattern": "**/checkout_repository_impl.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/data/repositories/checkout_repository_impl.dart

glob — {"pattern": "**/checkout_state.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_state.dart

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/data/repositories/checkout_repository_impl.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/data/repositories/checkout_repository_impl.dart</path>
<type>file</type>
<content>
1: import 'package:firebase_auth/firebase_auth.dart';
2: import 'package:t_store/features/checkout/data/datasources/checkout_remote_data_source.dart';
3: import 'package:t_store/features/checkout/data/mapper/checout_mapper.dart';
4: import 'package:t_store/features/checkout/data/mapper/order_mapper.dart';
5: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
6: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
7: import 'package:t_store/features/checkout/domain/repositories/check
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_state.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_state.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/checkout/domain/entities/checkout_entity.dart';
2: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
3: import 'package:t_store/features/personalization/pages/address/domain/entities/address_entity.dart';
4:
5: enum CheckoutStatus { initial, loading, success, failure }
6:
7: class CheckoutState {
8: final CheckoutStatus status;
9: final CheckoutEntity? checkoutData;
10: final String message;
11: final bool createOrderLoading;
12: final bool createOrderSuccess;
13: final OrderEnti
…[truncated]

Now I have a complete picture of the checkout flow. Let me provide an in-depth analysis:


The checkout feature follows Clean Architecture with three layers:

  • Presentation Layer: UI screens, cubits, and widgets
  • Domain Layer: Entities and use cases
  • Data Layer: Data sources, models, and repository implementations

1. Dependency Injection (checkout_injection.dart)

Section titled “1. Dependency Injection (checkout_injection.dart)”

The injection registers:

  • CheckoutRemoteDataSource - Interface for Firebase operations
  • CheckoutRepository - Impl that uses the data source
  • 3 Use Cases:
  • SyncCartWithServerUseCase - Syncs cart items with server prices
  • CreateOrderDraftUsecase - Creates a draft order
  • UpdateOrderPaymentStatusUsecase - Updates payment status
  • CheckoutUsecases - Wrapper class holding all use cases
  • CheckoutCubit - Factory (creates new instance per screen)

2. Data Source (checkout_remote_data_source.dart)

Section titled “2. Data Source (checkout_remote_data_source.dart)”

Three main operations:

1. Fetch product IDs from cart items
2. Query Firebase PRODUCTS_COLLECTION for these products
3. Match cart items with server products + variations
4. Calculate prices (uses salePrice if available, otherwise regular price)
5. Calculate totals:
- subtotal = sum(realPrice * quantity)
- shipping = 50.0 EGP (fixed)
- discount = 10.0 EGP (fixed)
- total = subtotal + shipping - discount
6. Return CheckoutModel with all calculated values

Key Logic:

  • Product prices are synced from the server (not local cart)
  • Handles sale prices vs regular prices
  • Uses batch processing for efficiency

B. createOrderDraft({checkoutData, userId})

Section titled “B. createOrderDraft({checkoutData, userId})”
1. Generate new order document reference
2. Fetch user's selected shipping address from Firebase
3. Create OrderModel with:
- orderId from document reference
- userId
- shippingAddress (from user's selected address)
- checkoutModel (items, prices, totals)
- paymentStatus: "pendingPayment"
- orderStatus: "unCompleted"
- timestamps
4. Batch write to:
- ORDERS_COLLECTION (global orders)
- USER_COLLECTION/{userId}/orders (user's orders)
5. Return created OrderModel

C. updateOrderPaymentStatus({orderId, newStatus, userId})

Section titled “C. updateOrderPaymentStatus({orderId, newStatus, userId})”
  • Updates paymentStatus in both global and user-specific order collections using a batch

State Management (BLoC pattern):

  • Holds CheckoutState with: status, checkoutData, order, address, loading flags
  • Three main methods:
1. Runs two operations in parallel:
- loadCheckout(items) - Sync cart with server
- loadSelectedAddress() - Get user's selected address

loadCheckout(items) - Sync cart with server

Section titled “loadCheckout(items) - Sync cart with server”
1. Set status = loading
2. Call syncCartWithServerUseCase(items)
3. On success: Set status = success, checkoutData = result
4. On failure: Set status = failure

createOrderDraft(checkoutData, [order]) - Create order

Section titled “createOrderDraft(checkoutData, [order]) - Create order”
1. Check if order already exists (orderId != null && orderStatus == "unCompleted")
- If exists: Set createOrderSuccess = true, return (avoid duplicate)
2. Set createOrderLoading = true
3. Call createOrderDraftUsecase(checkoutData)
4. On success: Set createOrderLoading = false, createOrderSuccess = true, order = newOrder
5. On failure: Set createOrderLoading = false, createOrderError = e

loadSelectedAddress() - Get shipping address

Section titled “loadSelectedAddress() - Get shipping address”
1. Get GetSelectedAddressUsecase from service locator
2. Call usecase to get selected address
3. Update state with address

Simple wrapper that aggregates three use cases:

class CheckoutUsecases {
final SyncCartWithServerUseCase syncCartWithServerUseCase;
final UpdateOrderPaymentStatusUsecase updateOrderPaymentStatusUsecase;
final CreateOrderDraftUsecase createOrderDraftUsecase;
}

Individual Use Cases:

…[truncated]

5 internal reasoning block(s) omitted — raw thinking is not exported (see archive index).