================
Shopfloor mobile
================
.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
:target: https://odoo-community.org/page/development-status
:alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwms-lightgray.png?logo=github
:target: https://github.com/OCA/wms/tree/13.0/shopfloor_mobile_base
:alt: OCA/wms
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/wms-13-0/wms-13-0-shopfloor_mobile_base
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
:target: https://runbot.odoo-community.org/runbot/285/13.0
:alt: Try me on Runbot
|badge1| |badge2| |badge3| |badge4| |badge5|
Base frontend for Shopfloor applications.
The work is organized in scenario.
A scenario represents a process in the workplace (eg: for WMS -> receive, deliver).
The app allows to start each process through the main menu.
Each scenario is linked to a specific menu item which can be configured in the backend.
Each scenario drives you through the work to do.
Tech details
~~~~~~~~~~~~
* This frontend is built on top of `VueJS <vuejs.org>`_ and `VuetifyJS <vuetifyjs.com/>`_
and relies on `shopfloor` module that exposes REST API in Odoo
(based in turn on `base_rest <https://github.com/OCA/rest-framework/tree/13.0/base_rest>`_).
* The whole business logic comes from `shopfloor_base` module,
this module takes care of providing a nice and reactive UI to work with.
* No Odoo JS is used, no assets machinery used.
Static assets are loaded straight, served by a specific controller.
This app is a Single Page App, hence resources are loaded only once.
The version of the module appended to the URL of each resources
makes sure it's not cached when the version changes.
* When developing you can use a demo mode which allows to define interactive scenario
with pure JS demo data, without interacting with Odoo.
Nothing to deal with Odoo demo data.
.. IMPORTANT::
This is an alpha version, the data model and design can change at any time without warning.
Only for development or testing purpose, do not use in production.
`More details on development status <https://odoo-community.org/page/development-status>`_
**Table of contents**
.. contents::
:local:
Usage
=====
Pre-requisites
~~~~~~~~~~~~~~
* Your Odoo instance is accessible via mobile device
* You have an API Key configured
Start the app
~~~~~~~~~~~~~
* Go to "Inventory -> Configuration -> Shopfloor -> Shopfloor App"
* In the login screen fill in your API key
* Hit "Login"
Select a profile
~~~~~~~~~~~~~~~~
Several profiles can be configured in the backend,
you must choose one before starting.
* Tap on "Configure profile"
* Select a profile
This will load all available menu items for the selected profile.
Change language
~~~~~~~~~~~~~~~
* Go to "Settings -> Language"
* Select a language
Customization
~~~~~~~~~~~~~
Please refer to `shopfloor_mobile_custom_example`.
Working environment
~~~~~~~~~~~~~~~~~~~
You can control which running env is considerd by Odoo config or env vars.
For Odoo config: `running_env` or `shopfloor_running_env`.
For env var: `RUNNING_ENV` or `SHOPFLOOR_RUNNING_ENV`.
Expected key `RUNNING_ENV` is compliant w/ `server_environment` naming but is not depending on it.
Additionally, as specific key for Shopfloor is supported.
**You don't need `server_environment` module to use this feature.**
Known issues / Roadmap
======================
* Split module by scenario
* Improve documentation and demo data
* Document each component
* Document demo mode
* Find / create a nice icon
* Finish base translations (move all UI strings to translatable terms)
* Use SCSS
* Refactor states definition
States are now part of the scenario data. They should be specific objects with their own class.
They should also provide all the actions that should be displayed w/ their handlers when needed.
Actions can be popup actions or buttons at the bottom of the screen.
The tricky part here could be how to register this states for the given component.
Today states have access to the full object of the scenario component as they are part of it.
`_get_state_spec` could probably lookup for registered states
(eg: when you register a component in the registry you should provide states as well).
When we'll have states in this fashion we should also consider if they should provide their own template.
This way the component template will hold only the generic bits of the scenario.
* Back buttons should be smarter
In some cases getting back using history is fine but very often this could lead to outdated data display.
To mitigate this in particular scenario's steps, custom handlers for the back action have been implemented.
For instance, in cluster_picking when you hit back on manual selection it forces the state to go to start and reload.
For starting we should provide `on_back` property to all states where we want to display it
(no more specific check on the state to display this button).
This part is also related to "Refactor states definition".
* Load modules/components dependencies
As of today we are using bare ES6 imports which requires devs to know the exact path
of the resource. If the resource changes name or path dependent files will be broken.
It would be nice to have a way to declare modules by name as Odoo JS does.
* Get rid of custom assets controller?
A controller takes care of loading static assets but seems to not be needed anymore.
Changelog
=========
13.0.1.0.0
~~~~~~~~~~
First official version.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/wms/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
`feedback <https://github.com/OCA/wms/issues/new?body=module:%20shopfloor_mobile_base%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
~~~~~~~
* Camptocamp
* BCIM
* Akretion
Contributors
~~~~~~~~~~~~
* Simone Orsi <simahawk@gmail.com>
* Thierry Ducrest <thierry.ducrest@camptocamp.com>
* Guewen Baconnier <guewen.baconnier@camptocamp.com>
* Raphaël Reverdy <raphael.reverdy@akretion.com>
* Sébastien Beau <sebastien.beau@akretion.com>
* Jacques-Etienne Baudoux <je@bcim.be>
Design
~~~~~~
* Joël Grand-Guillaume <joel.grandguillaume@camptocamp.com>
* Jacques-Etienne Baudoux <je@bcim.be>
Other credits
~~~~~~~~~~~~~
**Financial support**
* Cosanum
* Camptocamp R&D
* Akretion R&D
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.
.. |maintainer-simahawk| image:: https://github.com/simahawk.png?size=40px
:target: https://github.com/simahawk
:alt: simahawk
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-simahawk|
This module is part of the `OCA/wms <https://github.com/OCA/wms/tree/13.0/shopfloor_mobile_base>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/wms",
"name": "odoo13-addon-shopfloor-mobile-base",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": "",
"keywords": "",
"author": "Camptocamp, BCIM, Akretion, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": "",
"platform": null,
"description": "================\nShopfloor mobile\n================\n\n.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png\n :target: https://odoo-community.org/page/development-status\n :alt: Alpha\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwms-lightgray.png?logo=github\n :target: https://github.com/OCA/wms/tree/13.0/shopfloor_mobile_base\n :alt: OCA/wms\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/wms-13-0/wms-13-0-shopfloor_mobile_base\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png\n :target: https://runbot.odoo-community.org/runbot/285/13.0\n :alt: Try me on Runbot\n\n|badge1| |badge2| |badge3| |badge4| |badge5| \n\nBase frontend for Shopfloor applications.\n\nThe work is organized in scenario.\nA scenario represents a process in the workplace (eg: for WMS -> receive, deliver).\nThe app allows to start each process through the main menu.\n\nEach scenario is linked to a specific menu item which can be configured in the backend.\nEach scenario drives you through the work to do.\n\n\nTech details\n~~~~~~~~~~~~\n\n* This frontend is built on top of `VueJS <vuejs.org>`_ and `VuetifyJS <vuetifyjs.com/>`_\n and relies on `shopfloor` module that exposes REST API in Odoo\n (based in turn on `base_rest <https://github.com/OCA/rest-framework/tree/13.0/base_rest>`_).\n\n* The whole business logic comes from `shopfloor_base` module,\n this module takes care of providing a nice and reactive UI to work with.\n\n* No Odoo JS is used, no assets machinery used.\n\n Static assets are loaded straight, served by a specific controller.\n This app is a Single Page App, hence resources are loaded only once.\n\n The version of the module appended to the URL of each resources\n makes sure it's not cached when the version changes.\n\n* When developing you can use a demo mode which allows to define interactive scenario\n with pure JS demo data, without interacting with Odoo.\n Nothing to deal with Odoo demo data.\n\n.. IMPORTANT::\n This is an alpha version, the data model and design can change at any time without warning.\n Only for development or testing purpose, do not use in production.\n `More details on development status <https://odoo-community.org/page/development-status>`_\n\n**Table of contents**\n\n.. contents::\n :local:\n\nUsage\n=====\n\nPre-requisites\n~~~~~~~~~~~~~~\n\n* Your Odoo instance is accessible via mobile device\n* You have an API Key configured\n\nStart the app\n~~~~~~~~~~~~~\n\n* Go to \"Inventory -> Configuration -> Shopfloor -> Shopfloor App\"\n* In the login screen fill in your API key\n* Hit \"Login\"\n\nSelect a profile\n~~~~~~~~~~~~~~~~\n\nSeveral profiles can be configured in the backend,\nyou must choose one before starting.\n\n* Tap on \"Configure profile\"\n* Select a profile\n\nThis will load all available menu items for the selected profile.\n\nChange language\n~~~~~~~~~~~~~~~\n\n* Go to \"Settings -> Language\"\n* Select a language\n\nCustomization\n~~~~~~~~~~~~~\n\nPlease refer to `shopfloor_mobile_custom_example`.\n\n\nWorking environment\n~~~~~~~~~~~~~~~~~~~\n\nYou can control which running env is considerd by Odoo config or env vars.\n\n\nFor Odoo config: `running_env` or `shopfloor_running_env`.\n\nFor env var: `RUNNING_ENV` or `SHOPFLOOR_RUNNING_ENV`.\n\nExpected key `RUNNING_ENV` is compliant w/ `server_environment` naming but is not depending on it.\n\nAdditionally, as specific key for Shopfloor is supported.\n\n**You don't need `server_environment` module to use this feature.**\n\nKnown issues / Roadmap\n======================\n\n* Split module by scenario\n* Improve documentation and demo data\n* Document each component\n* Document demo mode\n* Find / create a nice icon\n* Finish base translations (move all UI strings to translatable terms)\n* Use SCSS\n* Refactor states definition\n\n States are now part of the scenario data. They should be specific objects with their own class.\n They should also provide all the actions that should be displayed w/ their handlers when needed.\n Actions can be popup actions or buttons at the bottom of the screen.\n The tricky part here could be how to register this states for the given component.\n Today states have access to the full object of the scenario component as they are part of it.\n `_get_state_spec` could probably lookup for registered states\n (eg: when you register a component in the registry you should provide states as well).\n When we'll have states in this fashion we should also consider if they should provide their own template.\n This way the component template will hold only the generic bits of the scenario.\n\n* Back buttons should be smarter\n\n In some cases getting back using history is fine but very often this could lead to outdated data display.\n To mitigate this in particular scenario's steps, custom handlers for the back action have been implemented.\n For instance, in cluster_picking when you hit back on manual selection it forces the state to go to start and reload.\n For starting we should provide `on_back` property to all states where we want to display it\n (no more specific check on the state to display this button).\n This part is also related to \"Refactor states definition\".\n\n* Load modules/components dependencies\n\n As of today we are using bare ES6 imports which requires devs to know the exact path\n of the resource. If the resource changes name or path dependent files will be broken.\n It would be nice to have a way to declare modules by name as Odoo JS does.\n\n* Get rid of custom assets controller?\n\n A controller takes care of loading static assets but seems to not be needed anymore.\n\nChangelog\n=========\n\n13.0.1.0.0\n~~~~~~~~~~\n\nFirst official version.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/wms/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us smashing it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/wms/issues/new?body=module:%20shopfloor_mobile_base%0Aversion:%2013.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n~~~~~~~\n\n* Camptocamp\n* BCIM\n* Akretion\n\nContributors\n~~~~~~~~~~~~\n\n* Simone Orsi <simahawk@gmail.com>\n* Thierry Ducrest <thierry.ducrest@camptocamp.com>\n* Guewen Baconnier <guewen.baconnier@camptocamp.com>\n* Rapha\u00ebl Reverdy <raphael.reverdy@akretion.com>\n* S\u00e9bastien Beau <sebastien.beau@akretion.com>\n* Jacques-Etienne Baudoux <je@bcim.be>\n\nDesign\n~~~~~~\n\n* Jo\u00ebl Grand-Guillaume <joel.grandguillaume@camptocamp.com>\n* Jacques-Etienne Baudoux <je@bcim.be>\n\nOther credits\n~~~~~~~~~~~~~\n\n**Financial support**\n\n* Cosanum\n* Camptocamp R&D\n* Akretion R&D\n\nMaintainers\n~~~~~~~~~~~\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\n.. |maintainer-simahawk| image:: https://github.com/simahawk.png?size=40px\n :target: https://github.com/simahawk\n :alt: simahawk\n\nCurrent `maintainer <https://odoo-community.org/page/maintainer-role>`__:\n\n|maintainer-simahawk| \n\nThis module is part of the `OCA/wms <https://github.com/OCA/wms/tree/13.0/shopfloor_mobile_base>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Mobile frontend for WMS Shopfloor app",
"version": "13.0.1.13.0",
"project_urls": {
"Homepage": "https://github.com/OCA/wms"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c5cd3f86af68e48a778d8ceb6a0a4a5d206fad96402282aa5627b9714cbed3b",
"md5": "32ac97fcbd2aa1ff251110abb9fde70f",
"sha256": "0d8863bddfd1e71cbe34fa502cbdba0ad0d638e2574e9090363bfe0a0a6fdc8c"
},
"downloads": -1,
"filename": "odoo13_addon_shopfloor_mobile_base-13.0.1.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "32ac97fcbd2aa1ff251110abb9fde70f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 2979170,
"upload_time": "2022-04-27T08:14:13",
"upload_time_iso_8601": "2022-04-27T08:14:13.112387Z",
"url": "https://files.pythonhosted.org/packages/6c/5c/d3f86af68e48a778d8ceb6a0a4a5d206fad96402282aa5627b9714cbed3b/odoo13_addon_shopfloor_mobile_base-13.0.1.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-04-27 08:14:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "wms",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "odoo13-addon-shopfloor-mobile-base"
}
JSON
