Resource.py 8.54 KB
Newer Older
Jean-Paul Smets's avatar
Jean-Paul Smets committed
1 2 3
##############################################################################
#
# Copyright (c) 2002 Nexedi SARL and Contributors. All Rights Reserved.
Jean-Paul Smets's avatar
Jean-Paul Smets committed
4
#                    Jean-Paul Smets-Solanes <jp@nexedi.com>
Jean-Paul Smets's avatar
Jean-Paul Smets committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66
#
# WARNING: This program as such is intended to be used by professional
# programmers who take the whole responsability of assessing all potential
# consequences resulting from its eventual inadequacies and bugs
# End users who are looking for a ready-to-use solution with commercial
# garantees and support are strongly adviced to contract a Free Software
# Service Company
#
# This program is Free Software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# 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 General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
#
##############################################################################

class Resource:
    """
        Properties which allow to define a generic Resource.

        The underlying idea is that we only define 'base' properties
        which correspond to a generic variations of the resource.

        Variations can change the base properties by introduction
        new attributions such as 'option' properties.
    """

    _properties = (
        # Pricing properties
        {   'id'          : 'source_base_price',
            'description' : 'A typical per unit price at which this resource can be sourced (bought)',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'source_base_price_validity',
            'description' : 'Validity of the typical per unit price at which this resource can be sourced',
            'type'        : 'date',
            'mode'        : 'w' },
        {   'id'          : 'destination_base_price',
            'description' : 'A typical per unit price at which this resource can be supplied (sold)',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'destination_base_price_validity',
            'description' : 'Validity of the typical per unit price at which this resource can be supplied',
            'type'        : 'date',
            'mode'        : 'w' },
        {   'id'          : 'base_price',
            'description' : 'A default per unit price used for internal price calculations',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'priced_quantity',
            'description' : 'Number of units involved in base prices',
            'type'        : 'float',
            'default'     : 1.0,
            'mode'        : 'w' },
67 68 69 70 71
        {   'id'          : 'consumer_unit_quantity',
            'description' : 'Number of consumer_unit involved in the resoure (sku)',
            'type'        : 'float',
            'default'     : 1.0,
            'mode'        : 'w' },
Yoshinori Okuji's avatar
Yoshinori Okuji committed
72
        {   'id'          : 'base_unit_quantity',
73
            'description' : 'The smallest transferrable amount expressed in the default unit',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
74 75 76
            'type'        : 'float',
            'default'     : 1.0,
            'mode'        : 'w' },
Jean-Paul Smets's avatar
Jean-Paul Smets committed
77 78 79 80 81 82 83 84 85 86
        # Physical properties
        {   'id'          : 'base_weight',
            'description' : 'A typical per unit weight of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'base_volume',
            'description' : 'A typical per unit volume of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'base_length',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
87
            'description' : 'A typical per unit length of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
88 89 90
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'base_width',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
91
            'description' : 'A typical per unit width of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
92 93 94
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'base_height',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
95 96 97 98 99
            'description' : 'A typical per unit height of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'base_surface',
            'description' : 'A typical per unit surface of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
100 101 102 103 104 105 106 107 108 109 110 111
            'type'        : 'float',
            'mode'        : 'w' },
        # Basic conversion properties
        # A property is set on categories to define if it is length, weight etc.
        # another property defines the conversion to the default lenght
        #                                         (ie. nomber of meters in 1 inch)
        # This allows to implement universal conversions
        {   'id'          : 'length_quantity',
            'description' : 'length of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'weight_quantity',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
112 113 114 115
            'description' : 'weight of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'height_quantity',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
116 117 118
            'description' : 'height of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
Yoshinori Okuji's avatar
Yoshinori Okuji committed
119 120 121 122
        {   'id'          : 'width_quantity',
            'description' : 'width of the resource',
            'type'        : 'float',
            'mode'        : 'w' },
Jean-Paul Smets's avatar
Jean-Paul Smets committed
123
        {   'id'          : 'surface_quantity',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
124
            'description' : 'surface area of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
125 126 127
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'volume_quantity',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
128
            'description' : 'volume of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
129 130 131
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'unit_quantity',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
132
            'description' : 'units of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
133 134 135
            'type'        : 'float',
            'mode'        : 'w' },
        {   'id'          : 'time_quantity',
Yoshinori Okuji's avatar
Yoshinori Okuji committed
136
            'description' : 'time of the resource',
Jean-Paul Smets's avatar
Jean-Paul Smets committed
137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159
            'type'        : 'float',
            'mode'        : 'w' },
        # Sourcing / planning properties
        {   'id'          : 'source_title',
            'storage_id'  : 'default_source_title', # Compatibility
            'description' : 'The titles of the sources of this resource',
            'type'        : 'string',
            'acquisition_base_category'     : ('source',),
            'acquisition_portal_type'       : ('Organisation','MetaNode'),
            'acquisition_copy_value'        : 0,
            'acquisition_accessor_id'       : 'getTitle',
            'acquisition_depends'           : None,
            'mode'        : 'w' },
        {   'id'          : 'destination_title',
            'storage_id'  : 'default_destination_title', # Compatibility
            'description' : 'The titles of the destinations of this resource',
            'type'        : 'string',
            'acquisition_base_category'     : ('destination',),
            'acquisition_portal_type'       : ('Organisation','MetaNode'),
            'acquisition_copy_value'        : 0,
            'acquisition_accessor_id'       : 'getTitle',
            'acquisition_depends'           : None,
            'mode'        : 'w' },
160 161 162 163 164 165 166 167 168 169 170
        # Default attributes overriden in supply lines (should be in supply line)
        {   'id'          : 'trade_description',
            'description' : 'A description of the document intended for client',
            'type'        : 'text',
            'default'     : '',
            'mode'        : 'w' },
        {   'id'          : 'instructions',
            'description' : 'instructions in order to explain how to use the resource',
            'type'        : 'text',
            'default'     : '',
            'mode'        : 'w' },
171 172 173 174 175 176 177 178
        # Pricing
        {  'id'          : 'p_variation_base_category',
           # XXX Compatibility
           'description' : 'Base category range of matrix',
           'type'        : 'lines',
           'default'     : [],
           'multivalued' : 1,
           'mode'        : 'w' },
Jean-Paul Smets's avatar
Jean-Paul Smets committed
179 180 181

    )

182
    _categories = ( 'source', 'destination', 'quantity_unit',
183
                    'base_contribution',
184
                    'use',
185
                    'price_currency', 'product_line',
186
                    'industrial_phase')
Jean-Paul Smets's avatar
Jean-Paul Smets committed
187