diff --git a/lib/api.dart b/lib/api.dart index 81b34286..d966db55 100644 --- a/lib/api.dart +++ b/lib/api.dart @@ -330,6 +330,10 @@ class InvenTreeAPI { // Ref: https://github.com/inventree/InvenTree/pull/11963 bool get supportsNewUserEndpoints => apiVersion >= 490; + // Does the server support TransferOrder model + // Ref: https://github.com/inventree/InvenTree/pull/11281 + bool get supportsTransferOrders => apiVersion >= 492; + // Does the server support the "creation_date" field on the StockItem model? // Ref: https://github.com/inventree/InvenTree/pull/12011 bool get supportsStockItemCreationDate => apiVersion >= 496; diff --git a/lib/barcode/barcode.dart b/lib/barcode/barcode.dart index 64be1d46..d4a45fbc 100644 --- a/lib/barcode/barcode.dart +++ b/lib/barcode/barcode.dart @@ -6,10 +6,12 @@ import "package:inventree/helpers.dart"; import "package:inventree/inventree/build.dart"; import "package:inventree/inventree/sales_order.dart"; import "package:inventree/inventree/sentry.dart"; +import "package:inventree/inventree/transfer_order.dart"; import "package:inventree/preferences.dart"; import "package:inventree/widget/build/build_detail.dart"; import "package:inventree/widget/company/manufacturer_part_detail.dart"; import "package:inventree/widget/order/sales_order_detail.dart"; +import "package:inventree/widget/order/transfer_order_detail.dart"; import "package:one_context/one_context.dart"; import "package:inventree/api.dart"; @@ -230,6 +232,23 @@ class BarcodeScanHandler extends BarcodeHandler { } } + /* + * Response when a "TransferOrder" instance is scanned + */ + Future handleTransferOrder(int pk) async { + var order = await InvenTreeTransferOrder().get(pk); + + if (order is InvenTreeTransferOrder && + InvenTreeAPI().supportsTransferOrders) { + OneContext().pop(); + OneContext().push( + MaterialPageRoute( + builder: (context) => TransferOrderDetailWidget(order), + ), + ); + } + } + /* * Response when a "PurchaseOrder" instance is scanned */ @@ -273,6 +292,7 @@ class BarcodeScanHandler extends BarcodeHandler { InvenTreeStockLocation.MODEL_TYPE, InvenTreeCompany.MODEL_TYPE, InvenTreeBuildOrder.MODEL_TYPE, + InvenTreeTransferOrder.MODEL_TYPE, InvenTreePurchaseOrder.MODEL_TYPE, InvenTreeSalesOrder.MODEL_TYPE, ]; @@ -304,6 +324,9 @@ class BarcodeScanHandler extends BarcodeHandler { case InvenTreeBuildOrder.MODEL_TYPE: await handleBuildOrder(pk); return; + case InvenTreeTransferOrder.MODEL_TYPE: + await handleTransferOrder(pk); + return; case InvenTreePurchaseOrder.MODEL_TYPE: await handlePurchaseOrder(pk); return; diff --git a/lib/inventree/transfer_order.dart b/lib/inventree/transfer_order.dart new file mode 100644 index 00000000..befe460c --- /dev/null +++ b/lib/inventree/transfer_order.dart @@ -0,0 +1,392 @@ +/* + * Models representing transfer orders + */ + +import "package:flutter/material.dart"; +import "package:flutter_tabler_icons/flutter_tabler_icons.dart"; + +import "package:inventree/api.dart"; +import "package:inventree/app_colors.dart"; +import "package:inventree/helpers.dart"; +import "package:inventree/inventree/model.dart"; +import "package:inventree/inventree/orders.dart"; +import "package:inventree/inventree/part.dart"; +import "package:inventree/inventree/stock.dart"; +import "package:inventree/l10.dart"; +import "package:inventree/widget/order/transfer_order_detail.dart"; + +/* + * Class representing an individual TransferOrder instance + */ +class InvenTreeTransferOrder extends InvenTreeOrder { + InvenTreeTransferOrder() : super(); + + InvenTreeTransferOrder.fromJson(Map json) + : super.fromJson(json); + + @override + InvenTreeModel createFromJson(Map json) => + InvenTreeTransferOrder.fromJson(json); + + // API endpoint URL + @override + String get URL => "order/transfer-order/"; + + static const String MODEL_TYPE = "transferorder"; + + @override + List get rolesRequired => ["transfer_order"]; + + // Return icon for this model + static IconData get icon => TablerIcons.transfer; + + @override + Future goToDetailPage(BuildContext context) async { + return Navigator.push( + context, + MaterialPageRoute(builder: (context) => TransferOrderDetailWidget(this)), + ); + } + + @override + Map> formFields() { + return { + "reference": {}, + "description": {}, + "project_code": {}, + "take_from": {}, + "destination": {"required": true}, + "consume": {}, + "start_date": {}, + "target_date": {}, + "link": {}, + "responsible": {}, + }; + } + + @override + Map defaultFilters() { + return {"take_from_detail": "true", "destination_detail": "true"}; + } + + // Source location for this transfer order (may be null - any location) + int? get sourceLocationId { + int value = getInt("take_from"); + return value > 0 ? value : null; + } + + // Destination location for this transfer order + int? get destinationId { + int value = getInt("destination"); + return value > 0 ? value : null; + } + + // Should allocated stock be "consumed" rather than transferred? + bool get consume => getBool("consume"); + + bool get isPending => TransferOrderStatus.isNameIn(status, ["PENDING"]); + + bool get isIssued => TransferOrderStatus.isNameIn(status, ["ISSUED"]); + + bool get isOnHold => TransferOrderStatus.isNameIn(status, ["ON_HOLD"]); + + bool get isComplete => TransferOrderStatus.isNameIn(status, ["COMPLETE"]); + + bool get isCancelled => TransferOrderStatus.isNameIn(status, ["CANCELLED"]); + + // An "open" order is one which is not complete or cancelled + bool get isOpen => !isComplete && !isCancelled; + + // Can this order be issued? + bool get canIssue => isPending || isOnHold; + + // Can this order be placed on hold? + bool get canHold => isPending || isIssued; + + // Can this order be completed? + bool get canCompleteOrder => (isIssued || isOnHold) && !isPending; + + // Can this order be cancelled? + bool get canCancel => isOpen; + + Future> getLineItems() async { + final results = await InvenTreeTransferOrderLineItem().list( + filters: {"order": "${pk}"}, + ); + + List items = []; + + for (var result in results) { + if (result is InvenTreeTransferOrderLineItem) { + items.add(result); + } + } + + return items; + } + + /// Mark this order as "issued" + Future issue() async { + return await api.post( + "${URL}${pk}/issue/", + body: {}, + expectedStatusCode: 201, + ); + } + + /// Place this order on hold + Future hold() async { + return await api.post( + "${URL}${pk}/hold/", + body: {}, + expectedStatusCode: 201, + ); + } + + /// Mark this order as "complete" + Future completeOrder({bool acceptIncomplete = false}) async { + Map data = { + "accept_incomplete": acceptIncomplete.toString(), + }; + + return await api.post( + "${URL}${pk}/complete/", + body: data, + expectedStatusCode: 201, + ); + } + + /// Mark this order as "cancelled" + Future cancel() async { + return await api.post( + "${URL}${pk}/cancel/", + body: {}, + expectedStatusCode: 201, + ); + } +} + +/* + * Class representing a line item within a Transfer Order + */ +class InvenTreeTransferOrderLineItem extends InvenTreeOrderLine { + InvenTreeTransferOrderLineItem() : super(); + + InvenTreeTransferOrderLineItem.fromJson(Map json) + : super.fromJson(json); + + @override + InvenTreeModel createFromJson(Map json) => + InvenTreeTransferOrderLineItem.fromJson(json); + + // API endpoint URL + @override + String get URL => "order/transfer-order-line/"; + + @override + List get rolesRequired => ["transfer_order"]; + + @override + Map defaultFilters() { + return {"part_detail": "true", "order_detail": "true"}; + } + + @override + Map> formFields() { + return { + "order": { + // Cannot edit the order from here + "hidden": true, + }, + "part": { + "required": true, + "filters": {"virtual": false}, + }, + "quantity": {"required": true}, + "reference": {}, + "target_date": {}, + "link": {}, + "notes": {}, + }; + } + + // Quantity of stock allocated against this line item + double get allocated => getDouble("allocated"); + + // Quantity of stock which has actually been transferred + double get transferred => getDouble("transferred"); + + bool get isComplete => transferred >= quantity; + + double get outstanding => quantity - transferred; + + double get progressRatio { + if (quantity <= 0 || transferred <= 0) { + return 0; + } + + return transferred / quantity; + } + + String get progressString => + simpleNumberString(transferred) + " / " + simpleNumberString(quantity); + + InvenTreeTransferOrder? get transferOrder { + dynamic detail = jsondata["order_detail"]; + + if (detail == null) { + return null; + } else { + return InvenTreeTransferOrder.fromJson(detail as Map); + } + } +} + +/* + * Class representing a single stock allocation against a Transfer Order line item + */ +class InvenTreeTransferOrderAllocation extends InvenTreeModel { + InvenTreeTransferOrderAllocation() : super(); + + InvenTreeTransferOrderAllocation.fromJson(Map json) + : super.fromJson(json); + + @override + InvenTreeModel createFromJson(Map json) => + InvenTreeTransferOrderAllocation.fromJson(json); + + @override + String get URL => "order/transfer-order-allocation/"; + + static const String MODEL_TYPE = "transferorderallocation"; + + @override + List get rolesRequired => ["transfer_order"]; + + @override + Map defaultFilters() { + return { + "part_detail": "true", + "order_detail": "true", + "item_detail": "true", + "location_detail": "true", + }; + } + + double get quantity => getDouble("quantity"); + + int get lineId => getInt("line"); + + int get orderId => getInt("order"); + + InvenTreeTransferOrder? get order { + dynamic detail = jsondata["order_detail"]; + + if (detail == null) { + return null; + } else { + return InvenTreeTransferOrder.fromJson(detail as Map); + } + } + + int get stockItemId => getInt("item"); + + InvenTreeStockItem? get stockItem { + dynamic detail = jsondata["item_detail"]; + + if (detail == null) { + return null; + } else { + return InvenTreeStockItem.fromJson(detail as Map); + } + } + + int get partId => getInt("part"); + + InvenTreePart? get part { + dynamic detail = jsondata["part_detail"]; + + if (detail == null) { + return null; + } else { + return InvenTreePart.fromJson(detail as Map); + } + } + + int get locationId => getInt("location"); + + InvenTreeStockLocation? get location { + dynamic detail = jsondata["location_detail"]; + + if (detail == null) { + return null; + } else { + return InvenTreeStockLocation.fromJson(detail as Map); + } + } +} + +/* + * Transfer Order Status Codes + * Ref: https://github.com/inventree/InvenTree/blob/master/src/backend/InvenTree/order/status_codes.py + */ +class TransferOrderStatus { + // Status codes as defined in backend status_codes.py + static const int PENDING = 10; // Transfer order is pending / inactive + static const int ISSUED = 20; // Transfer order has been issued + static const int ON_HOLD = 25; // Transfer order is on hold + static const int COMPLETE = 30; // Transfer order is complete + static const int CANCELLED = 40; // Transfer order was cancelled + + static const Map _names = { + PENDING: "PENDING", + ISSUED: "ISSUED", + ON_HOLD: "ON_HOLD", + COMPLETE: "COMPLETE", + CANCELLED: "CANCELLED", + }; + + // Return the (untranslated) name associated with a given status code + static String name(int status) => _names[status] ?? ""; + + // Test if the name associated with the given code is in the provided list + static bool isNameIn(int status, List names) { + return names.contains(name(status)); + } + + // Return a color based on the transfer order status + static Color getStatusColor(int status) { + switch (status) { + case PENDING: + return COLOR_GRAY_LIGHT; + case ISSUED: + return COLOR_PROGRESS; + case COMPLETE: + return COLOR_SUCCESS; + case CANCELLED: + return COLOR_DANGER; + case ON_HOLD: + return COLOR_WARNING; + default: + return COLOR_GRAY_LIGHT; + } + } + + // Return a (translated) string based on the transfer order status + static String getStatusText(int status) { + switch (status) { + case PENDING: + return L10().pending; + case ISSUED: + return L10().issued; + case COMPLETE: + return L10().complete; + case CANCELLED: + return L10().cancelled; + case ON_HOLD: + return L10().onHold; + default: + return L10().unknown; + } + } +} diff --git a/lib/l10n/app_en.arb b/lib/l10n/app_en.arb index d84bb56c..2055c42b 100644 --- a/lib/l10n/app_en.arb +++ b/lib/l10n/app_en.arb @@ -342,6 +342,12 @@ "configureServer": "Configure server settings", "@configureServer": {}, + "consume": "Consume", + "@consume": {}, + + "consumeDetail": "Allocated stock will be consumed, not transferred", + "@consumeDetail": {}, + "confirmScan": "Confirm Transfer", "@confirmScan": {}, @@ -701,6 +707,12 @@ "homeShowCustomersDescription": "Show customers button on home screen", "@homeShowCustomersDescription": {}, + "homeShowTransfer": "Show Transfer Orders", + "@homeShowTransfer": {}, + + "homeShowTransferDescription": "Show transfer order button on home screen", + "@homeShowTransferDescription": {}, + "imageUploadFailure": "Image upload failed", "@imageUploadFailure": {}, @@ -1097,6 +1109,15 @@ "pending": "Pending", "@pending": {}, + "issued": "Issued", + "@issued": {}, + + "cancelled": "Cancelled", + "@cancelled": {}, + + "onHold": "On Hold", + "@onHold": {}, + "permissionAccountDenied": "Your account does not have the required permissions to perform this action", "@permissionAccountDenied": {}, @@ -1811,6 +1832,21 @@ "description": "transfer" }, + "transferOrder": "Transfer Order", + "@transferOrder": {}, + + "transferOrders": "Transfer Orders", + "@transferOrders": {}, + + "transferOrderCreate": "New Transfer Order", + "@transferOrderCreate": {}, + + "transferOrderEdit": "Edit Transfer Order", + "@transferOrderEdit": {}, + + "transferOrderUpdated": "Transfer order updated", + "@transferOrderUpdated": {}, + "transferStock": "Transfer Stock", "@transferStock": { "description": "transfer stock" @@ -1852,6 +1888,9 @@ "units": "Units", "@units": {}, + "unknown": "Unknown", + "@unknown": {}, + "unknownResponse": "Unknown Response", "@unknownResponse": {}, diff --git a/lib/preferences.dart b/lib/preferences.dart index 7a6c21d3..04a2ff67 100644 --- a/lib/preferences.dart +++ b/lib/preferences.dart @@ -15,6 +15,7 @@ const String INV_HOME_SHOW_BUILD = "homeShowBuild"; const String INV_HOME_SHOW_MANUFACTURERS = "homeShowManufacturers"; const String INV_HOME_SHOW_CUSTOMERS = "homeShowCustomers"; const String INV_HOME_SHOW_SUPPLIERS = "homeShowSuppliers"; +const String INV_HOME_SHOW_TRANSFER = "homeShowTransfer"; const String INV_SCREEN_ORIENTATION = "appScreenOrientation"; const String INV_SHOW_PK = "showPk"; diff --git a/lib/settings/home_settings.dart b/lib/settings/home_settings.dart index e5e891e0..b2adea42 100644 --- a/lib/settings/home_settings.dart +++ b/lib/settings/home_settings.dart @@ -23,6 +23,7 @@ class _HomeScreenSettingsState extends State { bool homeShowSuppliers = true; bool homeShowManufacturers = true; bool homeShowCustomers = true; + bool homeShowTransfer = true; @override void initState() { @@ -63,6 +64,9 @@ class _HomeScreenSettingsState extends State { homeShowSuppliers = await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_SUPPLIERS, true) as bool; + homeShowTransfer = + await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_TRANSFER, true) + as bool; setState(() {}); } @@ -154,6 +158,23 @@ class _HomeScreenSettingsState extends State { }, ), ), + ListTile( + title: Text(L10().homeShowTransfer), + subtitle: Text(L10().homeShowTransferDescription), + leading: Icon(TablerIcons.transfer), + trailing: Switch( + value: homeShowTransfer, + onChanged: (bool value) { + InvenTreeSettingsManager().setValue( + INV_HOME_SHOW_TRANSFER, + value, + ); + setState(() { + homeShowTransfer = value; + }); + }, + ), + ), // TODO: When these features are improved, add them back in! // Currently, the company display does not provide any value /* diff --git a/lib/widget/drawer.dart b/lib/widget/drawer.dart index e25c7920..9f461c3e 100644 --- a/lib/widget/drawer.dart +++ b/lib/widget/drawer.dart @@ -10,11 +10,13 @@ import "package:inventree/inventree/part.dart"; import "package:inventree/inventree/purchase_order.dart"; import "package:inventree/inventree/sales_order.dart"; import "package:inventree/inventree/stock.dart"; +import "package:inventree/inventree/transfer_order.dart"; import "package:inventree/l10.dart"; import "package:inventree/settings/about.dart"; import "package:inventree/settings/settings.dart"; import "package:inventree/widget/build/build_list.dart"; import "package:inventree/widget/order/sales_order_list.dart"; +import "package:inventree/widget/order/transfer_order_list.dart"; import "package:inventree/widget/part/category_display.dart"; import "package:inventree/widget/notifications.dart"; import "package:inventree/widget/order/purchase_order_list.dart"; @@ -162,6 +164,18 @@ class _InvenTreeDrawerState extends State { } } + void _transferOrders() { + _closeDrawer(); + if (_checkConnection()) { + Navigator.push( + widget.parentContext, + MaterialPageRoute( + builder: (context) => TransferOrderListWidget(filters: {}), + ), + ); + } + } + void _notifications() { _closeDrawer(); if (_checkConnection()) { @@ -261,6 +275,17 @@ class _InvenTreeDrawerState extends State { ); } + if (InvenTreeAPI().supportsTransferOrders && + InvenTreeTransferOrder().canView) { + tiles.add( + ListTile( + title: Text(L10().transferOrders), + leading: Icon(TablerIcons.transfer, color: COLOR_ACTION), + onTap: _transferOrders, + ), + ); + } + if (InvenTreePurchaseOrder().canView) { tiles.add( ListTile( diff --git a/lib/widget/home.dart b/lib/widget/home.dart index e6d60bc6..c8ac9a64 100644 --- a/lib/widget/home.dart +++ b/lib/widget/home.dart @@ -12,6 +12,7 @@ import "package:inventree/inventree/update_check.dart"; import "package:inventree/inventree/purchase_order.dart"; import "package:inventree/inventree/sales_order.dart"; import "package:inventree/inventree/stock.dart"; +import "package:inventree/inventree/transfer_order.dart"; import "package:inventree/preferences.dart"; import "package:inventree/l10.dart"; import "package:inventree/settings/select_server.dart"; @@ -24,6 +25,7 @@ import "package:inventree/widget/stock/location_display.dart"; import "package:inventree/widget/part/part_list.dart"; import "package:inventree/widget/order/purchase_order_list.dart"; import "package:inventree/widget/order/sales_order_list.dart"; +import "package:inventree/widget/order/transfer_order_list.dart"; import "package:inventree/widget/build/build_list.dart"; import "package:inventree/widget/refreshable_state.dart"; import "package:inventree/widget/snacks.dart"; @@ -157,6 +159,7 @@ class _InvenTreeHomePageState extends State bool homeShowManufacturers = false; bool homeShowCustomers = false; bool homeShowSuppliers = false; + bool homeShowTransfer = false; // Selected user profile UserProfile? _profile; @@ -169,6 +172,8 @@ class _InvenTreeHomePageState extends State int? _soOverdueCount; int? _soOutstandingCount; int? _shipmentsPendingCount; + int? _transferOverdueCount; + int? _transferOutstandingCount; void _showParts(BuildContext context) { if (!InvenTreeAPI().checkConnection()) return; @@ -233,6 +238,17 @@ class _InvenTreeHomePageState extends State ); } + void _showTransferOrders(BuildContext context) { + if (!InvenTreeAPI().checkConnection()) return; + + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => TransferOrderListWidget(filters: {}), + ), + ); + } + void _showBuildOrders(BuildContext context) { if (!InvenTreeAPI().checkConnection()) return; @@ -330,6 +346,9 @@ class _InvenTreeHomePageState extends State homeShowSuppliers = await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_SUPPLIERS, true) as bool; + homeShowTransfer = + await InvenTreeSettingsManager().getValue(INV_HOME_SHOW_TRANSFER, true) + as bool; setState(() {}); @@ -356,6 +375,10 @@ class _InvenTreeHomePageState extends State final bool loadSo = homeShowSo && InvenTreeSalesOrder().canView; final bool loadShipments = homeShowShipments && InvenTreeSalesOrderShipment().canView; + final bool loadTransfer = + homeShowTransfer && + InvenTreeAPI().supportsTransferOrders && + InvenTreeTransferOrder().canView; int? buildOverdue; int? buildOutstanding; @@ -364,6 +387,8 @@ class _InvenTreeHomePageState extends State int? soOverdue; int? soOutstanding; int? shipmentsPending; + int? transferOverdue; + int? transferOutstanding; final List> requests = []; @@ -418,6 +443,21 @@ class _InvenTreeHomePageState extends State ); } + if (loadTransfer) { + requests.add( + InvenTreeTransferOrder().count(filters: {"overdue": "true"}).then((c) { + transferOverdue = c; + }), + ); + requests.add( + InvenTreeTransferOrder().count(filters: {"outstanding": "true"}).then(( + c, + ) { + transferOutstanding = c; + }), + ); + } + await Future.wait(requests); if (!mounted) { @@ -432,6 +472,8 @@ class _InvenTreeHomePageState extends State _soOverdueCount = soOverdue; _soOutstandingCount = soOutstanding; _shipmentsPendingCount = shipmentsPending; + _transferOverdueCount = transferOverdue; + _transferOutstandingCount = transferOutstanding; }); } @@ -571,6 +613,27 @@ class _InvenTreeHomePageState extends State ); } + // Transfer orders + if (homeShowTransfer && + InvenTreeAPI().supportsTransferOrders && + InvenTreeTransferOrder().canView) { + tiles.add( + _listTile( + context, + L10().transferOrders, + TablerIcons.transfer, + callback: () { + _showTransferOrders(context); + }, + trailing: buildOrderBadges( + context, + outstandingCount: _transferOutstandingCount, + overdueCount: _transferOverdueCount, + ), + ), + ); + } + // Purchase orders if (homeShowPo && InvenTreePurchaseOrder().canView) { tiles.add( diff --git a/lib/widget/order/transfer_order_allocation_list.dart b/lib/widget/order/transfer_order_allocation_list.dart new file mode 100644 index 00000000..8f6e40b4 --- /dev/null +++ b/lib/widget/order/transfer_order_allocation_list.dart @@ -0,0 +1,113 @@ +import "package:flutter/material.dart"; + +import "package:inventree/api.dart"; +import "package:inventree/helpers.dart"; +import "package:inventree/inventree/model.dart"; +import "package:inventree/inventree/transfer_order.dart"; +import "package:inventree/l10.dart"; + +import "package:inventree/widget/link_icon.dart"; +import "package:inventree/widget/paginator.dart"; +import "package:inventree/widget/refreshable_state.dart"; + +/* + * Full-page widget for displaying the stock items allocated against a + * single Transfer Order line item + */ +class TransferOrderAllocationWidget extends StatefulWidget { + const TransferOrderAllocationWidget(this.item, {Key? key}) : super(key: key); + + final InvenTreeTransferOrderLineItem item; + + @override + _TransferOrderAllocationWidgetState createState() => + _TransferOrderAllocationWidgetState(); +} + +class _TransferOrderAllocationWidgetState + extends RefreshableState { + _TransferOrderAllocationWidgetState(); + + @override + String getAppBarTitle() => L10().allocatedStock; + + @override + Widget getBody(BuildContext context) { + Map filters = {"line": widget.item.pk.toString()}; + + return Column( + children: [ + ListTile( + leading: InvenTreeAPI().getThumbnail(widget.item.partImage), + title: Text(widget.item.partName), + subtitle: Text(L10().allocatedStock), + ), + Divider(thickness: 1.25), + Expanded(child: PaginatedTransferOrderAllocationList(filters)), + ], + ); + } +} + +/* + * Paginated widget class for displaying a list of transfer order line item allocations + */ +class PaginatedTransferOrderAllocationList extends PaginatedSearchWidget { + const PaginatedTransferOrderAllocationList(Map filters) + : super(filters: filters); + + @override + String get searchTitle => L10().allocatedStock; + + @override + _PaginatedTransferOrderAllocationListState createState() => + _PaginatedTransferOrderAllocationListState(); +} + +class _PaginatedTransferOrderAllocationListState + extends PaginatedSearchState { + _PaginatedTransferOrderAllocationListState() : super(); + + @override + String get prefix => "to_allocation_"; + + @override + Map get orderingOptions => {}; + + @override + Map> get filterOptions => {}; + + @override + Future requestPage( + int limit, + int offset, + Map params, + ) async { + final page = await InvenTreeTransferOrderAllocation().listPaginated( + limit, + offset, + filters: params, + ); + + return page; + } + + @override + Widget buildItem(BuildContext context, InvenTreeModel model) { + InvenTreeTransferOrderAllocation allocation = + model as InvenTreeTransferOrderAllocation; + + var stockItem = allocation.stockItem; + var location = allocation.location; + + return ListTile( + title: Text(stockItem?.serialOrQuantityDisplay() ?? ""), + subtitle: Text(location?.pathstring ?? L10().locationNotSet), + leading: InvenTreeAPI().getThumbnail(allocation.part?.thumbnail ?? ""), + trailing: LargeText(simpleNumberString(allocation.quantity)), + onTap: () async { + stockItem?.goToDetailPage(context); + }, + ); + } +} diff --git a/lib/widget/order/transfer_order_detail.dart b/lib/widget/order/transfer_order_detail.dart new file mode 100644 index 00000000..2c6ab60d --- /dev/null +++ b/lib/widget/order/transfer_order_detail.dart @@ -0,0 +1,437 @@ +import "package:flutter/material.dart"; +import "package:flutter_speed_dial/flutter_speed_dial.dart"; +import "package:flutter_tabler_icons/flutter_tabler_icons.dart"; + +import "package:inventree/api_form.dart"; +import "package:inventree/app_colors.dart"; +import "package:inventree/l10.dart"; + +import "package:inventree/inventree/model.dart"; +import "package:inventree/inventree/stock.dart"; +import "package:inventree/inventree/transfer_order.dart"; + +import "package:inventree/widget/dialogs.dart"; +import "package:inventree/widget/link_icon.dart"; +import "package:inventree/widget/notes_widget.dart"; +import "package:inventree/widget/order/transfer_order_line_list.dart"; +import "package:inventree/widget/progress.dart"; +import "package:inventree/widget/refreshable_state.dart"; +import "package:inventree/widget/snacks.dart"; + +/* + * Widget for viewing a single TransferOrder instance + */ +class TransferOrderDetailWidget extends StatefulWidget { + const TransferOrderDetailWidget(this.order, {Key? key}) : super(key: key); + + final InvenTreeTransferOrder order; + + @override + _TransferOrderDetailState createState() => _TransferOrderDetailState(); +} + +class _TransferOrderDetailState + extends RefreshableState { + _TransferOrderDetailState(); + + InvenTreeStockLocation? sourceLocation; + InvenTreeStockLocation? destinationLocation; + + int completedLines = 0; + + @override + String getAppBarTitle() { + String title = L10().transferOrder; + + if (widget.order.reference.isNotEmpty) { + title += " - ${widget.order.reference}"; + } + + return title; + } + + @override + List appBarActions(BuildContext context) { + List actions = []; + + if (widget.order.canEdit) { + actions.add( + IconButton( + icon: Icon(TablerIcons.edit), + tooltip: L10().transferOrderEdit, + onPressed: () { + editOrder(context); + }, + ), + ); + } + + return actions; + } + + @override + List actionButtons(BuildContext context) { + List actions = []; + + if (!widget.order.canEdit) { + return actions; + } + + if (widget.order.canIssue) { + actions.add( + SpeedDialChild( + child: Icon(TablerIcons.send, color: COLOR_ACTION), + label: L10().issueOrder, + onTap: () async { + _issueOrder(context); + }, + ), + ); + } + + if (widget.order.canCompleteOrder) { + actions.add( + SpeedDialChild( + child: Icon(TablerIcons.circle_check, color: COLOR_SUCCESS), + label: L10().completeOrder, + onTap: () async { + _completeOrder(context); + }, + ), + ); + } + + if (widget.order.canHold) { + actions.add( + SpeedDialChild( + child: Icon(TablerIcons.player_pause, color: COLOR_WARNING), + label: L10().holdOrder, + onTap: () async { + _holdOrder(context); + }, + ), + ); + } + + if (widget.order.canCancel) { + actions.add( + SpeedDialChild( + child: Icon(TablerIcons.circle_x, color: COLOR_DANGER), + label: L10().cancelOrder, + onTap: () async { + _cancelOrder(context); + }, + ), + ); + } + + return actions; + } + + /// Issue this order + Future _issueOrder(BuildContext context) async { + confirmationDialog( + L10().issueOrder, + L10().issueOrderConfirm, + icon: TablerIcons.send, + color: COLOR_ACTION, + acceptText: L10().issue, + onAccept: () async { + widget.order.issue().then((dynamic) { + refresh(context); + }); + }, + ); + } + + /// Complete this order + Future _completeOrder(BuildContext context) async { + Map> fields = {"accept_incomplete": {}}; + + String url = "${widget.order.URL}${widget.order.pk}/complete/"; + + launchApiForm( + context, + L10().completeOrder, + url, + fields, + method: "POST", + onSuccess: (data) async { + refresh(context); + }, + ); + } + + /// Place this order on hold + Future _holdOrder(BuildContext context) async { + confirmationDialog( + L10().holdOrder, + L10().holdOrderConfirm, + icon: TablerIcons.player_pause, + color: COLOR_WARNING, + acceptText: L10().hold, + onAccept: () async { + widget.order.hold().then((dynamic) { + refresh(context); + }); + }, + ); + } + + /// Cancel this order + Future _cancelOrder(BuildContext context) async { + confirmationDialog( + L10().cancelOrder, + L10().cancelOrderConfirm, + icon: TablerIcons.circle_x, + color: COLOR_DANGER, + acceptText: L10().cancel, + onAccept: () async { + widget.order.cancel().then((dynamic) { + refresh(context); + }); + }, + ); + } + + @override + List barcodeButtons(BuildContext context) { + // Transfer orders don't have barcode functionality yet + return []; + } + + @override + Future request(BuildContext context) async { + await widget.order.reload(); + + List lines = await widget.order + .getLineItems(); + + completedLines = 0; + + for (var line in lines) { + if (line.isComplete) { + completedLines += 1; + } + } + + if (widget.order.sourceLocationId != null) { + InvenTreeStockLocation().get(widget.order.sourceLocationId!).then(( + InvenTreeModel? loc, + ) { + if (mounted) { + setState(() { + sourceLocation = loc is InvenTreeStockLocation ? loc : null; + }); + } + }); + } else if (mounted) { + setState(() { + sourceLocation = null; + }); + } + + if (widget.order.destinationId != null) { + InvenTreeStockLocation().get(widget.order.destinationId!).then(( + InvenTreeModel? loc, + ) { + if (mounted) { + setState(() { + destinationLocation = loc is InvenTreeStockLocation ? loc : null; + }); + } + }); + } else if (mounted) { + setState(() { + destinationLocation = null; + }); + } + } + + /// Edit the currently displayed TransferOrder + Future editOrder(BuildContext context) async { + var fields = widget.order.formFields(); + + widget.order.editForm( + context, + L10().transferOrderEdit, + fields: fields, + onSuccess: (data) async { + refresh(context); + showSnackIcon(L10().transferOrderUpdated, success: true); + }, + ); + } + + Widget headerTile(BuildContext context) { + return Card( + child: ListTile( + title: Text(widget.order.reference), + subtitle: Text(widget.order.description), + trailing: LargeText( + TransferOrderStatus.getStatusText(widget.order.status), + color: TransferOrderStatus.getStatusColor(widget.order.status), + ), + ), + ); + } + + List orderTiles(BuildContext context) { + List tiles = []; + + tiles.add(headerTile(context)); + + if (showPk) { + tiles.add(pkTile(widget.order.pk)); + } + + if (widget.order.hasProjectCode) { + tiles.add( + ListTile( + title: Text(L10().projectCode), + subtitle: Text( + "${widget.order.projectCode} - ${widget.order.projectCodeDescription}", + ), + leading: Icon(TablerIcons.list), + ), + ); + } + + if (sourceLocation != null) { + tiles.add( + ListTile( + title: Text(L10().sourceLocation), + subtitle: Text(sourceLocation!.pathstring), + leading: Icon(TablerIcons.map_pin, color: COLOR_ACTION), + trailing: LinkIcon(), + onTap: () => sourceLocation!.goToDetailPage(context), + ), + ); + } + + if (destinationLocation != null) { + tiles.add( + ListTile( + title: Text(L10().destination), + subtitle: Text(destinationLocation!.pathstring), + leading: Icon(TablerIcons.map_pin, color: COLOR_ACTION), + trailing: LinkIcon(), + onTap: () => destinationLocation!.goToDetailPage(context), + ), + ); + } + + if (widget.order.consume) { + tiles.add( + ListTile( + title: Text(L10().consume), + subtitle: Text(L10().consumeDetail), + leading: Icon(TablerIcons.flame, color: COLOR_WARNING), + ), + ); + } + + Color lineColor = completedLines < widget.order.lineItemCount + ? COLOR_WARNING + : COLOR_SUCCESS; + + tiles.add( + ListTile( + title: Text(L10().lineItems), + subtitle: ProgressBar( + completedLines.toDouble(), + maximum: widget.order.lineItemCount.toDouble(), + ), + leading: Icon(TablerIcons.clipboard_check), + trailing: LargeText( + "${completedLines} / ${widget.order.lineItemCount}", + color: lineColor, + ), + ), + ); + + if (widget.order.creationDate.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().creationDate), + trailing: LargeText(widget.order.creationDate), + leading: Icon(TablerIcons.calendar), + ), + ); + } + + if (widget.order.startDate.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().startDate), + trailing: LargeText(widget.order.startDate), + leading: Icon(TablerIcons.calendar), + ), + ); + } + + if (widget.order.targetDate.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().targetDate), + trailing: LargeText(widget.order.targetDate), + leading: Icon(TablerIcons.calendar), + ), + ); + } + + if (widget.order.completionDate.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().completionDate), + trailing: LargeText(widget.order.completionDate), + leading: Icon(TablerIcons.calendar), + ), + ); + } + + if (widget.order.responsibleName.isNotEmpty && + widget.order.responsibleLabel.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().responsible), + leading: Icon( + widget.order.responsibleLabel == "group" + ? TablerIcons.users + : TablerIcons.user, + ), + trailing: LargeText(widget.order.responsibleName), + ), + ); + } + + tiles.add( + ListTile( + title: Text(L10().notes), + leading: Icon(TablerIcons.note, color: COLOR_ACTION), + trailing: LinkIcon(), + onTap: () { + Navigator.push( + context, + MaterialPageRoute(builder: (context) => NotesWidget(widget.order)), + ); + }, + ), + ); + + return tiles; + } + + @override + List getTabIcons(BuildContext context) { + return [Tab(text: L10().details), Tab(text: L10().parts)]; + } + + @override + List getTabs(BuildContext context) { + return [ + ListView(children: orderTiles(context)), + PaginatedTransferOrderLineList({"order": widget.order.pk.toString()}), + ]; + } +} diff --git a/lib/widget/order/transfer_order_line_detail.dart b/lib/widget/order/transfer_order_line_detail.dart new file mode 100644 index 00000000..d578306d --- /dev/null +++ b/lib/widget/order/transfer_order_line_detail.dart @@ -0,0 +1,180 @@ +import "package:flutter/material.dart"; +import "package:flutter_tabler_icons/flutter_tabler_icons.dart"; + +import "package:inventree/api.dart"; +import "package:inventree/app_colors.dart"; +import "package:inventree/helpers.dart"; +import "package:inventree/l10.dart"; + +import "package:inventree/inventree/part.dart"; +import "package:inventree/inventree/transfer_order.dart"; + +import "package:inventree/widget/link_icon.dart"; +import "package:inventree/widget/order/transfer_order_allocation_list.dart"; +import "package:inventree/widget/progress.dart"; +import "package:inventree/widget/refreshable_state.dart"; +import "package:inventree/widget/snacks.dart"; + +/* + * Widget for displaying detail view of a single TransferOrderLineItem + */ +class TransferOrderLineDetailWidget extends StatefulWidget { + const TransferOrderLineDetailWidget(this.item, {Key? key}) : super(key: key); + + final InvenTreeTransferOrderLineItem item; + + @override + _TransferOrderLineDetailState createState() => + _TransferOrderLineDetailState(); +} + +class _TransferOrderLineDetailState + extends RefreshableState { + _TransferOrderLineDetailState(); + + @override + String getAppBarTitle() => L10().lineItem; + + @override + List appBarActions(BuildContext context) { + List actions = []; + + if (widget.item.canEdit) { + actions.add( + IconButton( + icon: Icon(TablerIcons.edit), + onPressed: () { + _editLineItem(context); + }, + ), + ); + } + + return actions; + } + + @override + Future request(BuildContext context) async { + await widget.item.reload(); + } + + // Callback to edit this line item + Future _editLineItem(BuildContext context) async { + var fields = widget.item.formFields(); + + widget.item.editForm( + context, + L10().editLineItem, + fields: fields, + onSuccess: (data) async { + refresh(context); + showSnackIcon(L10().lineItemUpdated, success: true); + }, + ); + } + + @override + List getTiles(BuildContext context) { + List tiles = []; + + if (showPk) { + tiles.add(pkTile(widget.item.pk)); + } + + // Reference to the part + tiles.add( + ListTile( + title: Text(L10().part), + subtitle: Text(widget.item.partName), + leading: InvenTreeAPI().getThumbnail(widget.item.partImage), + trailing: LinkIcon(), + onTap: () async { + showLoadingOverlay(); + var part = await InvenTreePart().get(widget.item.partId); + hideLoadingOverlay(); + + if (part is InvenTreePart) { + part.goToDetailPage(context); + } + }, + ), + ); + + // Transferred quantity + tiles.add( + ListTile( + title: Text(L10().transfer), + subtitle: ProgressBar(widget.item.progressRatio), + trailing: LargeText( + widget.item.progressString, + color: widget.item.isComplete ? COLOR_SUCCESS : COLOR_WARNING, + ), + leading: Icon(TablerIcons.progress), + ), + ); + + // Allocated stock items + tiles.add( + ListTile( + title: Text(L10().allocatedStock), + leading: Icon(TablerIcons.clipboard_check, color: COLOR_ACTION), + trailing: LinkIcon(text: simpleNumberString(widget.item.allocated)), + onTap: () => Navigator.push( + context, + MaterialPageRoute( + builder: (context) => TransferOrderAllocationWidget(widget.item), + ), + ), + ), + ); + + // Reference + if (widget.item.reference.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().reference), + subtitle: Text(widget.item.reference), + leading: Icon(TablerIcons.hash), + ), + ); + } + + // Target date + if (widget.item.targetDate.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().targetDate), + subtitle: Text(widget.item.targetDate), + leading: Icon(TablerIcons.calendar), + ), + ); + } + + // Notes + if (widget.item.notes.isNotEmpty) { + tiles.add( + ListTile( + title: Text(L10().notes), + subtitle: Text(widget.item.notes), + leading: Icon(TablerIcons.note), + ), + ); + } + + // External link + if (widget.item.hasLink) { + tiles.add( + ListTile( + title: Text(L10().link), + subtitle: Text(widget.item.link), + leading: Icon(TablerIcons.link, color: COLOR_ACTION), + onTap: () async { + await openLink(widget.item.link); + }, + ), + ); + } + + return tiles; + } +} diff --git a/lib/widget/order/transfer_order_line_list.dart b/lib/widget/order/transfer_order_line_list.dart new file mode 100644 index 00000000..046d961f --- /dev/null +++ b/lib/widget/order/transfer_order_line_list.dart @@ -0,0 +1,105 @@ +import "package:flutter/material.dart"; + +import "package:inventree/api.dart"; +import "package:inventree/app_colors.dart"; +import "package:inventree/l10.dart"; + +import "package:inventree/inventree/model.dart"; +import "package:inventree/inventree/transfer_order.dart"; + +import "package:inventree/widget/link_icon.dart"; +import "package:inventree/widget/order/transfer_order_line_detail.dart"; +import "package:inventree/widget/paginator.dart"; +import "package:inventree/widget/progress.dart"; + +/* + * Paginated widget class for displaying a list of parts assigned to a Transfer Order + */ +class PaginatedTransferOrderLineList extends PaginatedSearchWidget { + const PaginatedTransferOrderLineList(Map filters) + : super(filters: filters); + + @override + String get searchTitle => L10().lineItems; + + @override + _PaginatedTransferOrderLineListState createState() => + _PaginatedTransferOrderLineListState(); +} + +class _PaginatedTransferOrderLineListState + extends PaginatedSearchState { + _PaginatedTransferOrderLineListState() : super(); + + @override + String get prefix => "to_line_"; + + @override + Map get orderingOptions => { + "part": L10().part, + "quantity": L10().quantity, + "target_date": L10().targetDate, + }; + + @override + Map> get filterOptions => { + "completed": { + "label": L10().received, + "help_text": L10().receivedFilterDetail, + "tristate": true, + }, + "allocated": { + "label": L10().allocated, + "help_text": L10().allocatedFilterDetail, + "tristate": true, + }, + }; + + @override + Future requestPage( + int limit, + int offset, + Map params, + ) async { + final page = await InvenTreeTransferOrderLineItem().listPaginated( + limit, + offset, + filters: params, + ); + + return page; + } + + @override + Widget buildItem(BuildContext context, InvenTreeModel model) { + InvenTreeTransferOrderLineItem item = + model as InvenTreeTransferOrderLineItem; + + return ListTile( + title: Text(item.partName), + subtitle: Column( + crossAxisAlignment: CrossAxisAlignment.start, + children: [ + if (item.partDescription.isNotEmpty) Text(item.partDescription), + ProgressBar(item.transferred, maximum: item.quantity), + ], + ), + leading: InvenTreeAPI().getThumbnail(item.partImage), + trailing: LargeText( + item.progressString, + color: item.isComplete ? COLOR_SUCCESS : COLOR_WARNING, + ), + onTap: () async { + showLoadingOverlay(); + await item.reload(); + hideLoadingOverlay(); + Navigator.push( + context, + MaterialPageRoute( + builder: (context) => TransferOrderLineDetailWidget(item), + ), + ); + }, + ); + } +} diff --git a/lib/widget/order/transfer_order_list.dart b/lib/widget/order/transfer_order_list.dart new file mode 100644 index 00000000..fa78c9db --- /dev/null +++ b/lib/widget/order/transfer_order_list.dart @@ -0,0 +1,162 @@ +import "package:flutter/material.dart"; +import "package:flutter_speed_dial/flutter_speed_dial.dart"; +import "package:flutter_tabler_icons/flutter_tabler_icons.dart"; + +import "package:inventree/l10.dart"; + +import "package:inventree/inventree/model.dart"; +import "package:inventree/inventree/transfer_order.dart"; + +import "package:inventree/widget/link_icon.dart"; +import "package:inventree/widget/paginator.dart"; +import "package:inventree/widget/refreshable_state.dart"; + +/* + * Widget class for displaying a list of Transfer Orders + */ +class TransferOrderListWidget extends StatefulWidget { + const TransferOrderListWidget({this.filters = const {}, Key? key}) + : super(key: key); + + final Map filters; + + @override + _TransferOrderListWidgetState createState() => + _TransferOrderListWidgetState(); +} + +class _TransferOrderListWidgetState + extends RefreshableState { + _TransferOrderListWidgetState(); + + @override + String getAppBarTitle() => L10().transferOrders; + + @override + List actionButtons(BuildContext context) { + List actions = []; + + if (InvenTreeTransferOrder().canCreate) { + actions.add( + SpeedDialChild( + child: Icon(TablerIcons.circle_plus), + label: L10().transferOrderCreate, + onTap: () { + _createTransferOrder(context); + }, + ), + ); + } + + return actions; + } + + // Launch form to create a new TransferOrder + Future _createTransferOrder(BuildContext context) async { + var fields = InvenTreeTransferOrder().formFields(); + + InvenTreeTransferOrder().createForm( + context, + L10().transferOrderCreate, + fields: fields, + onSuccess: (result) async { + Map data = result as Map; + + if (data.containsKey("pk")) { + var order = InvenTreeTransferOrder.fromJson(data); + order.goToDetailPage(context); + } + }, + ); + } + + @override + List barcodeButtons(BuildContext context) { + // Transfer orders don't have barcode functionality yet + return []; + } + + @override + Widget getBody(BuildContext context) { + return PaginatedTransferOrderList(widget.filters); + } +} + +class PaginatedTransferOrderList extends PaginatedSearchWidget { + const PaginatedTransferOrderList(Map filters) + : super(filters: filters); + + @override + String get searchTitle => L10().transferOrders; + + @override + _PaginatedTransferOrderListState createState() => + _PaginatedTransferOrderListState(); +} + +class _PaginatedTransferOrderListState + extends PaginatedSearchState { + _PaginatedTransferOrderListState() : super(); + + @override + String get prefix => "to_"; + + @override + Map get orderingOptions => { + "reference": L10().reference, + "status": L10().status, + "target_date": L10().targetDate, + }; + + @override + Map> get filterOptions => { + "outstanding": { + "label": L10().outstanding, + "help_text": L10().outstandingOrderDetail, + "tristate": true, + "default": true, + }, + "overdue": { + "label": L10().overdue, + "help_text": L10().overdueDetail, + "tristate": true, + }, + "assigned_to_me": { + "label": L10().assignedToMe, + "help_text": L10().assignedToMeDetail, + "tristate": true, + }, + }; + + @override + Future requestPage( + int limit, + int offset, + Map params, + ) async { + final page = await InvenTreeTransferOrder().listPaginated( + limit, + offset, + filters: params, + ); + + return page; + } + + @override + Widget buildItem(BuildContext context, InvenTreeModel model) { + InvenTreeTransferOrder order = model as InvenTreeTransferOrder; + + return ListTile( + title: Text(order.reference), + subtitle: Text(order.description), + trailing: LargeText( + TransferOrderStatus.getStatusText(order.status), + color: TransferOrderStatus.getStatusColor(order.status), + ), + onTap: () async { + order.goToDetailPage(context); + }, + ); + } +}