diff --git a/README.md b/README.md index db411864..b044f3d5 100644 --- a/README.md +++ b/README.md @@ -2,23 +2,42 @@ [![Coverage Status](https://coveralls.io/repos/OCA/vertical-ngo/badge.png?branch=8.0)](https://coveralls.io/r/OCA/vertical-ngo?branch=8.0) -This project aim to develop and publish all modules related to the need of humanitarian NGOs. It would cover the overall needs in terms of logistics, order management, accounting, transportation and distribution. - -Main changes are made in the procurement standard flow of Odoo. Usually, you have sales that drive procurement, that drive purchase. With those modules, you record logistic requisition to capture the needs, you source them from one way or another (purchase, stock, donnation,..) and give back to the requestor the price, time and product information. If he agree with, then you confirm the requisition by creating an offer. The offer will drive all the necessary flow to deliver the good where they are needed. It also improve the purchase requisition flow to fit more with the NGO's problematic. - -In the future, it'll cover other NGO's specific needs such as the distribution, transportation, finance (donations, donors report,.. ), volonteer management,.. +This project aim to develop and publish all modules related to the need of +humanitarian NGOs. It would cover the overall needs in terms of logistics, +order management, accounting, transportation and distribution. + +Main changes are made in the procurement standard flow of Odoo. Usually, you +have sales that drive procurement, that drive purchase. With those modules, you +record logistic requisition to capture the needs, you source them from one way +or another (purchase, stock, donnation,..) and give back to the requestor the +price, time and product information. If he agree with, then you confirm the +requisition by creating an offer. The offer will drive all the necessary flows +to deliver the goods where they are needed. It also improves the purchase +requisition flow to fit more with the NGO's problematic. + +In the future, it'll cover other NGO's specific needs such as the distribution, +transportation, finance (donations, donors report,.. ), volonteer management,.. You'll find here : ---------------------- -- NGO Addons: That contain the module specific to the NGO world (currently management of logistic reuquisition, kind of need registring and sourcing tools) +- NGO Addons: That contain the module specific to the NGO world (currently + management of logistic reuquisition, kind of need registring and sourcing + tools) + +Other related community project where we put some useful module for NGO as well +------------------------------------------------------------------------------- -Other related community project where we put some useful module for NGO as well: --------------------------------------------------------------------------------------------------------------------- + * https://github.com/OCA/stock-logistics-transport : module + `stock_route_transit`, `stock_shipment_management`, `transport_information` - * https://github.com/OCA/stock-logistics-warehouse : module `stock_reserve` and `stock_reserve_sale`, `stock_location_ownership` + * https://github.com/OCA/stock-logistics-warehouse : module `stock_reserve` + and `stock_reserve_sale`, `stock_location_ownership` - * https://github.com/OCA/stock-logistics-workflow : module `stock_split_picking` + * https://github.com/OCA/stock-logistics-workflow : module + `stock_split_picking` - * https://github.com/OCA/sale-workflow : module `sale_validity`, `sale_quotation_sourcing`, `sale_sourced_by_line`, `sale_exception_nostock`, `sale_cancel_reason`, `partner_prepayment` + * https://github.com/OCA/sale-workflow : module `sale_validity`, + `sale_quotation_sourcing`, `sale_sourced_by_line`, `sale_exception_nostock`, + `sale_cancel_reason`, `partner_prepayment` diff --git a/i18n/vertical_ngo.pot b/i18n/vertical_ngo.pot new file mode 100644 index 00000000..2c1c8276 --- /dev/null +++ b/i18n/vertical_ngo.pot @@ -0,0 +1,203 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * vertical_ngo +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 8.0\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2015-05-24 14:10+0000\n" +"PO-Revision-Date: 2015-05-24 14:10+0000\n" +"Last-Translator: <>\n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_requisition:0 +msgid "A Logistics requisition express a need that is requested somewhere. It allows to manage the sourcing of the needs before making a cost estimate to the requestor." +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_framework_agreement_sourcing:0 +msgid "Allow to source a logistics requisition with a framework agreement" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Apply" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Cancel" +msgstr "" + +#. module: vertical_ngo +#: model:ir.actions.act_window,name:vertical_ngo.action_ngo_configuration +msgid "Configure NGO" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Configure NGO Verticalization" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_framework_agreement_requisition:0 +msgid "Create tenders to negociate a framework agreements" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,create_uid:0 +msgid "Created by" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,create_date:0 +msgid "Created on" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Features" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,id:0 +msgid "ID" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,write_uid:0 +msgid "Last Updated by" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,write_date:0 +msgid "Last Updated on" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Logistic Requisitions" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_budget:0 +msgid "Manage budget on logistics requisitions and cost estimates" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_requisition_donation:0 +msgid "Manage donor stock dispatches as logistics requisitions" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_order_donation:0 +msgid "Manage in-kind donations" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_requisition:0 +msgid "Manage logistics requisitions and logistics orders" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_order_multicurrency:0 +msgid "Manage multiple currencies for logistics orders" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_logistic_requisition_multicurrency:0 +msgid "Manage multiple currencies for logistics requisitions" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_ngo_purchase_requisition:0 +msgid "Manage purchase requisitions" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_ngo_purchase:0 +msgid "Manage purchases and framework agreements" +msgstr "" + +#. module: vertical_ngo +#: field:ngo.config.settings,module_ngo_shipment_plan:0 +msgid "Manage shipment plans" +msgstr "" + +#. module: vertical_ngo +#: model:ir.ui.menu,name:vertical_ngo.menu_ngo_configuration +msgid "NGO" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Purchase Management" +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "Shipment" +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_framework_agreement_requisition:0 +msgid "To allow your NGO to manage tenders when negociating framework agreements from possible suppliers." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_budget:0 +msgid "adds the notion of budget and budget holer on logistics requisitions and logistics orders." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_framework_agreement_sourcing:0 +msgid "if your NGO has framework agreements with suppliers which you use to source logistics requisitions." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_order_donation:0 +msgid "if your NGO has to manage logistics orders which are in-kind donations from other partners." +msgstr "" + +#. module: vertical_ngo +#: view:ngo.config.settings:vertical_ngo.view_ngo_configuration +msgid "or" +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_requisition_donation:0 +msgid "to create logistics requisition to dispatch stock stored in your warehouse and owned by other entities." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_order_multicurrency:0 +msgid "to display the amount of the logistics order in the company currency using the exchange rate at the date of the order." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_logistic_requisition_multicurrency:0 +msgid "to display the amounts on logistics requisitions in company currency.\n" +"The amounts are converted from requisition currency to company currency at rates of requisition date." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_ngo_shipment_plan:0 +msgid "to follow the shipment of your logistics orders and manage transit locations." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_ngo_purchase:0 +msgid "to manage purchases with a RFQ / Bid workflow, and various international transport documents on your purchase orders." +msgstr "" + +#. module: vertical_ngo +#: help:ngo.config.settings,module_ngo_purchase_requisition:0 +msgid "to use the updated bid selection process" +msgstr "" + diff --git a/vertical_ngo/README.rst b/vertical_ngo/README.rst new file mode 100644 index 00000000..a6c9dbff --- /dev/null +++ b/vertical_ngo/README.rst @@ -0,0 +1,57 @@ +.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg + :alt: License: AGPL-3 + +Odoo Verticalisation for NGO Application +======================================== + +This application allows you to configure the Odoo Verticalization for Non +Government Organizations (NGO). + +Installation +============ + +To install, make sure that you have modules from the following OCA repositories +available: + +* department (https://github.com/OCA/department/) +* purchase-workflow (https://github.com/OCA/purchase-workflow) +* sale-workflow (https://github.com/OCA/sale-workflow) +* stock-logistics-workflow (https://github.com/OCA/stock-logistics-workflow) +* stock-logistics-transport (https://github.com/OCA/stock-logistics-transport) + +Configuration +============= + +To configure this module, go to Settings -> NGO and perform the required +configuration. + + +Bug Tracker +=========== + +Bugs are tracked on `GitHub 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 +`here `_. + +Credits +======= + +Contributors +------------ +* Alexandre Fayolle + +Maintainer +---------- + +.. image:: https://odoo-community.org/logo.png + :alt: Odoo Community Association + :target: https://odoo-community.org + +This module is maintained by the OCA. + +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. + +To contribute to this module, please visit http://odoo-community.org. diff --git a/vertical_ngo/__init__.py b/vertical_ngo/__init__.py new file mode 100644 index 00000000..0650744f --- /dev/null +++ b/vertical_ngo/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/vertical_ngo/__openerp__.py b/vertical_ngo/__openerp__.py new file mode 100644 index 00000000..08d82839 --- /dev/null +++ b/vertical_ngo/__openerp__.py @@ -0,0 +1,36 @@ +# -*- coding: utf-8 -*- +############################################################################## +# +# Copyright 2015 Camptocamp SA +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Affero General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see . +# +############################################################################## + +{"name": "Vertical NGO", + "summary": "Odoo NGO Verticalization", + "version": "0.1", + "author": "Camptocamp,Odoo Community Association (OCA)", + "license": "AGPL-3", + "category": "Purchase Management", + "images": [], + "website": "http://www.camptocamp.com", + "depends": [], + "demo": [], + "data": ['view/vertical_ngo.xml', + ], + 'installable': True, + "auto_install": False, + "application": True + } diff --git a/vertical_ngo/models/__init__.py b/vertical_ngo/models/__init__.py new file mode 100644 index 00000000..ab480f8b --- /dev/null +++ b/vertical_ngo/models/__init__.py @@ -0,0 +1 @@ +from . import res_config diff --git a/vertical_ngo/models/res_config.py b/vertical_ngo/models/res_config.py new file mode 100644 index 00000000..6773bf25 --- /dev/null +++ b/vertical_ngo/models/res_config.py @@ -0,0 +1,83 @@ +# -*- coding: utf-8 -*- +############################################################################## +# +# Copyright 2015 Camptocamp SA +# +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU Affero General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Affero General Public License for more details. +# +# You should have received a copy of the GNU Affero General Public License +# along with this program. If not, see . +# +############################################################################## + +from openerp import models, fields + + +class ngo_config_settings(models.TransientModel): + _name = 'ngo.config.settings' + _inherit = 'res.config.settings' + + module_framework_agreement_requisition = fields.Boolean( + 'Create tenders to negociate a framework agreements', + help="To allow your NGO to manage tenders when negociating " + "framework agreements from possible suppliers." + ) + module_framework_agreement_sourcing = fields.Boolean( + 'Allow to source a logistics requisition with a framework agreement', + help="if your NGO has framework agreements with suppliers " + "which you use to source logistics requisitions." + ) + module_logistic_budget = fields.Boolean( + 'Manage budget on logistics requisitions and cost estimates', + help="adds the notion of budget and budget holer on logistics " + "requisitions and logistics orders." + ) + module_logistic_order_donation = fields.Boolean( + 'Manage in-kind donations', + help="if your NGO has to manage logistics orders which are " + "in-kind donations from other partners." + ) + module_logistic_order_multicurrency = fields.Boolean( + 'Manage multiple currencies for logistics orders', + help="to display the amount of the logistics order " + "in the company currency using the exchange rate at " + "the date of the order." + ) + module_logistic_requisition = fields.Boolean( + 'Manage logistics requisitions and logistics orders', + help="A Logistics requisition express a need that is " + "requested somewhere. It allows to manage the sourcing " + "of the needs before making a cost estimate to the requestor." + ) + module_logistic_requisition_donation = fields.Boolean( + 'Manage donor stock dispatches as logistics requisitions', + help="to create logistics requisition to dispatch stock " + "stored in your warehouse and owned by other entities." + ) + module_logistic_requisition_multicurrency = fields.Boolean( + 'Manage multiple currencies for logistics requisitions', + help="to display the amounts on logistics requisitions in " + "company currency.\n" + "The amounts are converted from requisition currency to " + "company currency at rates of requisition date.") + module_ngo_purchase_requisition = fields.Boolean( + 'Manage purchase requisitions', + help="to use the updated bid selection process") + module_ngo_purchase = fields.Boolean( + 'Manage purchases and framework agreements', + help="to manage purchases with a RFQ / Bid workflow, and " + "various international transport documents on your purchase orders." + ) + module_ngo_shipment_plan = fields.Boolean( + 'Manage shipment plans', + help="to follow the shipment of your logistics orders and manage " + "transit locations." + ) diff --git a/vertical_ngo/static/description/icon.png b/vertical_ngo/static/description/icon.png new file mode 100644 index 00000000..f502cf83 Binary files /dev/null and b/vertical_ngo/static/description/icon.png differ diff --git a/vertical_ngo/static/description/icon.svg b/vertical_ngo/static/description/icon.svg new file mode 100644 index 00000000..4be24a44 --- /dev/null +++ b/vertical_ngo/static/description/icon.svg @@ -0,0 +1,98 @@ + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + NGO + diff --git a/vertical_ngo/static/description/index.html b/vertical_ngo/static/description/index.html new file mode 100644 index 00000000..ce5c822b --- /dev/null +++ b/vertical_ngo/static/description/index.html @@ -0,0 +1,171 @@ +
+
+
+

Odoo Verticalization for NGO

+

This project aim to develop and publish all modules related to the + need of humanitarian NGOs. It would cover the overall needs in terms of + logistics, order management, accounting, transportation and + distribution. +

+ +

Main changes are made in the procurement standard flow of + Odoo. Usually, you have sales that drive procurement, that drive + purchase. With those modules, you record logistic requisition to + capture the needs, you source them from one way or another (purchase, + stock, donnation,..) and give back to the requestor the price, time and + product information. If he agree with, then you confirm the requisition + by creating an offer. The offer will drive all the necessary flow to + deliver the good where they are needed. It also improve the purchase + requisition flow to fit more with the NGO's problematic.

+ +

In the future, it will cover other NGO's specific needs such as the + distribution, transportation, finance (donations, donors report…), + volonteer management…

+ +
+
+
+ +
+
+
+

Installation

+
+
+

To install this module, you need to ensure that + the following projects are in your addons path: +

+ + and optionally: +
    +
  • + department: + to manage logistic requiritions by department +
    • +
  • + stock-logistics-warehouse + for modules such as + stock_reserve, + stock_reserve_sale, + stock_location_ownership… +
    • +
  • + stock-logistics-worflow + for modules such as + stock_split_picking… +
    • +
  • + sale-workflow + for modules such as + sale_validity, + sale_quotation_sourcing, + sale_sourced_by_line, + sale_exception_nostock, + sale_cancel_reason, + partner_prepayment… +
    • +
+

+
+
+
+ + + +
+
+
+
+ +
+
+
+

Configuration

+
+
+

To configure this module, you need to: +

    +
  • Go to Settings -> NGO, and select the features you + want to use.
    • +
+

+
+
+
+ + + +
+
+
+
+ +
+
+
+

Usage

+
+
+

To use this module, you need to go to the order + management menu. All the main functions are conveniently available + in there +

    +
  • creation of logistics requisitions
    • +
  • sourcing of logistics requisitions lines
    • +
  • management of cost estimates and logistics orders
    • +
  • shipment management
    • +
+

+

For further information, please visit: +

+

+
+
+
+ + + +
+
+
+
+ +
+
+
+

Known issues / Roadmap

+
+
+

+

    +
  • support more activities for NGOs
    • +
+

+
+
+
+ +
+
+
+

Maintainer

+

+ This module is maintained by the OCA.
+ + 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.
To contribute to this module, please + visit http://odoo-community.org.
+ +

+
+
+
diff --git a/vertical_ngo/static/description/vertical-ngo-settings.png b/vertical_ngo/static/description/vertical-ngo-settings.png new file mode 100644 index 00000000..2d4d8c59 Binary files /dev/null and b/vertical_ngo/static/description/vertical-ngo-settings.png differ diff --git a/vertical_ngo/static/description/vertical-ngo_LR.png b/vertical_ngo/static/description/vertical-ngo_LR.png new file mode 100644 index 00000000..ce9df9dd Binary files /dev/null and b/vertical_ngo/static/description/vertical-ngo_LR.png differ diff --git a/vertical_ngo/view/vertical_ngo.xml b/vertical_ngo/view/vertical_ngo.xml new file mode 100644 index 00000000..4e684050 --- /dev/null +++ b/vertical_ngo/view/vertical_ngo.xml @@ -0,0 +1,115 @@ + + + + + + Configure NGO + ngo.config.settings + +
+
+
+ + + + + + + + + + +
+ + + + Configure NGO + ir.actions.act_window + ngo.config.settings + form + inline + + + + + + +