2
0
mirror of https://github.com/inventree/inventree-app.git synced 2025-06-14 19:25:27 +00:00

Sales order support (#438)

* Add new models for SalesOrder

- Create generic Order and OrderLine models with common functionality

* Refactor

- Move some widgets around
- Cleanup directory structure

* Add link to home screen and nav drawer

* Add SalesOrder list widget

* Linting fixes

* Fix string

* Refactor PurchaseOrderDetailWidget

* Tweaks to existing code

* linting

* Fixes for drawer widget

* Add "detail" page for SalesOrder

* Add more tiles to SalesOrder detail

* Allow editing of salesorder

* add list filters for sales orders

* Display list of line items

* Customer updates

- Display customer icon on home screen
- Fetch sales orders for customer detail page

* Cleanup company detail view

* Create new sales order from list

* Stricter typing for formFields method

* Create new PurchaseOrder and SalesOrder from company deatil

* Status code updates

- Add function for name comparison
- Remove hard-coded values

* Update view permission checks for home widget

* Add ability to manually add SalesOrderLineItem

* Add nice progress bar widgets

* Display detail view for sales order line item

* edit SalesOrderLineItem

* Fix unused import

* Hide "shipped items" tab

- Will be added in a future update
This commit is contained in:
Oliver
2023-11-12 23:13:22 +11:00
committed by GitHub
parent c1c0d46957
commit bdd5470e68
45 changed files with 1565 additions and 284 deletions

View File

@ -0,0 +1,400 @@
import "package:flutter/material.dart";
import "package:flutter_speed_dial/flutter_speed_dial.dart";
import "package:font_awesome_flutter/font_awesome_flutter.dart";
import "package:inventree/l10.dart";
import "package:inventree/api.dart";
import "package:inventree/app_colors.dart";
import "package:inventree/helpers.dart";
import "package:inventree/inventree/company.dart";
import "package:inventree/inventree/purchase_order.dart";
import "package:inventree/inventree/sales_order.dart";
import "package:inventree/widget/attachment_widget.dart";
import "package:inventree/widget/order/purchase_order_list.dart";
import "package:inventree/widget/order/sales_order_list.dart";
import "package:inventree/widget/refreshable_state.dart";
import "package:inventree/widget/snacks.dart";
import "package:inventree/widget/company/supplier_part_list.dart";
import "package:inventree/widget/order/sales_order_detail.dart";
import "package:inventree/widget/order/purchase_order_detail.dart";
/*
* Widget for displaying detail view of a single Company instance
*/
class CompanyDetailWidget extends StatefulWidget {
const CompanyDetailWidget(this.company, {Key? key}) : super(key: key);
final InvenTreeCompany company;
@override
_CompanyDetailState createState() => _CompanyDetailState();
}
class _CompanyDetailState extends RefreshableState<CompanyDetailWidget> {
_CompanyDetailState();
int supplierPartCount = 0;
int outstandingPurchaseOrders = 0;
int outstandingSalesOrders = 0;
int attachmentCount = 0;
@override
String getAppBarTitle() => L10().company;
@override
List<Widget> appBarActions(BuildContext context) {
List<Widget> actions = [];
if (InvenTreeCompany().canEdit) {
actions.add(
IconButton(
icon: Icon(Icons.edit_square),
tooltip: L10().companyEdit,
onPressed: () {
editCompany(context);
}
)
);
}
return actions;
}
@override
List<SpeedDialChild> actionButtons(BuildContext context) {
List<SpeedDialChild> actions = [];
if (widget.company.isCustomer && InvenTreeSalesOrder().canCreate) {
actions.add(SpeedDialChild(
child: FaIcon(FontAwesomeIcons.truck),
label: L10().salesOrderCreate,
onTap: () async {
_createSalesOrder(context);
}
));
}
if (widget.company.isSupplier && InvenTreePurchaseOrder().canCreate) {
actions.add(SpeedDialChild(
child: FaIcon(FontAwesomeIcons.cartShopping),
label: L10().purchaseOrderCreate,
onTap: () async {
_createPurchaseOrder(context);
}
));
}
return actions;
}
Future<void> _createSalesOrder(BuildContext context) async {
var fields = InvenTreeSalesOrder().formFields();
// Cannot set contact until company is locked in
fields.remove("contact");
fields["customer"]?["value"] = widget.company.pk;
InvenTreeSalesOrder().createForm(
context,
L10().salesOrderCreate,
fields: fields,
onSuccess: (result) async {
Map<String, dynamic> data = result as Map<String, dynamic>;
if (data.containsKey("pk")) {
var order = InvenTreeSalesOrder.fromJson(data);
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SalesOrderDetailWidget(order)
)
);
}
}
);
}
Future<void> _createPurchaseOrder(BuildContext context) async {
var fields = InvenTreePurchaseOrder().formFields();
// Cannot set contact until company is locked in
fields.remove("contact");
fields["supplier"]?["value"] = widget.company.pk;
InvenTreePurchaseOrder().createForm(
context,
L10().purchaseOrderCreate,
fields: fields,
onSuccess: (result) async {
Map<String, dynamic> data = result as Map<String, dynamic>;
if (data.containsKey("pk")) {
var order = InvenTreePurchaseOrder.fromJson(data);
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => PurchaseOrderDetailWidget(order)
)
);
}
}
);
}
@override
Future<void> request(BuildContext context) async {
final bool result = await widget.company.reload();
if (!result || widget.company.pk <= 0) {
// Company could not be loaded for some reason
Navigator.of(context).pop();
return;
}
outstandingPurchaseOrders = widget.company.isSupplier ?
await InvenTreePurchaseOrder().count(filters: {
"supplier": widget.company.pk.toString(),
"outstanding": "true"
}) : 0;
outstandingSalesOrders = widget.company.isCustomer ?
await InvenTreeSalesOrder().count(filters: {
"customer": widget.company.pk.toString(),
"outstanding": "true"
}) : 0;
InvenTreeSupplierPart().count(
filters: {
"supplier": widget.company.pk.toString()
}
).then((value) {
if (mounted) {
setState(() {
supplierPartCount = value;
});
}
});
if (api.supportCompanyAttachments) {
InvenTreeCompanyAttachment().count(
filters: {
"company": widget.company.pk.toString()
}
).then((value) {
if (mounted) {
setState(() {
attachmentCount = value;
});
}
});
}
}
Future <void> editCompany(BuildContext context) async {
widget.company.editForm(
context,
L10().companyEdit,
onSuccess: (data) async {
refresh(context);
showSnackIcon(L10().companyUpdated, success: true);
}
);
}
/*
* Construct a list of tiles to display for this Company instance
*/
@override
List<Widget> getTiles(BuildContext context) {
List<Widget> tiles = [];
bool sep = false;
tiles.add(Card(
child: ListTile(
title: Text("${widget.company.name}"),
subtitle: Text("${widget.company.description}"),
leading: InvenTreeAPI().getThumbnail(widget.company.image),
),
));
if (widget.company.website.isNotEmpty) {
tiles.add(ListTile(
title: Text("${widget.company.website}"),
leading: FaIcon(FontAwesomeIcons.globe, color: COLOR_ACTION),
onTap: () async {
openLink(widget.company.website);
},
));
sep = true;
}
if (widget.company.email.isNotEmpty) {
tiles.add(ListTile(
title: Text("${widget.company.email}"),
leading: FaIcon(FontAwesomeIcons.at, color: COLOR_ACTION),
onTap: () async {
openLink("mailto:${widget.company.email}");
},
));
sep = true;
}
if (widget.company.phone.isNotEmpty) {
tiles.add(ListTile(
title: Text("${widget.company.phone}"),
leading: FaIcon(FontAwesomeIcons.phone, color: COLOR_ACTION),
onTap: () {
openLink("tel:${widget.company.phone}");
},
));
sep = true;
}
// External link
if (widget.company.link.isNotEmpty) {
tiles.add(ListTile(
title: Text("${widget.company.link}"),
leading: FaIcon(FontAwesomeIcons.link, color: COLOR_ACTION),
onTap: () {
widget.company.openLink();
},
));
sep = true;
}
if (sep) {
tiles.add(Divider());
}
if (widget.company.isSupplier) {
if (supplierPartCount > 0) {
tiles.add(
ListTile(
title: Text(L10().supplierParts),
leading: FaIcon(FontAwesomeIcons.building, color: COLOR_ACTION),
trailing: Text(supplierPartCount.toString()),
onTap: () {
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SupplierPartList({
"supplier": widget.company.pk.toString()
})
)
);
}
)
);
}
tiles.add(
ListTile(
title: Text(L10().purchaseOrders),
leading: FaIcon(FontAwesomeIcons.cartShopping, color: COLOR_ACTION),
trailing: Text("${outstandingPurchaseOrders}"),
onTap: () {
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => PurchaseOrderListWidget(
filters: {
"supplier": "${widget.company.pk}"
}
)
)
);
}
)
);
// TODO: Display "supplied parts" count (click through to list of supplier parts)
/*
tiles.add(
ListTile(
title: Text(L10().suppliedParts),
leading: FaIcon(FontAwesomeIcons.shapes),
trailing: Text("${company.partSuppliedCount}"),
)
);
*/
}
if (widget.company.isManufacturer) {
// TODO - Add list of manufacturer parts
}
if (widget.company.isCustomer) {
tiles.add(
ListTile(
title: Text(L10().salesOrders),
leading: FaIcon(FontAwesomeIcons.truck, color: COLOR_ACTION),
trailing: Text("${outstandingSalesOrders}"),
onTap: () {
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SalesOrderListWidget(
filters: {
"customer": widget.company.pk.toString()
}
)
)
);
}
)
);
}
if (widget.company.notes.isNotEmpty) {
tiles.add(ListTile(
title: Text(L10().notes),
leading: FaIcon(FontAwesomeIcons.noteSticky),
onTap: null,
));
}
if (api.supportCompanyAttachments) {
tiles.add(ListTile(
title: Text(L10().attachments),
leading: FaIcon(FontAwesomeIcons.fileLines, color: COLOR_ACTION),
trailing: attachmentCount > 0 ? Text(attachmentCount.toString()) : null,
onTap: () {
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => AttachmentWidget(
InvenTreeCompanyAttachment(),
widget.company.pk,
InvenTreeCompany().canEdit
)
)
);
}
));
}
return tiles;
}
}

View File

@ -0,0 +1,83 @@
import "package:flutter/material.dart";
import "package:inventree/api.dart";
import "package:inventree/inventree/company.dart";
import "package:inventree/inventree/model.dart";
import "package:inventree/widget/paginator.dart";
import "package:inventree/widget/refreshable_state.dart";
import "package:inventree/widget/company/company_detail.dart";
/*
* Widget for displaying a filterable list of Company instances
*/
class CompanyListWidget extends StatefulWidget {
const CompanyListWidget(this.title, this.filters, {Key? key}) : super(key: key);
final String title;
final Map<String, String> filters;
@override
_CompanyListWidgetState createState() => _CompanyListWidgetState();
}
class _CompanyListWidgetState extends RefreshableState<CompanyListWidget> {
_CompanyListWidgetState();
@override
String getAppBarTitle() => widget.title;
@override
Widget getBody(BuildContext context) {
return PaginatedCompanyList(widget.title, widget.filters);
}
}
class PaginatedCompanyList extends PaginatedSearchWidget {
const PaginatedCompanyList(this.companyTitle, Map<String, String> filters) : super(filters: filters);
final String companyTitle;
@override
String get searchTitle => companyTitle;
@override
_CompanyListState createState() => _CompanyListState();
}
class _CompanyListState extends PaginatedSearchState<PaginatedCompanyList> {
_CompanyListState() : super();
@override
Future<InvenTreePageResponse?> requestPage(int limit, int offset, Map<String, String> params) async {
final page = await InvenTreeCompany().listPaginated(limit, offset, filters: params);
return page;
}
@override
Widget buildItem(BuildContext context, InvenTreeModel model) {
InvenTreeCompany company = model as InvenTreeCompany;
return ListTile(
title: Text(company.name),
subtitle: Text(company.description),
leading: InvenTreeAPI().getThumbnail(company.image),
onTap: () async {
Navigator.push(context, MaterialPageRoute(builder: (context) => CompanyDetailWidget(company)));
},
);
}
}

View File

@ -0,0 +1,234 @@
import "package:flutter/material.dart";
import "package:flutter_speed_dial/flutter_speed_dial.dart";
import "package:font_awesome_flutter/font_awesome_flutter.dart";
import "package:inventree/api.dart";
import "package:inventree/app_colors.dart";
import "package:inventree/barcode/barcode.dart";
import "package:inventree/l10.dart";
import "package:inventree/inventree/part.dart";
import "package:inventree/inventree/company.dart";
import "package:inventree/widget/company/company_detail.dart";
import "package:inventree/widget/part/part_detail.dart";
import "package:inventree/widget/progress.dart";
import "package:inventree/widget/refreshable_state.dart";
import "package:inventree/widget/snacks.dart";
import "package:url_launcher/url_launcher.dart";
/*
* Detail widget for viewing a single SupplierPart instance
*/
class SupplierPartDetailWidget extends StatefulWidget {
const SupplierPartDetailWidget(this.supplierPart, {Key? key}) : super(key: key);
final InvenTreeSupplierPart supplierPart;
@override
_SupplierPartDisplayState createState() => _SupplierPartDisplayState();
}
class _SupplierPartDisplayState extends RefreshableState<SupplierPartDetailWidget> {
_SupplierPartDisplayState();
@override
String getAppBarTitle() => L10().supplierPart;
/*
* Launch a form to edit the current SupplierPart instance
*/
Future<void> editSupplierPart(BuildContext context) async {
widget.supplierPart.editForm(
context,
L10().supplierPartEdit,
onSuccess: (data) async {
refresh(context);
showSnackIcon(L10().supplierPartUpdated, success: true);
}
);
}
@override
List<SpeedDialChild> barcodeButtons(BuildContext context) {
List<SpeedDialChild> actions = [];
if (widget.supplierPart.canEdit) {
actions.add(
customBarcodeAction(
context, this,
widget.supplierPart.customBarcode,
"supplierpart",
widget.supplierPart.pk
)
);
}
return actions;
}
@override
List<Widget> appBarActions(BuildContext context) {
List<Widget> actions = [];
if (widget.supplierPart.canEdit) {
actions.add(
IconButton(
icon: Icon(Icons.edit_square),
tooltip: L10().edit,
onPressed: () {
editSupplierPart(context);
}
)
);
}
return actions;
}
@override
Future<void> request(BuildContext context) async {
final bool result = widget.supplierPart.pk > 0 && await widget.supplierPart.reload();
if (!result) {
Navigator.of(context).pop();
}
}
/*
* Build a set of tiles to display for this SupplierPart
*/
@override
List<Widget> getTiles(BuildContext context) {
List<Widget> tiles = [];
if (loading) {
tiles.add(progressIndicator());
return tiles;
}
// Internal Part
tiles.add(
ListTile(
title: Text(L10().internalPart),
subtitle: Text(widget.supplierPart.partName),
leading: FaIcon(FontAwesomeIcons.shapes, color: COLOR_ACTION),
trailing: InvenTreeAPI().getThumbnail(widget.supplierPart.partImage),
onTap: () async {
showLoadingOverlay(context);
final part = await InvenTreePart().get(widget.supplierPart.partId);
hideLoadingOverlay();
if (part is InvenTreePart) {
Navigator.push(context, MaterialPageRoute(
builder: (context) => PartDetailWidget(part)));
}
},
)
);
// Supplier details
tiles.add(
ListTile(
title: Text(L10().supplier),
subtitle: Text(widget.supplierPart.supplierName),
leading: FaIcon(FontAwesomeIcons.building, color: COLOR_ACTION),
trailing: InvenTreeAPI().getThumbnail(widget.supplierPart.supplierImage),
onTap: () async {
showLoadingOverlay(context);
var supplier = await InvenTreeCompany().get(widget.supplierPart.supplierId);
hideLoadingOverlay();
if (supplier is InvenTreeCompany) {
Navigator.push(context, MaterialPageRoute(
builder: (context) => CompanyDetailWidget(supplier)
));
}
}
)
);
// SKU (part number)
tiles.add(
ListTile(
title: Text(L10().supplierPartNumber),
subtitle: Text(widget.supplierPart.SKU),
leading: FaIcon(FontAwesomeIcons.barcode),
)
);
// Manufacturer information
if (widget.supplierPart.manufacturerPartId > 0) {
tiles.add(
ListTile(
title: Text(L10().manufacturer),
subtitle: Text(widget.supplierPart.manufacturerName),
leading: FaIcon(FontAwesomeIcons.industry, color: COLOR_ACTION),
trailing: InvenTreeAPI().getThumbnail(widget.supplierPart.manufacturerImage),
onTap: () async {
showLoadingOverlay(context);
var supplier = await InvenTreeCompany().get(widget.supplierPart.manufacturerId);
hideLoadingOverlay();
if (supplier is InvenTreeCompany) {
Navigator.push(context, MaterialPageRoute(
builder: (context) => CompanyDetailWidget(supplier)
));
}
}
)
);
tiles.add(
ListTile(
title: Text(L10().manufacturerPartNumber),
subtitle: Text(widget.supplierPart.MPN),
leading: FaIcon(FontAwesomeIcons.barcode),
)
);
}
// Packaging
if (widget.supplierPart.packaging.isNotEmpty || widget.supplierPart.pack_quantity.isNotEmpty) {
tiles.add(
ListTile(
title: Text(L10().packaging),
subtitle: widget.supplierPart.packaging.isNotEmpty ? Text(widget.supplierPart.packaging) : null,
leading: FaIcon(FontAwesomeIcons.boxesPacking),
trailing: widget.supplierPart.pack_quantity.isNotEmpty ? Text(widget.supplierPart.pack_quantity) : null,
)
);
}
if (widget.supplierPart.link.isNotEmpty) {
tiles.add(
ListTile(
title: Text(widget.supplierPart.link),
leading: FaIcon(FontAwesomeIcons.link, color: COLOR_ACTION),
onTap: () async {
var uri = Uri.tryParse(widget.supplierPart.link);
if (uri != null && await canLaunchUrl(uri)) {
await launchUrl(uri);
}
},
)
);
}
if (widget.supplierPart.note.isNotEmpty) {
tiles.add(
ListTile(
title: Text(widget.supplierPart.note),
leading: FaIcon(FontAwesomeIcons.pencil),
)
);
}
return tiles;
}
}

View File

@ -0,0 +1,92 @@
import "package:flutter/material.dart";
import "package:inventree/api.dart";
import "package:inventree/l10.dart";
import "package:inventree/inventree/company.dart";
import "package:inventree/inventree/model.dart";
import "package:inventree/widget/paginator.dart";
import "package:inventree/widget/refreshable_state.dart";
import "package:inventree/widget/company/supplier_part_detail.dart";
/*
* Widget for displaying a list of Supplier Part instances
*/
class SupplierPartList extends StatefulWidget {
const SupplierPartList(this.filters);
final Map<String, String> filters;
@override
_SupplierPartListState createState() => _SupplierPartListState();
}
class _SupplierPartListState extends RefreshableState<SupplierPartList> {
@override
String getAppBarTitle() => L10().supplierParts;
@override
Widget getBody(BuildContext context) {
return PaginatedSupplierPartList(widget.filters);
}
}
class PaginatedSupplierPartList extends PaginatedSearchWidget {
const PaginatedSupplierPartList(Map<String, String> filters) : super(filters: filters);
@override
String get searchTitle => L10().supplierParts;
@override
_PaginatedSupplierPartListState createState() => _PaginatedSupplierPartListState();
}
class _PaginatedSupplierPartListState extends PaginatedSearchState<PaginatedSupplierPartList> {
_PaginatedSupplierPartListState() : super();
@override
String get prefix => "supplierpart_";
@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 InvenTreeSupplierPart().listPaginated(limit, offset, filters: params);
return page;
}
@override
Widget buildItem(BuildContext context, InvenTreeModel model) {
InvenTreeSupplierPart supplierPart = model as InvenTreeSupplierPart;
return ListTile(
title: Text(supplierPart.SKU),
subtitle: Text(supplierPart.partName),
leading: InvenTreeAPI().getThumbnail(supplierPart.supplierImage),
trailing: InvenTreeAPI().getThumbnail(supplierPart.partImage),
onTap: () {
Navigator.push(
context,
MaterialPageRoute(
builder: (context) => SupplierPartDetailWidget(supplierPart)
)
);
},
);
}
}