FS/FS/AccessRight.pm

   1 package FS::AccessRight;
   2
   3 use strict;
   4 use vars qw(@rights); # %rights);
   5 use Tie::IxHash;
   6
   7 =head1 NAME
   8
   9 FS::AccessRight - Access control rights.
  10
  11 =head1 SYNOPSIS
  12
  13   use FS::AccessRight;
  14
  15 =head1 DESCRIPTION
  16
  17 Access control rights - Permission to perform specific actions that can be
  18 assigned to users and/or groups.
  19
  20 =cut
  21
  22 #@rights = (
  23 #  'Reports' => [
  24 #    '_desc' => 'Access to high-level reporting',
  25 #  ],
  26 #  'Configuration' => [
  27 #    '_desc' => 'Access to configuration',
  28 #
  29 #    'Settings' => {},
  30 #
  31 #    'agent' => [
  32 #      '_desc' => 'Master access to reseller configuration',
  33 #      'agent_type'  => {},
  34 #      'agent'       => {},
  35 #    ],
  36 #
  37 #    'export_svc_pkg' => [
  38 #      '_desc' => 'Access to export, service and package configuration',
  39 #      'part_export' => {},
  40 #      'part_svc'    => {},
  41 #      'part_pkg'    => {},
  42 #      'pkg_class'   => {},
  43 #    ],
  44 #
  45 #    'billing' => [
  46 #      '_desc' => 'Access to billing configuration',
  47 #      'payment_gateway'  => {},
  48 #      'part_bill_event'  => {},
  49 #      'prepay_credit'    => {},
  50 #      'rate'             => {},
  51 #      'cust_main_county' => {},
  52 #    ],
  53 #
  54 #    'dialup' => [
  55 #      '_desc' => 'Access to dialup configuraiton',
  56 #      'svc_acct_pop' => {},
  57 #    ],
  58 #
  59 #    'broadband' => [
  60 #      '_desc' => 'Access to broadband configuration',
  61 #      'router'     => {},
  62 #      'addr_block' => {},
  63 #    ],
  64 #
  65 #    'misc' => [
  66 #      'part_referral'      => {},
  67 #      'part_virtual_field' => {},
  68 #      'msgcat'             => {},
  69 #      'inventory_class'    => {},
  70 #    ],
  71 #
  72 #  },
  73 #
  74 #);
  75 #
  76 ##turn it into a more hash-like structure, but ordered via IxHash
  77
  78 #well, this is what we have for now.  could be ordered better, could be lots of
  79 # things better, but this ACL system does 99% of what folks need and the UI
  80 # isn't *that* bad
  81 #
  82 # okay, well it *really* needs some catgorization in the UI.  badly.
  83 @rights = (
  84
  85 ##
  86 # basic customer rights
  87 ##
  88   'New customer',
  89   'View customer',
  90   #'View Customer | View tickets',
  91   'Edit customer',
  92   'Cancel customer',
  93   'Complimentary customer', #aka users-allow_comp
  94   'Delete customer', #aka. deletecustomers #Enable customer deletions. Be very careful! Deleting a customer will remove all traces that this customer ever existed! It should probably only be used when auditing a legacy database. Normally, you cancel all of a customers' packages if they cancel service.
  95   'Add customer note',
  96
  97 ###
  98 # customer package rights
  99 ###
 100   'Order customer package',
 101   'One-time charge',
 102   'Change customer package',
 103   'Bulk change customer packages',
 104   'Edit customer package dates',
 105   'Customize customer package',
 106   'Suspend customer package',
 107   'Unsuspend customer package',
 108   'Cancel customer package immediately',
 109   'Cancel customer package later',
 110
 111 ###
 112 # customer service rights
 113 ###
 114   'Provision customer service',
 115   'Unprovision customer service',
 116
 117   'View/link unlinked services', #not agent-virtualizable without more work
 118
 119 ###
 120 # customer invoice/financial info rights
 121 ###
 122   'View invoices',
 123   'View customer tax exemptions', #yow
 124
 125 ###
 126 # customer payment rights
 127 ###
 128   'Post payment',
 129   'Post payment batch',
 130   'Unapply payment', #aka. unapplypayments Enable "unapplication" of unclosed payments.
 131   'Process payment',
 132   'Refund payment',
 133
 134   'Delete payment', #aka. deletepayments - Enable deletion of unclosed payments. Be very careful! Only delete payments that were data-entry errors, not adjustments. Optionally specify one or more comma-separated email addresses to be notified when a payment is deleted.
 135
 136 ###
 137 # customer credit rights
 138 ###
 139   'Post credit',
 140   #'Apply credit',
 141   'Unapply credit', #aka unapplycredits Enable "unapplication" of unclosed credits.
 142   'Delete credit', #aka. deletecredits Enable deletion of unclosed credits. Be very careful! Only delete credits that were data-entry errors, not adjustments. Optionally specify one or more comma-separated email addresses to be notified when a credit is deleted.
 143
 144 ###
 145 # customer voiding rights..
 146 ###
 147   'Credit card void', #aka. cc-void #Enable local-only voiding of echeck payments in addition to refunds against the payment gateway
 148   'Echeck void', #aka. echeck-void #Enable local-only voiding of echeck payments in addition to refunds against the payment gateway
 149   'Regular void',
 150   'Unvoid', #aka. unvoid #Enable unvoiding of voided payments
 151
 152 ###
 153 # report/listing rights...
 154 ###
 155   'List customers',
 156   #'List zip codes',
 157   'List invoices',
 158   'List packages',
 159   'List services',
 160
 161   'List rating data',  # 'Usage reports',
 162   'Billing event reports',
 163   'Financial reports',
 164
 165 ###
 166 # misc rights
 167 ###
 168   'Job queue',         # these are not currently agent-virtualized
 169   'Process batches',   #
 170   'Reprocess batches', #
 171   'Import',            #
 172   'Export',            #
 173
 174 ###
 175 # setup/config rights
 176 ###
 177   'Edit advertising sources',
 178   'Edit global advertising sources',
 179
 180   'Configuration', #most of the rest of the configuraiton is not
 181                    # agent-virtualized
 182 );
 183
 184 sub rights {
 185   @rights;
 186 }
 187