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 |
Transcript
Section titled “Transcript”Analyze the checkout flow in depth. Read and analyze:
- lib/features/checkout/checkout_injection.dart - Checkout dependency injection
- lib/features/checkout/data/datasources/checkout_remote_data_source.dart - Checkout data source
- lib/features/checkout/presentation/cubits/checkout_cubit.dart - Checkout cubit
- lib/features/checkout/domain/usecases/checkout_usecases.dart - Checkout use cases
- 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 String7: 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.dartglob — {"pattern": "**/checkout_state.dart"}
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/checkout/presentation/cubits/checkout_state.dartread — {"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:
Complete Checkout Flow Analysis
Section titled “Complete Checkout Flow Analysis”Architecture Overview
Section titled “Architecture Overview”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 operationsCheckoutRepository- Impl that uses the data source- 3 Use Cases:
SyncCartWithServerUseCase- Syncs cart items with server pricesCreateOrderDraftUsecase- Creates a draft orderUpdateOrderPaymentStatusUsecase- Updates payment statusCheckoutUsecases- Wrapper class holding all use casesCheckoutCubit- 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:
A. syncCartWithServer({itemsPayload})
Section titled “A. syncCartWithServer({itemsPayload})”1. Fetch product IDs from cart items2. Query Firebase PRODUCTS_COLLECTION for these products3. Match cart items with server products + variations4. 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 - discount6. Return CheckoutModel with all calculated valuesKey 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 reference2. Fetch user's selected shipping address from Firebase3. Create OrderModel with: - orderId from document reference - userId - shippingAddress (from user's selected address) - checkoutModel (items, prices, totals) - paymentStatus: "pendingPayment" - orderStatus: "unCompleted" - timestamps4. Batch write to: - ORDERS_COLLECTION (global orders) - USER_COLLECTION/{userId}/orders (user's orders)5. Return created OrderModelC. updateOrderPaymentStatus({orderId, newStatus, userId})
Section titled “C. updateOrderPaymentStatus({orderId, newStatus, userId})”- Updates
paymentStatusin both global and user-specific order collections using a batch
3. Checkout Cubit (checkout_cubit.dart)
Section titled “3. Checkout Cubit (checkout_cubit.dart)”State Management (BLoC pattern):
- Holds
CheckoutStatewith: status, checkoutData, order, address, loading flags - Three main methods:
init(items) - Called when screen loads
Section titled “init(items) - Called when screen loads”1. Runs two operations in parallel: - loadCheckout(items) - Sync cart with server - loadSelectedAddress() - Get user's selected addressloadCheckout(items) - Sync cart with server
Section titled “loadCheckout(items) - Sync cart with server”1. Set status = loading2. Call syncCartWithServerUseCase(items)3. On success: Set status = success, checkoutData = result4. On failure: Set status = failurecreateOrderDraft(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 = true3. Call createOrderDraftUsecase(checkoutData)4. On success: Set createOrderLoading = false, createOrderSuccess = true, order = newOrder5. On failure: Set createOrderLoading = false, createOrderError = eloadSelectedAddress() - Get shipping address
Section titled “loadSelectedAddress() - Get shipping address”1. Get GetSelectedAddressUsecase from service locator2. Call usecase to get selected address3. Update state with address4. Use Cases (checkout_usecases.dart)
Section titled “4. Use Cases (checkout_usecases.dart)”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).