Transfer order (#854)

* Add API version check

* Implement basic transfer order support

* add link to drawer

* Adjust dashboard display order

* Support transfer order allocation detail

* Add progress bar

* Enable scan of transfer order
This commit is contained in:
Oliver
2026-07-14 15:37:43 +10:00
committed by GitHub
parent 8568187b38
commit 0fe2bdd507
13 changed files with 1565 additions and 0 deletions
@@ -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<TransferOrderAllocationWidget> {
_TransferOrderAllocationWidgetState();
@override
String getAppBarTitle() => L10().allocatedStock;
@override
Widget getBody(BuildContext context) {
Map<String, String> 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<String, String> filters)
: super(filters: filters);
@override
String get searchTitle => L10().allocatedStock;
@override
_PaginatedTransferOrderAllocationListState createState() =>
_PaginatedTransferOrderAllocationListState();
}
class _PaginatedTransferOrderAllocationListState
extends PaginatedSearchState<PaginatedTransferOrderAllocationList> {
_PaginatedTransferOrderAllocationListState() : super();
@override
String get prefix => "to_allocation_";
@override
Map<String, String> get orderingOptions => {};
@override
Map<String, Map<String, dynamic>> get filterOptions => {};
@override
Future<InvenTreePageResponse?> requestPage(
int limit,
int offset,
Map<String, String> 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);
},
);
}
}
+437
View File
@@ -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<TransferOrderDetailWidget> {
_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<Widget> appBarActions(BuildContext context) {
List<Widget> actions = [];
if (widget.order.canEdit) {
actions.add(
IconButton(
icon: Icon(TablerIcons.edit),
tooltip: L10().transferOrderEdit,
onPressed: () {
editOrder(context);
},
),
);
}
return actions;
}
@override
List<SpeedDialChild> actionButtons(BuildContext context) {
List<SpeedDialChild> 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<void> _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<void> _completeOrder(BuildContext context) async {
Map<String, Map<String, dynamic>> 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<void> _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<void> _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<SpeedDialChild> barcodeButtons(BuildContext context) {
// Transfer orders don't have barcode functionality yet
return [];
}
@override
Future<void> request(BuildContext context) async {
await widget.order.reload();
List<InvenTreeTransferOrderLineItem> 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<void> 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<Widget> orderTiles(BuildContext context) {
List<Widget> 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<Widget> getTabIcons(BuildContext context) {
return [Tab(text: L10().details), Tab(text: L10().parts)];
}
@override
List<Widget> getTabs(BuildContext context) {
return [
ListView(children: orderTiles(context)),
PaginatedTransferOrderLineList({"order": widget.order.pk.toString()}),
];
}
}
@@ -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<TransferOrderLineDetailWidget> {
_TransferOrderLineDetailState();
@override
String getAppBarTitle() => L10().lineItem;
@override
List<Widget> appBarActions(BuildContext context) {
List<Widget> actions = [];
if (widget.item.canEdit) {
actions.add(
IconButton(
icon: Icon(TablerIcons.edit),
onPressed: () {
_editLineItem(context);
},
),
);
}
return actions;
}
@override
Future<void> request(BuildContext context) async {
await widget.item.reload();
}
// Callback to edit this line item
Future<void> _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<Widget> getTiles(BuildContext context) {
List<Widget> 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;
}
}
@@ -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<String, String> filters)
: super(filters: filters);
@override
String get searchTitle => L10().lineItems;
@override
_PaginatedTransferOrderLineListState createState() =>
_PaginatedTransferOrderLineListState();
}
class _PaginatedTransferOrderLineListState
extends PaginatedSearchState<PaginatedTransferOrderLineList> {
_PaginatedTransferOrderLineListState() : super();
@override
String get prefix => "to_line_";
@override
Map<String, String> get orderingOptions => {
"part": L10().part,
"quantity": L10().quantity,
"target_date": L10().targetDate,
};
@override
Map<String, Map<String, dynamic>> get filterOptions => {
"completed": {
"label": L10().received,
"help_text": L10().receivedFilterDetail,
"tristate": true,
},
"allocated": {
"label": L10().allocated,
"help_text": L10().allocatedFilterDetail,
"tristate": true,
},
};
@override
Future<InvenTreePageResponse?> requestPage(
int limit,
int offset,
Map<String, String> 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),
),
);
},
);
}
}
+162
View File
@@ -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<String, String> filters;
@override
_TransferOrderListWidgetState createState() =>
_TransferOrderListWidgetState();
}
class _TransferOrderListWidgetState
extends RefreshableState<TransferOrderListWidget> {
_TransferOrderListWidgetState();
@override
String getAppBarTitle() => L10().transferOrders;
@override
List<SpeedDialChild> actionButtons(BuildContext context) {
List<SpeedDialChild> 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<void> _createTransferOrder(BuildContext context) async {
var fields = InvenTreeTransferOrder().formFields();
InvenTreeTransferOrder().createForm(
context,
L10().transferOrderCreate,
fields: fields,
onSuccess: (result) async {
Map<String, dynamic> data = result as Map<String, dynamic>;
if (data.containsKey("pk")) {
var order = InvenTreeTransferOrder.fromJson(data);
order.goToDetailPage(context);
}
},
);
}
@override
List<SpeedDialChild> 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<String, String> filters)
: super(filters: filters);
@override
String get searchTitle => L10().transferOrders;
@override
_PaginatedTransferOrderListState createState() =>
_PaginatedTransferOrderListState();
}
class _PaginatedTransferOrderListState
extends PaginatedSearchState<PaginatedTransferOrderList> {
_PaginatedTransferOrderListState() : super();
@override
String get prefix => "to_";
@override
Map<String, String> get orderingOptions => {
"reference": L10().reference,
"status": L10().status,
"target_date": L10().targetDate,
};
@override
Map<String, Map<String, dynamic>> 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<InvenTreePageResponse?> requestPage(
int limit,
int offset,
Map<String, String> 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);
},
);
}
}