FS/FS/Schema.pm

   1 package FS::Schema;
   2
   3 use vars qw(@ISA @EXPORT_OK $DEBUG $setup_hack %dbdef_cache);
   4 use subs qw(reload_dbdef);
   5 use Exporter;
   6 use DBIx::DBSchema 0.44; #for foreign keys with MATCH / ON DELETE/UPDATE
   7 use DBIx::DBSchema::Table;
   8 use DBIx::DBSchema::Column;
   9 use DBIx::DBSchema::Index;
  10 use DBIx::DBSchema::ForeignKey;
  11 #can't use this yet, dependency bs #use FS::Conf;
  12
  13 @ISA = qw(Exporter);
  14 @EXPORT_OK = qw( dbdef dbdef_dist reload_dbdef );
  15
  16 $DEBUG = 0;
  17 $me = '[FS::Schema]';
  18
  19 =head1 NAME
  20
  21 FS::Schema - Freeside database schema
  22
  23 =head1 SYNOPSYS
  24
  25     use FS::Schema qw(dbdef dbdef_dist reload_dbdef);
  26
  27     $dbdef = reload_dbdef;
  28     $dbdef = reload_dbdef "/non/standard/filename";
  29     $dbdef = dbdef;
  30     $dbdef_dist = dbdef_dist;
  31
  32 =head1 DESCRIPTION
  33
  34 This class represents the database schema.
  35
  36 =head1 METHODS
  37
  38 =over 4
  39
  40 =item reload_dbdef([FILENAME])
  41
  42 Load a database definition (see L<DBIx::DBSchema>), optionally from a
  43 non-default filename.  This command is executed at startup unless
  44 I<$FS::Schema::setup_hack> is true.  Returns a DBIx::DBSchema object.
  45
  46 =cut
  47
  48 sub reload_dbdef {
  49   my $file = shift;
  50
  51   unless ( exists $dbdef_cache{$file} ) {
  52     warn "[debug]$me loading dbdef for $file\n" if $DEBUG;
  53     $dbdef_cache{$file} = DBIx::DBSchema->load( $file )
  54       or die "can't load database schema from $file: $DBIx::DBSchema::errstr\n";
  55   } else {
  56     warn "[debug]$me re-using cached dbdef for $file\n" if $DEBUG;
  57   }
  58   $dbdef = $dbdef_cache{$file};
  59   FS::Record::fk_methods_init();
  60 }
  61
  62 =item dbdef
  63
  64 Returns the current database definition (represents the current database,
  65 assuming it is up-to-date).  See L<DBIx::DBSchema>.
  66
  67 =cut
  68
  69 sub dbdef { $dbdef; }
  70
  71 =item dbdef_dist [ DATASRC ]
  72
  73 Returns the current canoical database definition as defined in this file.
  74
  75 Optionally, pass a DBI data source to enable syntax specific to that database.
  76 Currently, this enables "ENGINE=InnoDB" for MySQL databases.
  77
  78 =cut
  79
  80 sub dbdef_dist {
  81   my $datasrc = @_ && !ref($_[0]) ? shift : '';
  82   my $opt = @_ ? shift : {};
  83
  84   my $local_options = '';
  85   if ( $datasrc =~ /^dbi:mysql/i ) {
  86     $local_options = 'ENGINE=InnoDB';
  87   }
  88
  89   ###
  90   # create a dbdef object from the old data structure
  91   ###
  92
  93   my $tables_hashref = tables_hashref();
  94
  95   #turn it into objects
  96   my $dbdef = new DBIx::DBSchema map {
  97
  98     my $tablename = $_;
  99     my $indexnum = 1;
 100
 101     my @columns;
 102     while (@{$tables_hashref->{$tablename}{'columns'}}) {
 103       #my($name, $type, $null, $length, $default, $local) =
 104       my @coldef =
 105         splice @{$tables_hashref->{$tablename}{'columns'}}, 0, 6;
 106       my %hash = map { $_ => shift @coldef }
 107                      qw( name type null length default local );
 108
 109       #can be removed once we depend on DBIx::DBSchema 0.39;
 110       $hash{'type'} = 'LONGTEXT'
 111         if $hash{'type'} =~ /^TEXT$/i && $datasrc =~ /^dbi:mysql/i;
 112
 113       unless ( defined $hash{'default'} ) {
 114         warn "$tablename:\n".
 115              join('', map "$_ => $hash{$_}\n", keys %hash) ;# $stop = <STDIN>;
 116       }
 117
 118       push @columns, new DBIx::DBSchema::Column ( \%hash );
 119     }
 120
 121     #false laziness w/sub indices in DBIx::DBSchema::DBD (well, sorta)
 122     #and sub sql_create_table in DBIx::DBSchema::Table (slighty more?)
 123     my $unique = $tables_hashref->{$tablename}{'unique'};
 124     warn "missing index for $tablename\n" unless defined $tables_hashref->{$tablename}{'index'};
 125     my @index  = @{ $tables_hashref->{$tablename}{'index'} };
 126
 127     # kludge to avoid avoid "BLOB/TEXT column 'statustext' used in key
 128     #  specification without a key length".
 129     # better solution: teach DBIx::DBSchema to specify a default length for
 130     #  MySQL indices on text columns, or just to support an index length at all
 131     #  so we can pass something in.
 132     # best solution: eliminate need for this index in cust_main::retry_realtime
 133     @index = grep { @{$_}[0] ne 'statustext' } @index
 134       if $datasrc =~ /^dbi:mysql/i;
 135
 136     my @indices = ();
 137     push @indices, map {
 138                          DBIx::DBSchema::Index->new({
 139                            'name'    => $tablename. $indexnum++,
 140                            'unique'  => 1,
 141                            'columns' => $_,
 142                          });
 143                        }
 144                        @$unique;
 145     push @indices, map {
 146                          DBIx::DBSchema::Index->new({
 147                            'name'    => $tablename. $indexnum++,
 148                            'unique'  => 0,
 149                            'columns' => $_,
 150                          });
 151                        }
 152                        @index;
 153
 154     my @foreign_keys =
 155       map DBIx::DBSchema::ForeignKey->new($_),
 156         @{ $tables_hashref->{$tablename}{'foreign_keys'} || [] };
 157
 158     DBIx::DBSchema::Table->new({
 159       name          => $tablename,
 160       primary_key   => $tables_hashref->{$tablename}{'primary_key'},
 161       columns       => \@columns,
 162       indices       => \@indices,
 163       foreign_keys  => \@foreign_keys,
 164       local_options => $local_options,
 165     });
 166
 167   } keys %$tables_hashref;
 168
 169   if ( $DEBUG ) {
 170     warn "[debug]$me initial dbdef_dist created ($dbdef) with tables:\n";
 171     warn "[debug]$me   $_\n" foreach $dbdef->tables;
 172   }
 173
 174   #add radius attributes to svc_acct
 175   #
 176   #my($svc_acct)=$dbdef->table('svc_acct');
 177   #
 178   #my($attribute);
 179   #foreach $attribute (@attributes) {
 180   #  $svc_acct->addcolumn ( new DBIx::DBSchema::Column (
 181   #    'radius_'. $attribute,
 182   #    'varchar',
 183   #    'NULL',
 184   #    $char_d,
 185   #  ));
 186   #}
 187   #
 188   #foreach $attribute (@check_attributes) {
 189   #  $svc_acct->addcolumn( new DBIx::DBSchema::Column (
 190   #    'rc_'. $attribute,
 191   #    'varchar',
 192   #    'NULL',
 193   #    $char_d,
 194   #  ));
 195   #}
 196
 197   my $tables_hashref_torrus = tables_hashref_torrus();
 198
 199   #create history tables
 200   foreach my $table (
 201     grep {    ! /^(clientapi|access_user)_session/
 202            && ! /^h_/
 203            && ! /^log(_context)?$/
 204            && ! /^(legacy_cust_history|cacti_page|template_image|access_user_log)$/
 205            && ( ! /^queue(_arg|_depend|_stat)?$/ || ! $opt->{'queue-no_history'} )
 206            && ! $tables_hashref_torrus->{$_}
 207          }
 208       $dbdef->tables
 209   ) {
 210     my $tableobj = $dbdef->table($table)
 211       or die "unknown table $table";
 212
 213     my %h_indices = ();
 214
 215     unless ( $table eq 'cust_event' || $table eq 'cdr' ) { #others?
 216
 217       my %indices = $tableobj->indices;
 218
 219       %h_indices = map {
 220                          ( "h_$_" =>
 221                              DBIx::DBSchema::Index->new({
 222                                'name'    => 'h_'. $indices{$_}->name,
 223                                'unique'  => 0,
 224                                'columns' => [ @{$indices{$_}->columns} ],
 225                              })
 226                          );
 227                        }
 228                        keys %indices;
 229
 230       $h_indices{"h_${table}_srckey"} =
 231         DBIx::DBSchema::Index->new({
 232           'name'    => "h_${table}_srckey",
 233           'unique'  => 0,
 234           'columns' => [ 'history_action', #right?
 235                          $tableobj->primary_key,
 236                        ],
 237         });
 238
 239       $h_indices{"h_${table}_srckey2"} =
 240          DBIx::DBSchema::Index->new({
 241            'name'    => "h_${table}_srckey2",
 242            'unique'  => 0,
 243            'columns' => [ 'history_date',
 244                           $tableobj->primary_key,
 245                         ],
 246          });
 247
 248         #necessary for queries that want to look at *who* made changes
 249       $h_indices{"h_${table}_usernum"} =
 250          DBIx::DBSchema::Index->new({
 251            'name'    => "h_${table}_usernum",
 252            'unique'  => 0,
 253            'columns' => [ 'history_usernum'],
 254          });
 255
 256         # necessary because of the evil OR username for older data, be really nice if everything was just migrated to usernum and we could drop username
 257         # This will not be helpful to mysql, but postgres smartly does a bitmap across both indexes, mysql will just use one
 258
 259       $h_indices{"h_${table}_user"} =
 260          DBIx::DBSchema::Index->new({
 261            'name'    => "h_${table}_user",
 262            'unique'  => 0,
 263            'columns' => [ 'history_user'],
 264          });
 265     }
 266
 267     my $primary_key_col = $tableobj->column($tableobj->primary_key)
 268       or die "$table: primary key declared as ". $tableobj->primary_key.
 269              ", but no column of that name\n";
 270
 271     my $historynum_type = ( $tableobj->column($tableobj->primary_key)->type
 272                               =~ /^(bigserial|bigint|int8)$/i
 273                                 ? 'bigserial'
 274                                 : 'serial'
 275                           );
 276
 277     my $h_tableobj = DBIx::DBSchema::Table->new( {
 278       'name'          => "h_$table",
 279       'primary_key'   => 'historynum',
 280       'indices'       => \%h_indices,
 281       'local_options' => $local_options,
 282       'columns'       => [
 283           DBIx::DBSchema::Column->new( {
 284             'name'    => 'historynum',
 285             'type'    => $historynum_type,
 286             'null'    => 'NOT NULL',
 287             'length'  => '',
 288             'default' => '',
 289             'local'   => '',
 290           } ),
 291           DBIx::DBSchema::Column->new( {
 292             'name'    => 'history_date',
 293             'type'    => 'int',
 294             'null'    => 'NULL',
 295             'length'  => '',
 296             'default' => '',
 297             'local'   => '',
 298           } ),
 299           DBIx::DBSchema::Column->new( {
 300             'name'    => 'history_user',
 301             'type'    => 'varchar',
 302             'null'    => 'NULL',
 303             'length'  => '80',
 304             'default' => '',
 305             'local'   => '',
 306           } ),
 307           DBIx::DBSchema::Column->new( {
 308             'name'    => 'history_usernum',
 309             'type'    => 'int',
 310             'null'    => 'NULL',
 311             'length'  => '',
 312             'default' => '',
 313             'local'   => '',
 314           } ),
 315           DBIx::DBSchema::Column->new( {
 316             'name'    => 'history_action',
 317             'type'    => 'varchar',
 318             'null'    => 'NOT NULL',
 319             'length'  => '80',
 320             'default' => '',
 321             'local'   => '',
 322           } ),
 323           map {
 324             my $column = $tableobj->column($_);
 325
 326             #clone so as to not disturb the original
 327             $column = DBIx::DBSchema::Column->new( {
 328               map { $_ => $column->$_() }
 329                 qw( name type null length default local )
 330             } );
 331
 332             if ( $column->type =~ /^(\w*)SERIAL$/i ) {
 333               $column->type(uc($1).'INT');
 334               $column->null('NULL');
 335             }
 336             #$column->default('')
 337             #  if $column->default =~ /^nextval\(/i;
 338             #( my $local = $column->local ) =~ s/AUTO_INCREMENT//i;
 339             #$column->local($local);
 340             $column;
 341           } $tableobj->columns
 342       ],
 343     } );
 344     $dbdef->addtable($h_tableobj);
 345   }
 346
 347   if ( $datasrc =~ /^dbi:mysql/i ) {
 348
 349     my $dup_lock_table = DBIx::DBSchema::Table->new( {
 350       'name'          => 'duplicate_lock',
 351       'primary_key'   => 'duplocknum',
 352       'local_options' => $local_options,
 353       'columns'       => [
 354         DBIx::DBSchema::Column->new( {
 355           'name'    => 'duplocknum',
 356           'type'    => 'serial',
 357           'null'    => 'NOT NULL',
 358           'length'  => '',
 359           'default' => '',
 360           'local'   => '',
 361         } ),
 362         DBIx::DBSchema::Column->new( {
 363           'name'    => 'lockname',
 364           'type'    => 'varchar',
 365           'null'    => 'NOT NULL',
 366           'length'  => '80',
 367           'default' => '',
 368           'local'   => '',
 369         } ),
 370       ],
 371       'indices' => { 'duplicate_lock1' =>
 372                        DBIx::DBSchema::Index->new({
 373                          'name'    => 'duplicate_lock1',
 374                          'unique'  => 1,
 375                          'columns' => [ 'lockname' ],
 376                        })
 377                    },
 378     } );
 379
 380     $dbdef->addtable($dup_lock_table);
 381
 382   }
 383
 384   $dbdef;
 385
 386 }
 387
 388 #torrus tables http://torrus.org/reporting_setup.pod.html#create_sql_tables
 389 sub tables_hashref_torrus {
 390
 391   return {
 392
 393     # Collector export table. It usually grows at several megabytes
 394     # per month, and is updated every 5 minutes
 395     'srvexport' => {
 396       'columns' => [
 397         'id',         'serial', '', '', '', '',
 398         'srv_date',     'date', '', '', '', '',#date and time of the data sample
 399         'srv_time',     'time', '', '', '', '',
 400         'serviceid', 'varchar', '', 64, '', '',#unique service ID per counter
 401         'value',     'double precision', '', '', '', '',#collected rate or gauge value
 402         'intvl', 'int', '', '', '', '', # collection interval - for counter volume calculation
 403       ],
 404       'primary_key' => 'id',
 405       'unique' => [],
 406       'index'  => [ ['srv_date'], ['srv_date', 'srv_time'], ['serviceid'], ],
 407     },
 408
 409     #Tables for (currently monthly only) report contents.
 410     #These are updated usually once per month, and read at the moment of
 411     #rendering the report output (HTML now, PDF or XML or Excel or whatever
 412     #in the future)
 413
 414     #DBIx::Sequence backend, theplatform-independent inplementation
 415     #of sequences
 416     'dbix_sequence_state' => {
 417       'columns' => [
 418         'id',       'serial', '', '', '', '',
 419         'dataset', 'varchar', '', 50, '', '',
 420         'state_id',    'int', '', '', '', '',
 421       ],
 422       'primary_key' => 'id',
 423       #CONSTRAINT pk_dbix_sequence PRIMARY KEY (dataset, state_id)
 424       'unique' => [ [ 'dataset', 'state_id' ], ],
 425       'index'  => [],
 426     },
 427
 428     'dbix_sequence_release' => {
 429       'columns' => [
 430         'id',       'serial', '', '', '', '',
 431         'dataset', 'varchar', '', 50, '', '',
 432         'released_id', 'int', '', '', '', '',
 433       ],
 434       'primary_key' => 'id',
 435       #CONSTRAINT pk_dbi_release PRIMARY KEY (dataset, released_id)
 436       'unique' => [ [ 'dataset', 'released_id', ] ],
 437       'index'  => [],
 438     },
 439
 440     #Each report is characterized by name, date and time.
 441     #Monthly reports are automatically assigned 00:00 of the 1st day
 442     #in the month. The report contains fields for every service ID
 443     #defined across all datasource trees.
 444     'reports' => {
 445       'columns' => [
 446         'id',          'serial', '', '', '', '',
 447         'rep_date',      'date', '', '', '', '',#Start date of the report
 448         'rep_time',      'time', '', '', '', '',#Start time of the report
 449         'reportname', 'varchar', '', 64, '', '',#Report name, such as
 450                                                 # MonthlyUsage
 451         'iscomplete',     'int', '', '', '', '',#0 when the report is in
 452                                                 # progress, 1 when it is ready
 453       ],
 454       'primary_key' => 'id',
 455       'unique' => [ [ qw(rep_date rep_time reportname) ] ],
 456       'index'  => [ [ 'rep_date' ] ],
 457     },
 458
 459     #Each report contains fields. For each service ID,
 460     #the report may contain several fields for various statistics.
 461     #Each field contains information about the units of the value it
 462     #contains
 463     'reportfields' => {
 464       'columns' => [
 465         'id',              'serial',     '', '',    '', '',
 466         'rep_id',             'int', 'NULL', '',    '', '',
 467         'name',           'varchar',     '', 64,    '', '',#name of the field,
 468                                                            # such as AVG or MAX
 469         'serviceid',      'varchar',     '', 64,    '', '',#service ID
 470         'value', 'double precision',     '', '',    '', '',#Numeric value
 471         'units',          'varchar',     '', 64, \"''", '',#Units, such as bytes
 472                                                            # or Mbps
 473       ],
 474       'primary_key', => 'id',
 475       'unique' => [ [ qw(rep_id name serviceid) ] ],
 476       'index'  => [],
 477     },
 478
 479   };
 480
 481 }
 482
 483 sub tables_hashref {
 484
 485   my $char_d = 80; #default maxlength for text fields
 486
 487   #my(@date_type)  = ( 'timestamp', '', ''     );
 488   my @date_type = ( 'int', 'NULL', ''     );
 489   my @perl_type = ( 'text', 'NULL', ''  );
 490   my @money_type = ( 'decimal',   '', '10,2' );
 491   my @money_typen = ( 'decimal',   'NULL', '10,2' );
 492   my @taxrate_type  = ( 'decimal',   '',     '14,8' ); # requires pg 8 for
 493   my @taxrate_typen = ( 'decimal',   'NULL', '14,8' ); # fs-upgrade to work
 494
 495   my $username_len = 64; #usernamemax config file
 496
 497     # name type nullability length default local
 498
 499   return {
 500
 501     'agent' => {
 502       'columns' => [
 503         'agentnum',          'serial',    '',       '', '', '',
 504         'agent',            'varchar',    '',  $char_d, '', '',
 505         'typenum',              'int',    '',       '', '', '',
 506         'ticketing_queueid',    'int', 'NULL',      '', '', '',
 507         'invoice_template', 'varchar', 'NULL', $char_d, '', '',
 508         'agent_custnum',        'int', 'NULL',      '', '', '',
 509         'disabled',            'char', 'NULL',       1, '', '',
 510         'username',         'varchar', 'NULL', $char_d, '', '',
 511         '_password',        'varchar', 'NULL', $char_d, '', '',
 512         'freq',              'int', 'NULL', '', '', '', #deprecated (never used)
 513         'prog',                     @perl_type, '', '', #deprecated (never used)
 514       ],
 515       'primary_key'  => 'agentnum',
 516       #'unique' => [ [ 'agent_custnum' ] ], #one agent per customer?
 517                                             #insert is giving it a value, tho..
 518       #'index' => [ ['typenum'], ['disabled'] ],
 519       'unique'       => [],
 520       'index'        => [ ['typenum'], ['disabled'], ['agent_custnum'] ],
 521       'foreign_keys' => [
 522                           { columns    => [ 'typenum' ],
 523                             table      => 'agent_type',
 524                           },
 525                           # 1. RT tables aren't part of our data structure, so
 526                           #     we can't make sure Queue is created already
 527                           # 2. Future ability to plug in other ticketing systems
 528                           #{ columns    => [ 'ticketing_queueid' ],
 529                           #  table      => 'Queue',
 530                           #  references => [ 'id' ],
 531                           #},
 532                           { columns    => [ 'agent_custnum' ],
 533                             table      => 'cust_main',
 534                             references => [ 'custnum' ],
 535                           },
 536                         ],
 537     },
 538
 539     'agent_pkg_class' => {
 540       'columns' => [
 541         'agentpkgclassnum',    'serial',     '',    '', '', '',
 542         'agentnum',               'int',     '',    '', '', '',
 543         'classnum',               'int', 'NULL',    '', '', '',
 544         'commission_percent', 'decimal',     '', '7,4', '', '',
 545       ],
 546       'primary_key'  => 'agentpkgclassnum',
 547       'unique'       => [ [ 'agentnum', 'classnum' ], ],
 548       'index'        => [],
 549       'foreign_keys' => [
 550                           { columns    => [ 'agentnum' ],
 551                             table      => 'agent',
 552                           },
 553                           { columns    => [ 'classnum' ],
 554                             table      => 'pkg_class',
 555                           },
 556                         ],
 557     },
 558
 559     'agent_type' => {
 560       'columns' => [
 561         'typenum',  'serial',      '',      '', '', '',
 562         'atype',    'varchar',     '', $char_d, '', '',
 563         'disabled',    'char', 'NULL',       1, '', '',
 564       ],
 565       'primary_key' => 'typenum',
 566       'unique' => [],
 567       'index' => [ ['disabled'] ],
 568     },
 569
 570     'type_pkgs' => {
 571       'columns' => [
 572         'typepkgnum', 'serial', '', '', '', '',
 573         'typenum',   'int',  '', '', '', '',
 574         'pkgpart',   'int',  '', '', '', '',
 575       ],
 576       'primary_key'  => 'typepkgnum',
 577       'unique'       => [ ['typenum', 'pkgpart'] ],
 578       'index'        => [ ['typenum'] ],
 579       'foreign_keys' => [
 580                           { columns    => [ 'typenum' ],
 581                             table      => 'agent_type',
 582                           },
 583                           { columns    => [ 'pkgpart' ],
 584                             table      => 'part_pkg',
 585                           },
 586                         ],
 587     },
 588
 589     'agent_currency' => {
 590       'columns' => [
 591         'agentcurrencynum', 'serial', '', '', '', '',
 592         'agentnum',            'int', '', '', '', '',
 593         'currency',           'char', '',  3, '', '',
 594       ],
 595       'primary_key'  => 'agentcurrencynum',
 596       'unique'       => [],
 597       'index'        => [ ['agentnum'] ],
 598       'foreign_keys' => [
 599                           { columns    => [ 'agentnum' ],
 600                             table      => 'agent',
 601                           },
 602                         ],
 603     },
 604
 605     'sales' => {
 606       'columns' => [
 607         'salesnum',          'serial',    '',       '', '', '',
 608         'salesperson',      'varchar',    '',  $char_d, '', '',
 609         'agentnum',             'int', 'NULL',      '', '', '',
 610         'sales_custnum',        'int', 'NULL',      '', '', '',
 611         'disabled',            'char', 'NULL',       1, '', '',
 612       ],
 613       'primary_key'  => 'salesnum',
 614       'unique'       => [],
 615       'index'        => [ ['salesnum'], ['disabled'] ],
 616       'foreign_keys' => [
 617                           { columns    => [ 'agentnum' ],
 618                             table      => 'agent',
 619                           },
 620                           { columns    => [ 'sales_custnum' ],
 621                             table      => 'cust_main',
 622                             references => [ 'custnum' ],
 623                           },
 624                         ],
 625     },
 626
 627     'sales_pkg_class' => {
 628       'columns' => [
 629         'salespkgclassnum',    'serial',     '',    '', '', '',
 630         'salesnum',               'int',     '',    '', '', '',
 631         'classnum',               'int', 'NULL',    '', '', '',
 632         'commission_percent', 'decimal',     '', '7,4', '', '',
 633         'commission_duration',    'int', 'NULL',    '', '', '',
 634       ],
 635       'primary_key'  => 'salespkgclassnum',
 636       'unique'       => [ [ 'salesnum', 'classnum' ], ],
 637       'index'        => [],
 638       'foreign_keys' => [
 639                           { columns    => [ 'salesnum' ],
 640                             table      => 'sales',
 641                           },
 642                           { columns    => [ 'classnum' ],
 643                             table      => 'pkg_class',
 644                           },
 645                         ],
 646     },
 647
 648     'cust_attachment' => {
 649       'columns' => [
 650         'attachnum', 'serial', '', '', '', '',
 651         'custnum',   'int', '', '', '', '',
 652         '_date',     @date_type, '', '',
 653         'otaker',    'varchar', 'NULL', 32, '', '',
 654         'usernum',   'int', 'NULL', '', '', '',
 655         'filename',  'varchar', '', 255, '', '',
 656         'mime_type', 'varchar', '', $char_d, '', '',
 657         'title',     'varchar', 'NULL', $char_d, '', '',
 658         'body',      'blob', 'NULL', '', '', '',
 659         'disabled',  @date_type, '', '',
 660       ],
 661       'primary_key'  => 'attachnum',
 662       'unique'       => [],
 663       'index'        => [ ['custnum'], ['usernum'], ],
 664       'foreign_keys' => [
 665                           { columns    => [ 'custnum' ],
 666                             table      => 'cust_main',
 667                           },
 668                           { columns    => [ 'usernum' ],
 669                             table      => 'access_user',
 670                           },
 671                         ],
 672    },
 673
 674     'cust_bill' => {
 675       'columns' => [
 676         #regular fields
 677         'invnum',         'serial',     '',      '', '', '',
 678         'custnum',           'int',     '',      '', '', '',
 679         '_date',        @date_type,                  '', '',
 680         'charged',     @money_type,                  '', '',
 681         'currency',         'char', 'NULL',       3, '', '',
 682         'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
 683
 684         #customer balance info at invoice generation time
 685         #(deprecated)
 686         'previous_balance',   @money_typen, '', '',  #eventually not nullable
 687         'billing_balance',    @money_typen, '', '',  #eventually not nullable
 688
 689         #deprecated (unused by now, right?)
 690         'printed',      'int',     '', '', '', '',
 691
 692         #specific use cases
 693         'closed',      'char', 'NULL',  1, '', '', #not yet used much
 694         'statementnum', 'int', 'NULL', '', '', '', #invoice aggregate statements
 695         'agent_invid',  'int', 'NULL', '', '', '', #(varchar?) importing legacy
 696         'promised_date', @date_type,       '', '',
 697         'taxengine_request', 'text', 'NULL', '', '', '',
 698
 699         'pending',     'char', 'NULL',  1, '', '',
 700       ],
 701       'primary_key'  => 'invnum',
 702       'unique'       => [ [ 'custnum', 'agent_invid' ] ], #agentnum?  huh
 703       'index'        => [ ['custnum'], ['_date'], ['statementnum'],
 704                           ['agent_invid'],
 705                         ],
 706       'foreign_keys' => [
 707                           { columns    => [ 'custnum' ],
 708                             table      => 'cust_main',
 709                           },
 710                           { columns    => [ 'statementnum' ],
 711                             table      => 'cust_statement',
 712                           },
 713                         ],
 714     },
 715
 716     'cust_bill_void' => {
 717       'columns' => [
 718         #regular fields
 719         'invnum',            'int',     '',      '', '', '',
 720         'custnum',           'int',     '',      '', '', '',
 721         '_date',        @date_type,                  '', '',
 722         'charged',     @money_type,                  '', '',
 723         'currency',         'char', 'NULL',       3, '', '',
 724         'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
 725
 726         #customer balance info at invoice generation time
 727         'previous_balance',   @money_typen, '', '',  #eventually not nullable
 728         'billing_balance',    @money_typen, '', '',  #eventually not nullable
 729
 730         #specific use cases
 731         'closed',      'char', 'NULL',  1, '', '', #not yet used much
 732         'statementnum', 'int', 'NULL', '', '', '', #invoice aggregate statements
 733         'agent_invid',  'int', 'NULL', '', '', '', #(varchar?) importing legacy
 734         'promised_date', @date_type,       '', '',
 735         'taxengine_request', 'text', 'NULL', '', '', '',
 736
 737         #void fields
 738         'void_date', @date_type, '', '',
 739         'reason',     'varchar', 'NULL', $char_d, '', '',
 740         'reasonnum',      'int', 'NULL',      '', '', '',
 741         'void_usernum',   'int', 'NULL',      '', '', '',
 742       ],
 743       'primary_key'  => 'invnum',
 744       'unique'       => [ [ 'custnum', 'agent_invid' ] ], #agentnum?  huh
 745       'index'        => [ ['custnum'], ['_date'], ['statementnum'],
 746                           ['agent_invid'], [ 'void_usernum' ],
 747                         ],
 748       'foreign_keys' => [
 749                           { columns    => [ 'custnum' ],
 750                             table      => 'cust_main',
 751                           },
 752                           { columns    => [ 'statementnum' ],
 753                             table      => 'cust_statement', #_void? both?
 754                           },
 755                           { columns    => [ 'reasonnum' ],
 756                             table      => 'reason',
 757                           },
 758                           { columns    => [ 'void_usernum' ],
 759                             table      => 'access_user',
 760                             references => [ 'usernum' ],
 761                           },
 762                         ],
 763     },
 764
 765     #for importing invoices from a legacy system for display purposes only
 766     # no effect upon balance
 767     'legacy_cust_bill' => {
 768       'columns' => [
 769         'legacyinvnum',  'serial',     '',      '', '', '',
 770         'legacyid',     'varchar', 'NULL', $char_d, '', '',
 771         'custnum',          'int',     '',      '', '', '',
 772         '_date',       @date_type,                  '', '',
 773         'charged',    @money_type,                  '', '',
 774         'currency',        'char', 'NULL',       3, '', '',
 775         'content_pdf',     'blob', 'NULL',      '', '', '',
 776         'content_html',    'text', 'NULL',      '', '', '',
 777         'locale',       'varchar', 'NULL',      16, '', '',
 778       ],
 779       'primary_key'  => 'legacyinvnum',
 780       'unique'       => [],
 781       'index'        => [ ['legacyid', 'custnum', 'locale' ], ],
 782       'foreign_keys' => [
 783                           { columns    => [ 'custnum' ],
 784                             table      => 'cust_main',
 785                           },
 786                         ],
 787     },
 788
 789     'legacy_cust_history' => {
 790       'columns' => [
 791         'legacyhistorynum', 'serial',     '',        '', '', '',
 792         'custnum',             'int',     '',        '', '', '',
 793         'history_action',  'varchar',     '',   $char_d, '', '',
 794         'history_date',           @date_type,            '', '',
 795         'history_usernum',     'int', 'NULL',        '', '', '',
 796         'item',            'varchar', 'NULL',   $char_d, '', '',
 797         'description',     'varchar', 'NULL', 2*$char_d, '', '',
 798         'change_data',        'text', 'NULL',        '', '', '',
 799       ],
 800       'primary_key'  => 'legacyhistorynum',
 801       'unique'       => [],
 802       'index'        => [ ['custnum'], ['history_date'], ],
 803       'foreign_keys' => [
 804                           { columns    => [ 'custnum' ],
 805                             table      => 'cust_main',
 806                           },
 807                           { columns    => [ 'history_usernum' ],
 808                             table      => 'access_user',
 809                             references => [ 'usernum' ],
 810                           },
 811                         ],
 812     },
 813
 814     'cust_statement' => {
 815       'columns' => [
 816         'statementnum', 'serial', '', '', '', '',
 817         'custnum',         'int', '', '', '', '',
 818         '_date',           @date_type,    '', '',
 819       ],
 820       'primary_key'  => 'statementnum',
 821       'unique'       => [],
 822       'index'        => [ ['custnum'], ['_date'], ],
 823       'foreign_keys' => [
 824                           { columns    => [ 'custnum' ],
 825                             table      => 'cust_main',
 826                           },
 827                         ],
 828     },
 829
 830     'part_event' => {
 831       'columns' => [
 832         'eventpart',   'serial',      '',      '', '', '',
 833         'agentnum',    'int',     'NULL',      '', '', '',
 834         'event',       'varchar',     '', $char_d, '', '',
 835         'eventtable',  'varchar',     '', $char_d, '', '',
 836         'check_freq',  'varchar', 'NULL', $char_d, '', '',
 837         'weight',      'int',         '',      '', '', '',
 838         'action',      'varchar',     '', $char_d, '', '',
 839         'disabled',     'char',   'NULL',       1, '', '',
 840       ],
 841       'primary_key'  => 'eventpart',
 842       'unique'       => [],
 843       'index'        => [ ['agentnum'], ['eventtable'], ['check_freq'],
 844                           ['disabled'],
 845                         ],
 846       'foreign_keys' => [
 847                           { columns    => [ 'agentnum' ],
 848                             table      => 'agent',
 849                           },
 850                         ],
 851     },
 852
 853     'part_event_option' => {
 854       'columns' => [
 855         'optionnum', 'serial', '', '', '', '',
 856         'eventpart', 'int', '', '', '', '',
 857         'optionname', 'varchar', '', $char_d, '', '',
 858         'optionvalue', 'text', 'NULL', '', '', '',
 859       ],
 860       'primary_key'  => 'optionnum',
 861       'unique'       => [],
 862       'index'        => [ [ 'eventpart' ], [ 'optionname' ] ],
 863       'foreign_keys' => [
 864                           { columns    => [ 'eventpart' ],
 865                             table      => 'part_event',
 866                           },
 867                         ],
 868     },
 869
 870     'part_event_condition' => {
 871       'columns' => [
 872         'eventconditionnum', 'serial', '', '', '', '',
 873         'eventpart', 'int', '', '', '', '',
 874         'conditionname', 'varchar', '', $char_d, '', '',
 875       ],
 876       'primary_key'  => 'eventconditionnum',
 877       'unique'       => [],
 878       'index'        => [ [ 'eventpart' ], [ 'conditionname' ] ],
 879       'foreign_keys' => [
 880                           { columns    => [ 'eventpart' ],
 881                             table      => 'part_event',
 882                           },
 883                         ],
 884     },
 885
 886     'part_event_condition_option' => {
 887       'columns' => [
 888         'optionnum', 'serial', '', '', '', '',
 889         'eventconditionnum', 'int', '', '', '', '',
 890         'optionname', 'varchar', '', $char_d, '', '',
 891         'optionvalue', 'text', 'NULL', '', '', '',
 892       ],
 893       'primary_key'  => 'optionnum',
 894       'unique'       => [],
 895       'index'        => [ [ 'eventconditionnum' ], [ 'optionname' ] ],
 896       'foreign_keys' => [
 897                           { columns    => [ 'eventconditionnum' ],
 898                             table      => 'part_event_condition',
 899                           },
 900                         ],
 901     },
 902
 903     'part_event_condition_option_option' => {
 904       'columns' => [
 905         'optionoptionnum', 'serial', '', '', '', '',
 906         'optionnum', 'int', '', '', '', '',
 907         'optionname', 'varchar', '', $char_d, '', '',
 908         'optionvalue', 'text', 'NULL', '', '', '',
 909       ],
 910       'primary_key'  => 'optionoptionnum',
 911       'unique'       => [],
 912       'index'        => [ [ 'optionnum' ], [ 'optionname' ] ],
 913       'foreign_keys' => [
 914                           { columns    => [ 'optionnum' ],
 915                             table      => 'part_event_condition_option',
 916                           },
 917                         ],
 918     },
 919
 920     'cust_event' => {
 921       'columns' => [
 922         'eventnum',    'serial',  '', '', '', '',
 923         'eventpart',   'int',  '', '', '', '',
 924         'tablenum',   'int',  '', '', '', '',
 925         '_date',     @date_type, '', '',
 926         'status', 'varchar', '', $char_d, '', '',
 927         'statustext', 'text', 'NULL', '', '', '',
 928         'no_action',  'char', 'NULL',  1, '', '',
 929       ],
 930       'primary_key'  => 'eventnum',
 931       #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
 932       'unique'       => [],
 933       'index'        => [ ['eventpart'], ['tablenum'], ['status'],
 934                           ['statustext'], ['_date'], ['no_action'],
 935                         ],
 936       'foreign_keys' => [
 937                           { columns    => [ 'eventpart' ],
 938                             table      => 'part_event',
 939                           },
 940                         ],
 941     },
 942
 943     'cust_event_fee' => {
 944       'columns' => [
 945         'eventfeenum', 'serial', '', '', '', '',
 946         'eventnum',       'int', '', '', '', '',
 947         'billpkgnum',     'int', 'NULL', '', '', '',
 948         'feepart',        'int', '', '', '', '',
 949         'nextbill',      'char', 'NULL',  1, '', '',
 950       ],
 951       'primary_key'  => 'eventfeenum', # I'd rather just use eventnum
 952       'unique' => [ [ 'billpkgnum' ], [ 'eventnum' ] ], # one-to-one link
 953       'index'  => [ [ 'feepart' ] ],
 954       'foreign_keys' => [
 955                           { columns => [ 'eventnum' ],
 956                             table   => 'cust_event',
 957                           },
 958                           #{ columns => [ 'billpkgnum' ],
 959                           #  table   => 'cust_bill_pkg',
 960                           #},
 961                           { columns => [ 'feepart' ],
 962                             table   => 'part_fee',
 963                           },
 964                         ],
 965     },
 966
 967     'cust_bill_pkg' => {
 968       'columns' => [
 969         'billpkgnum',          'serial',     '',      '', '', '',
 970         'invnum',                 'int',     '',      '', '', '',
 971         'pkgnum',                 'int',     '',      '', '', '',
 972         'pkgpart_override',       'int', 'NULL',      '', '', '',
 973         'setup',                 @money_type,             '', '',
 974         'unitsetup',             @money_typen,            '', '',
 975         'setup_billed_currency', 'char', 'NULL',       3, '', '',
 976         'setup_billed_amount',   @money_typen,            '', '',
 977         'recur',                 @money_type,             '', '',
 978         'unitrecur',             @money_typen,            '', '',
 979         'recur_billed_currency', 'char', 'NULL',       3, '', '',
 980         'recur_billed_amount',   @money_typen,            '', '',
 981         'sdate',                 @date_type,              '', '',
 982         'edate',                 @date_type,              '', '',
 983         'itemdesc',           'varchar', 'NULL', $char_d, '', '',
 984         'itemcomment',        'varchar', 'NULL', $char_d, '', '',
 985         'section',            'varchar', 'NULL', $char_d, '', '',
 986         'freq',               'varchar', 'NULL', $char_d, '', '',
 987         'quantity',               'int', 'NULL',      '', '', '',
 988         'hidden',                'char', 'NULL',       1, '', '',
 989         'feepart',                'int', 'NULL',      '', '', '',
 990       ],
 991       'primary_key'  => 'billpkgnum',
 992       'unique'       => [],
 993       'index'        => [ ['invnum'], [ 'pkgnum' ], [ 'itemdesc' ], ],
 994       'foreign_keys' => [
 995                           { columns    => [ 'invnum' ],
 996                             table      => 'cust_bill',
 997                           },
 998                           #pkgnum 0 and -1 are used for special things
 999                           #{ columns    => [ 'pkgnum' ],
1000                           #  table      => 'cust_pkg',
1001                           #},
1002                           { columns    => [ 'pkgpart_override' ],
1003                             table      => 'part_pkg',
1004                             references => [ 'pkgpart' ],
1005                           },
1006                           { columns    => [ 'feepart' ],
1007                             table      => 'part_fee',
1008                           },
1009                         ],
1010     },
1011
1012     'cust_bill_pkg_detail' => {
1013       'columns' => [
1014         'detailnum', 'serial', '', '', '', '',
1015           # bigserial? this table will eventually be as big as cdr...
1016         'billpkgnum', 'int', 'NULL', '', '', '',        # should not be nullable
1017         'pkgnum',  'int', 'NULL', '', '', '',           # deprecated
1018         'invnum',  'int', 'NULL', '', '', '',           # deprecated
1019         'amount',  'decimal', 'NULL', '10,4', '', '',
1020         'format',  'char', 'NULL', 1, '', '',
1021         'classnum', 'int', 'NULL', '', '', '',
1022         'duration', 'int', 'NULL', '',  0, '',
1023         'phonenum', 'varchar', 'NULL', 255, '', '', # has to hold a service label
1024         'accountcode', 'varchar',  'NULL',      32, '', '',
1025         'startdate',  @date_type, '', '',
1026         'regionname', 'varchar', 'NULL', $char_d, '', '',
1027         'detail',  'varchar', '', 255, '', '',
1028       ],
1029       'primary_key'  => 'detailnum',
1030       'unique'       => [],
1031       'index'        => [ [ 'billpkgnum' ], [ 'classnum' ],
1032                           [ 'pkgnum', 'invnum' ],
1033                         ],
1034       'foreign_keys' => [
1035                           { columns    => [ 'billpkgnum' ],
1036                             table      => 'cust_bill_pkg',
1037                           },
1038                           #{ columns    => [ 'pkgnum' ],
1039                           #  table      => 'cust_pkg',
1040                           #},
1041                           #{ columns    => [ 'invnum' ],
1042                           #  table      => 'cust_bill',
1043                           #},
1044                           { columns    => [ 'classnum' ],
1045                             table      => 'usage_class',
1046                           },
1047                         ],
1048     },
1049
1050     'cust_bill_pkg_display' => {
1051       'columns' => [
1052         'billpkgdisplaynum', 'serial', '', '', '', '',
1053         'billpkgnum', 'int', '', '', '', '',
1054         'section',  'varchar', 'NULL', $char_d, '', '',
1055         #'unitsetup', @money_typen, '', '',     #override the linked real one?
1056         #'unitrecur', @money_typen, '', '',     #this too?
1057         'post_total', 'char', 'NULL', 1, '', '',
1058         'type',       'char', 'NULL', 1, '', '',
1059         'summary',    'char', 'NULL', 1, '', '',
1060       ],
1061       'primary_key'  => 'billpkgdisplaynum',
1062       'unique'       => [],
1063       'index'        => [ ['billpkgnum'], ],
1064       'foreign_keys' => [
1065                           { columns    => [ 'billpkgnum' ],
1066                             table      => 'cust_bill_pkg',
1067                           },
1068                         ],
1069     },
1070
1071     'cust_bill_pkg_fee' => {
1072       'columns' => [
1073         'billpkgfeenum',    'serial', '', '', '', '',
1074         'billpkgnum',          'int', '', '', '', '',
1075         'base_invnum',       'int', '', '', '', '',
1076         'base_billpkgnum',   'int', 'NULL', '', '', '',
1077         'amount',        @money_type,         '', '',
1078       ],
1079       'primary_key' => 'billpkgfeenum',
1080       'unique'      => [],
1081       'index'       => [ ['billpkgnum'],
1082                          ['base_invnum'],
1083                          ['base_billpkgnum'],
1084                        ],
1085       'foreign_keys' => [
1086                           { columns     => [ 'billpkgnum' ],
1087                             table       => 'cust_bill_pkg',
1088                           },
1089                         ],
1090     },
1091
1092     'cust_bill_pkg_fee_void' => {
1093       'columns' => [
1094         'billpkgfeenum',    'serial', '', '', '', '',
1095         'billpkgnum',          'int', '', '', '', '',
1096         'base_invnum',       'int', '', '', '', '',
1097         'base_billpkgnum',   'int', 'NULL', '', '', '',
1098         'amount',        @money_type,         '', '',
1099       ],
1100       'primary_key' => 'billpkgfeenum',
1101       'unique'      => [],
1102       'index'       => [ ['billpkgnum'],
1103                          ['base_invnum'],
1104                          ['base_billpkgnum'],
1105                        ],
1106       'foreign_keys' => [
1107                           { columns     => [ 'billpkgnum' ],
1108                             table       => 'cust_bill_pkg_void',
1109                           },
1110                         ],
1111     },
1112
1113
1114     'cust_bill_pkg_tax_location' => {
1115       'columns' => [
1116         'billpkgtaxlocationnum', 'serial',     '',      '', '', '',
1117         'billpkgnum',               'int',     '',      '', '', '',
1118         'taxnum',                   'int',     '',      '', '', '',
1119         'taxtype',              'varchar',     '', $char_d, '', '',
1120         'pkgnum',                   'int',     '',      '', '', '', #redundant
1121         'locationnum',              'int',     '',      '', '', '', #redundant
1122         'amount',             @money_type,                  '', '',
1123         'currency',                'char', 'NULL',       3, '', '',
1124         'taxable_billpkgnum',       'int', 'NULL',      '', '', '',
1125       ],
1126       'primary_key'  => 'billpkgtaxlocationnum',
1127       'unique'       => [],
1128       'index'        => [ [ 'billpkgnum' ],
1129                           [ 'taxnum' ],
1130                           [ 'pkgnum' ],
1131                           [ 'locationnum' ],
1132                           [ 'taxable_billpkgnum' ],
1133                         ],
1134       'foreign_keys' => [
1135                           { columns    => [ 'billpkgnum' ],
1136                             table      => 'cust_bill_pkg',
1137                           },
1138                           #{ columns    => [ 'pkgnum' ],
1139                           #  table      => 'cust_pkg',
1140                           #}, # taxes can apply to fees
1141                           { columns    => [ 'locationnum' ],
1142                             table      => 'cust_location',
1143                           },
1144                           #{ columns    => [ 'taxable_billpkgnum' ],
1145                           #  table      => 'cust_bill_pkg',
1146                           #  references => [ 'billpkgnum' ],
1147                           #},
1148                         ],
1149     },
1150
1151     'cust_bill_pkg_tax_rate_location' => {
1152       'columns' => [
1153         'billpkgtaxratelocationnum', 'serial',      '',      '', '', '',
1154         'billpkgnum',                   'int',      '',      '', '', '',
1155         'taxnum',                       'int',      '',      '', '', '',
1156         'taxtype',                  'varchar',      '', $char_d, '', '',
1157         'locationtaxid',            'varchar',  'NULL', $char_d, '', '',
1158         'taxratelocationnum',           'int',      '',      '', '', '',
1159         'amount',                 @money_type,                   '', '',
1160         'currency',                    'char', 'NULL',        3, '', '',
1161         'taxable_billpkgnum',           'int', 'NULL',       '', '', '',
1162         'taxclass',                 'varchar', 'NULL',       10, '', '',
1163       ],
1164       'primary_key'  => 'billpkgtaxratelocationnum',
1165       'unique'       => [],
1166       'index'        => [ ['billpkgnum'], ['taxnum'], ['taxratelocationnum'],
1167                           ['taxable_billpkgnum'],
1168                         ],
1169       'foreign_keys' => [
1170                           { columns    => [ 'billpkgnum' ],
1171                             table      => 'cust_bill_pkg',
1172                           },
1173                           { columns    => [ 'taxratelocationnum' ],
1174                             table      => 'tax_rate_location',
1175                           },
1176                           #{ columns    => [ 'taxable_billpkgnum' ],
1177                           #  table      => 'cust_bill_pkg',
1178                           #  references => [ 'billpkgnum' ],
1179                           #},
1180                         ],
1181     },
1182
1183     'cust_bill_pkg_void' => {
1184       'columns' => [
1185         'billpkgnum',           'int',     '',      '', '', '',
1186         'invnum',               'int',     '',      '', '', '',
1187         'pkgnum',               'int',     '',      '', '', '',
1188         'pkgpart_override',     'int', 'NULL',      '', '', '',
1189         'setup',               @money_type,             '', '',
1190         'recur',               @money_type,             '', '',
1191         #XXX a currency for a line item?  or just one for the entire invoice
1192         #'currency',            'char', 'NULL',       3, '', '',
1193         'sdate',               @date_type,              '', '',
1194         'edate',               @date_type,              '', '',
1195         'itemdesc',         'varchar', 'NULL', $char_d, '', '',
1196         'itemcomment',      'varchar', 'NULL', $char_d, '', '',
1197         'section',          'varchar', 'NULL', $char_d, '', '',
1198         'freq',             'varchar', 'NULL', $char_d, '', '',
1199         'quantity',             'int', 'NULL',      '', '', '',
1200         'unitsetup',           @money_typen,            '', '',
1201         'unitrecur',           @money_typen,            '', '',
1202         'hidden',              'char', 'NULL',       1, '', '',
1203         'feepart',              'int', 'NULL',      '', '', '',
1204         #void fields
1205         'void_date', @date_type, '', '',
1206         'reason',     'varchar', 'NULL', $char_d, '', '',
1207         'reasonnum',      'int', 'NULL',      '', '', '',
1208         'void_usernum',   'int', 'NULL',      '', '', '',
1209       ],
1210       'primary_key'  => 'billpkgnum',
1211       'unique'       => [],
1212       'index'        => [ ['invnum'], ['pkgnum'], ['itemdesc'],
1213                           ['void_usernum'],
1214                         ],
1215       'foreign_keys' => [
1216                           { columns    => [ 'invnum' ],
1217                             table      => 'cust_bill_void',
1218                           },
1219                           { columns    => [ 'reasonnum' ],
1220                             table      => 'reason',
1221                           },
1222                           #pkgnum 0 and -1 are used for special things
1223                           #{ columns    => [ 'pkgnum' ],
1224                           #  table      => 'cust_pkg',
1225                           #},
1226                           { columns    => [ 'pkgpart_override' ],
1227                             table      => 'part_pkg',
1228                             references => [ 'pkgpart' ],
1229                           },
1230                           { columns    => [ 'void_usernum' ],
1231                             table      => 'access_user',
1232                             references => [ 'usernum' ],
1233                           },
1234                         ],
1235     },
1236
1237     'cust_bill_pkg_detail_void' => {
1238       'columns' => [
1239         'detailnum',  'int', '', '', '', '',
1240         'billpkgnum', 'int', 'NULL', '', '', '',        # should not be nullable
1241         'pkgnum',  'int', 'NULL', '', '', '',           # deprecated
1242         'invnum',  'int', 'NULL', '', '', '',           # deprecated
1243         'amount',  'decimal', 'NULL', '10,4', '', '',
1244         'format',  'char', 'NULL', 1, '', '',
1245         'classnum', 'int', 'NULL', '', '', '',
1246         'duration', 'int', 'NULL', '',  0, '',
1247         'phonenum', 'varchar', 'NULL', 255, '', '',
1248         'accountcode', 'varchar',  'NULL',      32, '', '',
1249         'startdate',  @date_type, '', '',
1250         'regionname', 'varchar', 'NULL', $char_d, '', '',
1251         'detail',  'varchar', '', 255, '', '',
1252       ],
1253       'primary_key'  => 'detailnum',
1254       'unique'       => [],
1255       'index'        => [ ['billpkgnum'], ['classnum'], ['pkgnum', 'invnum'] ],
1256       'foreign_keys' => [
1257                           { columns    => [ 'billpkgnum' ],
1258                             table      => 'cust_bill_pkg_void',
1259                           },
1260                           #{ columns    => [ 'pkgnum' ],
1261                           #  table      => 'cust_pkg',
1262                           #},
1263                           #{ columns    => [ 'invnum' ],
1264                           #  table      => 'cust_bill',
1265                           #},
1266                           { columns    => [ 'classnum' ],
1267                             table      => 'usage_class',
1268                           },
1269                         ],
1270     },
1271
1272     'cust_bill_pkg_display_void' => {
1273       'columns' => [
1274         'billpkgdisplaynum',    'int', '', '', '', '',
1275         'billpkgnum', 'int', '', '', '', '',
1276         'section',  'varchar', 'NULL', $char_d, '', '',
1277         #'unitsetup', @money_typen, '', '',     #override the linked real one?
1278         #'unitrecur', @money_typen, '', '',     #this too?
1279         'post_total', 'char', 'NULL', 1, '', '',
1280         'type',       'char', 'NULL', 1, '', '',
1281         'summary',    'char', 'NULL', 1, '', '',
1282       ],
1283       'primary_key'  => 'billpkgdisplaynum',
1284       'unique'       => [],
1285       'index'        => [ ['billpkgnum'], ],
1286       'foreign_keys' => [
1287                           { columns    => [ 'billpkgnum' ],
1288                             table      => 'cust_bill_pkg_void',
1289                           },
1290                         ],
1291     },
1292
1293     'cust_bill_pkg_tax_location_void' => {
1294       'columns' => [
1295         'billpkgtaxlocationnum',    'int',     '',      '', '', '',
1296         'billpkgnum',               'int',     '',      '', '', '',
1297         'taxnum',                   'int',     '',      '', '', '',
1298         'taxtype',              'varchar',     '', $char_d, '', '',
1299         'pkgnum',                   'int',     '',      '', '', '',
1300         'locationnum',              'int',     '',      '', '', '', #redundant?
1301         'amount',             @money_type,                  '', '',
1302         'currency',                'char', 'NULL',       3, '', '',
1303         'taxable_billpkgnum',       'int', 'NULL',      '', '', '',
1304       ],
1305       'primary_key'  => 'billpkgtaxlocationnum',
1306       'unique'       => [],
1307       'index'        => [ ['billpkgnum'], ['taxnum'], ['pkgnum'],
1308                           ['locationnum'],
1309                         ],
1310       'foreign_keys' => [
1311                           { columns    => [ 'billpkgnum' ],
1312                             table      => 'cust_bill_pkg_void',
1313                           },
1314                           { columns    => [ 'locationnum' ],
1315                             table      => 'cust_location',
1316                           },
1317                           #{ columns    => [ 'taxable_billpkgnum' ],
1318                           #  table      => 'cust_bill_pkg_void',
1319                           #  references => [ 'billpkgnum' ],
1320                           #},
1321                         ],
1322     },
1323
1324     'cust_bill_pkg_tax_rate_location_void' => {
1325       'columns' => [
1326         'billpkgtaxratelocationnum',    'int',     '',      '', '', '',
1327         'billpkgnum',                   'int',     '',      '', '', '',
1328         'taxnum',                       'int',     '',      '', '', '',
1329         'taxtype',                  'varchar',     '', $char_d, '', '',
1330         'locationtaxid',            'varchar', 'NULL', $char_d, '', '',
1331         'taxratelocationnum',           'int',     '',      '', '', '',
1332         'amount',                 @money_type,                  '', '',
1333         'currency',                    'char', 'NULL',       3, '', '',
1334       ],
1335       'primary_key'  => 'billpkgtaxratelocationnum',
1336       'unique'       => [],
1337       'index'        => [ ['billpkgnum'], ['taxnum'], ['taxratelocationnum'] ],
1338       'foreign_keys' => [
1339                           { columns    => [ 'billpkgnum' ],
1340                             table      => 'cust_bill_pkg_void',
1341                           },
1342                           { columns    => [ 'taxratelocationnum' ],
1343                             table      => 'tax_rate_location',
1344                           },
1345                         ],
1346     },
1347
1348     'cust_credit' => {
1349       'columns' => [
1350         'crednum',  'serial',     '', '', '', '',
1351         'custnum',     'int',     '', '', '', '',
1352         '_date',  @date_type,             '', '',
1353         'amount',@money_type,             '', '',
1354         'currency',   'char', 'NULL',  3, '', '',
1355         'otaker',  'varchar', 'NULL', 32, '', '',
1356         'usernum',     'int', 'NULL', '', '', '',
1357         'reason',     'text', 'NULL', '', '', '',
1358         'reasonnum',   'int', 'NULL', '', '', '',
1359         'addlinfo',   'text', 'NULL', '', '', '',
1360         'closed',     'char', 'NULL',  1, '', '',
1361         'pkgnum',      'int', 'NULL', '', '','',#desired pkgnum for pkg-balances
1362         'eventnum',    'int', 'NULL', '', '','',#triggering event for commission
1363         'commission_agentnum', 'int', 'NULL', '', '', '', #
1364         'commission_salesnum', 'int', 'NULL', '', '', '', #
1365         'commission_pkgnum',   'int', 'NULL', '', '', '', #
1366         'credbatch',    'varchar', 'NULL', $char_d, '', '',
1367       ],
1368       'primary_key'  => 'crednum',
1369       'unique'       => [],
1370       'index'        => [ ['custnum'], ['_date'], ['usernum'], ['eventnum'],
1371                           ['commission_salesnum'], ['credbatch'],
1372                         ],
1373       'foreign_keys' => [
1374                           { columns    => [ 'custnum' ],
1375                             table      => 'cust_main',
1376                           },
1377                           { columns    => [ 'usernum' ],
1378                             table      => 'access_user',
1379                           },
1380                           { columns    => [ 'reasonnum' ],
1381                             table      => 'reason',
1382                           },
1383                           { columns    => [ 'pkgnum' ],
1384                             table      => 'cust_pkg',
1385                           },
1386                           { columns    => [ 'eventnum' ],
1387                             table      => 'cust_event',
1388                           },
1389                           { columns    => [ 'commission_agentnum' ],
1390                             table      => 'agent',
1391                             references => [ 'agentnum' ],
1392                           },
1393                           { columns    => [ 'commission_salesnum' ],
1394                             table      => 'sales',
1395                             references => [ 'salesnum' ],
1396                           },
1397                           { columns    => [ 'commission_pkgnum' ],
1398                             table      => 'cust_pkg',
1399                             references => [ 'pkgnum' ],
1400                           },
1401                         ],
1402     },
1403
1404     'cust_credit_void' => {
1405       'columns' => [
1406         'crednum',  'serial',     '', '', '', '',
1407         'custnum',     'int',     '', '', '', '',
1408         '_date',  @date_type,             '', '',
1409         'amount',@money_type,             '', '',
1410         'currency',   'char', 'NULL',  3, '', '',
1411         'otaker',  'varchar', 'NULL', 32, '', '',
1412         'usernum',     'int', 'NULL', '', '', '',
1413         'reason',     'text', 'NULL', '', '', '',
1414         'reasonnum',   'int', 'NULL', '', '', '',
1415         'addlinfo',   'text', 'NULL', '', '', '',
1416         'closed',     'char', 'NULL',  1, '', '',
1417         'pkgnum',      'int', 'NULL', '', '','',
1418         'eventnum',    'int', 'NULL', '', '','',
1419         'commission_agentnum', 'int', 'NULL', '', '', '',
1420         'commission_salesnum', 'int', 'NULL', '', '', '',
1421         'commission_pkgnum',   'int', 'NULL', '', '', '',
1422         #void fields
1423         'void_date',  @date_type,                  '', '',
1424         'void_reason', 'varchar', 'NULL', $char_d, '', '',
1425         'void_reasonnum', 'int', 'NULL', '', '', '',
1426         'void_usernum',    'int', 'NULL',      '', '', '',
1427       ],
1428       'primary_key'  => 'crednum',
1429       'unique'       => [],
1430       'index'        => [ ['custnum'], ['_date'], ['usernum'], ['eventnum'],
1431                           ['commission_salesnum'],
1432                         ],
1433       'foreign_keys' => [
1434                           { columns    => [ 'custnum' ],
1435                             table      => 'cust_main',
1436                           },
1437                           { columns    => [ 'usernum' ],
1438                             table      => 'access_user',
1439                           },
1440                           { columns    => [ 'reasonnum' ],
1441                             table      => 'reason',
1442                           },
1443                           { columns    => [ 'pkgnum' ],
1444                             table      => 'cust_pkg',
1445                           },
1446                           { columns    => [ 'eventnum' ],
1447                             table      => 'cust_event',
1448                           },
1449                           { columns    => [ 'commission_agentnum' ],
1450                             table      => 'agent',
1451                             references => [ 'agentnum' ],
1452                           },
1453                           { columns    => [ 'commission_salesnum' ],
1454                             table      => 'sales',
1455                             references => [ 'salesnum' ],
1456                           },
1457                           { columns    => [ 'commission_pkgnum' ],
1458                             table      => 'cust_pkg',
1459                             references => [ 'pkgnum' ],
1460                           },
1461                           { columns    => [ 'void_reasonnum' ],
1462                             table      => 'reason',
1463                             references => [ 'reasonnum' ],
1464                           },
1465                           { columns    => [ 'void_usernum' ],
1466                             table      => 'access_user',
1467                             references => [ 'usernum' ],
1468                           },
1469                         ],
1470     },
1471
1472
1473     'cust_credit_bill' => {
1474       'columns' => [
1475         'creditbillnum', 'serial', '', '', '', '',
1476         'crednum',  'int', '', '', '', '',
1477         'invnum',  'int', '', '', '', '',
1478         '_date',    @date_type, '', '',
1479         'amount',   @money_type, '', '',
1480         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
1481       ],
1482       'primary_key'  => 'creditbillnum',
1483       'unique'       => [],
1484       'index'        => [ ['crednum'], ['invnum'] ],
1485       'foreign_keys' => [
1486                           { columns    => [ 'crednum' ],
1487                             table      => 'cust_credit',
1488                           },
1489                           { columns    => [ 'invnum' ],
1490                             table      => 'cust_bill',
1491                           },
1492                           { columns    => [ 'pkgnum' ],
1493                             table      => 'cust_pkg',
1494                           },
1495                         ],
1496     },
1497
1498     'cust_credit_bill_pkg' => {
1499       'columns' => [
1500         'creditbillpkgnum', 'serial', '',      '', '', '',
1501         'creditbillnum',       'int', '',      '', '', '',
1502         'billpkgnum',          'int', '',      '', '', '',
1503         'billpkgtaxlocationnum', 'int', 'NULL', '', '', '',
1504         'billpkgtaxratelocationnum', 'int', 'NULL', '', '', '',
1505         'amount',            @money_type,          '', '',
1506         'setuprecur',      'varchar', '', $char_d, '', '',
1507         'sdate',   @date_type, '', '',
1508         'edate',   @date_type, '', '',
1509       ],
1510       'primary_key'  => 'creditbillpkgnum',
1511       'unique'       => [],
1512       'index'        => [ [ 'creditbillnum' ],
1513                           [ 'billpkgnum' ],
1514                           [ 'billpkgtaxlocationnum' ],
1515                           [ 'billpkgtaxratelocationnum' ],
1516                         ],
1517       'foreign_keys' => [
1518                           { columns    => [ 'creditbillnum' ],
1519                             table      => 'cust_credit_bill',
1520                           },
1521                           { columns    => [ 'billpkgnum' ],
1522                             table      => 'cust_bill_pkg',
1523                           },
1524                           { columns    => [ 'billpkgtaxlocationnum' ],
1525                             table      => 'cust_bill_pkg_tax_location',
1526                           },
1527                           { columns    => [ 'billpkgtaxratelocationnum' ],
1528                             table      => 'cust_bill_pkg_tax_rate_location',
1529                           },
1530                         ],
1531     },
1532
1533     'cust_credit_source_bill_pkg' => {
1534       'columns' => [
1535         'creditsourcebillpkgnum', 'serial',     '', '', '', '',
1536         'crednum',                   'int',     '', '', '', '',
1537         'billpkgnum',                'int',     '', '', '', '',
1538         'amount',              @money_type,             '', '',
1539         'currency',                 'char', 'NULL',  3, '', '',
1540       ],
1541       'primary_key'  => 'creditsourcebillpkgnum',
1542       'unique'       => [],
1543       'index'        => [ ['crednum'], ['billpkgnum'] ],
1544       'foreign_keys' => [
1545                           { columns => ['billpkgnum'],
1546                             table   => 'cust_bill_pkg',
1547                           },
1548                           { columns => ['crednum'],
1549                             table   => 'cust_credit',
1550                           },
1551                         ],
1552     },
1553
1554     'cust_main' => {
1555       'columns' => [
1556         'custnum',  'serial',  '',     '', '', '',
1557         'agentnum', 'int',  '',     '', '', '',
1558         'salesnum', 'int',  'NULL', '', '', '',
1559         'agent_custid', 'varchar', 'NULL', $char_d, '', '',
1560         'classnum', 'int', 'NULL', '', '', '',
1561         'custbatch', 'varchar', 'NULL', $char_d, '', '',
1562 #        'titlenum', 'int',  'NULL',   '', '', '',
1563         'last',     'varchar', '',   2*$char_d, '', '',
1564 #        'middle',   'varchar', 'NULL', $char_d, '', '',
1565         'first',    'varchar', '',     $char_d, '', '',
1566         'ss',       'varchar', 'NULL', 11, '', '',
1567         'stateid', 'varchar', 'NULL', $char_d, '', '',
1568         'stateid_state', 'varchar', 'NULL', $char_d, '', '',
1569         'national_id', 'varchar', 'NULL', $char_d, '', '',
1570         'birthdate' ,@date_type, '', '',
1571         'spouse_last',  'varchar', 'NULL', 2*$char_d, '', '',
1572         'spouse_first', 'varchar', 'NULL', $char_d, '', '',
1573         'spouse_birthdate', @date_type, '', '',
1574         'anniversary_date', @date_type, '', '',
1575         'signupdate',@date_type, '', '',
1576         'dundate',   @date_type, '', '',
1577         'company',  'varchar', 'NULL', $char_d, '', '',
1578         'address1', 'varchar', 'NULL', $char_d, '', '',
1579         'address2', 'varchar', 'NULL', $char_d, '', '',
1580         'city',     'varchar', 'NULL', $char_d, '', '',
1581         'county',   'varchar', 'NULL', $char_d, '', '',
1582         'state',    'varchar', 'NULL', $char_d, '', '',
1583         'zip',      'varchar', 'NULL', 10, '', '',
1584         'country',  'char',    'NULL',  2, '', '',
1585         'latitude', 'decimal', 'NULL', '10,7', '', '',
1586         'longitude','decimal', 'NULL', '10,7', '', '',
1587         'coord_auto',  'char', 'NULL',  1, '', '',
1588         'addr_clean',  'char', 'NULL',  1, '', '',
1589         'daytime',  'varchar', 'NULL', 20, '', '',
1590         'night',    'varchar', 'NULL', 20, '', '',
1591         'fax',      'varchar', 'NULL', 12, '', '',
1592         'mobile',   'varchar', 'NULL', 12, '', '',
1593         'ship_last',     'varchar', 'NULL', 2*$char_d, '', '',
1594 #        'ship_middle',   'varchar', 'NULL', $char_d, '', '',
1595         'ship_first',    'varchar', 'NULL', $char_d, '', '',
1596         'ship_company',  'varchar', 'NULL', $char_d, '', '',
1597         'ship_address1', 'varchar', 'NULL', $char_d, '', '',
1598         'ship_address2', 'varchar', 'NULL', $char_d, '', '',
1599         'ship_city',     'varchar', 'NULL', $char_d, '', '',
1600         'ship_county',   'varchar', 'NULL', $char_d, '', '',
1601         'ship_state',    'varchar', 'NULL', $char_d, '', '',
1602         'ship_zip',      'varchar', 'NULL', 10, '', '',
1603         'ship_country',  'char', 'NULL', 2, '', '',
1604         'ship_latitude', 'decimal', 'NULL', '10,7', '', '',
1605         'ship_longitude','decimal', 'NULL', '10,7', '', '',
1606         'ship_coord_auto',  'char', 'NULL',  1, '', '',
1607         'ship_addr_clean',  'char', 'NULL',  1, '', '',
1608         'ship_daytime',  'varchar', 'NULL', 20, '', '',
1609         'ship_night',    'varchar', 'NULL', 20, '', '',
1610         'ship_fax',      'varchar', 'NULL', 12, '', '',
1611         'ship_mobile',   'varchar', 'NULL', 12, '', '',
1612         'currency',         'char', 'NULL',  3, '', '',
1613
1614         #deprecated, info moved to cust_payby
1615         'payby',    'char', 'NULL',     4, '', '',
1616         'payinfo',  'varchar', 'NULL', 512, '', '',
1617         'paycvv',   'varchar', 'NULL', 512, '', '',
1618         'paymask', 'varchar', 'NULL', $char_d, '', '',
1619         #'paydate',  @date_type, '', '',
1620         'paydate',  'varchar', 'NULL', 10, '', '',
1621         'paystart_month', 'int', 'NULL', '', '', '',
1622         'paystart_year',  'int', 'NULL', '', '', '',
1623         'payissue', 'varchar', 'NULL', 2, '', '',
1624         'payname',  'varchar', 'NULL', 2*$char_d, '', '',
1625         'paystate', 'varchar', 'NULL', $char_d, '', '',
1626         'paytype',  'varchar', 'NULL', $char_d, '', '',
1627         'payip',    'varchar', 'NULL', 15, '', '',
1628         'paycardtype', 'varchar', 'NULL',   $char_d, '', '',
1629
1630         'is_tokenized', 'char', 'NULL', '1', '', '',
1631
1632         'geocode',  'varchar', 'NULL', 20,  '', '',
1633         'censustract', 'varchar', 'NULL', 20,  '', '', # 7 to save space?
1634         'censusyear', 'char', 'NULL', 4, '', '',
1635         'district', 'varchar', 'NULL', 20, '', '',
1636         'tax',      'char', 'NULL', 1, '', '',
1637         'otaker',   'varchar', 'NULL',    32, '', '',
1638         'usernum',   'int', 'NULL', '', '', '',
1639         'refnum',   'int',  '',     '', '', '',
1640         'referral_custnum', 'int',  'NULL', '', '', '',
1641         'comments', 'text', 'NULL', '', '', '',
1642         'spool_cdr','char', 'NULL', 1, '', '',
1643         'squelch_cdr','char', 'NULL', 1, '', '',
1644         'cdr_termination_percentage', 'decimal', 'NULL', '7,4', '', '',
1645         'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
1646         'credit_limit', @money_typen, '', '',
1647         'credit_limit_currency', 'char', 'NULL',  3, '', '',
1648         'archived', 'char', 'NULL', 1, '', '',
1649         'email_csv_cdr', 'char', 'NULL', 1, '', '',
1650         'accountcode_cdr', 'char', 'NULL', 1, '', '',
1651         'billday',   'int', 'NULL', '', '', '',
1652         'prorate_day',   'int', 'NULL', '', '', '',
1653         'force_prorate_day', 'char', 'NULL', 1, '', '',
1654         'edit_subject', 'char', 'NULL', 1, '', '',
1655         'locale', 'varchar', 'NULL', 16, '', '',
1656         'calling_list_exempt', 'char', 'NULL', 1, '', '',
1657         'invoice_noemail', 'char', 'NULL', 1, '', '',
1658         'message_noemail', 'char', 'NULL', 1, '', '',
1659         'bill_locationnum', 'int', 'NULL', '', '', '',
1660         'ship_locationnum', 'int', 'NULL', '', '', '',
1661         'taxstatusnum',   'int', 'NULL', '', '', '',
1662         'complimentary', 'char', 'NULL', 1, '', '',
1663         'po_number', 'varchar', 'NULL', $char_d, '', '',
1664         'invoice_attn', 'varchar', 'NULL', $char_d, '', '',
1665         'invoice_ship_address', 'char', 'NULL', 1, '', '',
1666         'postal_invoice', 'char', 'NULL', 1, '', '',
1667         'paymentreceipt_noemail', 'char', 'NULL', 1, '', '',
1668       ],
1669       'primary_key'  => 'custnum',
1670       'unique'       => [ [ 'agentnum', 'agent_custid' ] ],
1671       #'index'        => [ ['last'], ['company'] ],
1672       'index'        => [
1673                           ['agentnum'], ['refnum'], ['classnum'], ['usernum'],
1674                           [ 'custbatch' ],
1675                           [ 'referral_custnum' ],
1676                           [ 'payby' ], [ 'paydate' ],
1677                           [ 'archived' ],
1678                           [ 'ship_locationnum' ],
1679                           [ 'bill_locationnum' ],
1680                           [ 'paycardtype' ],
1681                           [ 'is_tokenized' ],
1682                         ],
1683       'foreign_keys' => [
1684                           { columns    => [ 'agentnum' ],
1685                             table      => 'agent',
1686                           },
1687                           { columns    => [ 'salesnum' ],
1688                             table      => 'sales',
1689                           },
1690                           { columns    => [ 'refnum' ],
1691                             table      => 'part_referral',
1692                           },
1693                           { columns    => [ 'classnum' ],
1694                             table      => 'cust_class',
1695                           },
1696                           { columns    => [ 'usernum' ],
1697                             table      => 'access_user',
1698                           },
1699                           { columns    => [ 'referral_custnum' ],
1700                             table      => 'cust_main',
1701                             references => [ 'custnum' ],
1702                           },
1703                           { columns    => [ 'bill_locationnum' ],
1704                             table      => 'cust_location',
1705                             references => [ 'locationnum' ],
1706                           },
1707                           { columns    => [ 'ship_locationnum' ],
1708                             table      => 'cust_location',
1709                             references => [ 'locationnum' ],
1710                           },
1711                         ],
1712     },
1713
1714     'cust_payby' => {
1715       'columns' => [
1716         'custpaybynum', 'serial',     '',        '', '', '',
1717         'custnum',         'int',     '',        '', '', '',
1718         'weight',          'int', 'NULL',        '', '', '',
1719         'payby',          'char',     '',         4, '', '',
1720         'payinfo',     'varchar', 'NULL',       512, '', '',
1721         'paycardtype', 'varchar', 'NULL',   $char_d, '', '',
1722         'paycvv',      'varchar', 'NULL',       512, '', '',
1723         'paymask',     'varchar', 'NULL',   $char_d, '', '',
1724         #'paydate',   @date_type, '', '',
1725         'paydate',     'varchar', 'NULL',        10, '', '',
1726         'paystart_month',  'int', 'NULL',        '', '', '',
1727         'paystart_year',   'int', 'NULL',        '', '', '',
1728         'payissue',    'varchar', 'NULL',         2, '', '',
1729         'payname',     'varchar', 'NULL', 2*$char_d, '', '',
1730         'paystate',    'varchar', 'NULL',   $char_d, '', '',
1731         'paytype',     'varchar', 'NULL',   $char_d, '', '',
1732         'payip',       'varchar', 'NULL',        15, '', '',
1733         'locationnum',     'int', 'NULL',        '', '', '',
1734         'is_tokenized',   'char', 'NULL',         1, '', '',
1735       ],
1736       'primary_key'  => 'custpaybynum',
1737       'unique'       => [],
1738       'index'        => [ [ 'custnum' ], [ 'is_tokenized' ] ],
1739       'foreign_keys' => [
1740                           { columns    => [ 'custnum' ],
1741                             table      => 'cust_main',
1742                           },
1743                           { columns    => [ 'locationnum' ],
1744                             table      => 'cust_location',
1745                           },
1746                         ],
1747     },
1748
1749     'contact_class' => {
1750       'columns' => [
1751         'classnum',    'serial',   '',      '', '', '',
1752         'classname',   'varchar',  '', $char_d, '', '',
1753         'disabled',    'char', 'NULL',       1, '', '',
1754       ],
1755       'primary_key' => 'classnum',
1756       'unique' => [],
1757       'index' => [ ['disabled'] ],
1758     },
1759
1760     'cust_contact' => {
1761       'columns' => [
1762         'custcontactnum',     'serial',     '',  '', '', '',
1763         'custnum',               'int',     '',  '', '', '',
1764         'contactnum',            'int',     '',  '', '', '',
1765         'classnum',              'int', 'NULL',  '', '', '',
1766         'comment',           'varchar', 'NULL', 255, '', '',
1767         'selfservice_access',   'char', 'NULL',   1, '', '',
1768         'invoice_dest',         'char', 'NULL',   1, '', '', # Y or NULL
1769         'message_dest',         'char', 'NULL',   1, '', '', # Y or NULL
1770       ],
1771       'primary_key'  => 'custcontactnum',
1772       'unique'       => [ [ 'custnum', 'contactnum' ], ],
1773       'index'        => [ [ 'custnum' ], [ 'contactnum' ], ],
1774       'foreign_keys' => [
1775                           { columns    => [ 'custnum' ],
1776                             table      => 'cust_main',
1777                           },
1778                           { columns    => [ 'contactnum' ],
1779                             table      => 'contact',
1780                           },
1781                           { columns    => [ 'classnum' ],
1782                             table      => 'contact_class',
1783                           },
1784                         ],
1785     },
1786
1787     'prospect_contact' => {
1788       'columns' => [
1789         'prospectcontactnum', 'serial',     '',  '', '', '',
1790         'prospectnum',       'int',     '',  '', '', '',
1791         'contactnum',        'int',     '',  '', '', '',
1792         'classnum',          'int', 'NULL',  '', '', '',
1793         'comment',       'varchar', 'NULL', 255, '', '',
1794       ],
1795       'primary_key'  => 'prospectcontactnum',
1796       'unique'       => [ [ 'prospectnum', 'contactnum' ], ],
1797       'index'        => [ [ 'prospectnum' ], [ 'contactnum' ], ],
1798       'foreign_keys' => [
1799                           { columns    => [ 'prospectnum' ],
1800                             table      => 'prospect_main',
1801                           },
1802                           { columns    => [ 'contactnum' ],
1803                             table      => 'contact',
1804                           },
1805                           { columns    => [ 'classnum' ],
1806                             table      => 'contact_class',
1807                           },
1808                         ],
1809     },
1810
1811     'contact' => {
1812       'columns' => [
1813         'contactnum', 'serial',     '',      '', '', '',
1814         'prospectnum',   'int', 'NULL',      '', '', '', #deprecated, now prospect_contact table
1815         'custnum',       'int', 'NULL',      '', '', '', #deprecated, now cust_contact table
1816         'locationnum',   'int', 'NULL',      '', '', '', #not yet
1817         'classnum',      'int', 'NULL',      '', '', '', #deprecated, now prospect_contact or cust_contact
1818 #        'titlenum',      'int', 'NULL',      '', '', '', #eg Mr. Mrs. Dr. Rev.
1819         'last',      'varchar',     '', $char_d, '', '',
1820 #        'middle',    'varchar', 'NULL', $char_d, '', '',
1821         'first',     'varchar',     '', $char_d, '', '',
1822         'title',     'varchar', 'NULL', $char_d, '', '', #eg Head Bottle Washer
1823         'comment',   'varchar', 'NULL',     255, '', '',  #depredated, now prospect_contact or cust_contact
1824         'selfservice_access',    'char', 'NULL',       1, '', '', #deprecated, now cust_contact
1825         '_password',          'varchar', 'NULL', $char_d, '', '',
1826         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
1827         'disabled',              'char', 'NULL',       1, '', '',
1828         'invoice_dest',          'char', 'NULL',       1, '', '',
1829       ],
1830       'primary_key'  => 'contactnum',
1831       'unique'       => [],
1832       'index'        => [ [ 'prospectnum' ], [ 'custnum' ], [ 'locationnum' ],
1833                           [ 'last' ], [ 'first' ],
1834                         ],
1835       'foreign_keys' => [
1836                           { columns    => [ 'prospectnum' ],
1837                             table      => 'prospect_main',
1838                           },
1839                           { columns    => [ 'custnum' ],
1840                             table      => 'cust_main',
1841                           },
1842                           { columns    => [ 'locationnum' ],
1843                             table      => 'cust_location',
1844                           },
1845                           { columns    => [ 'classnum' ],
1846                             table      => 'contact_class',
1847                           },
1848                         ],
1849     },
1850
1851     'contact_phone' => {
1852       'columns' => [
1853         'contactphonenum', 'serial',     '', '', '', '',
1854         'contactnum',         'int',     '', '', '', '',
1855         'phonetypenum',       'int',     '', '', '', '',
1856         'countrycode',    'varchar',     '',  3, '', '',
1857         'phonenum',       'varchar',     '', 14, '', '',
1858         'extension',      'varchar', 'NULL',  7, '', '',
1859         #?#'comment',        'varchar',     '', $char_d, '', '',
1860       ],
1861       'primary_key'  => 'contactphonenum',
1862       'unique'       => [],
1863       'index'        => [],
1864       'foreign_keys' => [
1865                           { columns    => [ 'contactnum' ],
1866                             table      => 'contact',
1867                           },
1868                           { columns    => [ 'phonetypenum' ],
1869                             table      => 'phone_type',
1870                           },
1871                         ],
1872     },
1873
1874     'phone_type' => {
1875       'columns' => [
1876         'phonetypenum',  'serial', '',      '', '', '',
1877         'typename',     'varchar', '', $char_d, '', '',
1878         'weight',           'int', '',      '', '', '',
1879       ],
1880       'primary_key' => 'phonetypenum',
1881       'unique'      => [ [ 'typename' ], ],
1882       'index'       => [],
1883     },
1884
1885     'contact_email' => {
1886       'columns' => [
1887         'contactemailnum', 'serial', '',      '', '', '',
1888         'contactnum',         'int', '',      '', '', '',
1889         'emailaddress',   'varchar', '', $char_d, '', '',
1890       ],
1891       'primary_key'  => 'contactemailnum',
1892       #'unique'       => [ [ 'contactnum', 'emailaddress' ], ],
1893       'unique'       => [ [ 'emailaddress' ], ],
1894       'index'        => [],
1895       'foreign_keys' => [
1896                           { columns    => [ 'contactnum' ],
1897                             table      => 'contact',
1898                           },
1899                         ],
1900     },
1901
1902     'prospect_main' => {
1903       'columns' => [
1904         'prospectnum',  'serial',     '',      '', '', '',
1905         'agentnum',        'int',     '',      '', '', '',
1906         'company',     'varchar', 'NULL', $char_d, '', '',
1907         'add_date',   @date_type,                  '', '',
1908         'disabled',       'char', 'NULL',       1, '', '',
1909         'custnum',         'int', 'NULL',      '', '', '',
1910         'refnum',          'int', 'NULL',      '', '', '',
1911         'taxstatusnum',    'int', 'NULL',      '', '', '',
1912       ],
1913       'primary_key'  => 'prospectnum',
1914       'unique'       => [],
1915       'index'        => [ ['company'], ['agentnum'], ['disabled'], ['refnum'] ],
1916       'foreign_keys' => [
1917                           { columns    => [ 'agentnum' ],
1918                             table      => 'agent',
1919                           },
1920                           { columns    => [ 'custnum' ],
1921                             table      => 'cust_main',
1922                           },
1923                           { columns    => [ 'refnum' ],
1924                             table      => 'part_referral',
1925                           },
1926                         ],
1927     },
1928
1929     'quotation' => {
1930       'columns' => [
1931         #regular fields
1932         'quotationnum',           'serial',     '', '',   '', '',
1933         'prospectnum',               'int', 'NULL', '',   '', '',
1934         'custnum',                   'int', 'NULL', '',   '', '',
1935         '_date',                @date_type,               '', '',
1936         'disabled',                 'char', 'NULL',  1,   '', '',
1937         'usernum',                   'int', 'NULL', '',   '', '',
1938         'close_date',           @date_type,               '', '',
1939         'confidence',                'int', 'NULL', '',   '', '',
1940         'quotation_description', 'varchar', 'NULL', '50', '', '',
1941         #'total',      @money_type,       '', '',
1942         #'quotation_term', 'varchar', 'NULL', $char_d, '', '',
1943       ],
1944       'primary_key'  => 'quotationnum',
1945       'unique'       => [],
1946       'index'        => [ [ 'prospectnum' ], ['custnum'], ['disabled'], ],
1947       'foreign_keys' => [
1948                           { columns    => [ 'prospectnum' ],
1949                             table      => 'prospect_main',
1950                           },
1951                           { columns    => [ 'custnum' ],
1952                             table      => 'cust_main',
1953                           },
1954                           { columns    => [ 'usernum' ],
1955                             table      => 'access_user',
1956                           },
1957                         ],
1958     },
1959
1960     'quotation_pkg' => {
1961       'columns' => [
1962         'quotationpkgnum',   'serial',     '', '', '', '',
1963         'quotationnum',         'int', 'NULL', '', '', '', #shouldn't be null,
1964                                                            # but history...
1965         'pkgpart',              'int',     '', '', '', '',
1966         'locationnum',          'int', 'NULL', '', '', '',
1967         'start_date',      @date_type,             '', '',
1968         'contract_end',    @date_type,             '', '',
1969         'quantity',             'int', 'NULL', '', '', '',
1970         'waive_setup',         'char', 'NULL',  1, '', '',
1971         'unitsetup',     @money_typen,             '', '',
1972         'unitrecur',     @money_typen,             '', '',
1973       ],
1974       'primary_key'  => 'quotationpkgnum',
1975       'unique'       => [],
1976       'index'        => [ ['pkgpart'], ],
1977       'foreign_keys' => [
1978                           { columns    => [ 'quotationnum' ],
1979                             table      => 'quotation',
1980                           },
1981                           { columns    => [ 'pkgpart' ],
1982                             table      => 'part_pkg',
1983                           },
1984                           { columns    => [ 'locationnum' ],
1985                             table      => 'cust_location',
1986                           },
1987                         ],
1988     },
1989
1990     'quotation_pkg_detail' => {
1991       'columns' => [
1992         'detailnum', 'serial', '', '', '', '',
1993         'quotationpkgnum', 'int', '', '', '', '',
1994         'format',  'char', 'NULL', 1, '', '',       # not used for anything
1995         'detail',  'varchar', '', 255, '', '',
1996         'copy_on_order',        'char', 'NULL',  1, '', '', # 'Y' to copy when ordering
1997       ],
1998       'primary_key'  => 'detailnum',
1999       'unique'       => [],
2000       'index'        => [ [ 'quotationpkgnum' ] ],
2001       'foreign_keys' => [
2002                           { columns    => [ 'quotationpkgnum' ],
2003                             table      => 'quotation_pkg',
2004                             references => [ 'quotationpkgnum' ],
2005                           },
2006                         ],
2007     },
2008
2009     'quotation_pkg_discount' => {
2010       'columns' => [
2011         'quotationpkgdiscountnum', 'serial', '', '', '', '',
2012         'quotationpkgnum',            'int', '', '', '', '',
2013         'discountnum',                'int', '', '', '', '',
2014         'setuprecur',             'varchar', 'NULL', $char_d, '', '',
2015         'amount',              @money_typen, '', '',
2016         #'end_date',              @date_type,         '', '',
2017       ],
2018       'primary_key'  => 'quotationpkgdiscountnum',
2019       'unique'       => [],
2020       'index'        => [ [ 'quotationpkgnum' ], ], #[ 'discountnum' ] ],
2021       'foreign_keys' => [
2022                           { columns    => [ 'quotationpkgnum' ],
2023                             table      => 'quotation_pkg',
2024                           },
2025                           { columns    => [ 'discountnum' ],
2026                             table      => 'discount',
2027                           },
2028                         ],
2029     },
2030
2031     'quotation_pkg_tax' => {
2032       'columns' => [
2033         'quotationtaxnum',  'serial',     '',      '', '', '',
2034         'quotationpkgnum',     'int',     '',      '', '', '',
2035         'itemdesc',        'varchar',     '', $char_d, '', '',
2036         'setup_amount',    @money_type,                '', '',
2037         'recur_amount',    @money_type,                '', '',
2038       ],
2039       'primary_key' => 'quotationtaxnum',
2040       'unique' => [],
2041       'index'  => [ [ 'quotationpkgnum' ] ],
2042       'foreign_keys' => [
2043                           { columns    => [ 'quotationpkgnum' ],
2044                             table      => 'quotation_pkg',
2045                           },
2046                         ],
2047     },
2048
2049     'cust_location' => { #'location' now that its prospects too, but...
2050       'columns' => [
2051         'locationnum',      'serial',     '',      '', '', '',
2052         'prospectnum',         'int', 'NULL',      '', '', '',
2053         'custnum',             'int', 'NULL',      '', '', '',
2054         'locationname',    'varchar', 'NULL', $char_d, '', '',
2055         'address1',        'varchar',     '', $char_d, '', '',
2056         'address2',        'varchar', 'NULL', $char_d, '', '',
2057         'city',            'varchar', 'NULL', $char_d, '', '',
2058         'county',          'varchar', 'NULL', $char_d, '', '',
2059         'state',           'varchar', 'NULL', $char_d, '', '',
2060         'zip',             'varchar', 'NULL',      10, '', '',
2061         'latitude',        'decimal', 'NULL',  '10,7', '', '',
2062         'longitude',       'decimal', 'NULL',  '10,7', '', '',
2063         'coord_auto',         'char', 'NULL',       1, '', '',
2064         'addr_clean',         'char', 'NULL',       1, '', '',
2065         'country',            'char',     '',       2, '', '',
2066         'geocode',         'varchar', 'NULL',      20, '', '',
2067         'district',        'varchar', 'NULL',      20, '', '',
2068         'censustract',     'varchar', 'NULL',      20, '', '',
2069         'censusyear',         'char', 'NULL',       4, '', '',
2070
2071         #used only in... DSL qualification?  .CA DSL qualification?
2072         'location_type',   'varchar', 'NULL',      20, '', '',
2073         'location_number', 'varchar', 'NULL',      20, '', '',
2074         'location_kind',      'char', 'NULL',       1, '', '',
2075
2076         'incorporated',       'char', 'NULL',       1, '', '',
2077         'disabled',           'char', 'NULL',       1, '', '',
2078       ],
2079       'primary_key'  => 'locationnum',
2080       'unique'       => [],
2081       'index'        => [ [ 'prospectnum' ], [ 'custnum' ],
2082                           [ 'county' ], [ 'state' ], [ 'country' ], [ 'zip' ],
2083                           [ 'city' ], [ 'district' ]
2084                         ],
2085       'foreign_keys' => [
2086                           { columns    => [ 'prospectnum' ],
2087                             table      => 'prospect_main',
2088                           },
2089                           { columns    => [ 'custnum' ],
2090                             table      => 'cust_main',
2091                           },
2092                         ],
2093     },
2094
2095     'cust_main_invoice' => {
2096       'columns' => [
2097         'destnum',  'serial',  '',     '', '', '',
2098         'custnum',  'int',  '',     '', '', '',
2099         'dest',     'varchar', '',  $char_d, '', '',
2100       ],
2101       'primary_key'  => 'destnum',
2102       'unique'       => [],
2103       'index'        => [ ['custnum'], ],
2104       'foreign_keys' => [
2105                           { columns    => [ 'custnum' ],
2106                             table      => 'cust_main',
2107                           },
2108                         ],
2109     },
2110
2111     'cust_main_credit_limit' => {
2112       'columns' => [
2113         'creditlimitnum',   'serial', '', '', '', '',
2114         'custnum',             'int', '', '', '', '',
2115         '_date',          @date_type,         '', '',
2116         'amount',       @money_typen,         '', '',
2117         #'amount_currency', 'char', 'NULL',  3, '', '',
2118         'credit_limit', @money_typen,         '', '',
2119         #'credit_limit_currency', 'char', 'NULL',  3, '', '',
2120       ],
2121       'primary_key'  => 'creditlimitnum',
2122       'unique'       => [],
2123       'index'        => [ ['custnum'], ],
2124       'foreign_keys' => [
2125                           { columns    => [ 'custnum' ],
2126                             table      => 'cust_main',
2127                           },
2128                         ],
2129     },
2130
2131     'cust_main_note' => {
2132       'columns' => [
2133         'notenum',   'serial',    '',  '', '', '',
2134         'custnum',      'int',    '',  '', '', '',
2135         'classnum',     'int', 'NULL', '', '', '',
2136         '_date',          @date_type,      '', '',
2137         'otaker',   'varchar', 'NULL', 32, '', '',
2138         'usernum',      'int', 'NULL', '', '', '',
2139         'comments',    'text', 'NULL', '', '', '',
2140         'sticky',       'int',     '', '',  0, '',
2141       ],
2142       'primary_key'  => 'notenum',
2143       'unique'       => [],
2144       'index'        => [ [ 'custnum' ], [ '_date' ], [ 'usernum' ], ],
2145       'foreign_keys' => [
2146                           { columns    => [ 'custnum' ],
2147                             table      => 'cust_main',
2148                           },
2149                           { columns    => [ 'classnum' ],
2150                             table      => 'cust_note_class',
2151                           },
2152                           { columns    => [ 'usernum' ],
2153                             table      => 'access_user',
2154                           },
2155                         ],
2156     },
2157
2158     'cust_note_class' => {
2159       'columns' => [
2160         'classnum',    'serial',   '',      '', '', '',
2161         'classname',   'varchar',  '', $char_d, '', '',
2162         'disabled',    'char', 'NULL',       1, '', '',
2163       ],
2164       'primary_key' => 'classnum',
2165       'unique' => [],
2166       'index' => [ ['disabled'] ],
2167     },
2168
2169     'cust_category' => {
2170       'columns' => [
2171         'categorynum',   'serial',  '', '', '', '',
2172         'categoryname',  'varchar', '', $char_d, '', '',
2173         'weight',         'int', 'NULL',  '', '', '',
2174         'disabled',      'char', 'NULL',   1, '', '',
2175       ],
2176       'primary_key' => 'categorynum',
2177       'unique' => [],
2178       'index' => [ ['disabled'] ],
2179     },
2180
2181     'cust_class' => {
2182       'columns' => [
2183         'classnum',     'serial',     '',      '', '', '',
2184         'classname',   'varchar',     '', $char_d, '', '',
2185         'categorynum',     'int', 'NULL',      '', '', '',
2186         'tax',            'char', 'NULL',       1, '', '',
2187         'disabled',       'char', 'NULL',       1, '', '',
2188       ],
2189       'primary_key'  => 'classnum',
2190       'unique'       => [],
2191       'index'        => [ ['disabled'] ],
2192       'foreign_keys' => [
2193                           { columns    => [ 'categorynum' ],
2194                             table      => 'cust_category',
2195                           },
2196                         ],
2197     },
2198
2199     'cust_tag' => {
2200       'columns' => [
2201         'custtagnum', 'serial', '', '', '', '',
2202         'custnum',       'int', '', '', '', '',
2203         'tagnum',        'int', '', '', '', '',
2204       ],
2205       'primary_key'  => 'custtagnum',
2206       'unique'       => [ [ 'custnum', 'tagnum' ] ],
2207       'index'        => [ [ 'custnum' ] ],
2208       'foreign_keys' => [
2209                           { columns    => [ 'custnum' ],
2210                             table      => 'cust_main',
2211                           },
2212                           { columns    => [ 'tagnum' ],
2213                             table      => 'part_tag',
2214                           },
2215                         ],
2216     },
2217
2218     'part_tag' => {
2219       'columns' => [
2220         'tagnum',    'serial',     '',      '', '', '',
2221         'tagname',  'varchar',     '', $char_d, '', '',
2222         'tagdesc',  'varchar', 'NULL', $char_d, '', '',
2223         'tagcolor', 'varchar', 'NULL',       6, '', '',
2224         'by_default',  'char', 'NULL',       1, '', '',
2225         'disabled',    'char', 'NULL',       1, '', '',
2226       ],
2227       'primary_key' => 'tagnum',
2228       'unique'      => [], #[ [ 'tagname' ] ], #?
2229       'index'       => [ [ 'disabled' ] ],
2230     },
2231
2232     'cust_main_exemption' => {
2233       'columns' => [
2234         'exemptionnum',   'serial',     '',      '', '', '',
2235         'custnum',           'int',     '',      '', '', '',
2236         'taxname',       'varchar',     '', $char_d, '', '',
2237         'exempt_number', 'varchar', 'NULL', $char_d, '', '',
2238         #start/end dates?  for reporting?
2239       ],
2240       'primary_key'  => 'exemptionnum',
2241       'unique'       => [],
2242       'index'        => [ [ 'custnum' ] ],
2243       'foreign_keys' => [
2244                           { columns    => [ 'custnum' ],
2245                             table      => 'cust_main',
2246                           },
2247                         ],
2248     },
2249
2250     'cust_tax_adjustment' => {
2251       'columns' => [
2252         'adjustmentnum', 'serial',     '',      '', '', '',
2253         'custnum',          'int',     '',      '', '', '',
2254         'taxname',      'varchar',     '', $char_d, '', '',
2255         'amount',     @money_type,                  '', '',
2256         'currency',        'char', 'NULL',       3, '', '',
2257         'comment',      'varchar', 'NULL', $char_d, '', '',
2258         'billpkgnum',       'int', 'NULL',      '', '', '',
2259         #more?  no cust_bill_pkg_tax_location?
2260       ],
2261       'primary_key'  => 'adjustmentnum',
2262       'unique'       => [],
2263       'index'        => [ [ 'custnum' ], [ 'billpkgnum' ] ],
2264       'foreign_keys' => [
2265                           { columns    => [ 'custnum' ],
2266                             table      => 'cust_main',
2267                           },
2268                           { columns    => [ 'billpkgnum' ],
2269                             table      => 'cust_bill_pkg',
2270                           },
2271                         ],
2272     },
2273
2274     'cust_main_county' => { #district+city+county+state+country are checked
2275                             #off the cust_main_county for validation and to
2276                             #provide a tax rate.
2277       'columns' => [
2278         'taxnum',    'serial',     '',      '', '', '',
2279         'district', 'varchar', 'NULL',      20, '', '',
2280         'city',     'varchar', 'NULL', $char_d, '', '',
2281         'county',   'varchar', 'NULL', $char_d, '', '',
2282         'state',    'varchar', 'NULL', $char_d, '', '',
2283         'country',     'char',     '',       2, '', '',
2284         'taxclass', 'varchar', 'NULL', $char_d, '', '',
2285         'exempt_amount', @money_type,            '', '',
2286         'exempt_amount_currency', 'char', 'NULL', 3, '', '',
2287         'tax',         'real',     '',      '', '', '', #tax %
2288         'taxname',  'varchar', 'NULL', $char_d, '', '',
2289         'setuptax',    'char', 'NULL',       1, '', '', # Y = setup tax exempt
2290         'recurtax',    'char', 'NULL',       1, '', '', # Y = recur tax exempt
2291         'source',   'varchar', 'NULL', $char_d, '', '',
2292         'charge_prediscount', 'char', 'NULL', 1, '', '', # Y = charge this tax pre discount
2293       ],
2294       'primary_key' => 'taxnum',
2295       'unique' => [],
2296   #    'unique' => [ ['taxnum'], ['state', 'county'] ],
2297       'index' => [ [ 'district' ], [ 'city' ], [ 'county' ], [ 'state' ],
2298                    [ 'country' ],
2299                    [ 'taxclass' ],
2300                  ],
2301     },
2302
2303     'tax_rate'    => {
2304       'columns' => [
2305         'taxnum',       'serial',     '',      '', '', '',
2306         'geocode',     'varchar', 'NULL', $char_d, '', '',#cch provides 10 char
2307         'data_vendor', 'varchar', 'NULL', $char_d, '', '',#auto update source
2308         'location',    'varchar', 'NULL', $char_d, '', '',#provided by tax authority
2309         'taxclassnum', 'int',     'NULL',      '', '', '',
2310         'effective_date', @date_type, '', '',
2311         'tax',        @taxrate_type,      '', '',        # tax %
2312         'excessrate', @taxrate_typen,     '', '',        # second tax %
2313         'taxbase',    @money_typen, '', '',              # amount at first tax rate
2314         'taxmax',     @money_typen, '', '',              # maximum about at both rates
2315         'usetax',        @taxrate_typen,     '', '',     # tax % when non-local
2316         'useexcessrate', @taxrate_typen,     '', '',     # second tax % when non-local
2317         'unittype',    'int',  'NULL', '', '', '',      # for fee
2318         'fee',         @taxrate_typen,     '', '',      # amount tax per unit
2319         'excessfee',   @taxrate_typen,     '', '',      # second amount tax per unit
2320         'feebase',     @taxrate_typen,     '', '',      # units taxed at first rate
2321         'feemax',      @taxrate_typen,     '', '',      # maximum number of unit taxed
2322         'maxtype',     'int',  'NULL', '', '', '',      # indicator of how thresholds accumulate
2323         'taxname', 'varchar',  'NULL', $char_d, '', '', # may appear on invoice
2324         'taxauth',     'int',  'NULL', '', '', '',      # tax authority
2325         'basetype',    'int',  'NULL', '', '', '', # indicator of basis for tax
2326         'passtype',    'int',  'NULL', '', '', '', # indicator declaring how item should be shown
2327         'passflag',    'char', 'NULL', 1, '', '',  # Y = required to list as line item, N = Prohibited
2328         'setuptax',    'char', 'NULL', 1, '', '',  # Y = setup tax exempt
2329         'recurtax',    'char', 'NULL', 1, '', '',  # Y = recur tax exempt
2330         'inoutcity',   'char', 'NULL', 1, '', '',  # '', 'I', or 'O'
2331         'inoutlocal',  'char', 'NULL', 1, '', '',  # '', 'I', or 'O'
2332         'manual',      'char', 'NULL', 1, '', '',  # Y = manually edited
2333         'disabled',    'char', 'NULL', 1, '', '',  # Y = tax disabled
2334       ],
2335       'primary_key'  => 'taxnum',
2336       'unique'       => [],
2337       'index'        => [ ['taxclassnum'], ['data_vendor', 'geocode'] ],
2338       'foreign_keys' => [
2339                           { columns    => [ 'taxclassnum' ],
2340                             table      => 'tax_class',
2341                           },
2342                         ],
2343     },
2344
2345     'tax_rate_location' => {
2346       'columns' => [
2347         'taxratelocationnum', 'serial',  '',     '', '', '',
2348         'data_vendor',        'varchar', 'NULL', $char_d, '', '',
2349         'geocode',            'varchar', '',     20,      '', '',
2350         'district',           'varchar', 'NULL', $char_d, '', '',
2351         'city',               'varchar', 'NULL', $char_d, '', '',
2352         'county',             'varchar', 'NULL', $char_d, '', '',
2353         'state',              'char',    'NULL',       2, '', '',
2354         'country',            'char',    'NULL',       2, '', '',
2355         'disabled',           'char',    'NULL', 1, '', '',
2356       ],
2357       'primary_key' => 'taxratelocationnum',
2358       'unique' => [],
2359       'index' => [ [ 'data_vendor', 'geocode', 'disabled' ] ],
2360     },
2361
2362     'cust_tax_location' => {
2363       'columns' => [
2364         'custlocationnum', 'serial',  '',     '', '', '',
2365         'data_vendor',     'varchar', 'NULL', $char_d, '', '', # update source
2366         'city',            'varchar', 'NULL', $char_d, '', '',
2367         'postalcity',      'varchar', 'NULL', $char_d, '', '',
2368         'county',          'varchar', 'NULL', $char_d, '', '',
2369         'zip',             'char',    'NULL', 5,  '', '',
2370         'state',           'char',    '',     2,  '', '',
2371         'country',         'char',    'NULL', 2,  '', '', # should not actually be NULL, but cch...
2372         'ziphi',           'char',    'NULL', 10, '', '',
2373         'ziplo',           'char',    'NULL', 10, '', '',
2374         'plus4hi',         'char',    'NULL', 4,  '', '',
2375         'plus4lo',         'char',    'NULL', 4,  '', '',
2376         'default_location','char',    'NULL', 1,  '', '', # Y = default for zip
2377         'cityflag',        'char',    'NULL', 1,  '', '', # I(n)/O(out)/B(oth)/NULL
2378         'geocode',         'varchar', '',    20,  '', '',
2379       ],
2380       'primary_key' => 'custlocationnum',
2381       'unique' => [],
2382       'index' => [ [ 'zip', 'plus4lo', 'plus4hi', 'ziphi', 'ziplo' ] ],
2383     },
2384
2385     'tax_class' => {
2386       'columns' => [
2387         'taxclassnum',  'serial',  '',            '', '', '',
2388         'data_vendor',  'varchar', 'NULL',   $char_d, '', '',
2389         'taxclass',     'varchar', '',       $char_d, '', '',
2390         'description',  'varchar', '',     2*$char_d, '', '',
2391       ],
2392       'primary_key' => 'taxclassnum',
2393       'unique' => [ [ 'data_vendor', 'taxclass' ] ],
2394       'index' => [],
2395     },
2396
2397     'tax_status' => {
2398       'columns' => [
2399         'taxstatusnum', 'serial', '',             '', '', '',
2400         'data_vendor',  'varchar', 'NULL',   $char_d, '', '',
2401         'taxstatus',    'varchar', '',       $char_d, '', '',
2402         'description',  'varchar', '',       $char_d, '', '',
2403       ],
2404       'primary_key' => 'taxstatusnum',
2405       'unique'      => [ [ 'data_vendor', 'taxstatus' ] ],
2406       'index' => [],
2407     },
2408
2409     'cust_pay_pending' => {
2410       'columns' => [
2411         'paypendingnum',      'serial',     '',      '', '', '',
2412         'custnum',               'int', 'NULL',      '', '', '',
2413         'paid',            @money_type,                  '', '',
2414         'currency',             'char', 'NULL',       3, '', '',
2415         '_date',            @date_type,                  '', '',
2416         'payby',                'char',     '',       4, '', '',
2417         'payinfo',           'varchar', 'NULL',     512, '', '',
2418         'paymask',           'varchar', 'NULL', $char_d, '', '',
2419         'paydate',           'varchar', 'NULL',     10, '', '',
2420         'recurring_billing', 'varchar', 'NULL', $char_d, '', '',
2421         'payunique',         'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
2422
2423         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
2424         'status',       'varchar',     '', $char_d, '', '',
2425         'session_id',   'varchar', 'NULL', 1024, '', '', # SHA-512-hex
2426         'statustext',   'text',    'NULL',  '', '', '',
2427         'gatewaynum',   'int',     'NULL',  '', '', '',
2428         #'cust_balance', @money_type,            '', '',
2429         'paynum',       'int',     'NULL',  '', '', '',
2430         'void_paynum',  'int',     'NULL',  '', '', '',
2431         'jobnum',    'bigint',     'NULL',  '', '', '',
2432         'invnum',       'int',     'NULL',  '', '', '',
2433         'manual',       'char',    'NULL',   1, '', '',
2434         'discount_term','int',     'NULL',  '', '', '',
2435         'failure_status','varchar','NULL',  16, '', '',
2436         'is_tokenized',   'char', 'NULL',    1, '', '',
2437       ],
2438       'primary_key'  => 'paypendingnum',
2439       'unique'       => [ [ 'payunique' ] ],
2440       'index'        => [ [ 'custnum' ], [ 'status' ],
2441                           ['paynum'], ['void_paynum'], ['jobnum'], ['invnum'],
2442                           [ 'is_tokenized' ],
2443                         ],
2444       'foreign_keys' => [
2445                           { columns    => [ 'custnum' ],
2446                             table      => 'cust_main',
2447                           },
2448                           { columns    => [ 'pkgnum' ],
2449                             table      => 'cust_pkg',
2450                           },
2451                           { columns    => [ 'gatewaynum' ],
2452                             table      => 'payment_gateway',
2453                           },
2454                           { columns    => [ 'paynum' ],
2455                             table      => 'cust_pay',
2456                           },
2457                           { columns    => [ 'void_paynum' ],
2458                             table      => 'cust_pay_void',
2459                             references => [ 'paynum' ],
2460                           },
2461                           { columns    => [ 'jobnum' ],
2462                             table      => 'queue',
2463                           },
2464                           { columns    => [ 'invnum' ],
2465                             table      => 'cust_bill',
2466                           },
2467                         ],
2468     },
2469
2470     'cust_pay' => {
2471       'columns' => [
2472         'paynum',       'serial',    '',       '', '', '',
2473         'custnum',         'int',    '',       '', '', '',
2474         '_date',     @date_type,                   '', '',
2475         'paid',      @money_type,                  '', '',
2476         'currency',       'char', 'NULL',       3, '', '',
2477         'otaker',      'varchar', 'NULL',      32, '', '',
2478         'usernum',         'int', 'NULL',      '', '', '',
2479         'payby',          'char',     '',       4, '', '',
2480         'payinfo',     'varchar', 'NULL',     512, '', '',
2481         'paycardtype', 'varchar', 'NULL',   $char_d, '', '',
2482         'paymask',     'varchar', 'NULL', $char_d, '', '',
2483         'paydate',     'varchar', 'NULL',      10, '', '',
2484         'paybatch',    'varchar', 'NULL', $char_d, '', '',#for auditing purposes
2485         'payunique',   'varchar', 'NULL', $char_d, '', '',#separate paybatch "unique" functions from current usage
2486         'closed',         'char', 'NULL',       1, '', '',
2487         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
2488         'no_auto_apply',  'char', 'NULL',       1, '', '',
2489         'is_tokenized',   'char', 'NULL',       1, '', '',
2490
2491         # cash/check deposit info fields
2492         'bank',        'varchar', 'NULL', $char_d, '', '',
2493         'depositor',   'varchar', 'NULL', $char_d, '', '',
2494         'account',     'varchar', 'NULL',      20, '', '',
2495         'teller',      'varchar', 'NULL',      20, '', '',
2496
2497         'batchnum',        'int', 'NULL',      '', '', '',#pay_batch foreign key
2498
2499         # credit card/EFT fields (formerly in paybatch)
2500         'gatewaynum',      'int', 'NULL',      '', '', '', # payment_gateway FK
2501         'processor',   'varchar', 'NULL', $char_d, '', '', # module name
2502         'auth',        'varchar', 'NULL',      16, '', '', # CC auth number
2503         'order_number','varchar', 'NULL', 256, '', '', # transaction number
2504       ],
2505       'primary_key'  => 'paynum',
2506       #i guess not now, with cust_pay_pending, if we actually make it here, we _do_ want to record it# 'unique' => [ [ 'payunique' ] ],
2507       'index'        => [ ['custnum'], ['paybatch'], ['payby'], ['_date'],
2508                           ['usernum'], ['is_tokenized'],
2509                         ],
2510       'foreign_keys' => [
2511                           { columns    => [ 'custnum' ],
2512                             table      => 'cust_main',
2513                           },
2514                           { columns    => [ 'usernum' ],
2515                             table      => 'access_user',
2516                           },
2517                           { columns    => [ 'pkgnum' ],
2518                             table      => 'cust_pkg',
2519                           },
2520                           { columns    => [ 'batchnum' ],
2521                             table      => 'pay_batch',
2522                           },
2523                           { columns    => [ 'gatewaynum' ],
2524                             table      => 'payment_gateway',
2525                           },
2526                         ],
2527     },
2528
2529     'cust_pay_void' => {
2530       'columns' => [
2531         'paynum',          'int',    '',       '', '', '',
2532         'custnum',         'int',    '',       '', '', '',
2533         '_date',      @date_type,                  '', '',
2534         'paid',      @money_type,                  '', '',
2535         'currency',       'char', 'NULL',       3, '', '',
2536         'otaker',      'varchar', 'NULL',      32, '', '',
2537         'usernum',         'int', 'NULL',      '', '', '',
2538         'payby',          'char',     '',       4, '', '',
2539         'payinfo',     'varchar', 'NULL',     512, '', '',
2540         'paycardtype', 'varchar', 'NULL',   $char_d, '', '',
2541         'paymask',     'varchar', 'NULL', $char_d, '', '',
2542         #'paydate' ?
2543         'paybatch',    'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
2544         'closed',        'char',  'NULL',       1, '', '',
2545         'pkgnum', 'int',   'NULL', '', '', '', #desired pkgnum for pkg-balances
2546         'is_tokenized',   'char', 'NULL',       1, '', '',
2547
2548         # cash/check deposit info fields
2549         'bank',       'varchar', 'NULL', $char_d, '', '',
2550         'depositor',  'varchar', 'NULL', $char_d, '', '',
2551         'account',    'varchar', 'NULL',      20, '', '',
2552         'teller',     'varchar', 'NULL',      20, '', '',
2553         'batchnum',       'int', 'NULL',      '', '', '', #pay_batch foreign key
2554
2555         # credit card/EFT fields (formerly in paybatch)
2556         'gatewaynum',      'int', 'NULL',      '', '', '', # payment_gateway FK
2557         'processor',   'varchar', 'NULL', $char_d, '', '', # module name
2558         'auth',        'varchar', 'NULL',      16, '', '', # CC auth number
2559         'order_number','varchar', 'NULL', 256, '', '', # transaction number
2560
2561         #void fields
2562         'void_date',  @date_type,                  '', '',
2563         'reason',      'varchar', 'NULL', $char_d, '', '',
2564         'reasonnum',       'int', 'NULL',      '', '', '',
2565         'void_usernum',    'int', 'NULL',      '', '', '',
2566       ],
2567       'primary_key'  => 'paynum',
2568       'unique'       => [],
2569       'index'        => [ ['custnum'], ['usernum'], ['void_usernum'],
2570                           ['is_tokenized'],
2571                         ],
2572       'foreign_keys' => [
2573                           { columns    => [ 'custnum' ],
2574                             table      => 'cust_main',
2575                           },
2576                           { columns    => [ 'usernum' ],
2577                             table      => 'access_user',
2578                           },
2579                           { columns    => [ 'pkgnum' ],
2580                             table      => 'cust_pkg',
2581                           },
2582                           { columns    => [ 'batchnum' ],
2583                             table      => 'pay_batch',
2584                           },
2585                           { columns    => [ 'gatewaynum' ],
2586                             table      => 'payment_gateway',
2587                           },
2588                           { columns    => [ 'reasonnum' ],
2589                             table      => 'reason',
2590                           },
2591                           { columns    => [ 'void_usernum' ],
2592                             table      => 'access_user',
2593                             references => [ 'usernum' ],
2594                           },
2595                         ],
2596     },
2597
2598     'cust_bill_pay' => {
2599       'columns' => [
2600         'billpaynum', 'serial',     '',   '', '', '',
2601         'invnum',  'int',     '',   '', '', '',
2602         'paynum',  'int',     '',   '', '', '',
2603         'amount',  @money_type, '', '',
2604         '_date',   @date_type, '', '',
2605         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
2606       ],
2607       'primary_key'  => 'billpaynum',
2608       'unique'       => [],
2609       'index'        => [ [ 'paynum' ], [ 'invnum' ] ],
2610       'foreign_keys' => [
2611                           { columns    => [ 'invnum' ],
2612                             table      => 'cust_bill',
2613                           },
2614                           { columns    => [ 'paynum' ],
2615                             table      => 'cust_pay',
2616                           },
2617                           { columns    => [ 'pkgnum' ],
2618                             table      => 'cust_pkg',
2619                           },
2620                         ],
2621     },
2622
2623     'cust_bill_pay_batch' => {
2624       'columns' => [
2625         'billpaynum', 'serial',     '',   '', '', '',
2626         'invnum',  'int',     '',   '', '', '',
2627         'paybatchnum',  'int',     '',   '', '', '',
2628         'amount',  @money_type, '', '',
2629         '_date',   @date_type, '', '',
2630       ],
2631       'primary_key'  => 'billpaynum',
2632       'unique'       => [],
2633       'index'        => [ [ 'paybatchnum' ], [ 'invnum' ] ],
2634       'foreign_keys' => [
2635                           { columns    => [ 'invnum' ],
2636                             table      => 'cust_bill',
2637                           },
2638                           { columns    => [ 'paybatchnum' ],
2639                             table      => 'cust_pay_batch',
2640                           },
2641                         ],
2642     },
2643
2644     'cust_bill_pay_pkg' => {
2645       'columns' => [
2646         'billpaypkgnum', 'serial', '', '', '', '',
2647         'billpaynum',       'int', '', '', '', '',
2648         'billpkgnum',       'int', '', '', '', '',
2649         'billpkgtaxlocationnum', 'int', 'NULL', '', '', '',
2650         'billpkgtaxratelocationnum', 'int', 'NULL', '', '', '',
2651         'amount',         @money_type,     '', '',
2652         'setuprecur',      'varchar', '', $char_d, '', '',
2653         'sdate',   @date_type, '', '',
2654         'edate',   @date_type, '', '',
2655       ],
2656       'primary_key'  => 'billpaypkgnum',
2657       'unique'       => [],
2658       'index'        => [ [ 'billpaynum' ], [ 'billpkgnum' ], ],
2659       'foreign_keys' => [
2660                           { columns    => [ 'billpaynum' ],
2661                             table      => 'cust_bill_pay',
2662                           },
2663                           { columns    => [ 'billpkgnum' ],
2664                             table      => 'cust_bill_pkg',
2665                           },
2666                           { columns    => [ 'billpkgtaxlocationnum' ],
2667                             table      => 'cust_bill_pkg_tax_location',
2668                           },
2669                           { columns    => [ 'billpkgtaxratelocationnum' ],
2670                             table      => 'cust_bill_pkg_tax_rate_location',
2671                           },
2672                         ],
2673     },
2674
2675     'pay_batch' => { #batches of payments to an external processor
2676       'columns' => [
2677         'batchnum', 'serial',     '', '', '', '',
2678         'agentnum',    'int', 'NULL', '', '', '',
2679         'payby',      'char',     '',  4, '', '', # CARD/CHEK
2680         'status',     'char', 'NULL',  1, '', '',
2681         'download',       @date_type,     '', '',
2682         'upload',         @date_type,     '', '',
2683         'title',   'varchar', 'NULL',255, '', '',
2684         'processor_id',   'varchar', 'NULL',255, '', '',
2685         'type',      'char',  '',  6, 'DEBIT', '', # DEBIT/CREDIT
2686       ],
2687       'primary_key'  => 'batchnum',
2688       'unique'       => [],
2689       'index'        => [],
2690       'foreign_keys' => [
2691                           { columns    => [ 'agentnum' ],
2692                             table      => 'agent',
2693                           },
2694                         ],
2695     },
2696
2697     'cust_pay_batch' => { #list of customers in current CARD/CHEK batch
2698       'columns' => [
2699         'paybatchnum',    'serial',     '',      '', '', '',
2700         'batchnum',          'int',     '',      '', '', '',
2701         'invnum',            'int',     '',      '', '', '',
2702         'custnum',           'int',     '',      '', '', '',
2703         'last',          'varchar',     '', $char_d, '', '',
2704         'first',         'varchar',     '', $char_d, '', '',
2705         'address1',      'varchar',     '', $char_d, '', '',
2706         'address2',      'varchar', 'NULL', $char_d, '', '',
2707         'city',          'varchar', 'NULL', $char_d, '', '',
2708         'state',         'varchar', 'NULL', $char_d, '', '',
2709         'zip',           'varchar', 'NULL',      10, '', '',
2710         'country',          'char',     '',       2, '', '',
2711         'payby',            'char',     '',       4, '', '',
2712         'payinfo',       'varchar', 'NULL',     512, '', '',
2713         #'exp',          @date_type,                  '', '',
2714         'exp',           'varchar', 'NULL',      11, '', '',
2715         'payname',       'varchar', 'NULL', $char_d, '', '',
2716         'paytype',       'varchar', 'NULL', $char_d, '', '',
2717         'amount',      @money_type,                  '', '',
2718         'currency',         'char', 'NULL',       3, '', '',
2719         'status',        'varchar', 'NULL', $char_d, '', '',
2720         'failure_status','varchar', 'NULL',      16, '', '',
2721         'error_message', 'varchar', 'NULL', $char_d, '', '',
2722         'paycode',       'varchar', 'NULL', $char_d, '', '',
2723       ],
2724       'primary_key'  => 'paybatchnum',
2725       'unique'       => [],
2726       'index'        => [ ['batchnum'], ['invnum'], ['custnum'],['status'] ],
2727       'foreign_keys' => [
2728                           { columns    => [ 'batchnum' ],
2729                             table      => 'pay_batch',
2730                           },
2731                           #{ columns    => [ 'invnum' ],
2732                           #  table      => 'cust_bill',
2733                           #},
2734                           { columns    => [ 'custnum' ],
2735                             table      => 'cust_main',
2736                           },
2737                         ],
2738     },
2739
2740     'fcc477map' => {
2741       'columns' => [
2742         'formkey',   'varchar',     '', 255, '', '',
2743         'formvalue',    'text', 'NULL',  '', '', '',
2744       ],
2745       'primary_key' => 'formkey',
2746       'unique'      => [],
2747       'index'       => [],
2748     },
2749
2750     'cust_pkg' => {
2751       'columns' => [
2752         'pkgnum',           'serial',     '', '', '', '',
2753         'custnum',             'int',     '', '', '', '',
2754         'pkgpart',             'int',     '', '', '', '',
2755         'pkgbatch',        'varchar', 'NULL', $char_d, '', '',
2756         'contactnum',          'int', 'NULL', '', '', '',
2757         'locationnum',         'int', 'NULL', '', '', '',
2758         'otaker',          'varchar', 'NULL', 32, '', '',
2759         'usernum',             'int', 'NULL', '', '', '',
2760         'salesnum',            'int', 'NULL', '', '', '',
2761         'order_date',     @date_type,             '', '',
2762         'start_date',     @date_type,             '', '',
2763         'setup',          @date_type,             '', '',
2764         'bill',           @date_type,             '', '',
2765         'last_bill',      @date_type,             '', '',
2766         'susp',           @date_type,             '', '',
2767         'adjourn',        @date_type,             '', '',
2768         'resume',         @date_type,             '', '',
2769         'cancel',         @date_type,             '', '',
2770         'uncancel',       @date_type,             '', '',
2771         'uncancel_pkgnum',     'int', 'NULL', '', '', '',
2772         'expire',         @date_type,             '', '',
2773         'contract_end',   @date_type,             '', '',
2774         'dundate',        @date_type,             '', '',
2775         'change_date',    @date_type,             '', '',
2776         'change_pkgnum',       'int', 'NULL', '', '', '',
2777         'change_pkgpart',      'int', 'NULL', '', '', '',
2778         'change_locationnum',  'int', 'NULL', '', '', '',
2779         'change_custnum',      'int', 'NULL', '', '', '',
2780         'main_pkgnum',         'int', 'NULL', '', '', '',
2781         'pkglinknum',          'int', 'NULL', '', '', '',
2782         'manual_flag',        'char', 'NULL',  1, '', '',
2783         'no_auto',            'char', 'NULL',  1, '', '',
2784         'quantity',            'int', 'NULL', '', '', '',
2785         'agent_pkgid',     'varchar', 'NULL', $char_d, '', '',
2786         'waive_setup',        'char', 'NULL',  1, '', '',
2787         'recur_show_zero',    'char', 'NULL',  1, '', '',
2788         'setup_show_zero',    'char', 'NULL',  1, '', '',
2789         'change_to_pkgnum',    'int', 'NULL', '', '', '',
2790         'separate_bill',      'char', 'NULL',  1, '', '',
2791       ],
2792       'primary_key'  => 'pkgnum',
2793       'unique'       => [],
2794       'index'        => [ ['custnum'], ['pkgpart'], ['pkgbatch'],
2795                           ['locationnum'], ['usernum'], ['agent_pkgid'],
2796                           ['order_date'], [ 'start_date' ], ['setup'], ['bill'],
2797                           ['last_bill'], ['susp'], ['adjourn'], ['resume'],
2798                           ['cancel'], ['expire'], ['contract_end'],
2799                           ['change_date'],
2800                           ['no_auto'],
2801                           #['contactnum'],
2802                           ['salesnum'],
2803                           #['uncancel_pkgnum'],
2804                           #['change_pkgnum'], ['change_locationnum'],
2805                           #['change_custnum'],
2806                           ['main_pkgnum'],
2807                           #['pkglinknum'], ['change_to_pkgnum'],
2808                         ],
2809       'foreign_keys' => [
2810                           { columns    => [ 'custnum' ],
2811                             table      => 'cust_main',
2812                           },
2813                           { columns    => [ 'pkgpart' ],
2814                             table      => 'part_pkg',
2815                           },
2816                           { columns    => [ 'contactnum' ],
2817                             table      => 'contact',
2818                           },
2819                           { columns    => [ 'locationnum' ],
2820                             table      => 'cust_location',
2821                           },
2822                           { columns    => [ 'usernum' ],
2823                             table      => 'access_user',
2824                           },
2825                           { columns    => [ 'salesnum' ],
2826                             table      => 'sales',
2827                           },
2828                           { columns    => [ 'uncancel_pkgnum' ],
2829                             table      => 'cust_pkg',
2830                             references => [ 'pkgnum' ],
2831                           },
2832                           { columns    => [ 'change_pkgnum' ],
2833                             table      => 'cust_pkg',
2834                             references => [ 'pkgnum' ],
2835                           },
2836                           { columns    => [ 'change_pkgpart' ],
2837                             table      => 'part_pkg',
2838                             references => [ 'pkgpart' ],
2839                           },
2840                           { columns    => [ 'change_locationnum' ],
2841                             table      => 'cust_location',
2842                             references => [ 'locationnum' ],
2843                           },
2844                           { columns    => [ 'change_custnum' ],
2845                             table      => 'cust_main',
2846                             references => [ 'custnum' ],
2847                           },
2848                           { columns    => [ 'main_pkgnum' ],
2849                             table      => 'cust_pkg',
2850                             references => [ 'pkgnum' ],
2851                           },
2852                           { columns    => [ 'pkglinknum' ],
2853                             table      => 'part_pkg_link',
2854                           },
2855                           { columns    => [ 'change_to_pkgnum' ],
2856                             table      => 'cust_pkg',
2857                             references => [ 'pkgnum' ],
2858                           },
2859                         ],
2860    },
2861
2862     'cust_pkg_option' => {
2863       'columns' => [
2864         'optionnum', 'serial', '', '', '', '',
2865         'pkgnum', 'int', '', '', '', '',
2866         'optionname', 'varchar', '', $char_d, '', '',
2867         'optionvalue', 'text', 'NULL', '', '', '',
2868       ],
2869       'primary_key'  => 'optionnum',
2870       'unique'       => [],
2871       'index'        => [ [ 'pkgnum' ], [ 'optionname' ] ],
2872       'foreign_keys' => [
2873                           { columns    => [ 'pkgnum' ],
2874                             table      => 'cust_pkg',
2875                           },
2876                         ],
2877     },
2878
2879     'cust_pkg_detail' => {
2880       'columns' => [
2881         'pkgdetailnum', 'serial', '',        '', '', '',
2882         'pkgnum',          'int', '',        '', '', '',
2883         'detail',      'varchar', '', 2*$char_d, '', '',
2884         'detailtype',     'char', '',         1, '', '', #"I"nvoice or "C"omment
2885         'weight',          'int', '',        '', '', '',
2886       ],
2887       'primary_key'  => 'pkgdetailnum',
2888       'unique'       => [],
2889       'index'        => [ [ 'pkgnum', 'detailtype' ] ],
2890       'foreign_keys' => [
2891                           { columns    => [ 'pkgnum' ],
2892                             table      => 'cust_pkg',
2893                           },
2894                         ],
2895     },
2896
2897     'cust_pkg_reason' => {
2898       'columns' => [
2899         'num',      'serial',    '',   '', '', '',
2900         'pkgnum',   'int',    '',   '', '', '',
2901         'reasonnum','int',    '',   '', '', '',
2902         'action',   'char', 'NULL', 1, '', '',     #should not be nullable
2903         'otaker',   'varchar', 'NULL', 32, '', '',
2904         'usernum',   'int', 'NULL', '', '', '',
2905         'date',     @date_type, '', '',
2906       ],
2907       'primary_key'  => 'num',
2908       'unique'       => [],
2909       'index'        => [ ['pkgnum'], ['reasonnum'], ['action'], ['usernum'], ],
2910       'foreign_keys' => [
2911                           { columns    => [ 'pkgnum' ],
2912                             table      => 'cust_pkg',
2913                           },
2914                           { columns    => [ 'reasonnum' ],
2915                             table      => 'reason',
2916                           },
2917                           { columns    => [ 'usernum' ],
2918                             table      => 'access_user',
2919                           },
2920                         ],
2921     },
2922
2923     'cust_pkg_reason_fee' => {
2924       'columns' => [
2925         'pkgreasonfeenum', 'serial', '', '', '', '',
2926         'pkgreasonnum',       'int', '', '', '', '',
2927         'billpkgnum',         'int', 'NULL', '', '', '',
2928         'feepart',            'int', '', '', '', '',
2929         'nextbill',          'char', 'NULL',  1, '', '',
2930       ],
2931       'primary_key'  => 'pkgreasonfeenum',
2932       'unique' => [ [ 'billpkgnum' ], [ 'pkgreasonnum' ] ], # one-to-one link
2933       'index'  => [ [ 'feepart' ] ],
2934       'foreign_keys' => [
2935                           { columns     => [ 'pkgreasonnum' ],
2936                             table       => 'cust_pkg_reason',
2937                             references  => [ 'num' ],
2938                           },
2939                           { columns     => [ 'feepart' ],
2940                             table       => 'part_fee',
2941                           },
2942                           # can't link billpkgnum, because of voids
2943       ],
2944     },
2945
2946     'cust_pkg_discount' => {
2947       'columns' => [
2948         'pkgdiscountnum', 'serial', '',        '', '', '',
2949         'pkgnum',            'int', '',        '', '', '',
2950         'discountnum',       'int', '',        '', '', '',
2951         'months_used',   'decimal', 'NULL', '7,4', '', '',
2952         'end_date',     @date_type,                '', '',
2953         'otaker',        'varchar', 'NULL',    32, '', '',
2954         'usernum',           'int', 'NULL',    '', '', '',
2955         'disabled',         'char', 'NULL',     1, '', '',
2956         'setuprecur',       'char', 'NULL',     5, '', '',
2957       ],
2958       'primary_key'  => 'pkgdiscountnum',
2959       'unique'       => [],
2960       'index'        => [ [ 'pkgnum' ], [ 'discountnum' ], [ 'usernum' ], ],
2961       'foreign_keys' => [
2962                           { columns    => [ 'pkgnum' ],
2963                             table      => 'cust_pkg',
2964                           },
2965                           { columns    => [ 'discountnum' ],
2966                             table      => 'discount',
2967                           },
2968                           { columns    => [ 'usernum' ],
2969                             table      => 'access_user',
2970                           },
2971                         ],
2972     },
2973
2974     'cust_pkg_usage' => {
2975       'columns' => [
2976         'pkgusagenum', 'serial', '', '', '', '',
2977         'pkgnum',         'int', '', '', '', '',
2978         'minutes',        'double precision', '', '', '', '',
2979         'pkgusagepart',   'int', '', '', '', '',
2980       ],
2981       'primary_key'  => 'pkgusagenum',
2982       'unique'       => [],
2983       'index'        => [ [ 'pkgnum' ], [ 'pkgusagepart' ] ],
2984       'foreign_keys' => [
2985                           { columns    => [ 'pkgnum' ],
2986                             table      => 'cust_pkg',
2987                           },
2988                           { columns    => [ 'pkgusagepart' ],
2989                             table      => 'part_pkg_usage',
2990                           },
2991                         ],
2992     },
2993
2994     'cdr_cust_pkg_usage' => {
2995       'columns' => [
2996         'cdrusagenum', 'bigserial', '', '', '', '',
2997         'acctid',      'bigint',    '', '', '', '',
2998         'pkgusagenum', 'int',       '', '', '', '',
2999         'minutes',     'double precision',       '', '', '', '',
3000       ],
3001       'primary_key'  => 'cdrusagenum',
3002       'unique'       => [],
3003       'index'        => [ [ 'pkgusagenum' ], [ 'acctid' ] ],
3004       'foreign_keys' => [
3005                           { columns    => [ 'acctid' ],
3006                             table      => 'cdr',
3007                           },
3008                           { columns    => [ 'pkgusagenum' ],
3009                             table      => 'cust_pkg_usage',
3010                           },
3011                         ],
3012     },
3013
3014     'cust_bill_pkg_discount' => {
3015       'columns' => [
3016         'billpkgdiscountnum', 'serial',        '', '', '', '',
3017         'billpkgnum',            'int',        '', '', '', '',
3018         'pkgdiscountnum',        'int',        '', '', '', '',
3019         'amount',          @money_type,                '', '',
3020         'months',            'decimal', 'NULL', '7,4', '', '',
3021       ],
3022       'primary_key'  => 'billpkgdiscountnum',
3023       'unique'       => [],
3024       'index'        => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
3025       'foreign_keys' => [
3026                           { columns    => [ 'billpkgnum' ],
3027                             table      => 'cust_bill_pkg',
3028                           },
3029                           { columns    => [ 'pkgdiscountnum' ],
3030                             table      => 'cust_pkg_discount',
3031                           },
3032                         ],
3033     },
3034
3035     'cust_bill_pkg_discount_void' => {
3036       'columns' => [
3037         'billpkgdiscountnum',    'int',        '', '', '', '',
3038         'billpkgnum',            'int',        '', '', '', '',
3039         'pkgdiscountnum',        'int',        '', '', '', '',
3040         'amount',          @money_type,                '', '',
3041         'months',            'decimal', 'NULL', '7,4', '', '',
3042       ],
3043       'primary_key'  => 'billpkgdiscountnum',
3044       'unique'       => [],
3045       'index'        => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
3046       'foreign_keys' => [
3047                           { columns    => [ 'billpkgnum' ],
3048                             table      => 'cust_bill_pkg_void',
3049                           },
3050                           { columns    => [ 'pkgdiscountnum' ],
3051                             table      => 'cust_pkg_discount',
3052                           },
3053                         ],
3054     },
3055
3056     'discount' => {
3057       'columns' => [
3058         'discountnum', 'serial',     '',      '', '', '',
3059         #'agentnum',       'int', 'NULL',      '', '', '',
3060         'classnum',       'int', 'NULL',      '', '', '',
3061         'name',       'varchar', 'NULL', $char_d, '', '',
3062         'amount',   @money_type,                  '', '',
3063         'percent',    'decimal',     '',   '7,4', '', '',
3064         'months',     'decimal', 'NULL',   '7,4', '', '',
3065         'disabled',      'char', 'NULL',       1, '', '',
3066         'setup',         'char', 'NULL',       1, '', '',
3067         #'linked',        'char', 'NULL',       1, '', '',
3068       ],
3069       'primary_key'  => 'discountnum',
3070       'unique'       => [],
3071       'index'        => [], # [ 'agentnum' ], ],
3072       'foreign_keys' => [
3073                           { columns    => [ 'classnum' ],
3074                             table      => 'discount_class',
3075                           },
3076                         ],
3077     },
3078
3079     'discount_class' => {
3080       'columns' => [
3081         'classnum',    'serial',   '',      '', '', '',
3082         'classname',   'varchar',  '', $char_d, '', '',
3083         #'categorynum', 'int',  'NULL',      '', '', '',
3084         'disabled',    'char', 'NULL',       1, '', '',
3085       ],
3086       'primary_key' => 'classnum',
3087       'unique' => [],
3088       'index' => [ ['disabled'] ],
3089     },
3090
3091     'cust_refund' => {
3092       'columns' => [
3093         'refundnum',    'serial',    '',   '', '', '',
3094         'custnum',  'int',    '',   '', '', '',
3095         '_date',        @date_type, '', '',
3096         'refund',       @money_type, '', '',
3097         'currency',       'char', 'NULL',       3, '', '',
3098         'otaker',       'varchar',   'NULL',   32, '', '',
3099         'usernum',   'int', 'NULL', '', '', '',
3100         'reason',       'varchar',   'NULL',   $char_d, '', '',
3101         'reasonnum',   'int', 'NULL', '', '', '',
3102         'payby',        'char',   '',     4, '', '', # CARD/BILL/COMP, should
3103                                                      # be index into payby
3104                                                      # table eventually
3105         'payinfo',      'varchar',   'NULL', 512, '', '', #see cust_main above
3106         'paycardtype',  'varchar', 'NULL',   $char_d, '', '',
3107         'paymask', 'varchar', 'NULL', $char_d, '', '',
3108         'paybatch',     'varchar',   'NULL', $char_d, '', '',
3109         'closed',    'char', 'NULL', 1, '', '',
3110         'source_paynum', 'int', 'NULL', '', '', '', # link to cust_payby, to prevent unapply of gateway-generated refunds
3111         # credit card/EFT fields (formerly in paybatch)
3112         'gatewaynum',     'int', 'NULL', '', '', '', # payment_gateway FK
3113         'processor',  'varchar', 'NULL', $char_d, '', '', # module name
3114         'auth',       'varchar','NULL',16, '', '', # CC auth number
3115         'order_number', 'varchar','NULL',$char_d, '', '', # transaction number
3116         'is_tokenized',   'char', 'NULL',    1, '', '',
3117       ],
3118       'primary_key'  => 'refundnum',
3119       'unique'       => [],
3120       'index'        => [ ['custnum'], ['_date'], [ 'usernum' ], ['is_tokenized'] ],
3121       'foreign_keys' => [
3122                           { columns    => [ 'custnum' ],
3123                             table      => 'cust_main',
3124                           },
3125                           { columns    => [ 'usernum' ],
3126                             table      => 'access_user',
3127                           },
3128                           { columns    => [ 'reasonnum' ],
3129                             table      => 'reason',
3130                           },
3131                           { columns    => [ 'gatewaynum' ],
3132                             table      => 'payment_gateway',
3133                           },
3134                           { columns    => [ 'source_paynum' ],
3135                             table      => 'cust_pay',
3136                             references => [ 'paynum' ],
3137                           },
3138                         ],
3139     },
3140
3141     'cust_credit_refund' => {
3142       'columns' => [
3143         'creditrefundnum', 'serial',     '',   '', '', '',
3144         'crednum',  'int',     '',   '', '', '',
3145         'refundnum',  'int',     '',   '', '', '',
3146         'amount',  @money_type, '', '',
3147         '_date',   @date_type, '', '',
3148       ],
3149       'primary_key'  => 'creditrefundnum',
3150       'unique'       => [],
3151       'index'        => [ ['crednum'], ['refundnum'] ],
3152       'foreign_keys' => [
3153                           { columns    => [ 'crednum' ],
3154                             table      => 'cust_credit',
3155                           },
3156                           { columns    => [ 'refundnum' ],
3157                             table      => 'cust_refund',
3158                           },
3159                         ],
3160     },
3161
3162
3163     'cust_svc' => {
3164       'columns' => [
3165         'svcnum',      'serial',     '', '', '', '',
3166         'pkgnum',         'int', 'NULL', '', '', '',
3167         'svcpart',        'int',     '', '', '', '',
3168         'agent_svcid',    'int', 'NULL', '', '', '',
3169         'overlimit',           @date_type,   '', '',
3170       ],
3171       'primary_key'  => 'svcnum',
3172       'unique'       => [],
3173       'index'        => [ ['svcnum'], ['pkgnum'], ['svcpart'],
3174                           ['agent_svcid'],
3175                         ],
3176       'foreign_keys' => [
3177                           { columns    => [ 'pkgnum' ],
3178                             table      => 'cust_pkg',
3179                           },
3180                           { columns    => [ 'svcpart' ],
3181                             table      => 'part_svc',
3182                           },
3183                         ],
3184     },
3185
3186     'cust_svc_option' => {
3187       'columns' => [
3188         'optionnum',   'serial', '', '', '', '',
3189         'svcnum',      'int', '', '', '', '',
3190         'optionname',  'varchar', '', $char_d, '', '',
3191         'optionvalue', 'text', 'NULL', '', '', '',
3192       ],
3193       'primary_key'  => 'optionnum',
3194       'unique'       => [],
3195       'index'        => [ [ 'svcnum' ], [ 'optionname' ] ],
3196       'foreign_keys' => [
3197                           { columns    => [ 'svcnum' ],
3198                             table      => 'cust_svc',
3199                           },
3200                         ],
3201     },
3202
3203     'svc_export_machine' => {
3204       'columns' => [
3205         'svcexportmachinenum', 'serial', '', '', '', '',
3206         'svcnum',                 'int', '', '', '', '',
3207         'exportnum',              'int', '', '', '', '',
3208         'machinenum',             'int', '', '', '', '',
3209       ],
3210       'primary_key'  => 'svcexportmachinenum',
3211       'unique'       => [ ['svcnum', 'exportnum'] ],
3212       'index'        => [],
3213       'foreign_keys' => [
3214                           { columns    => [ 'svcnum' ],
3215                             table      => 'cust_svc',
3216                           },
3217                           { columns    => [ 'exportnum' ],
3218                             table      => 'part_export',
3219                           },
3220                           { columns    => [ 'machinenum' ],
3221                             table      => 'part_export_machine',
3222                           },
3223                         ],
3224     },
3225
3226     'part_export_machine' => {
3227       'columns' => [
3228         'machinenum', 'serial', '', '', '', '',
3229         'exportnum',     'int', '', '', '', '',
3230         'machine',    'varchar', 'NULL', $char_d, '', '',
3231         'disabled',      'char', 'NULL',       1, '', '',
3232       ],
3233       'primary_key'  => 'machinenum',
3234       'unique'       => [ [ 'exportnum', 'machine' ] ],
3235       'index'        => [ [ 'exportnum' ] ],
3236       'foreign_keys' => [
3237                           { columns    => [ 'exportnum' ],
3238                             table      => 'part_export',
3239                           },
3240                         ],
3241     },
3242
3243     'part_pkg' => {
3244       'columns' => [
3245         'pkgpart',       'serial',    '',   '', '', '',
3246         'pkgpartbatch',  'varchar', 'NULL', $char_d, '', '',
3247         'pkg',           'varchar',   '',   104, '', '',
3248         'comment',       'varchar', 'NULL', 2*$char_d, '', '',
3249         'promo_code',    'varchar', 'NULL', $char_d, '', '',
3250         'freq',          'varchar',   '',   $char_d, '', '', #billing frequency
3251         'setuptax',      'char', 'NULL', 1, '', '',
3252         'recurtax',      'char', 'NULL', 1, '', '',
3253         'plan',          'varchar', 'NULL', $char_d, '', '',
3254         'disabled',      'char', 'NULL', 1, '', '',
3255         'custom',        'char', 'NULL', 1, '', '',
3256         'taxclass',      'varchar', 'NULL', $char_d, '', '',
3257         'classnum',      'int',     'NULL', '', '', '',
3258         'addon_classnum','int',     'NULL', '', '', '',
3259         'taxproductnum', 'int',     'NULL', '', '', '',
3260         'setup_cost',    @money_typen,          '', '',
3261         'recur_cost',    @money_typen,          '', '',
3262         'pay_weight',    'real',    'NULL', '', '', '',
3263         'credit_weight', 'real',    'NULL', '', '', '',
3264         'agentnum',      'int',     'NULL', '', '', '',
3265         'fcc_ds0s',      'int',     'NULL', '', '', '',
3266         'fcc_voip_class','char',    'NULL',  1, '', '',
3267         'no_auto',          'char', 'NULL',  1, '', '',
3268         'recur_show_zero',  'char', 'NULL',  1, '', '',
3269         'setup_show_zero',  'char', 'NULL',  1, '', '',
3270         'successor',     'int',     'NULL', '', '', '',
3271         'family_pkgpart','int',     'NULL', '', '', '',
3272         'delay_start',   'int',     'NULL', '', '', '',
3273         'start_on_hold', 'char',    'NULL',  1, '', '',
3274         'agent_pkgpartid', 'varchar', 'NULL', 20, '', '',
3275         'expire_months', 'int',     'NULL', '', '', '',
3276         'adjourn_months', 'int',    'NULL', '', '', '',
3277         'contract_end_months','int','NULL', '', '', '',
3278         'change_to_pkgpart', 'int', 'NULL', '', '', '',
3279       ],
3280       'primary_key'  => 'pkgpart',
3281       'unique'       => [],
3282       'index'        => [ [ 'promo_code' ], [ 'disabled' ], [ 'classnum' ],
3283                           [ 'agentnum' ], ['no_auto'], ['agent_pkgpartid'],
3284                         ],
3285       'foreign_keys' => [
3286                           { columns    => [ 'classnum' ],
3287                             table      => 'pkg_class',
3288                           },
3289                           { columns    => [ 'addon_classnum' ],
3290                             table      => 'pkg_class',
3291                             references => [ 'classnum' ],
3292                           },
3293                           { columns    => [ 'taxproductnum' ],
3294                             table      => 'part_pkg_taxproduct',
3295                           },
3296                           { columns    => [ 'agentnum' ],
3297                             table      => 'agent',
3298                           },
3299                           { columns    => [ 'successor' ],
3300                             table      => 'part_pkg',
3301                             references => [ 'pkgpart' ],
3302                           },
3303                           { columns    => [ 'family_pkgpart' ],
3304                             table      => 'part_pkg',
3305                             references => [ 'pkgpart' ],
3306                           },
3307                           { columns    => [ 'change_to_pkgpart' ],
3308                             table      => 'part_pkg',
3309                             references => [ 'pkgpart' ],
3310                           },
3311                         ],
3312     },
3313
3314     'part_pkg_msgcat' => {
3315       'columns' => [
3316         'pkgpartmsgnum',  'serial',     '',        '', '', '',
3317         'pkgpart',           'int',     '',        '', '', '',
3318         'locale',        'varchar',     '',        16, '', '',
3319         'pkg',           'varchar',     '',   $char_d, '', '', #longer/no limit?
3320         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
3321       ],
3322       'primary_key'  => 'pkgpartmsgnum',
3323       'unique'       => [ [ 'pkgpart', 'locale' ] ],
3324       'index'        => [],
3325       'foreign_keys' => [
3326                           { columns    => [ 'pkgpart' ],
3327                             table      => 'part_pkg',
3328                           },
3329                         ],
3330     },
3331
3332     'part_pkg_currency' => {
3333       'columns' => [
3334         'pkgcurrencynum', 'serial', '',      '', '', '',
3335         'pkgpart',           'int', '',      '', '', '',
3336         'currency',         'char', '',       3, '', '',
3337         'optionname',    'varchar', '', $char_d, '', '',
3338         'optionvalue',      'text', '',      '', '', '',
3339       ],
3340       'primary_key'  => 'pkgcurrencynum',
3341       'unique'       => [ [ 'pkgpart', 'currency', 'optionname' ] ],
3342       'index'        => [ ['pkgpart'] ],
3343       'foreign_keys' => [
3344                           { columns    => [ 'pkgpart' ],
3345                             table      => 'part_pkg',
3346                           },
3347                         ],
3348     },
3349
3350     'currency_exchange' => {
3351       'columns' => [
3352         'currencyratenum', 'serial', '',    '', '', '',
3353         'from_currency',     'char', '',     3, '', '',
3354         'to_currency',       'char', '',     3, '', '',
3355         'rate',           'decimal', '', '7,6', '', '',
3356       ],
3357       'primary_key' => 'currencyratenum',
3358       'unique'      => [ [ 'from_currency', 'to_currency' ] ],
3359       'index'       => [],
3360     },
3361
3362     'part_pkg_usageprice' => {
3363       'columns' => [
3364         'usagepricepart', 'serial',      '',      '', '', '',
3365         'pkgpart',           'int',      '',      '', '', '',
3366         'price',          @money_type,                '', '',
3367         'currency',         'char',  'NULL',       3, '', '',
3368         'action',        'varchar',      '', $char_d, '', '',
3369         'target',        'varchar',      '', $char_d, '', '',
3370         'amount',        'varchar',      '', $char_d, '', '',
3371       ],
3372       'primary_key'  => 'usagepricepart',
3373       'unique'       => [ [ 'pkgpart', 'currency', 'target' ] ],
3374       'index'        => [ [ 'pkgpart' ] ],
3375       'foreign_keys' => [
3376                           { columns    => [ 'pkgpart' ],
3377                             table      => 'part_pkg',
3378                           },
3379                         ],
3380     },
3381
3382     'cust_pkg_usageprice' => {
3383       'columns' => [
3384         'usagepricenum', 'serial',      '',      '', '', '',
3385         'pkgnum',           'int',      '',      '', '', '',
3386         'usagepricepart',   'int',      '',      '', '', '',
3387         'quantity',         'int',      '',      '', '', '',
3388       ],
3389       'primary_key'  => 'usagepricenum',
3390       'unique'       => [ [ 'pkgnum', 'usagepricepart' ] ],
3391       'index'        => [ [ 'pkgnum' ] ],
3392       'foreign_keys' => [
3393                           { columns    => [ 'pkgnum' ],
3394                             table      => 'cust_pkg',
3395                           },
3396                           { columns    => [ 'usagepricepart' ],
3397                             table      => 'part_pkg_usageprice',
3398                           },
3399                         ],
3400     },
3401
3402     'part_fee' => {
3403       'columns' => [
3404         'feepart',       'serial',    '',   '', '', '',
3405         'itemdesc',      'varchar',   '',   $char_d,   '', '',
3406         'comment',       'varchar', 'NULL', 2*$char_d, '', '',
3407         'disabled',      'char',    'NULL',  1, '', '',
3408         'classnum',      'int',     'NULL', '', '', '',
3409         'taxclass',      'varchar', 'NULL', $char_d, '', '',
3410         'taxproductnum', 'int',     'NULL', '', '', '',
3411         'pay_weight',    'real',    'NULL', '', '', '',
3412         'credit_weight', 'real',    'NULL', '', '', '',
3413         'agentnum',      'int',     'NULL', '', '', '',
3414         'amount',   @money_type,                '', '',
3415         'percent',     'decimal',    '', '7,4', '', '',
3416         'basis',         'varchar',  '',    16, '', '',
3417         'minimum',    @money_typen,             '', '',
3418         'maximum',    @money_typen,             '', '',
3419         'limit_credit',  'char',    'NULL',  1, '', '',
3420         'setuprecur',    'char',     '',     5, '', '',
3421         'taxable',       'char',    'NULL',  1, '', '',
3422       ],
3423       'primary_key'  => 'feepart',
3424       'unique'       => [],
3425       'index'        => [ [ 'disabled' ], [ 'classnum' ], [ 'agentnum' ]
3426                         ],
3427       'foreign_keys' => [
3428                           { columns    => [ 'classnum' ],
3429                             table      => 'pkg_class',
3430                           },
3431                           { columns    => [ 'taxproductnum' ],
3432                             table      => 'part_pkg_taxproduct',
3433                           },
3434                           { columns    => [ 'agentnum' ],
3435                             table      => 'agent',
3436                           },
3437                         ],
3438     },
3439
3440     'part_fee_msgcat' => {
3441       'columns' => [
3442         'feepartmsgnum',  'serial',     '',        '', '', '',
3443         'feepart',           'int',     '',        '', '', '',
3444         'locale',        'varchar',     '',        16, '', '',
3445         'itemdesc',      'varchar',     '',   $char_d, '', '', #longer/no limit?
3446         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
3447       ],
3448       'primary_key'  => 'feepartmsgnum',
3449       'unique'       => [ [ 'feepart', 'locale' ] ],
3450       'index'        => [],
3451       'foreign_keys' => [
3452                           { columns    => [ 'feepart' ],
3453                             table      => 'part_fee',
3454                           },
3455                         ],
3456     },
3457
3458     'part_fee_usage' => {
3459       'columns' => [
3460         'feepartusagenum','serial',     '',        '', '', '',
3461         'feepart',           'int',     '',        '', '', '',
3462         'classnum',          'int',     '',        '', '', '',
3463         'amount',   @money_type,                '', '',
3464         'percent',     'decimal',    '', '7,4', '', '',
3465       ],
3466       'primary_key'  => 'feepartusagenum',
3467       'unique'       => [ [ 'feepart', 'classnum' ] ],
3468       'index'        => [],
3469       'foreign_keys' => [
3470                           { columns    => [ 'feepart' ],
3471                             table      => 'part_fee',
3472                           },
3473                           { columns    => [ 'classnum' ],
3474                             table      => 'usage_class',
3475                           },
3476                         ],
3477     },
3478
3479     'part_pkg_link' => {
3480       'columns' => [
3481         'pkglinknum',  'serial',   '',      '', '', '',
3482         'src_pkgpart', 'int',      '',      '', '', '',
3483         'dst_pkgpart', 'int',      '',      '', '', '',
3484         'link_type',   'varchar',  '', $char_d, '', '',
3485         'hidden',      'char', 'NULL',       1, '', '',
3486       ],
3487       'primary_key'  => 'pkglinknum',
3488       'unique'       => [ ['src_pkgpart','dst_pkgpart','link_type','hidden'] ],
3489       'index'        => [ [ 'src_pkgpart' ] ],
3490       'foreign_keys' => [
3491                           { columns    => [ 'src_pkgpart' ],
3492                             table      => 'part_pkg',
3493                             references => [ 'pkgpart' ]
3494                           },
3495                           { columns    => [ 'dst_pkgpart' ],
3496                             table      => 'part_pkg',
3497                             references => [ 'pkgpart' ]
3498                           },
3499                         ],
3500     },
3501     # XXX somewhat borked unique: we don't really want a hidden and unhidden
3502     # it turns out we'd prefer to use svc, bill, and invisibill (or something)
3503
3504     'part_pkg_discount' => {
3505       'columns' => [
3506         'pkgdiscountnum', 'serial',   '',      '', '', '',
3507         'pkgpart',        'int',      '',      '', '', '',
3508         'discountnum',    'int',      '',      '', '', '',
3509       ],
3510       'primary_key'  => 'pkgdiscountnum',
3511       'unique'       => [ [ 'pkgpart', 'discountnum' ] ],
3512       'index'        => [],
3513       'foreign_keys' => [
3514                           { columns    => [ 'pkgpart' ],
3515                             table      => 'part_pkg',
3516                           },
3517                           { columns    => [ 'discountnum' ],
3518                             table      => 'discount',
3519                           },
3520                         ],
3521     },
3522
3523     'part_pkg_taxclass' => {
3524       'columns' => [
3525         'taxclassnum',  'serial', '',       '', '', '',
3526         'taxclass',     'varchar', '', $char_d, '', '',
3527         'disabled', 'char',   'NULL',         1, '', '',
3528       ],
3529       'primary_key' => 'taxclassnum',
3530       'unique'      => [ [ 'taxclass' ] ],
3531       'index'       => [ [ 'disabled' ] ],
3532     },
3533
3534     'part_pkg_taxproduct' => {
3535       'columns' => [
3536         'taxproductnum', 'serial',      '',        '', '', '',
3537         'data_vendor',   'varchar', 'NULL',   $char_d, '', '',
3538         'taxproduct',    'varchar',     '',   $char_d, '', '',
3539         'description',   'varchar',     '', 3*$char_d, '', '',
3540         'note',             'text', 'NULL',        '', '', '',
3541       ],
3542       'primary_key' => 'taxproductnum',
3543       'unique'      => [ [ 'data_vendor', 'taxproduct' ] ],
3544       'index'       => [],
3545     },
3546
3547     'part_pkg_taxrate' => {
3548       'columns' => [
3549         'pkgtaxratenum', 'serial',  '',     '',      '', '',
3550         'data_vendor',   'varchar', 'NULL', $char_d, '', '', # update source
3551         'geocode',       'varchar', 'NULL', $char_d, '', '', # cch provides 10
3552         'taxproductnum', 'int',  '',     '',       '', '',
3553         'city',             'varchar', 'NULL', $char_d, '', '', # tax_location?
3554         'county',           'varchar', 'NULL', $char_d, '', '',
3555         'state',            'varchar', 'NULL', $char_d, '', '',
3556         'local',            'varchar', 'NULL', $char_d, '', '',
3557         'country',          'char',    'NULL', 2,       '', '',
3558         'taxclassnumtaxed', 'int',     'NULL', '',      '', '',
3559         'taxcattaxed',      'varchar', 'NULL', $char_d, '', '',
3560         'taxclassnum',      'int',     'NULL', '',      '', '',
3561         'effdate',          @date_type, '', '',
3562         'taxable',          'char',    'NULL', 1,       '', '',
3563       ],
3564       'primary_key'  => 'pkgtaxratenum',
3565       'unique'       => [],
3566       'index'        => [ [ 'data_vendor', 'geocode', 'taxproductnum' ] ],
3567       'foreign_keys' => [
3568                           { columns    => [ 'taxproductnum' ],
3569                             table      => 'part_pkg_taxproduct',
3570                           },
3571                           { columns    => [ 'taxclassnumtaxed' ],
3572                             table      => 'tax_class',
3573                             references => [ 'taxclassnum' ],
3574                           },
3575                           { columns    => [ 'taxclassnum' ],
3576                             table      => 'tax_class',
3577                           },
3578                         ],
3579     },
3580
3581     'part_pkg_taxoverride' => {
3582       'columns' => [
3583         'taxoverridenum', 'serial', '', '', '', '',
3584         'pkgpart',           'int', '', '', '', '',
3585         'taxclassnum',       'int', '', '', '', '',
3586         'usage_class',    'varchar', 'NULL', $char_d, '', '',
3587       ],
3588       'primary_key'  => 'taxoverridenum',
3589       'unique'       => [],
3590       'index'        => [ [ 'pkgpart' ], [ 'taxclassnum' ] ],
3591       'foreign_keys' => [
3592                           { columns    => [ 'pkgpart' ],
3593                             table      => 'part_pkg',
3594                           },
3595                           { columns    => [ 'taxclassnum' ],
3596                             table      => 'tax_class',
3597                           },
3598                         ],
3599     },
3600
3601 #    'part_title' => {
3602 #      'columns' => [
3603 #        'titlenum',   'int',    '',   '',
3604 #        'title',      'varchar',   '',   $char_d,
3605 #      ],
3606 #      'primary_key' => 'titlenum',
3607 #      'unique' => [ [] ],
3608 #      'index' => [ [] ],
3609 #    },
3610
3611     'pkg_svc' => {
3612       'columns' => [
3613         'pkgsvcnum',   'serial',    '', '', '', '',
3614         'pkgpart',        'int',    '', '', '', '',
3615         'svcpart',        'int',    '', '', '', '',
3616         'quantity',       'int',    '', '', '', '',
3617         'primary_svc',   'char', 'NULL', 1, '', '',
3618         'hidden',        'char', 'NULL', 1, '', '',
3619         'bulk_skip',     'char', 'NULL', 1, '', '',
3620         'provision_hold', 'char', 'NULL', 1, '', '',
3621       ],
3622       'primary_key'  => 'pkgsvcnum',
3623       'unique'       => [ ['pkgpart', 'svcpart'] ],
3624       'index'        => [ ['pkgpart'], ['quantity'] ],
3625       'foreign_keys' => [
3626                           { columns    => [ 'pkgpart' ],
3627                             table      => 'part_pkg',
3628                           },
3629                           { columns    => [ 'svcpart' ],
3630                             table      => 'part_svc',
3631                           },
3632                         ],
3633     },
3634
3635     'part_referral' => {
3636       'columns' => [
3637         'refnum',   'serial',     '',        '', '', '',
3638         'referral', 'varchar',    '',   $char_d, '', '',
3639         'disabled', 'char',   'NULL',         1, '', '',
3640         'agentnum', 'int',    'NULL',        '', '', '',
3641         'title',   'varchar', 'NULL',   $char_d, '', '',
3642       ],
3643       'primary_key'  => 'refnum',
3644       'unique'       => [ ['agentnum', 'title'] ],
3645       'index'        => [ ['disabled'], ['agentnum'], ],
3646       'foreign_keys' => [
3647                           { columns    => [ 'agentnum' ],
3648                             table      => 'agent',
3649                           },
3650                         ],
3651     },
3652
3653     'part_svc' => {
3654       'columns' => [
3655         'svcpart',             'serial',     '',        '', '', '',
3656         'svc',                'varchar',     '',   $char_d, '', '',
3657         'svcdb',              'varchar',     '',   $char_d, '', '',
3658         'disabled',              'char', 'NULL',         1, '', '',
3659         'preserve',              'char', 'NULL',         1, '', '',
3660         'selfservice_access', 'varchar', 'NULL',   $char_d, '', '',
3661         'classnum',               'int', 'NULL',        '', '', '',
3662         'restrict_edit_password','char', 'NULL',         1, '', '',
3663         'has_router',            'char', 'NULL',         1, '', '',
3664 ],
3665       'primary_key'  => 'svcpart',
3666       'unique'       => [],
3667       'index'        => [ [ 'disabled' ] ],
3668       'foreign_keys' => [
3669                           { columns    => [ 'classnum' ],
3670                             table      => 'part_svc_class',
3671                           },
3672                         ],
3673     },
3674
3675     'part_svc_column' => {
3676       'columns' => [
3677         'columnnum',   'serial',      '',      '', '', '',
3678         'svcpart',     'int',         '',      '', '', '',
3679         'columnname',  'varchar',     '',      64, '', '',
3680         'columnlabel', 'varchar', 'NULL', $char_d, '', '',
3681         'columnvalue', 'varchar', 'NULL',     512, '', '',
3682         'columnflag',  'char',    'NULL',       1, '', '',
3683         'required',    'char',    'NULL',       1, '', '',
3684       ],
3685       'primary_key'  => 'columnnum',
3686       'unique'       => [ [ 'svcpart', 'columnname' ] ],
3687       'index'        => [ [ 'svcpart' ] ],
3688       'foreign_keys' => [
3689                           { columns    => [ 'svcpart' ],
3690                             table      => 'part_svc',
3691                           },
3692                         ],
3693     },
3694
3695     'part_svc_class' => {
3696       'columns' => [
3697         'classnum',    'serial',   '',      '', '', '',
3698         'classname',   'varchar',  '', $char_d, '', '',
3699         'disabled',    'char', 'NULL',       1, '', '',
3700       ],
3701       'primary_key' => 'classnum',
3702       'unique' => [],
3703       'index' => [ ['disabled'] ],
3704     },
3705
3706     'part_svc_link' => {
3707       'columns' => [
3708         'svclinknum',  'serial',   '',      '', '', '',
3709         #'linkname',    'varchar', 'NULL', $char_d, '', '',
3710         'agentnum',    'int',     'NULL', '', '', '',
3711         'src_svcpart', 'int',      '',      '', '', '',
3712         'dst_svcpart', 'int',      '',      '', '', '',
3713         'link_type',   'varchar',  '', $char_d, '', '',
3714         'disabled',    'char', 'NULL',   1, '', '',
3715       ],
3716       'primary_key'  => 'svclinknum',
3717       'unique'       => [ ['agentnum','src_svcpart','dst_svcpart','link_type'] ],
3718       'index'        => [ [ 'src_svcpart' ], [ 'src_svcpart', 'link_type' ], [ 'disabled' ] ],
3719       'foreign_keys' => [
3720                           { columns    => [ 'src_svcpart' ],
3721                             table      => 'part_svc',
3722                             references => [ 'svcpart' ]
3723                           },
3724                           { columns    => [ 'dst_svcpart' ],
3725                             table      => 'part_svc',
3726                             references => [ 'svcpart' ]
3727                           },
3728                         ],
3729     },
3730
3731     'part_svc_msgcat' => {
3732       'columns' => [
3733         'svcpartmsgnum',  'serial',     '',        '', '', '',
3734         'svcpart',           'int',     '',        '', '', '',
3735         'locale',        'varchar',     '',        16, '', '',
3736         'svc',           'varchar',     '',   $char_d, '', '',
3737       ],
3738       'primary_key'  => 'svcpartmsgnum',
3739       'unique'       => [ [ 'svcpart', 'locale' ] ],
3740       'index'        => [],
3741       'foreign_keys' => [
3742                           { columns    => [ 'svcpart' ],
3743                             table      => 'part_svc',
3744                           },
3745                         ],
3746     },
3747
3748
3749     #(this should be renamed to part_pop)
3750     'svc_acct_pop' => {
3751       'columns' => [
3752         'popnum',    'serial',    '',   '', '', '',
3753         'city',      'varchar',   '',   $char_d, '', '',
3754         'state',     'varchar',   '',   $char_d, '', '',
3755         'ac',        'char',   '',   3, '', '',
3756         'exch',      'char',   '',   3, '', '',
3757         'loc',       'char',   'NULL',   4, '', '', #NULL for legacy purposes
3758       ],
3759       'primary_key' => 'popnum',
3760       'unique' => [],
3761       'index' => [ [ 'state' ] ],
3762     },
3763
3764     'part_pop_local' => {
3765       'columns' => [
3766         'localnum',  'serial',     '',     '', '', '',
3767         'popnum',    'int',     '',     '', '', '',
3768         'city',      'varchar', 'NULL', $char_d, '', '',
3769         'state',     'char',    'NULL', 2, '', '',
3770         'npa',       'char',    '',     3, '', '',
3771         'nxx',       'char',    '',     3, '', '',
3772       ],
3773       'primary_key'  => 'localnum',
3774       'unique'       => [],
3775       'index'        => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
3776       'foreign_keys' => [
3777                          { columns    => [ 'popnum' ],
3778                            table      => 'svc_acct_pop',
3779                          },
3780                        ],
3781     },
3782
3783     'qual' => {
3784       'columns' => [
3785         'qualnum',  'serial',     '',     '', '', '',
3786         'custnum',    'int',     'NULL',     '', '', '',
3787         'prospectnum',    'int',     'NULL',     '', '', '',
3788         'locationnum',    'int',     'NULL',     '', '', '',
3789         'phonenum',     'varchar', 'NULL',       24, '', '',
3790         'exportnum',      'int', 'NULL', '', '', '',
3791         'vendor_qual_id',      'varchar', 'NULL', $char_d, '', '',
3792         'status',      'char', '', 1, '', '',
3793       ],
3794       'primary_key'  => 'qualnum',
3795       'unique'       => [],
3796       'index'        => [ ['locationnum'], ['custnum'], ['prospectnum'],
3797                           ['phonenum'], ['vendor_qual_id'],
3798                         ],
3799       'foreign_keys' => [
3800                           { columns    => [ 'custnum' ],
3801                             table      => 'cust_main',
3802                           },
3803                           { columns    => [ 'prospectnum' ],
3804                             table      => 'prospect_main',
3805                           },
3806                           { columns    => [ 'locationnum' ],
3807                             table      => 'cust_location',
3808                           },
3809                           { columns    => [ 'exportnum' ],
3810                             table      => 'part_export',
3811                           },
3812                         ],
3813     },
3814
3815     'qual_option' => {
3816       'columns' => [
3817         'optionnum', 'serial', '', '', '', '',
3818         'qualnum',  'int',     '',     '', '', '',
3819         'optionname', 'varchar', '', $char_d, '', '',
3820         'optionvalue', 'text', 'NULL', '', '', '',
3821       ],
3822       'primary_key'  => 'optionnum',
3823       'unique'       => [],
3824       'index'        => [],
3825       'foreign_keys' => [
3826                           { columns    => [ 'qualnum' ],
3827                             table      => 'qual',
3828                           },
3829                         ],
3830     },
3831
3832     'svc_acct' => {
3833       'columns' => [
3834         'svcnum',    'int',    '',   '', '', '',
3835         'username',  'varchar',   '',   $username_len, '', '',
3836         '_password', 'varchar',   'NULL',  512, '', '',
3837         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
3838         'sec_phrase', 'varchar',  'NULL',   $char_d, '', '',
3839         'popnum',    'int',    'NULL',   '', '', '',
3840         'sectornum', 'int', 'NULL',      '', '', '',
3841         'uid',       'int', 'NULL',   '', '', '',
3842         'gid',       'int', 'NULL',   '', '', '',
3843         'finger',    'varchar',   'NULL',   2*$char_d, '', '',
3844         'dir',       'varchar',   'NULL',   $char_d, '', '',
3845         'shell',     'varchar',   'NULL',   $char_d, '', '',
3846         'quota',     'varchar',   'NULL',   $char_d, '', '',
3847         'slipip',    'varchar',   'NULL',   15, '', '', #four TINYINTs, bah.
3848         # IP address mgmt
3849         'routernum', 'int', 'NULL',      '', '', '',
3850         'blocknum',  'int', 'NULL',      '', '', '',
3851         'seconds',   'int', 'NULL',   '', '', '', #uhhhh
3852         'seconds_threshold',   'int', 'NULL',   '', '', '',
3853         'upbytes',   'bigint', 'NULL',   '', '', '',
3854         'upbytes_threshold',   'bigint', 'NULL',   '', '', '',
3855         'downbytes', 'bigint', 'NULL',   '', '', '',
3856         'downbytes_threshold',   'bigint', 'NULL',   '', '', '',
3857         'totalbytes','bigint', 'NULL',   '', '', '',
3858         'totalbytes_threshold',   'bigint', 'NULL',   '', '', '',
3859         'domsvc',    'int',     '', '', '', '',
3860         'pbxsvc',    'int', 'NULL', '', '', '',
3861         'last_login',  @date_type, '', '',
3862         'last_logout', @date_type, '', '',
3863         #cardfortress field(s)
3864         'cf_privatekey',      'text', 'NULL',      '', '', '',
3865         #communigate pro fields (quota = MaxAccountSize)
3866         'cgp_aliases',     'varchar', 'NULL',     255, '', '',
3867         #settings
3868         'cgp_type',        'varchar', 'NULL', $char_d, '', '', #AccountType
3869         'file_quota',      'varchar', 'NULL', $char_d, '', '', #MaxWebSize
3870         'file_maxnum',     'varchar', 'NULL', $char_d, '', '', #MaxWebFiles
3871         'file_maxsize',    'varchar', 'NULL', $char_d, '', '', #MaxFileSize
3872         'cgp_accessmodes', 'varchar', 'NULL',     255, '', '', #AccessModes
3873         'password_selfchange','char', 'NULL',       1, '', '', #PWDAllowed
3874         'password_recover',   'char', 'NULL',       1, 'Y','', #PasswordRecovery
3875         'cgp_rulesallowed','varchar', 'NULL', $char_d, '', '', #RulesAllowed
3876         'cgp_rpopallowed',    'char', 'NULL',       1, '', '', #RPOPAllowed
3877         'cgp_mailtoall',      'char', 'NULL',       1, '', '', #MailToAll
3878         'cgp_addmailtrailer', 'char', 'NULL',       1, '', '', #AddMailTrailer
3879         'cgp_archiveafter',    'int', 'NULL',      '', '', '', #ArchiveMessagesAfter
3880         #XXX mailing lists
3881         #preferences
3882         'cgp_deletemode',     'varchar', 'NULL', $char_d, '', '',#DeleteMode
3883         'cgp_emptytrash',     'varchar', 'NULL', $char_d, '', '',#EmptyTrash
3884         'cgp_language',       'varchar', 'NULL', $char_d, '', '',#Language
3885         'cgp_timezone',       'varchar', 'NULL', $char_d, '', '',#TimeZone
3886         'cgp_skinname',       'varchar', 'NULL', $char_d, '', '',#SkinName
3887         'cgp_prontoskinname', 'varchar', 'NULL', $char_d, '', '',#ProntoSkinName
3888         'cgp_sendmdnmode',    'varchar', 'NULL', $char_d, '', '',#SendMDNMode
3889         #mail
3890         #XXX RPOP settings
3891         #
3892       ],
3893       'primary_key'  => 'svcnum',
3894       #'unique'       => [ [ 'username', 'domsvc' ] ],
3895       'unique'       => [],
3896       'index'        => [ ['username'], ['domsvc'], ['pbxsvc'] ],
3897       'foreign_keys' => [
3898                           { columns    => [ 'svcnum' ],
3899                             table      => 'cust_svc',
3900                           },
3901                           { columns    => [ 'popnum' ],
3902                             table      => 'svc_acct_pop',
3903                           },
3904                           { columns    => [ 'sectornum' ],
3905                             table      => 'tower_sector',
3906                           },
3907                           { columns    => [ 'routernum' ],
3908                             table      => 'router',
3909                           },
3910                           { columns    => [ 'blocknum' ],
3911                             table      => 'addr_block',
3912                           },
3913                           { columns    => [ 'domsvc' ],
3914                             table      => 'svc_domain', #'cust_svc',
3915                             references => [ 'svcnum' ],
3916                           },
3917                           { columns    => [ 'pbxsvc' ],
3918                             table      => 'svc_pbx', #'cust_svc',
3919                             references => [ 'svcnum' ],
3920                           },
3921                         ],
3922     },
3923
3924     'acct_rt_transaction' => {
3925       'columns' => [
3926         'svcrtid',   'int',    '',   '', '', '', #why am i not a serial
3927         'svcnum',    'int',    '',   '', '', '',
3928         'transaction_id',       'int', '',   '', '', '',
3929         '_date',   @date_type, '', '',
3930         'seconds',   'int', '',   '', '', '', #uhhhh
3931         'support',   'int', '',   '', '', '',
3932       ],
3933       'primary_key'  => 'svcrtid',
3934       'unique'       => [],
3935       'index'        => [ ['svcnum', 'transaction_id'] ],
3936       'foreign_keys' => [
3937                           # problems w/deleted services, and as per below, this
3938                           # is our internal hack, not a customer-facing feature
3939                           #{ columns    => [ 'svcnum' ],
3940                           #  table      => 'svc_acct', #'cust_svc',
3941                           #},
3942
3943                           # 1. RT tables aren't part of our data structure, so
3944                           #     we can't make sure Queue is created already
3945                           # 2. This is our internal hack for time tracking, not
3946                           #     a user-facing feature
3947                           #{ columns    => [ 'transaction_id' ],
3948                           #  table      => 'Transaction',
3949                           #  references => [ 'id' ],
3950                           #},
3951                         ],
3952     },
3953
3954     #'svc_charge' => {
3955     #  'columns' => [
3956     #    'svcnum',    'int',    '',   '',
3957     #    'amount',    @money_type,
3958     #  ],
3959     #  'primary_key' => 'svcnum',
3960     #  'unique' => [ [] ],
3961     #  'index' => [ [] ],
3962     #},
3963
3964     'svc_domain' => {
3965       'columns' => [
3966         'svcnum',           'int',    '',        '', '', '',
3967         'domain',       'varchar',    '',   $char_d, '', '',
3968         'suffix',       'varchar', 'NULL',  $char_d, '', '',
3969         'catchall',         'int', 'NULL',       '', '', '',
3970         'parent_svcnum',    'int', 'NULL',       '', '', '',
3971         'quota',        'varchar', 'NULL',  $char_d, '', '',
3972
3973         #registration info
3974         'registrarnum',     'int', 'NULL',       '', '', '',
3975         'registrarkey', 'varchar', 'NULL',      512, '', '',
3976         'setup_date',      @date_type, '', '',
3977         'renewal_interval', 'int', 'NULL',       '', '', '',
3978         'expiration_date', @date_type, '', '',
3979
3980         #some weird shit australia-specific shit?  yuck.. seems totally unused
3981         'au_registrant_name',       'varchar', 'NULL',  $char_d, '', '',
3982         'au_eligibility_type',      'varchar', 'NULL',  $char_d, '', '',
3983
3984         #communigate pro fields (quota = MaxAccountSize)
3985         'max_accounts',     'int', 'NULL',       '', '', '',
3986         'trailer',         'text', 'NULL',       '', '', '',
3987         'cgp_aliases',  'varchar', 'NULL',      255, '', '',
3988         'cgp_accessmodes','varchar','NULL',     255, '', '', #DomainAccessModes
3989         'cgp_certificatetype','varchar','NULL', $char_d, '', '',
3990
3991         #(account default) settings
3992         'acct_def_password_selfchange',   'char', 'NULL',       1,  '', '',
3993         'acct_def_password_recover',      'char', 'NULL',       1, 'Y', '',
3994         'acct_def_cgp_accessmodes',    'varchar', 'NULL',     255,  '', '',
3995         'acct_def_quota',              'varchar', 'NULL', $char_d,  '', '',
3996         'acct_def_file_quota',         'varchar', 'NULL', $char_d,  '', '',
3997         'acct_def_file_maxnum',        'varchar', 'NULL', $char_d,  '', '',
3998         'acct_def_file_maxsize',       'varchar', 'NULL', $char_d,  '', '',
3999         'acct_def_cgp_rulesallowed',   'varchar', 'NULL', $char_d,  '', '',
4000         'acct_def_cgp_rpopallowed',       'char', 'NULL',       1,  '', '',
4001         'acct_def_cgp_mailtoall',         'char', 'NULL',       1,  '', '',
4002         'acct_def_cgp_addmailtrailer',    'char', 'NULL',       1,  '', '',
4003         'acct_def_cgp_archiveafter',       'int', 'NULL',      '',  '', '',
4004
4005         #(account default) preferences
4006         'acct_def_cgp_deletemode',     'varchar', 'NULL', $char_d,  '', '',
4007         'acct_def_cgp_emptytrash',     'varchar', 'NULL', $char_d,  '', '',
4008         'acct_def_cgp_language',       'varchar', 'NULL', $char_d,  '', '',
4009         'acct_def_cgp_timezone',       'varchar', 'NULL', $char_d,  '', '',
4010         'acct_def_cgp_skinname',       'varchar', 'NULL', $char_d,  '', '',
4011         'acct_def_cgp_prontoskinname', 'varchar', 'NULL', $char_d,  '', '',
4012         'acct_def_cgp_sendmdnmode',    'varchar', 'NULL', $char_d,  '', '',
4013       ],
4014       'primary_key'  => 'svcnum',
4015       'unique'       => [],
4016       'index'        => [ ['domain'] ],
4017       'foreign_keys' => [
4018                           { columns    => [ 'svcnum' ],
4019                             table      => 'cust_svc',
4020                           },
4021                           { columns    => [ 'catchall' ],
4022                             table      => 'svc_acct',
4023                             references => [ 'svcnum' ],
4024                           },
4025                           { columns    => [ 'parent_svcnum' ],
4026                             table      => 'cust_svc',
4027                             references => [ 'svcnum' ],
4028                           },
4029                           { columns    => [ 'registrarnum' ],
4030                             table      => 'registrar',
4031                           },
4032                         ],
4033     },
4034
4035     'svc_dsl' => {
4036       'columns' => [
4037         'svcnum',                    'int',    '',        '', '', '',
4038         'pushed',                    'int', 'NULL',       '', '', '',
4039         'desired_due_date',          'int', 'NULL',       '', '', '',
4040         'due_date',                  'int', 'NULL',       '', '', '',
4041         'vendor_order_id',       'varchar', 'NULL', $char_d,  '', '',
4042         'vendor_qual_id',        'varchar', 'NULL', $char_d,  '', '',
4043         'vendor_order_type',     'varchar', 'NULL', $char_d,  '', '',
4044         'vendor_order_status',   'varchar', 'NULL', $char_d,  '', '',
4045         'first',                 'varchar', 'NULL', $char_d,  '', '',
4046         'last',                  'varchar', 'NULL', $char_d,  '', '',
4047         'company',               'varchar', 'NULL', $char_d,  '', '',
4048         'phonenum',              'varchar', 'NULL',      24, '', '',
4049         'gateway_access_number', 'varchar', 'NULL',      24, '', '',
4050         'loop_type',                'char', 'NULL',       1, '', '',
4051         'local_voice_provider',  'varchar', 'NULL', $char_d, '', '',
4052         'circuitnum',            'varchar', 'NULL', $char_d, '', '',
4053         'rate_band',             'varchar', 'NULL', $char_d, '', '',
4054         'vpi',                       'int', 'NULL',      '', '', '',
4055         'vci',                       'int', 'NULL',      '', '', '',
4056         'isp_chg',                  'char', 'NULL',       1, '', '',
4057         'isp_prev',              'varchar', 'NULL', $char_d, '', '',
4058         'username',              'varchar', 'NULL', $char_d, '', '',
4059         'password',              'varchar', 'NULL', $char_d, '', '',
4060         'staticips',                'text', 'NULL',      '', '', '',
4061         'monitored',                'char', 'NULL',       1, '', '',
4062         'last_pull',                 'int', 'NULL',      '', '', '',
4063       ],
4064       'primary_key'  => 'svcnum',
4065       'unique'       => [ ],
4066       'index'        => [ ['phonenum'], ['vendor_order_id'] ],
4067       'foreign_keys' => [
4068                           { columns    => [ 'svcnum' ],
4069                             table      => 'cust_svc',
4070                           },
4071                         ],
4072     },
4073
4074     'dsl_device' => {
4075       'columns' => [
4076         'devicenum', 'serial',     '', '', '', '',
4077         #part_device?  or our own part_dsl_device?
4078         #'devicepart',   'int',     '', '', '', '',
4079         'svcnum',       'int',     '', '', '', '',
4080         'mac_addr', 'varchar',     '', 12, '', '',
4081       ],
4082       'primary_key'  => 'devicenum',
4083       'unique'       => [ [ 'mac_addr' ], ],
4084       'index'        => [ [ 'svcnum' ], ], # [ 'devicepart' ] ],
4085       'foreign_keys' => [
4086                           { columns    => [ 'svcnum' ],
4087                             table      => 'svc_dsl',
4088                           },
4089                         ],
4090     },
4091
4092     'dsl_note' => {
4093       'columns' => [
4094         'notenum',           'serial',    '',        '', '', '',
4095         'svcnum',     'int', '',       '', '', '',
4096         'author',     'varchar', 'NULL', $char_d,  '', '',
4097         'priority',   'char', 'NULL',       1,  '', '',
4098         '_date',     'int', 'NULL',       '', '', '',
4099         'note',     'text', '',       '', '', '',
4100       ],
4101       'primary_key'  => 'notenum',
4102       'unique'       => [],
4103       'index'        => [ ['svcnum'] ],
4104       'foreign_keys' => [
4105                           { columns    => [ 'svcnum' ],
4106                             table      => 'svc_dsl',
4107                           },
4108                         ],
4109     },
4110
4111     'svc_dish' => {
4112       'columns' => [
4113         'svcnum',   'int',     '',     '', '', '',
4114         'acctnum',  'varchar', '',     16, '', '',
4115         'installdate', @date_type,         '', '',
4116         'note',     'text',    'NULL', '', '', '',
4117       ],
4118       'primary_key'  => 'svcnum',
4119       'unique'       => [],
4120       'index'        => [],
4121       'foreign_keys' => [
4122                           { columns    => [ 'svcnum' ],
4123                             table      => 'cust_svc',
4124                           },
4125                         ],
4126     },
4127
4128     'svc_hardware' => {
4129       'columns' => [
4130         'svcnum',   'int',     '',          '', '', '',
4131         'typenum',  'int',     '',          '', '', '',
4132         'serial',   'varchar', 'NULL', $char_d, '', '',
4133         'ip_addr',  'varchar', 'NULL',      40, '', '',
4134         'hw_addr',  'varchar', 'NULL',      12, '', '',
4135         'smartcard','varchar', 'NULL',      30, '', '',
4136         'statusnum','int',     'NULL',      '', '', '',
4137         'note',     'text',    'NULL',      '', '', '',
4138       ],
4139       'primary_key'  => 'svcnum',
4140       'unique'       => [ ['typenum', 'serial'], ['ip_addr'], ['hw_addr'] ],
4141       'index'        => [],
4142       'foreign_keys' => [
4143                           { columns    => [ 'svcnum' ],
4144                             table      => 'cust_svc',
4145                           },
4146                           { columns    => [ 'typenum' ],
4147                             table      => 'hardware_type',
4148                           },
4149                           { columns    => [ 'statusnum' ],
4150                             table      => 'hardware_status',
4151                           },
4152                         ],
4153     },
4154
4155     'hardware_class' => {
4156       'columns' => [
4157         'classnum',   'serial', '',      '', '', '',
4158         'classname', 'varchar', '', $char_d, '', '',
4159       ],
4160       'primary_key' => 'classnum',
4161       'unique' => [],
4162       'index'  => [],
4163     },
4164
4165     'hardware_type' => {
4166       'columns' => [
4167         'typenum',  'serial',     '',      '', '', '',
4168         'classnum',    'int',     '',      '', '', '',
4169         'model',   'varchar',     '', $char_d, '', '',
4170         'revision','varchar', 'NULL', $char_d, '', '',
4171       ],
4172       'primary_key'  => 'typenum',
4173       'unique'       => [ [ 'classnum', 'model', 'revision' ] ],
4174       'index'        => [],
4175       'foreign_keys' => [
4176                           { columns    => [ 'classnum' ],
4177                             table      => 'hardware_class',
4178                           },
4179                         ],
4180     },
4181
4182     'hardware_status' => {
4183       'columns' => [
4184         'statusnum', 'serial', '',      '', '', '',
4185         'label'    ,'varchar', '', $char_d, '', '',
4186         'disabled',    'char', 'NULL',   1, '', '',
4187       ],
4188       'primary_key' => 'statusnum',
4189       'unique' => [],
4190       'index'  => [],
4191     },
4192
4193     'domain_record' => {
4194       'columns' => [
4195         'recnum',    'serial',     '',  '', '', '',
4196         'svcnum',    'int',     '',  '', '', '',
4197         'reczone',   'varchar', '',  255, '', '',
4198         'recaf',     'char',    '',  2, '', '',
4199         'rectype',   'varchar',    '',  5, '', '',
4200         'recdata',   'varchar', '',  255, '', '',
4201         'ttl',       'int',     'NULL', '', '', '',
4202       ],
4203       'primary_key'  => 'recnum',
4204       'unique'       => [],
4205       'index'        => [ ['svcnum'] ],
4206       'foreign_keys' => [
4207                           { columns    => [ 'svcnum' ],
4208                             table      => 'svc_domain',
4209                           },
4210                         ],
4211     },
4212
4213     'registrar' => {
4214       'columns' => [
4215         'registrarnum',   'serial', '',      '', '', '',
4216         'registrarname', 'varchar', '', $char_d, '', '',
4217       ],
4218       'primary_key' => 'registrarnum',
4219       'unique'      => [],
4220       'index'       => [],
4221     },
4222
4223     'cgp_rule' => {
4224       'columns' => [
4225         'rulenum',  'serial',     '',      '', '', '',
4226         'name',    'varchar',     '', $char_d, '', '',
4227         'comment', 'varchar', 'NULL', $char_d, '', '',
4228         'svcnum',      'int',     '',      '', '', '',
4229         'priority',    'int',     '',      '', '', '',
4230       ],
4231       'primary_key' => 'rulenum',
4232       'unique'      => [ [ 'svcnum', 'name' ] ],
4233       'index'       => [ [ 'svcnum' ] ],
4234       'foreign_keys' => [
4235                           { columns    => [ 'svcnum' ],
4236                             table      => 'cust_svc', #svc_acct / svc_domain
4237                           },
4238                         ],
4239     },
4240
4241     'cgp_rule_condition' => {
4242       'columns' => [
4243         'ruleconditionnum',  'serial',     '',      '', '', '',
4244         'conditionname',    'varchar',     '', $char_d, '', '',
4245         'op',               'varchar', 'NULL', $char_d, '', '',
4246         'params',           'varchar', 'NULL',     255, '', '',
4247         'rulenum',              'int',     '',      '', '', '',
4248       ],
4249       'primary_key'  => 'ruleconditionnum',
4250       'unique'       => [],
4251       'index'        => [ [ 'rulenum' ] ],
4252       'foreign_keys' => [
4253                           { columns    => [ 'rulenum' ],
4254                             table      => 'cgp_rule',
4255                           },
4256                         ],
4257     },
4258
4259     'cgp_rule_action' => {
4260        'columns' => [
4261         'ruleactionnum',  'serial',     '',      '', '', '',
4262         'action',        'varchar',     '', $char_d, '', '',
4263         'params',        'varchar', 'NULL',     255, '', '',
4264         'rulenum',           'int',     '',      '', '', '',
4265       ],
4266       'primary_key'  => 'ruleactionnum',
4267       'unique'       => [],
4268       'index'        => [ [ 'rulenum' ] ],
4269       'foreign_keys' => [
4270                           { columns    => [ 'rulenum' ],
4271                             table      => 'cgp_rule',
4272                           },
4273                         ],
4274    },
4275
4276     'svc_forward' => {
4277       'columns' => [
4278         'svcnum',   'int',            '',   '', '', '',
4279         'srcsvc',   'int',        'NULL',   '', '', '',
4280         'src',      'varchar',    'NULL',  255, '', '',
4281         'dstsvc',   'int',        'NULL',   '', '', '',
4282         'dst',      'varchar',    'NULL',  255, '', '',
4283       ],
4284       'primary_key'  => 'svcnum',
4285       'unique'       => [],
4286       'index'        => [ ['srcsvc'], ['dstsvc'] ],
4287       'foreign_keys' => [
4288                           { columns    => [ 'svcnum' ],
4289                             table      => 'cust_svc',
4290                           },
4291                           { columns    => [ 'srcsvc' ],
4292                             table      => 'svc_acct',
4293                             references => [ 'svcnum' ]
4294                           },
4295                           { columns    => [ 'dstsvc' ],
4296                             table      => 'svc_acct',
4297                             references => [ 'svcnum' ]
4298                           },
4299                         ],
4300     },
4301
4302     'svc_www' => {
4303       'columns' => [
4304         'svcnum',   'int',      '',  '', '', '',
4305         'recnum',   'int',      '',  '', '', '',
4306         'usersvc',  'int',  'NULL',  '', '', '',
4307         'config',   'text', 'NULL',  '', '', '',
4308       ],
4309       'primary_key' => 'svcnum',
4310       'unique'      => [],
4311       'index'       => [],
4312       'foreign_keys' => [
4313                           { columns    => [ 'svcnum' ],
4314                             table      => 'cust_svc',
4315                           },
4316                           { columns    => [ 'recnum' ],
4317                             table      => 'domain_record',
4318                           },
4319                           { columns    => [ 'usersvc' ],
4320                             table      => 'svc_acct',
4321                             references => [ 'svcnum' ]
4322                           },
4323                         ],
4324     },
4325
4326     #'svc_wo' => {
4327     #  'columns' => [
4328     #    'svcnum',    'int',    '',   '',
4329     #    'svcnum',    'int',    '',   '',
4330     #    'svcnum',    'int',    '',   '',
4331     #    'worker',    'varchar',   '',   $char_d,
4332     #    '_date',     @date_type,
4333     #  ],
4334     #  'primary_key' => 'svcnum',
4335     #  'unique' => [ [] ],
4336     #  'index' => [ [] ],
4337     #},
4338
4339     'prepay_credit' => {
4340       'columns' => [
4341         'prepaynum',   'serial',     '',   '', '', '',
4342         'identifier',  'varchar', '', $char_d, '', '',
4343         'amount',      @money_type, '', '',
4344         'seconds',     'int',     'NULL', '', '', '',
4345         'upbytes',     'bigint',     'NULL', '', '', '',
4346         'downbytes',   'bigint',     'NULL', '', '', '',
4347         'totalbytes',  'bigint',     'NULL', '', '', '',
4348         'agentnum',    'int',     'NULL', '', '', '',
4349       ],
4350       'primary_key'  => 'prepaynum',
4351       'unique'       => [ ['identifier'] ],
4352       'index'        => [ ['agentnum'] ],
4353       'foreign_keys' => [
4354                           { columns    => [ 'agentnum' ],
4355                             table      => 'agent',
4356                           },
4357                         ],
4358     },
4359
4360     'port' => {
4361       'columns' => [
4362         'portnum',  'serial',     '',   '', '', '',
4363         'ip',       'varchar', 'NULL', 15, '', '',
4364         'nasport',  'int',     'NULL', '', '', '',
4365         'nasnum',   'int',     '',   '', '', '',
4366       ],
4367       'primary_key'  => 'portnum',
4368       'unique'       => [],
4369       'index'        => [],
4370       'foreign_keys' => [
4371                           { columns    => [ 'nasnum' ],
4372                             table      => 'nas',
4373                           },
4374                         ],
4375     },
4376
4377     'nas' => {
4378       'columns' => [
4379         'nasnum',       'serial',     '',  '',              '', '',
4380         'nasname',     'varchar',     '', 128,              '', '',
4381         'shortname',   'varchar', 'NULL',  32,              '', '',
4382         'type',        'varchar',     '',  30,         'other', '',
4383         'ports',           'int', 'NULL',  '',              '', '',
4384         'secret',      'varchar',     '',  60,        'secret', '',
4385         'server',      'varchar', 'NULL',  64,              '', '',
4386         'community',   'varchar', 'NULL',  50,              '', '',
4387         'description', 'varchar',     '', 200, 'RADIUS Client', '',
4388         'svcnum',          'int', 'NULL',  '',              '', '',
4389       ],
4390       'primary_key'  => 'nasnum',
4391       'unique'       => [ [ 'nasname' ], ],
4392       'index'        => [],
4393       'foreign_keys' => [
4394                           { columns    => [ 'svcnum' ],
4395                             table      => 'svc_broadband',#no? could be _acct?
4396                                                           #remove or cust_svc?
4397                           },
4398                         ],
4399     },
4400
4401     'export_nas' => {
4402       'columns' => [
4403         'exportnasnum', 'serial', '', '', '', '',
4404         'exportnum',       'int', '', '', '', '',
4405         'nasnum',          'int', '', '', '', '',
4406       ],
4407       'primary_key'  => 'exportnasnum',
4408       'unique'       => [ [ 'exportnum', 'nasnum' ] ],
4409       'index'        => [ [ 'exportnum' ], [ 'nasnum' ] ],
4410       'foreign_keys' => [
4411                           { columns    => [ 'exportnum' ],
4412                             table      => 'part_export',
4413                           },
4414                           { columns    => [ 'nasnum' ],
4415                             table      => 'nas',
4416                           },
4417                         ],
4418     },
4419
4420     'queue' => {
4421       'columns' => [
4422         'jobnum',   'bigserial',     '',      '', '', '',
4423         'job',        'varchar',     '',     512, '', '',
4424         '_date',          'int',     '',      '', '', '',
4425         'status',     'varchar',     '', $char_d, '', '',
4426         'statustext',    'text', 'NULL',      '', '', '',
4427         'svcnum',         'int', 'NULL',      '', '', '',
4428         'custnum',        'int', 'NULL',      '', '', '',
4429         'secure',        'char', 'NULL',       1, '', '',
4430         'priority',       'int', 'NULL',      '', '', '',
4431         'usernum',        'int', 'NULL',      '', '', '',
4432       ],
4433       'primary_key'  => 'jobnum',
4434       'unique'       => [],
4435       'index'        => [ [ 'secure' ], [ 'priority' ],
4436                           [ 'job' ], [ 'svcnum' ], [ 'custnum' ], [ 'status' ],
4437                         ],
4438       'foreign_keys' => [
4439 #                          { columns    => [ 'svcnum' ],
4440 #                            table      => 'cust_svc',
4441 #                          },
4442                           { columns    => [ 'custnum' ],
4443                             table      => 'cust_main',
4444                           },
4445                           { columns    => [ 'usernum' ],
4446                             table      => 'access_user',
4447                           },
4448                         ],
4449     },
4450
4451     'queue_arg' => {
4452       'columns' => [
4453         'argnum', 'bigserial',     '', '', '', '',
4454         'jobnum',    'bigint',     '', '', '', '',
4455         'frozen',      'char', 'NULL',  1, '', '',
4456         'arg',         'text', 'NULL', '', '', '',
4457       ],
4458       'primary_key'  => 'argnum',
4459       'unique'       => [],
4460       'index'        => [ [ 'jobnum' ] ],
4461       'foreign_keys' => [
4462                           { columns    => [ 'jobnum' ],
4463                             table      => 'queue',
4464                             on_delete  => 'CASCADE',
4465                           },
4466                         ],
4467     },
4468
4469     'queue_depend' => {
4470       'columns' => [
4471         'dependnum',  'bigserial', '', '', '', '',
4472         'jobnum',        'bigint', '', '', '', '',
4473         'depend_jobnum', 'bigint', '', '', '', '',
4474       ],
4475       'primary_key'  => 'dependnum',
4476       'unique'       => [],
4477       'index'        => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
4478       'foreign_keys' => [
4479                           { columns    => [ 'jobnum' ],
4480                             table      => 'queue',
4481                           },
4482                           { columns    => [ 'depend_jobnum' ],
4483                             table      => 'queue',
4484                             references => [ 'jobnum' ],
4485                             on_delete  => 'CASCADE',
4486                           },
4487                         ],
4488     },
4489
4490     'queue_stat' => {
4491       'columns' => [
4492         'statnum', 'bigserial',     '',  '', '', '',
4493         'jobnum',     'bigint',     '',  '', '', '',
4494         'job',       'varchar',     '', 512, '', '',
4495         'custnum',       'int', 'NULL',  '', '', '',
4496         'insert_date', @date_type, '', '',
4497         'start_date',  @date_type, '', '',
4498         'end_date',    @date_type, '', '',
4499       ],
4500       'primary_key'  => 'statnum',
4501       'unique'       => [], #[ ['jobnum'] ],
4502       'index'        => [],
4503     },
4504
4505     'export_svc' => {
4506       'columns' => [
4507         'exportsvcnum' => 'serial', '', '', '', '',
4508         'exportnum'    => 'int', '', '', '', '',
4509         'svcpart'      => 'int', '', '', '', '',
4510         'role'         => 'varchar', 'NULL', 16, '', '',
4511       ],
4512       'primary_key'  => 'exportsvcnum',
4513       'unique'       => [ [ 'exportnum', 'svcpart' ] ],
4514       'index'        => [ [ 'exportnum' ], [ 'svcpart' ] ],
4515       'foreign_keys' => [
4516                           { columns    => [ 'exportnum' ],
4517                             table      => 'part_export',
4518                           },
4519                           { columns    => [ 'svcpart' ],
4520                             table      => 'part_svc',
4521                           },
4522                         ],
4523     },
4524
4525     'export_cust_svc' => {
4526       'columns' => [
4527         'exportcustsvcnum', 'serial', '', '', '', '',
4528         'exportnum', 'int', '', '', '', '',
4529         'svcnum', 'int', '', '', '', '',
4530         'remoteid', 'varchar', '', 512, '', '',
4531       ],
4532       'primary_key'  => 'exportcustsvcnum',
4533       'unique'       => [ [ 'exportnum', 'svcnum' ] ],
4534       'index'        => [ [ 'exportnum', 'svcnum' ] ],
4535       'foreign_keys' => [
4536                           { columns    => [ 'exportnum' ],
4537                             table      => 'part_export',
4538                           },
4539                           { columns    => [ 'svcnum' ],
4540                             table      => 'cust_svc',
4541                           },
4542                         ],
4543     },
4544
4545     'export_device' => {
4546       'columns' => [
4547         'exportdevicenum' => 'serial', '', '', '', '',
4548         'exportnum'       => 'int', '', '', '', '',
4549         'devicepart'      => 'int', '', '', '', '',
4550       ],
4551       'primary_key'  => 'exportdevicenum',
4552       'unique'       => [ [ 'exportnum', 'devicepart' ] ],
4553       'index'        => [ [ 'exportnum' ], [ 'devicepart' ] ],
4554       'foreign_keys' => [
4555                           { columns    => [ 'exportnum' ],
4556                             table      => 'part_export',
4557                           },
4558                           { columns    => [ 'devicepart' ],
4559                             table      => 'part_device',
4560                           },
4561                         ],
4562     },
4563
4564     'part_export' => {
4565       'columns' => [
4566         'exportnum',   'serial',     '',      '', '', '',
4567         'exportname', 'varchar', 'NULL', $char_d, '', '',
4568         'machine',    'varchar', 'NULL', $char_d, '', '',
4569         'exporttype', 'varchar',     '', $char_d, '', '',
4570         'nodomain',      'char', 'NULL',       1, '', '',
4571         'default_machine','int', 'NULL',      '', '', '',
4572         'no_suspend',    'char', 'NULL',       1, '', '',
4573         # could also have 'no_insert', 'no_replace', etc.
4574       ],
4575       'primary_key'  => 'exportnum',
4576       'unique'       => [],
4577       'index'        => [ [ 'machine' ], [ 'exporttype' ] ],
4578       'foreign_keys' => [
4579                           { columns    => [ 'default_machine' ],
4580                             table      => 'part_export_machine',
4581                             references => [ 'machinenum' ]
4582                           },
4583                         ],
4584     },
4585
4586     'part_export_option' => {
4587       'columns' => [
4588         'optionnum', 'serial', '', '', '', '',
4589         'exportnum', 'int', '', '', '', '',
4590         'optionname', 'varchar', '', $char_d, '', '',
4591         'optionvalue', 'text', 'NULL', '', '', '',
4592       ],
4593       'primary_key'  => 'optionnum',
4594       'unique'       => [],
4595       'index'        => [ [ 'exportnum' ], [ 'optionname' ] ],
4596       'foreign_keys' => [
4597                           { columns    => [ 'exportnum' ],
4598                             table      => 'part_export',
4599                           },
4600                         ],
4601     },
4602
4603     'radius_usergroup' => {
4604       'columns' => [
4605         'usergroupnum', 'serial', '', '', '', '',
4606         'svcnum',       'int', '', '', '', '',
4607         'groupname',    'varchar', 'NULL', $char_d, '', '', #deprecated
4608         'groupnum',     'int', 'NULL', '', '', '',
4609       ],
4610       'primary_key'  => 'usergroupnum',
4611       'unique'       => [],
4612       'index'        => [ [ 'svcnum' ], [ 'groupname' ] ],
4613       'foreign_keys' => [
4614                           { columns    => [ 'svcnum' ],
4615                             table      => 'cust_svc', #svc_acct / svc_broadband
4616                           },
4617                           { columns    => [ 'groupnum' ],
4618                             table      => 'radius_group',
4619                           },
4620                         ],
4621     },
4622
4623     'radius_group' => {
4624       'columns' => [
4625         'groupnum', 'serial', '', '', '', '',
4626         'groupname',    'varchar', '', $char_d, '', '',
4627         'description',  'varchar', 'NULL', $char_d, '', '',
4628         'priority', 'int', '', '', '1', '',
4629         'speed_up', 'int', 'NULL', '', '', '',
4630         'speed_down', 'int', 'NULL', '', '', '',
4631       ],
4632       'primary_key' => 'groupnum',
4633       'unique'      => [ ['groupname'] ],
4634       'index'       => [],
4635     },
4636
4637     'radius_attr' => {
4638       'columns' => [
4639         'attrnum',   'serial', '',      '', '', '',
4640         'groupnum',     'int', '',      '', '', '',
4641         'attrname', 'varchar', '', $char_d, '', '',
4642         'value',    'varchar', '',     255, '', '',
4643         'attrtype',    'char', '',       1, '', '',
4644         'op',          'char', '',       2, '', '',
4645       ],
4646       'primary_key'  => 'attrnum',
4647       'unique'       => [],
4648       'index'        => [ ['groupnum'], ],
4649       'foreign_keys' => [
4650                           { columns    => [ 'groupnum' ],
4651                             table      => 'radius_group',
4652                           },
4653                         ],
4654     },
4655
4656     'msgcat' => {
4657       'columns' => [
4658         'msgnum', 'serial', '', '', '', '',
4659         'msgcode', 'varchar', '', 255, '', '',
4660         'locale', 'varchar', '', 16, '', '',
4661         'msg', 'text', '', '', '', '',
4662       ],
4663       'primary_key' => 'msgnum',
4664       'unique'      => [ [ 'msgcode', 'locale' ] ],
4665       'index'       => [],
4666     },
4667
4668     'cust_tax_exempt' => {
4669       'columns' => [
4670         'exemptnum', 'serial', '', '', '', '',
4671         'custnum',   'int', '', '', '', '',
4672         'taxnum',    'int', '', '', '', '',
4673         'year',      'int', '', '', '', '',
4674         'month',     'int', '', '', '', '',
4675         'amount',   @money_type, '', '',
4676       ],
4677       'primary_key'  => 'exemptnum',
4678       'unique'       => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
4679       'index'        => [],
4680       'foreign_keys' => [
4681                           { columns    => [ 'custnum' ],
4682                             table      => 'cust_main',
4683                           },
4684                           { columns    => [ 'taxnum' ],
4685                             table      => 'cust_main_county',
4686                           },
4687                         ],
4688     },
4689
4690     'cust_tax_exempt_pkg' => {
4691       'columns' => [
4692         'exemptpkgnum',  'serial', '', '', '', '',
4693         #'custnum',      'int', '', '', '', ''
4694         'billpkgnum',   'int', '', '', '', '',
4695         'taxnum',       'int', '', '', '', '',
4696         'taxtype',  'varchar', 'NULL', $char_d, '', '',
4697         'year',         'int', 'NULL', '', '', '',
4698         'month',        'int', 'NULL', '', '', '',
4699         'creditbillpkgnum', 'int', 'NULL', '', '', '',
4700         'amount',       @money_type, '', '',
4701         # exemption type flags
4702         'exempt_cust',          'char', 'NULL', 1, '', '',
4703         'exempt_setup',         'char', 'NULL', 1, '', '',
4704         'exempt_recur',         'char', 'NULL', 1, '', '',
4705         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
4706         'exempt_monthly',       'char', 'NULL', 1, '', '',
4707       ],
4708       'primary_key'  => 'exemptpkgnum',
4709       'unique'       => [],
4710       'index'        => [ [ 'taxnum', 'year', 'month' ],
4711                           [ 'billpkgnum' ],
4712                           [ 'taxnum', 'taxtype' ],
4713                           [ 'creditbillpkgnum' ],
4714                         ],
4715       'foreign_keys' => [
4716                           { columns    => [ 'billpkgnum' ],
4717                             table      => 'cust_bill_pkg',
4718                           },
4719                           { columns    => [ 'creditbillpkgnum' ],
4720                             table      => 'cust_credit_bill_pkg',
4721                           },
4722                         ],
4723     },
4724
4725     'cust_tax_exempt_pkg_void' => {
4726       'columns' => [
4727         'exemptpkgnum',  'int', '', '', '', '',
4728         #'custnum',      'int', '', '', '', ''
4729         'billpkgnum',   'int', '', '', '', '',
4730         'taxnum',       'int', '', '', '', '',
4731         'taxtype',  'varchar', 'NULL', $char_d, '', '',
4732         'year',         'int', 'NULL', '', '', '',
4733         'month',        'int', 'NULL', '', '', '',
4734         'creditbillpkgnum', 'int', 'NULL', '', '', '',
4735         'amount',       @money_type, '', '',
4736         # exemption type flags
4737         'exempt_cust',          'char', 'NULL', 1, '', '',
4738         'exempt_setup',         'char', 'NULL', 1, '', '',
4739         'exempt_recur',         'char', 'NULL', 1, '', '',
4740         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
4741         'exempt_monthly',       'char', 'NULL', 1, '', '',
4742       ],
4743       'primary_key'  => 'exemptpkgnum',
4744       'unique'       => [],
4745       'index'        => [ [ 'taxnum', 'year', 'month' ],
4746                           [ 'billpkgnum' ],
4747                           [ 'taxnum', 'taxtype' ],
4748                           [ 'creditbillpkgnum' ],
4749                         ],
4750       'foreign_keys' => [
4751                           { columns    => [ 'billpkgnum' ],
4752                             table      => 'cust_bill_pkg_void',
4753                           },
4754                           { columns    => [ 'taxnum' ],
4755                             table      => 'cust_main_county',
4756                           },
4757                           { columns    => [ 'creditbillpkgnum' ],
4758                             table      => 'cust_credit_bill_pkg',
4759                           },
4760                         ],
4761     },
4762
4763     'router' => {
4764       'columns' => [
4765         'routernum', 'serial', '', '', '', '',
4766         'routername', 'varchar', '', $char_d, '', '',
4767         'svcnum', 'int', 'NULL', '', '', '',
4768         'agentnum',   'int', 'NULL', '', '', '',
4769         'manual_addr', 'char', 'NULL', 1, '', '',
4770       ],
4771       'primary_key'  => 'routernum',
4772       'unique'       => [],
4773       'index'        => [],
4774       'foreign_keys' => [
4775                           { columns    => [ 'svcnum' ],
4776                             table      => 'cust_svc', #svc_acct / svc_broadband
4777                           },
4778                           { columns    => [ 'agentnum' ],
4779                             table      => 'agent',
4780                           },
4781                         ],
4782     },
4783
4784     'part_svc_router' => {
4785       'columns' => [
4786         'svcrouternum', 'serial', '', '', '', '',
4787         'svcpart', 'int', '', '', '', '',
4788         'routernum', 'int', '', '', '', '',
4789       ],
4790       'primary_key'  => 'svcrouternum',
4791       'unique'       => [],
4792       'index'        => [],
4793       'foreign_keys' => [
4794                           { columns    => [ 'svcpart' ],
4795                             table      => 'part_svc',
4796                           },
4797                           { columns    => [ 'routernum' ],
4798                             table      => 'router',
4799                           },
4800                         ],
4801     },
4802
4803     'addr_block' => {
4804       'columns' => [
4805         'blocknum', 'serial', '', '', '', '',
4806         'routernum', 'int', '', '', '', '',
4807         'ip_gateway', 'varchar', '', 15, '', '',
4808         'ip_netmask', 'int', '', '', '', '',
4809         'agentnum',   'int', 'NULL', '', '', '',
4810         'manual_flag', 'char', 'NULL', 1, '', '',
4811       ],
4812       'primary_key'  => 'blocknum',
4813       'unique'       => [ [ 'blocknum', 'routernum' ] ],
4814       'index'        => [],
4815       'foreign_keys' => [
4816                           #{ columns    => [ 'routernum' ],
4817                           #   table      => 'router',
4818                           #},
4819                           { columns    => [ 'agentnum' ],
4820                             table      => 'agent',
4821                           },
4822                         ],
4823     },
4824
4825     'addr_range' => {
4826       'columns' => [
4827         'rangenum', 'serial', '', '', '', '',
4828         'start',    'varchar', '', 15, '', '',
4829         'length',   'int', '', '', '', '',
4830         'status',   'varchar', 'NULL', 32, '', '',
4831       ],
4832       'primary_key' => 'rangenum',
4833       'unique'      => [],
4834       'index'       => [],
4835     },
4836
4837     'svc_broadband' => {
4838       'columns' => [
4839         'svcnum',                  'int',     '',        '', '', '',
4840         'description',         'varchar', 'NULL',   $char_d, '', '',
4841         'routernum',               'int', 'NULL',        '', '', '',
4842         'blocknum',                'int', 'NULL',        '', '', '',
4843         'sectornum',               'int', 'NULL',        '', '', '',
4844         'speed_up',                'int', 'NULL',        '', '', '',
4845         'speed_down',              'int', 'NULL',        '', '', '',
4846         'ip_addr',             'varchar', 'NULL',        15, '', '',
4847         'mac_addr',            'varchar', 'NULL',        12, '', '',
4848         'authkey',             'varchar', 'NULL',        32, '', '',
4849         'latitude',            'decimal', 'NULL',    '10,7', '', '',
4850         'longitude',           'decimal', 'NULL',    '10,7', '', '',
4851         'altitude',            'decimal', 'NULL',        '', '', '',
4852         'vlan_profile',        'varchar', 'NULL',   $char_d, '', '',
4853         'performance_profile', 'varchar', 'NULL',   $char_d, '', '',
4854         'plan_id',             'varchar', 'NULL',   $char_d, '', '',
4855         'radio_serialnum',     'varchar', 'NULL',   $char_d, '', '',
4856         'radio_location',      'varchar', 'NULL', 2*$char_d, '', '',
4857         'poe_location',        'varchar', 'NULL', 2*$char_d, '', '',
4858         'rssi',                    'int', 'NULL',        '', '', '',
4859         'suid',                    'int', 'NULL',        '', '', '',
4860         'shared_svcnum',           'int', 'NULL',        '', '', '',
4861         'serviceid',           'varchar', 'NULL',        64, '', '',#srvexport/reportfields
4862         'speed_test_up',           'int', 'NULL',        '', '', '',
4863         'speed_test_down',         'int', 'NULL',        '', '', '',
4864         'speed_test_latency',      'int', 'NULL',        '', '', '',
4865       ],
4866       'primary_key'  => 'svcnum',
4867       'unique'       => [ [ 'ip_addr' ], [ 'mac_addr' ] ],
4868       'index'        => [],
4869       'foreign_keys' => [
4870                           { columns    => [ 'svcnum' ],
4871                             table      => 'cust_svc',
4872                           },
4873                           { columns    => [ 'routernum' ],
4874                             table      => 'router',
4875                           },
4876                           { columns    => [ 'blocknum' ],
4877                             table      => 'addr_block',
4878                           },
4879                           { columns    => [ 'sectornum' ],
4880                             table      => 'tower_sector',
4881                           },
4882                           { columns    => [ 'shared_svcnum' ],
4883                             table      => 'svc_broadband',
4884                             references => [ 'svcnum' ],
4885                           },
4886                         ],
4887     },
4888
4889     'tower' => {
4890       'columns' => [
4891         'towernum',    'serial',     '',      '', '', '',
4892         #'agentnum',       'int', 'NULL',      '', '', '',
4893         'towername',  'varchar',     '', $char_d, '', '',
4894         'disabled',      'char', 'NULL',       1, '', '',
4895         'latitude',   'decimal', 'NULL',  '10,7', '', '',
4896         'longitude',  'decimal', 'NULL',  '10,7', '', '',
4897         'coord_auto',    'char', 'NULL',       1, '', '',
4898         'altitude',   'decimal', 'NULL',      '', '', '',
4899         'height',     'decimal', 'NULL',      '', '', '',
4900         'veg_height', 'decimal', 'NULL',      '', '', '',
4901         'color',      'varchar', 'NULL',       6, '', '',
4902         'up_rate_limit',        'int', 'NULL',      '', '', '',
4903         'down_rate_limit',      'int', 'NULL',      '', '', '',
4904       ],
4905       'primary_key' => 'towernum',
4906       'unique'      => [ [ 'towername' ] ], # , 'agentnum' ] ],
4907       'index'       => [],
4908     },
4909
4910     'tower_sector' => {
4911       'columns' => [
4912         'sectornum',     'serial',     '',      '', '', '',
4913         'towernum',         'int',     '',      '', '', '',
4914         'sectorname',   'varchar',     '', $char_d, '', '',
4915         'ip_addr',      'varchar', 'NULL',      15, '', '',
4916         'height',       'decimal', 'NULL',      '', '', '',
4917         'freq_mhz',         'int', 'NULL',      '', '', '',
4918         'direction',        'int', 'NULL',      '', '', '',
4919         'width',            'int', 'NULL',      '', '', '',
4920         'sector_range', 'decimal', 'NULL',      '', '', '',  #?
4921         'downtilt',     'decimal', 'NULL',      '', '', '',
4922         'v_width',          'int', 'NULL',      '', '', '',
4923         'margin',       'decimal', 'NULL',     '', '', '',
4924         'image',           'blob', 'NULL',     '', '', '',
4925         'west',         'decimal', 'NULL', '10,7', '', '',
4926         'east',         'decimal', 'NULL', '10,7', '', '',
4927         'south',        'decimal', 'NULL', '10,7', '', '',
4928         'north',        'decimal', 'NULL', '10,7', '', '',
4929         'title',        'varchar', 'NULL', $char_d,'', '',
4930         'up_rate_limit',          'int', 'NULL',      '', '', '',
4931         'down_rate_limit',        'int', 'NULL',      '', '', '',
4932      ],
4933       'primary_key'  => 'sectornum',
4934       'unique'       => [ [ 'towernum', 'sectorname' ], [ 'ip_addr' ], ],
4935       'index'        => [ [ 'towernum' ] ],
4936       'foreign_keys' => [
4937                           { columns    => [ 'towernum' ],
4938                             table      => 'tower',
4939                           },
4940                         ],
4941     },
4942
4943     'part_virtual_field' => {
4944       'columns' => [
4945         'vfieldpart', 'serial', '', '', '', '',
4946         'dbtable', 'varchar', '', 32, '', '',
4947         'name', 'varchar', '', 32, '', '',
4948         'length', 'int', 'NULL', '', '', '',
4949         'label', 'varchar', 'NULL', 80, '', '',
4950       ],
4951       'primary_key' => 'vfieldpart',
4952       'unique' => [],
4953       'index' => [],
4954     },
4955
4956     'virtual_field' => {
4957       'columns' => [
4958         'vfieldnum', 'serial', '', '', '', '',
4959         'recnum', 'int', '', '', '', '',
4960         'vfieldpart', 'int', '', '', '', '',
4961         'value', 'varchar', '', 128, '', '',
4962       ],
4963       'primary_key'  => 'vfieldnum',
4964       'unique'       => [ [ 'vfieldpart', 'recnum' ] ],
4965       'index'        => [],
4966       'foreign_keys' => [
4967                           { columns    => [ 'vfieldpart' ],
4968                             table      => 'part_virtual_field',
4969                           },
4970                         ],
4971     },
4972
4973     'acct_snarf' => {
4974       'columns' => [
4975         'snarfnum',    'serial',     '',      '', '', '',
4976         'snarfname',  'varchar', 'NULL', $char_d, '', '',
4977         'svcnum',         'int',     '',      '', '', '',
4978         'machine',    'varchar',     '',     255, '', '',
4979         'protocol',   'varchar',     '', $char_d, '', '',
4980         'username',   'varchar',     '', $char_d, '', '',
4981         '_password',  'varchar',     '', $char_d, '', '',
4982         'check_freq',     'int', 'NULL',      '', '', '',
4983         'leavemail',     'char', 'NULL',       1, '', '',
4984         'apop',          'char', 'NULL',       1, '', '',
4985         'tls',           'char', 'NULL',       1, '', '',
4986         'mailbox',    'varchar', 'NULL', $char_d, '', '',
4987       ],
4988       'primary_key'  => 'snarfnum',
4989       'unique'       => [],
4990       'index'        => [ [ 'svcnum' ] ],
4991       'foreign_keys' => [
4992                           { columns    => [ 'svcnum' ],
4993                             table      => 'svc_acct',
4994                           },
4995                         ],
4996     },
4997
4998     'svc_external' => {
4999       'columns' => [
5000         'svcnum',     'int',     '',      '', '', '',
5001         'id',      'bigint', 'NULL',      '', '', '',
5002         'title',  'varchar', 'NULL', $char_d, '', '',
5003       ],
5004       'primary_key'  => 'svcnum',
5005       'unique'       => [],
5006       'index'        => [],
5007       'foreign_keys' => [
5008                           { columns    => [ 'svcnum' ],
5009                             table      => 'cust_svc',
5010                           },
5011                         ],
5012     },
5013
5014     'cust_pay_refund' => {
5015       'columns' => [
5016         'payrefundnum', 'serial', '', '', '', '',
5017         'paynum',  'int', '', '', '', '',
5018         'refundnum',  'int', '', '', '', '',
5019         '_date',    @date_type, '', '',
5020         'amount',   @money_type, '', '',
5021       ],
5022       'primary_key'  => 'payrefundnum',
5023       'unique'       => [],
5024       'index'        => [ ['paynum'], ['refundnum'] ],
5025       'foreign_keys' => [
5026                           { columns    => [ 'paynum' ],
5027                             table      => 'cust_pay',
5028                           },
5029                           { columns    => [ 'refundnum' ],
5030                             table      => 'cust_refund',
5031                           },
5032                         ],
5033     },
5034
5035     'part_pkg_option' => {
5036       'columns' => [
5037         'optionnum', 'serial', '', '', '', '',
5038         'pkgpart', 'int', '', '', '', '',
5039         'optionname', 'varchar', '', $char_d, '', '',
5040         'optionvalue', 'text', 'NULL', '', '', '',
5041       ],
5042       'primary_key'  => 'optionnum',
5043       'unique'       => [],
5044       'index'        => [ [ 'pkgpart' ], [ 'optionname' ] ],
5045       'foreign_keys' => [
5046                           { columns    => [ 'pkgpart' ],
5047                             table      => 'part_pkg',
5048                           },
5049                         ],
5050     },
5051
5052     'part_pkg_vendor' => {
5053       'columns' => [
5054         'num', 'serial', '', '', '', '',
5055         'pkgpart', 'int', '', '', '', '',
5056         'exportnum', 'int', '', '', '', '',
5057         'vendor_pkg_id', 'varchar', '', $char_d, '', '',
5058       ],
5059       'primary_key'  => 'num',
5060       'unique'       => [ [ 'pkgpart', 'exportnum' ] ],
5061       'index'        => [ [ 'pkgpart' ] ],
5062       'foreign_keys' => [
5063                           { columns    => [ 'pkgpart' ],
5064                             table      => 'part_pkg',
5065                           },
5066                           { columns    => [ 'exportnum' ],
5067                             table      => 'part_export',
5068                           },
5069                         ],
5070     },
5071
5072     'part_pkg_report_option' => {
5073       'columns' => [
5074         'num',      'serial',   '',      '', '', '',
5075         'name',     'varchar',  '', $char_d, '', '',
5076         'disabled', 'char', 'NULL',       1, '', '',
5077       ],
5078       'primary_key' => 'num',
5079       'unique' => [ [ 'name' ] ],
5080       'index' => [ [ 'disabled' ] ],
5081     },
5082
5083     'part_pkg_usage' => {
5084       'columns' => [
5085         'pkgusagepart', 'serial',   '', '', '', '',
5086         'pkgpart',  'int',      '', '', '', '',
5087         'minutes',  'double precision',      '', '', '', '',
5088         'priority', 'int',  'NULL', '', '', '',
5089         'shared',   'char', 'NULL',  1, '', '',
5090         'rollover', 'char', 'NULL',  1, '', '',
5091         'description',  'varchar', 'NULL', $char_d, '', '',
5092       ],
5093       'primary_key'  => 'pkgusagepart',
5094       'unique'       => [],
5095       'index'        => [ [ 'pkgpart' ] ],
5096       'foreign_keys' => [
5097                           { columns    => [ 'pkgpart' ],
5098                             table      => 'part_pkg',
5099                           },
5100                         ],
5101     },
5102
5103     'part_pkg_usage_class' => {
5104       'columns' => [
5105         'num',       'serial',  '', '', '', '',
5106         'pkgusagepart', 'int',  '', '', '', '',
5107         'classnum',     'int','NULL', '', '', '',
5108       ],
5109       'primary_key'  => 'num',
5110       'unique'       => [ [ 'pkgusagepart', 'classnum' ] ],
5111       'index'        => [],
5112       'foreign_keys' => [
5113                           { columns    => [ 'pkgusagepart' ],
5114                             table      => 'part_pkg_usage',
5115                           },
5116                           { columns    => [ 'classnum' ],
5117                             table      => 'usage_class',
5118                           },
5119                         ],
5120     },
5121
5122     'part_pkg_fcc_option' => {
5123       'columns' => [
5124         'num',        'serial', '', '', '', '',
5125         'fccoptionname', 'varchar', '', $char_d, '', '',
5126         'pkgpart',       'int', '', '', '', '',
5127         'optionvalue',   'varchar', 'NULL', $char_d, '', '',
5128       ],
5129       'primary_key' => 'num',
5130       'unique'      => [ [ 'fccoptionname', 'pkgpart' ] ],
5131       'index'       => [],
5132     },
5133
5134     'rate' => {
5135       'columns' => [
5136         'ratenum',          'serial',     '', '', '', '',
5137         'ratename',        'varchar', '',$char_d, '', '',
5138         'agentnum',            'int', 'NULL', '', '', '',
5139         'default_detailnum',   'int', 'NULL', '', '', '',
5140       ],
5141       'primary_key' => 'ratenum',
5142       'unique'      => [],
5143       'index'       => [],
5144       'foreign_keys' => [
5145                           { columns    => [ 'agentnum' ],
5146                             table      => 'agent',
5147                           },
5148                         ],
5149     },
5150
5151     'rate_detail' => {
5152       'columns' => [
5153         'ratedetailnum',   'serial',  '',     '',      '', '',
5154         'ratenum',         'int',     '',     '',      '', '',
5155         'orig_regionnum',  'int', 'NULL',     '',      '', '',
5156         'dest_regionnum',  'int', 'NULL',     '',      '', '',
5157         'min_included',    'int',     '',     '',      '', '',
5158         'conn_charge',     'decimal', '', '10,4', '0.0000', '',
5159         'conn_cost',       'decimal', '', '10,4', '0.0000', '',
5160         'conn_sec',        'int',     '',     '',      '0', '',
5161         'min_charge',      'decimal', '', '10,5',       '', '',
5162         'min_cost',        'decimal', '', '10,5','0.00000', '',
5163         'sec_granularity', 'int',     '',     '',       '', '',
5164         'ratetimenum',     'int', 'NULL',     '',       '', '',
5165         'classnum',        'int', 'NULL',     '',       '', '',
5166         'cdrtypenum',      'int', 'NULL',     '',       '', '',
5167         'region_group',   'char', 'NULL',      1,       '', '',
5168         'upstream_mult_charge',  'decimal',  '', '10,4', '0.0000', '',
5169         'upstream_mult_cost',    'decimal',  '', '10,4', '0.0000', '',
5170       ],
5171       'primary_key'  => 'ratedetailnum',
5172       'unique'       => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
5173       'index'        => [ [ 'ratenum', 'dest_regionnum' ],
5174                           [ 'ratenum', 'ratetimenum' ]
5175                         ],
5176       'foreign_keys' => [
5177                           { columns    => [ 'ratenum' ],
5178                             table      => 'rate',
5179                           },
5180                           { columns    => [ 'orig_regionnum' ],
5181                             table      => 'rate_region',
5182                             references => [ 'regionnum' ],
5183                           },
5184                           { columns    => [ 'dest_regionnum' ],
5185                             table      => 'rate_region',
5186                             references => [ 'regionnum' ],
5187                           },
5188                           { columns    => [ 'ratetimenum' ],
5189                             table      => 'rate_time',
5190                           },
5191                           { columns    => [ 'classnum' ],
5192                             table      => 'usage_class',
5193                           },
5194                           { columns    => [ 'cdrtypenum' ],
5195                             table      => 'cdr_type',
5196                           },
5197                         ],
5198     },
5199
5200     'rate_region' => {
5201       'columns' => [
5202         'regionnum',   'serial',      '', '', '', '',
5203         'regionname',  'varchar',     '', $char_d, '', '',
5204         'exact_match', 'char',    'NULL',  1, '', '',
5205       ],
5206       'primary_key' => 'regionnum',
5207       'unique'      => [],
5208       'index'       => [],
5209     },
5210
5211     'rate_prefix' => {
5212       'columns' => [
5213         'prefixnum',   'serial',      '', '', '', '',
5214         'regionnum',   'int',         '', '', '', '',
5215         'countrycode', 'varchar',     '',  3, '', '',
5216         'npa',         'varchar', 'NULL', 10, '', '', #actually the whole prefix
5217         'nxx',         'varchar', 'NULL',  3, '', '', #actually not used
5218         'latanum',     'int',     'NULL',      '', '', '',
5219         'state',       'char',    'NULL',       2, '', '',
5220         'ocn',         'char',    'NULL',       4, '', '',
5221       ],
5222       'primary_key'  => 'prefixnum',
5223       'unique'       => [ [ 'countrycode', 'npa', 'nxx' ] ],
5224       'index'        => [ [ 'countrycode' ], [ 'npa' ], [ 'regionnum' ] ],
5225       'foreign_keys' => [
5226                           { columns    => [ 'regionnum' ],
5227                             table      => 'rate_region',
5228                           },
5229                           { columns    => [ 'latanum' ],
5230                             table      => 'lata',
5231                           },
5232                         ],
5233     },
5234
5235     'rate_time' => {
5236       'columns' => [
5237         'ratetimenum', 'serial',      '',      '', '', '',
5238         'ratetimename',   'varchar',      '', $char_d, '', '',
5239       ],
5240       'primary_key' => 'ratetimenum',
5241       'unique'      => [],
5242       'index'       => [],
5243     },
5244
5245     'rate_time_interval' => {
5246       'columns' => [
5247         'intervalnum', 'serial', '', '', '', '',
5248         'stime',          'int', '', '', '', '',
5249         'etime',          'int', '', '', '', '',
5250         'ratetimenum',    'int', '', '', '', '',
5251       ],
5252       'primary_key'  => 'intervalnum',
5253       'unique'       => [],
5254       'index'        => [],
5255       'foreign_keys' => [
5256                           { columns    => [ 'ratetimenum' ],
5257                             table      => 'rate_time',
5258                           },
5259                         ],
5260      },
5261
5262     #not really part of the above rate_ stuff (used with flat rate rather than
5263     # rated billing), but could be eventually, and its a rate
5264     'rate_tier' => {
5265       'columns' => [
5266         'tiernum',   'serial', '',      '', '', '',
5267         'tiername', 'varchar', '', $char_d, '', '',
5268       ],
5269       'primary_key' => 'tiernum',
5270       'unique'      => [ [ 'tiername'], ],
5271       'index'       => [],
5272     },
5273
5274     'rate_tier_detail' => {
5275       'columns' => [
5276         'tierdetailnum', 'serial', '',     '', '', '',
5277         'tiernum',          'int', '',     '', '', '',
5278         'min_quan',         'int', '',     '', '', '',
5279         'min_charge',   'decimal', '', '10,4', '', '',
5280       ],
5281       'primary_key'  => 'tierdetailnum',
5282       'unique'       => [],
5283       'index'        => [ ['tiernum'], ],
5284       'foreign_keys' => [
5285                           { columns    => [ 'tiernum' ],
5286                             table      => 'rate_tier',
5287                           },
5288                         ],
5289     },
5290
5291     'usage_class' => {
5292       'columns' => [
5293         'classnum',    'serial',      '',      '', '', '',
5294         'weight',      'int',     'NULL',      '', '', '',
5295         'classname',   'varchar',     '', $char_d, '', '',
5296         'format',      'varchar', 'NULL', $char_d, '', '',
5297         'disabled',    'char',    'NULL',       1, '', '',
5298       ],
5299       'primary_key' => 'classnum',
5300       'unique' => [],
5301       'index' => [ ['disabled'] ],
5302     },
5303
5304     'reg_code' => {
5305       'columns' => [
5306         'codenum',   'serial',    '', '', '', '',
5307         'code',      'varchar',   '', $char_d, '', '',
5308         'agentnum',  'int',       '', '', '', '',
5309       ],
5310       'primary_key'  => 'codenum',
5311       'unique'       => [ [ 'agentnum', 'code' ] ],
5312       'index'        => [ [ 'agentnum' ] ],
5313       'foreign_keys' => [
5314                           { columns    => [ 'agentnum' ],
5315                             table      => 'agent',
5316                           },
5317                         ],
5318      },
5319
5320     'reg_code_pkg' => {
5321       'columns' => [
5322         'codepkgnum', 'serial', '', '', '', '',
5323         'codenum',   'int',    '', '', '', '',
5324         'pkgpart',   'int',    '', '', '', '',
5325       ],
5326       'primary_key'  => 'codepkgnum',
5327       'unique'       => [ [ 'codenum', 'pkgpart' ] ],
5328       'index'        => [ [ 'codenum' ] ],
5329       'foreign_keys' => [
5330                           { columns    => [ 'codenum' ],
5331                             table      => 'reg_code',
5332                           },
5333                           { columns    => [ 'pkgpart' ],
5334                             table      => 'part_pkg',
5335                           },
5336                         ],
5337     },
5338
5339     'clientapi_session' => {
5340       'columns' => [
5341         'sessionnum',  'serial',  '', '', '', '',
5342         'sessionid',  'varchar',  '', $char_d, '', '',
5343         'namespace',  'varchar',  '', $char_d, '', '',
5344       ],
5345       'primary_key' => 'sessionnum',
5346       'unique'      => [ [ 'sessionid', 'namespace' ] ],
5347       'index'       => [],
5348     },
5349
5350     'clientapi_session_field' => {
5351       'columns' => [
5352         'fieldnum',    'serial',     '', '', '', '',
5353         'sessionnum',     'int',     '', '', '', '',
5354         'fieldname',  'varchar',     '', $char_d, '', '',
5355         'fieldvalue',    'text', 'NULL', '', '', '',
5356       ],
5357       'primary_key'  => 'fieldnum',
5358       'unique'       => [ [ 'sessionnum', 'fieldname' ] ],
5359       'index'        => [],
5360       'foreign_keys' => [
5361                           { columns    => [ 'sessionnum' ],
5362                             table      => 'clientapi_session',
5363                           },
5364                         ],
5365     },
5366
5367     'payment_gateway' => {
5368       'columns' => [
5369         'gatewaynum',       'serial',   '',     '', '', '',
5370         'gateway_namespace','varchar',  'NULL', $char_d, '', '',
5371         'gateway_module',   'varchar',  '',     $char_d, '', '',
5372         'gateway_username', 'varchar',  'NULL', $char_d, '', '',
5373         'gateway_password', 'varchar',  'NULL', $char_d, '', '',
5374         'gateway_action',   'varchar',  'NULL', $char_d, '', '',
5375         'gateway_callback_url', 'varchar',  'NULL', 255, '', '',
5376         'gateway_cancel_url',   'varchar',  'NULL', 255, '', '',
5377         'disabled',   'char',  'NULL',   1, '', '',
5378       ],
5379       'primary_key' => 'gatewaynum',
5380       'unique' => [],
5381       'index'  => [ [ 'disabled' ] ],
5382     },
5383
5384     'payment_gateway_option' => {
5385       'columns' => [
5386         'optionnum',   'serial',  '',     '', '', '',
5387         'gatewaynum',  'int',     '',     '', '', '',
5388         'optionname',  'varchar', '',     $char_d, '', '',
5389         'optionvalue', 'text',    'NULL', '', '', '',
5390       ],
5391       'primary_key'  => 'optionnum',
5392       'unique'       => [],
5393       'index'        => [ [ 'gatewaynum' ], [ 'optionname' ] ],
5394       'foreign_keys' => [
5395                           { columns    => [ 'gatewaynum' ],
5396                             table      => 'payment_gateway',
5397                           },
5398                         ],
5399     },
5400
5401     'agent_payment_gateway' => {
5402       'columns' => [
5403         'agentgatewaynum', 'serial', '', '', '', '',
5404         'agentnum',        'int', '', '', '', '',
5405         'gatewaynum',      'int', '', '', '', '',
5406         'cardtype',        'varchar', 'NULL', $char_d, '', '',
5407         'taxclass',        'varchar', 'NULL', $char_d, '', '',
5408       ],
5409       'primary_key'  => 'agentgatewaynum',
5410       'unique'       => [],
5411       'index'        => [ [ 'agentnum', 'cardtype' ], ],
5412
5413       'foreign_keys' => [
5414
5415                           { columns    => [ 'agentnum' ],
5416                             table      => 'agent',
5417                           },
5418                           { columns    => [ 'gatewaynum' ],
5419                             table      => 'payment_gateway',
5420                           },
5421                         ],
5422     },
5423
5424     'banned_pay' => {
5425       'columns' => [
5426         'bannum',        'serial',     '',      '', '', '',
5427         'payby',           'char',     '',       4, '', '',
5428         'payinfo',      'varchar',     '',     128, '', '', #say, a 512-big digest _hex encoded
5429         'payinfo_hash', 'varchar', 'NULL',      32, '', '',
5430         #'paymask',      'varchar',  'NULL', $char_d, '', ''
5431         '_date',                @date_type,         '', '',
5432         'end_date',             @date_type,         '', '',
5433         'otaker',       'varchar', 'NULL',      32, '', '',
5434         'usernum',          'int', 'NULL',      '', '', '',
5435         'bantype',      'varchar', 'NULL', $char_d, '', '',
5436         'reason',       'varchar', 'NULL', $char_d, '', '',
5437       ],
5438       'primary_key'  => 'bannum',
5439       'unique'       => [],
5440       'index'        => [ [ 'payby', 'payinfo' ], [ 'usernum' ], ],
5441       'foreign_keys' => [
5442                           { columns    => [ 'usernum' ],
5443                             table      => 'access_user',
5444                           },
5445                         ],
5446     },
5447
5448     'pkg_category' => {
5449       'columns' => [
5450         'categorynum',        'serial',     '',      '', '', '',
5451         'categoryname',      'varchar',     '', $char_d, '', '',
5452         'weight',                'int', 'NULL',      '', '', '',
5453         'ticketing_queueid',     'int', 'NULL',      '', '', '',
5454         'condense',             'char', 'NULL',       1, '', '',
5455         'disabled',             'char', 'NULL',       1, '', '',
5456       ],
5457       'primary_key' => 'categorynum',
5458       'unique' => [],
5459       'index' => [ ['disabled'] ],
5460     },
5461
5462     'pkg_class' => {
5463       'columns' => [
5464         'classnum',    'serial',   '',      '', '', '',
5465         'classname',   'varchar',  '', $char_d, '', '',
5466         'categorynum', 'int',  'NULL',      '', '', '',
5467         'disabled',    'char', 'NULL',       1, '', '',
5468         'fcc_ds0s',      'int',     'NULL', '', '', '',
5469       ],
5470       'primary_key'  => 'classnum',
5471       'unique'       => [],
5472       'index'        => [ ['disabled'] ],
5473       'foreign_keys' => [
5474                           { columns    => [ 'categorynum' ],
5475                             table      => 'pkg_category',
5476                           },
5477                         ],
5478     },
5479
5480     'cdr' => {
5481       'columns' => [
5482         # qw( name type null length default local );
5483
5484         ###
5485         #asterisk fields
5486         ###
5487
5488         'acctid',   'bigserial',  '', '', '', '',
5489         #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
5490         'calldate', 'timestamp',   '',      '', \'now()', '',
5491         'clid',        'varchar',  '', $char_d, \"''", '',
5492         'src',         'varchar',  '', $char_d, \"''", '',
5493         'dst',         'varchar',  '', $char_d, \"''", '',
5494         'dcontext',    'varchar',  '', $char_d, \"''", '',
5495         'channel',     'varchar',  '', $char_d, \"''", '',
5496         'dstchannel',  'varchar',  '', $char_d, \"''", '',
5497         'lastapp',     'varchar',  '', $char_d, \"''", '',
5498         'lastdata',    'varchar',  '',     255, \"''", '',
5499
5500         #currently only opensips & voipswitch
5501         'src_ip_addr', 'varchar',  'NULL',  15,    '', '',
5502
5503         #currently only opensips
5504         'dst_ip_addr', 'varchar',  'NULL',  15,    '', '',
5505
5506         #currently only u4:
5507         # terminating number (as opposed to dialed destination)
5508         'dst_term',    'varchar',  'NULL', $char_d, '', '',
5509
5510         #these don't seem to be logged by most of the SQL cdr_* modules
5511         #except tds under sql-illegal names, so;
5512         # ... don't rely on them for rating?
5513         # and, what they hey, i went ahead and changed the names and data types
5514         # to freeside-style dates...
5515           #'start',  'timestamp', 'NULL',  '',    '', '',
5516           #'answer', 'timestamp', 'NULL',  '',    '', '',
5517           #'end',    'timestamp', 'NULL',  '',    '', '',
5518         'startdate',  @date_type, '', '',
5519         'answerdate', @date_type, '', '',
5520         'enddate',    @date_type, '', '',
5521         #
5522
5523         'duration',    'int',      '',      '',     0, '',
5524         'billsec',     'int',      '',      '',     0, '',
5525         'disposition', 'varchar',  '',      45, \"''", '',
5526         'amaflags',    'int',      '',      '',     0, '',
5527         'accountcode', 'varchar',  '',      32, \"''", '',
5528         'uniqueid',    'varchar',  '', $char_d, \"''", '',
5529         'userfield',   'varchar',  '',     512, \"''", '',
5530
5531         'max_callers', 'int',  'NULL',      '',    '', '',
5532
5533         ###
5534         # old fields for unitel/RSLCOM/convergent that don't map to asterisk
5535         # ones we adoped moved to "own fields" section below
5536         # charged_party, upstream_price, rated_price, carrierid, cdrtypenum
5537         ###
5538
5539         'upstream_currency',      'char', 'NULL',       3, '', '',
5540         'upstream_rateplanid',     'int', 'NULL',      '', '', '', #?
5541
5542         # how it was rated internally...
5543         'ratedetailnum',           'int', 'NULL',      '', '', '',
5544
5545         'distance',            'decimal', 'NULL',      '', '', '',
5546         'islocal',                 'int', 'NULL',      '', '', '', # '',  '', 0, '' instead?
5547
5548         #cdr_calltype: the big list in appendix 2
5549         'calltypenum',             'int', 'NULL',      '', '', '',
5550
5551         'description',         'varchar', 'NULL', $char_d, '', '',
5552         'quantity',                'int', 'NULL',      '', '', '',
5553
5554         'upstream_rateid',         'int', 'NULL',      '', '', '',
5555
5556         ###
5557         # more fields, for GSM imports
5558         ###
5559         'servicecode',             'int', 'NULL',      '', '', '',
5560         'quantity_able',           'int', 'NULL',      '', '', '',
5561
5562         ###
5563         #and now for our own fields
5564         ###
5565
5566         'cdrtypenum',              'int', 'NULL',      '', '', '',
5567
5568         'charged_party',       'varchar', 'NULL', $char_d, '', '',
5569         'charged_party_imsi',  'varchar', 'NULL', $char_d, '', '',
5570
5571         'upstream_price',      'decimal', 'NULL',  '10,5', '', '',
5572
5573         #currently only voipswitch
5574         #'upstream_rate',      'decimal', 'NULL',  '10,5', '', '',
5575
5576         'upstream_src_regionname', 'varchar', 'NULL', $char_d, '', '',
5577         'upstream_dst_regionname', 'varchar', 'NULL', $char_d, '', '',
5578
5579         # how it was rated internally...
5580         'rated_pretty_dst',       'varchar', 'NULL', $char_d, '', '',
5581         'rated_regionname',       'varchar', 'NULL', $char_d, '', '',
5582         'rated_price',            'decimal', 'NULL',  '10,4', '', '',
5583         'rated_seconds',              'int', 'NULL',      '', '', '',
5584         'rated_minutes', 'double precision', 'NULL',      '', '', '',
5585         'rated_granularity',          'int', 'NULL',      '', '', '',
5586         'rated_ratedetailnum',        'int', 'NULL',      '', '', '',
5587         'rated_classnum',             'int', 'NULL',      '', '', '',
5588         'rated_ratename',         'varchar', 'NULL', $char_d, '', '',
5589         'rated_cost',            'decimal', 'NULL',  '10,4', '', '',
5590
5591         # real endpoints of the call
5592         'src_lrn',             'varchar', 'NULL',     '15', '', '',
5593         'dst_lrn',             'varchar', 'NULL',     '15', '', '',
5594
5595         'carrierid',               'bigint', 'NULL',      '', '', '',
5596
5597         # service it was matched to
5598         'svcnum',             'int',   'NULL',     '',   '', '',
5599
5600         #NULL, done (or something)
5601         'freesidestatus', 'varchar',   'NULL',     32,   '', '',
5602
5603         #additional status info (i.e. reason for "skipped" freesidestatus)
5604         'freesidestatustext', 'text',  'NULL',     '',   '', '',
5605
5606         #NULL, done (or something)
5607         'freesiderewritestatus', 'varchar',   'NULL',     32,   '', '',
5608
5609         #an indexed place to put big numbers
5610         'cdrid',         'bigint',     'NULL',     '',  '', '',
5611
5612         #for taqua accountcode rewriting, for starters
5613         'sessionnum',       'int',    'NULL',      '', '', '',
5614         'subscriber',   'varchar',    'NULL', $char_d, '', '',
5615
5616         #old
5617         'cdrbatch',     'varchar',    'NULL',     255, '', '',
5618         #new
5619         'cdrbatchnum',      'int',    'NULL',      '', '', '',
5620
5621         # FK to cust_bill_pkg_detail; having a value here absolutely means
5622         # that the CDR appears on an invoice
5623         'detailnum',     'bigint',    'NULL',      '', '', '',
5624       ],
5625       'primary_key' => 'acctid',
5626       'unique' => [],
5627       'index' => [ [ 'calldate' ],
5628                    [ 'src' ], [ 'dst' ], [ 'dcontext' ], [ 'charged_party' ],
5629                    [ 'startdate' ], [ 'duration' ],
5630                    [ 'cdrtypenum' ], [ 'calltypenum' ],
5631                    [ 'lastapp' ],
5632                    ['accountcode'], ['uniqueid'], ['carrierid'], ['cdrid'],
5633                    [ 'sessionnum' ], [ 'subscriber' ],
5634                    [ 'freesidestatus' ], [ 'freesiderewritestatus' ],
5635                    [ 'cdrbatch' ], [ 'cdrbatchnum' ],
5636                    [ 'src_ip_addr' ], [ 'dst_ip_addr' ], [ 'dst_term' ],
5637                    [ 'detailnum' ],
5638                  ],
5639       #no FKs on cdr table... choosing not to throw errors no matter what's
5640       # thrown in here.  better to have the data.
5641     },
5642
5643     'cdr_batch' => {
5644       'columns' => [
5645         'cdrbatchnum',   'serial',    '',   '', '', '',
5646         'cdrbatch', 'varchar', 'NULL', 255, '', '',
5647         '_date',     @date_type, '', '',
5648       ],
5649       'primary_key' => 'cdrbatchnum',
5650       'unique' => [ [ 'cdrbatch' ] ],
5651       'index' => [],
5652     },
5653
5654     'cdr_termination' => {
5655       'columns' => [
5656         'cdrtermnum', 'bigserial',     '',      '', '', '',
5657         'acctid',        'bigint',     '',      '', '', '',
5658         'termpart',         'int',     '',      '', '', '',#future use see below
5659         'rated_price',  'decimal', 'NULL',  '10,4', '', '',
5660         'rated_seconds',    'int', 'NULL',      '', '', '',
5661         'rated_minutes', 'double precision', 'NULL',   '', '', '',
5662         'rated_granularity','int', 'NULL',      '', '', '',
5663         'status',       'varchar', 'NULL',      32, '', '',
5664         'svcnum',           'int', 'NULL',      '', '', '',
5665       ],
5666       'primary_key'  => 'cdrtermnum',
5667       'unique'       => [ [ 'acctid', 'termpart' ] ],
5668       'index'        => [ [ 'acctid' ], [ 'status' ], ],
5669       'foreign_keys' => [
5670                           { columns    => [ 'acctid' ],
5671                             table      => 'cdr',
5672                           },
5673                           { columns    => [ 'svcnum' ],
5674                             table      => 'cust_svc',
5675                           },
5676                         ],
5677     },
5678
5679     #to handle multiple termination/settlement passes...
5680    # 'part_termination' => {
5681    #   'columns' => [
5682    #     'termpart',       'int', '',      '', '', '',
5683    #     'termname',   'varchar', '', $char_d, '', '',
5684    #     'cdr_column', 'varchar', '', $char_d, '', '', #maybe set it here instead of in the price plan?
5685    #   ],
5686    #   'primary_key' => 'termpart',
5687    #   'unique' => [],
5688    #   'index'  => [],
5689    # },
5690
5691     #the remaining cdr_ tables are not really used
5692     'cdr_calltype' => {
5693       'columns' => [
5694         'calltypenum',   'serial',  '', '', '', '',
5695         'calltypename',  'varchar', '', $char_d, '', '',
5696       ],
5697       'primary_key' => 'calltypenum',
5698       'unique'      => [],
5699       'index'       => [],
5700     },
5701
5702     'cdr_type' => {
5703       'columns' => [
5704         'cdrtypenum'  => 'serial',  '', '', '', '',
5705         'cdrtypename' => 'varchar', '', $char_d, '', '',
5706       ],
5707       'primary_key' => 'cdrtypenum',
5708       'unique'      => [],
5709       'index'       => [],
5710     },
5711
5712     'cdr_carrier' => {
5713       'columns' => [
5714         'carrierid'   =>  'serial',     '',      '', '', '',
5715         'carriername' => 'varchar',     '', $char_d, '', '',
5716         'disabled'    =>    'char', 'NULL',       1, '', '',
5717       ],
5718       'primary_key' => 'carrierid',
5719       'unique'      => [],
5720       'index'       => [],
5721     },
5722
5723     #'cdr_file' => {
5724     #  'columns' => [
5725     #    'filenum',    'serial',     '', '', '', '',
5726     #    'filename',  'varchar',     '', '', '', '',
5727     #    'status',    'varchar', 'NULL', '', '', '',
5728     #  ],
5729     #  'primary_key' => 'filenum',
5730     #  'unique' => [ [ 'filename' ], ], #just change the index if we need to
5731     #                                   # agent-virtualize or have a customer
5732     #                                   # with dup-filename needs or something
5733     #                                   # (only used by cdr.http_and_import for
5734     #                                   #  chrissakes)
5735     #  'index'  => [],
5736     #},
5737
5738     'inventory_item' => {
5739       'columns' => [
5740         'itemnum',   'serial',      '',      '', '', '',
5741         'classnum',  'int',         '',      '', '', '',
5742         'agentnum',  'int',     'NULL',      '', '', '',
5743         'item',      'varchar',     '', $char_d, '', '',
5744         'svcnum',    'int',     'NULL',      '', '', '',
5745         'svc_field', 'varchar', 'NULL', $char_d, '', '',
5746       ],
5747       'primary_key'  => 'itemnum',
5748       'unique'       => [ [ 'classnum', 'item' ] ],
5749       'index'        => [ [ 'classnum' ], [ 'agentnum' ], [ 'svcnum' ] ],
5750       'foreign_keys' => [
5751                           { columns    => [ 'classnum' ],
5752                             table      => 'inventory_class',
5753                           },
5754                           { columns    => [ 'agentnum' ],
5755                             table      => 'agent',
5756                           },
5757                           { columns    => [ 'svcnum' ],
5758                             table      => 'cust_svc',
5759                           },
5760                         ],
5761     },
5762
5763     'inventory_class' => {
5764       'columns' => [
5765         'classnum',  'serial',       '',      '', '', '',
5766         'classname', 'varchar',      '', $char_d, '', '',
5767       ],
5768       'primary_key' => 'classnum',
5769       'unique' => [],
5770       'index'  => [],
5771     },
5772
5773     'access_user_session' => {
5774       'columns' => [
5775         'sessionnum',   'serial',  '',      '', '', '',
5776         'sessionkey',  'varchar',  '', $char_d, '', '',
5777         'usernum',         'int',  '',      '', '', '',
5778         'start_date', @date_type,               '', '',
5779         'last_date',  @date_type,               '', '',
5780       ],
5781       'primary_key'  => 'sessionnum',
5782       'unique'       => [ [ 'sessionkey' ] ],
5783       'index'        => [],
5784       'foreign_keys' => [
5785                           { columns    => [ 'usernum' ],
5786                             table      => 'access_user',
5787                           },
5788                         ],
5789     },
5790
5791     'access_user_session_log' => {
5792       'columns' => [
5793         'sessionlognum', 'serial', '',      '', '', '',
5794         'usernum',          'int', '',      '', '', '',
5795         'start_date',  @date_type,              '', '',
5796         'last_date',   @date_type,              '', '',
5797         'logout_date', @date_type,              '', '',
5798         'logout_type',  'varchar', '', $char_d, '', '',
5799       ],
5800       'primary_key' => 'sessionlognum',
5801       'unique'       => [],
5802       'index'        => [],
5803       'foreign_keys' => [
5804                           { columns    => [ 'usernum' ],
5805                             table      => 'access_user',
5806                           },
5807                         ],
5808     },
5809
5810     'access_user' => {
5811       'columns' => [
5812         'usernum',             'serial',     '',      '', '', '',
5813         'username',           'varchar',     '', $char_d, '', '',
5814         '_password',          'varchar', 'NULL', $char_d, '', '',
5815         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
5816         'last',               'varchar', 'NULL', $char_d, '', '',
5817         'first',              'varchar', 'NULL', $char_d, '', '',
5818         'user_custnum',           'int', 'NULL',      '', '', '',
5819         'report_salesnum',        'int', 'NULL',      '', '', '',
5820         'disabled',              'char', 'NULL',       1, '', '',
5821       ],
5822       'primary_key'  => 'usernum',
5823       'unique'       => [ [ 'username' ] ],
5824       'index'        => [ [ 'user_custnum' ] ],
5825       'foreign_keys' => [
5826                           { columns    => [ 'user_custnum' ],
5827                             table      => 'cust_main',
5828                             references => [ 'custnum' ],
5829                           },
5830                           { columns    => [ 'report_salesnum' ],
5831                             table      => 'sales',
5832                             references => [ 'salesnum' ],
5833                           },
5834                         ],
5835     },
5836
5837     'access_user_pref' => {
5838       'columns' => [
5839         'prefnum',    'serial',       '', '', '', '',
5840         'usernum',     'int',       '', '', '', '',
5841         'prefname', 'varchar', '', $char_d, '', '',
5842         'prefvalue', 'text', 'NULL', '', '', '',
5843         'expiration', @date_type, '', '',
5844       ],
5845       'primary_key'  => 'prefnum',
5846       'unique'       => [],
5847       'index'        => [ [ 'usernum' ] ],
5848       'foreign_keys' => [
5849                           { columns    => [ 'usernum' ],
5850                             table      => 'access_user',
5851                           },
5852                         ],
5853     },
5854
5855     'access_group' => {
5856       'columns' => [
5857         'groupnum',        'serial',     '',      '', '', '',
5858         'groupname',      'varchar',     '', $char_d, '', '',
5859         'session_timeout',    'int', 'NULL',      '', '', '',
5860       ],
5861       'primary_key' => 'groupnum',
5862       'unique' => [ [ 'groupname' ] ],
5863       'index'  => [],
5864     },
5865
5866     'access_usergroup' => {
5867       'columns' => [
5868         'usergroupnum', 'serial', '', '', '', '',
5869         'usernum',         'int', '', '', '', '',
5870         'groupnum',        'int', '', '', '', '',
5871       ],
5872       'primary_key'  => 'usergroupnum',
5873       'unique'       => [ [ 'usernum', 'groupnum' ] ],
5874       'index'        => [ [ 'usernum' ] ],
5875       'foreign_keys' => [
5876                           { columns    => [ 'usernum' ],
5877                             table      => 'access_user',
5878                           },
5879                           { columns    => [ 'groupnum' ],
5880                             table      => 'access_group',
5881                           },
5882                         ],
5883      },
5884
5885     'access_groupagent' => {
5886       'columns' => [
5887         'groupagentnum', 'serial', '', '', '', '',
5888         'groupnum',         'int', '', '', '', '',
5889         'agentnum',         'int', '', '', '', '',
5890       ],
5891       'primary_key'  => 'groupagentnum',
5892       'unique'       => [ [ 'groupnum', 'agentnum' ] ],
5893       'index'        => [ [ 'groupnum' ] ],
5894       'foreign_keys' => [
5895                           { columns    => [ 'groupnum' ],
5896                             table      => 'access_group',
5897                           },
5898                           { columns    => [ 'agentnum' ],
5899                             table      => 'agent',
5900                           },
5901                         ],
5902     },
5903
5904     'access_right' => {
5905       'columns' => [
5906         'rightnum',   'serial', '',      '', '', '',
5907         'righttype', 'varchar', '', $char_d, '', '',
5908         'rightobjnum',   'int', '',      '', '', '',
5909         'rightname', 'varchar', '', $char_d, '', '',
5910       ],
5911       'primary_key' => 'rightnum',
5912       'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
5913       'index'  => [],
5914     },
5915
5916     'access_user_log' => {
5917       'columns'      => [
5918         'lognum',          'serial',     '',        '', '', '',
5919         'usernum',            'int',     '',        '', '', '',
5920         'path',           'varchar',     '', 2*$char_d, '', '',
5921         '_date',                   @date_type,          '', '',
5922         'render_seconds',     'int', 'NULL',        '', '', '',
5923         'pid',                'int', 'NULL',        '', '', '',
5924       ],
5925       'primary_key'  => 'lognum',
5926       'unique'       => [],
5927       'index'        => [ ['usernum'], ['path'], ['_date'] ],
5928     },
5929
5930     'access_user_page_pref' => {
5931       'columns'     => [
5932         'prefnum'     =>  'serial',     '',      '', '', '',
5933         'usernum'     =>     'int',     '',      '', '', '',
5934         'path'        =>    'text',     '',      '', '', '',
5935         'tablenum'    =>     'int', 'NULL',      '', '', '',
5936         '_date'       =>    @date_type,              '', '',
5937         'prefname'    =>    'varchar',  '', $char_d, '', '',
5938         'prefvalue'   =>    'text',     '',      '', '', '',
5939       ],
5940       'primary_key' => 'prefnum',
5941       'unique'      => [ [ 'usernum', 'path', 'tablenum', 'prefname' ] ],
5942       'index'       => [],
5943       'foreign_keys' => [
5944                           { columns   => [ 'usernum' ],
5945                             table     => 'access_user'
5946                           },
5947                         ],
5948     },
5949
5950     'sched_item' => {
5951       'columns' => [
5952         'itemnum',   'serial',      '', '', '', '',
5953         'usernum',      'int',  'NULL', '', '', '',
5954         #'itemname', 'varchar', $char_d, '', '', '',
5955         'disabled',    'char',  'NULL',  1, '', '',
5956       ],
5957       'primary_key'  => 'itemnum',
5958       'unique'       => [ [ 'usernum' ] ],
5959       'index'        => [],
5960       'foreign_keys' => [
5961                           { columns    => [ 'usernum' ],
5962                             table      => 'access_user',
5963                           },
5964                         ],
5965     },
5966
5967     #'sched_item_class'
5968
5969     'sched_avail' => {
5970       'columns' => [
5971         'availnum',      'serial', '', '', '', '',
5972         'itemnum',          'int', '', '', '', '',
5973         'wday',             'int', '', '', '', '',
5974         'stime',            'int', '', '', '', '',
5975         'etime',            'int', '', '', '', '',
5976         'override_date',    @date_type,    '', '',
5977       ],
5978       'primary_key'  => 'availnum',
5979       'unique'       => [],
5980       'index'        => [],
5981       'foreign_keys' => [
5982                           { columns    => [ 'itemnum' ],
5983                             table      => 'sched_item',
5984                           },
5985                         ],
5986     },
5987
5988     'svc_phone' => {
5989       'columns' => [
5990         'svcnum',                         'int',     '',      '', '', '',
5991         'countrycode',                'varchar',     '',       3, '', '',
5992         'phonenum',                   'varchar',     '',      25, '', '', #12 ?
5993         'sim_imsi',                   'varchar', 'NULL',      15, '', '',
5994         'pin',                        'varchar', 'NULL', $char_d, '', '',
5995         'sip_password',               'varchar', 'NULL', $char_d, '', '',
5996         'phone_name',                 'varchar', 'NULL', $char_d, '', '',
5997         'pbxsvc',                         'int', 'NULL',      '', '', '',
5998         'domsvc',                         'int', 'NULL',      '', '', '',
5999         'locationnum',                    'int', 'NULL',      '', '', '',
6000         'forward_svcnum',                 'int', 'NULL',      '', '', '',
6001         'forwarddst',                 'varchar', 'NULL',      15, '', '',
6002         'email',                      'varchar', 'NULL',     255, '', '',
6003         'lnp_status',                 'varchar', 'NULL', $char_d, '', '',
6004         'portable',                      'char', 'NULL',       1, '', '',
6005         'lrn',                           'char', 'NULL',      10, '', '',
6006         'lnp_desired_due_date',           'int', 'NULL',      '', '', '',
6007         'lnp_due_date',                   'int', 'NULL',      '', '', '',
6008         'lnp_other_provider',         'varchar', 'NULL', $char_d, '', '',
6009         'lnp_other_provider_account', 'varchar', 'NULL', $char_d, '', '',
6010         'lnp_reject_reason',          'varchar', 'NULL', $char_d, '', '',
6011         'lnp_portid',                 'varchar', 'NULL', $char_d, '', '',
6012         'lnp_signature',                 'char', 'NULL',       1, '', '',
6013         'lnp_bill',                      'char', 'NULL',       1, '', '',
6014         'sms_carrierid',                  'int', 'NULL',      '', '', '',
6015         'sms_account',                'varchar', 'NULL', $char_d, '', '',
6016         'max_simultaneous',               'int', 'NULL',      '', '', '',
6017         'e911_class',                    'char', 'NULL',       1, '', '',
6018         'e911_type',                     'char', 'NULL',       1, '', '',
6019         'circuit_svcnum',                 'int', 'NULL',      '', '', '',
6020         'sip_server',                 'varchar', 'NULL', $char_d, '', '',
6021       ],
6022       'primary_key'  => 'svcnum',
6023       'unique'       => [ [ 'sms_carrierid', 'sms_account'] ],
6024       'index'        => [ ['countrycode', 'phonenum'], ['pbxsvc'], ['domsvc'],
6025                           ['locationnum'], ['sms_carrierid'],
6026                         ],
6027       'foreign_keys' => [
6028                           { columns    => [ 'svcnum' ],
6029                             table      => 'cust_svc',
6030                           },
6031                           { columns    => [ 'pbxsvc' ],
6032                             table      => 'svc_pbx', #'cust_svc',
6033                             references => [ 'svcnum' ],
6034                           },
6035                           { columns    => [ 'domsvc' ],
6036                             table      => 'svc_domain', #'cust_svc',
6037                             references => [ 'svcnum' ],
6038                           },
6039                           { columns    => [ 'locationnum' ],
6040                             table      => 'cust_location',
6041                           },
6042                           { columns    => [ 'sms_carrierid' ],
6043                             table      => 'cdr_carrier',
6044                             references => [ 'carrierid' ],
6045                           },
6046                           { columns    => [ 'circuit_svcnum' ],
6047                             table      => 'svc_circuit',
6048                             references => [ 'svcnum' ],
6049                           },
6050                         ],
6051     },
6052
6053     'phone_device' => {
6054       'columns' => [
6055         'devicenum', 'serial',     '', '', '', '',
6056         'devicepart',   'int',     '', '', '', '',
6057         'svcnum',       'int',     '', '', '', '',
6058         'mac_addr', 'varchar', 'NULL', 12, '', '',
6059       ],
6060       'primary_key'  => 'devicenum',
6061       'unique'       => [ [ 'mac_addr' ], ],
6062       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6063       'foreign_keys' => [
6064                           { columns    => [ 'devicepart' ],
6065                             table      => 'part_device',
6066                           },
6067                           { columns    => [ 'svcnum' ],
6068                             table      => 'svc_phone',
6069                           },
6070                         ],
6071     },
6072
6073     'part_device' => {
6074       'columns' => [
6075         'devicepart', 'serial',  '',      '', '', '',
6076         'devicename', 'varchar', '', $char_d, '', '',
6077         'inventory_classnum', 'int', 'NULL', '', '', '',
6078         'title',      'varchar', 'NULL', $char_d, '', '',
6079       ],
6080       'primary_key'  => 'devicepart',
6081       'unique'       => [ [ 'devicename' ] ], #?
6082       'index'        => [],
6083       'foreign_keys' => [
6084                           { columns    => [ 'inventory_classnum' ],
6085                             table      => 'inventory_class',
6086                             references => [ 'classnum' ],
6087                           },
6088                         ],
6089     },
6090
6091     'phone_avail' => {
6092       'columns' => [
6093         'availnum',    'serial',      '',      '', '', '',
6094         'exportnum',   'int',         '',      '', '', '',
6095         'countrycode', 'varchar',     '',       3, '', '',
6096         'state',       'char',    'NULL',       2, '', '',
6097         'npa',         'char',        '',       3, '', '',
6098         'nxx',         'char',    'NULL',       3, '', '',
6099         'station',     'char',    'NULL',       4, '', '',
6100         'name',        'varchar', 'NULL', $char_d, '', '',
6101         'rate_center_abbrev', 'varchar', 'NULL', $char_d, '', '',
6102         'latanum',      'int',     'NULL',      '', '', '',
6103         'msanum',       'int', 'NULL', '', '', '',
6104         'ordernum',      'int',     'NULL',      '', '', '',
6105         'svcnum',      'int',     'NULL',      '', '', '',
6106         'availbatch', 'varchar',  'NULL', $char_d, '', '',
6107       ],
6108       'primary_key'  => 'availnum',
6109       'unique'       => [],
6110       'index'        => [ ['exportnum','countrycode','state'],    #npa search
6111                           ['exportnum','countrycode','npa'],      #nxx search
6112                           ['exportnum','countrycode','npa','nxx'],#station srch
6113                           [ 'exportnum','countrycode','npa','nxx','station'], #
6114                           [ 'svcnum' ],
6115                           [ 'availbatch' ],
6116                           [ 'latanum' ],
6117                         ],
6118       'foreign_keys' => [
6119                           { columns    => [ 'exportnum' ],
6120                             table      => 'part_export',
6121                           },
6122                           { columns    => [ 'latanum' ],
6123                             table      => 'lata',
6124                           },
6125                           { columns    => [ 'msanum' ],
6126                             table      => 'msa',
6127                           },
6128                           { columns    => [ 'ordernum' ],
6129                             table      => 'did_order',
6130                           },
6131                           { columns    => [ 'svcnum' ],
6132                             table      => 'svc_phone',
6133                           },
6134                         ],
6135     },
6136
6137     'lata' => {
6138       'columns' => [
6139         'latanum',    'int',      '',      '', '', '',
6140         'description',   'varchar',    '',      $char_d, '', '',
6141         'have_usage',   'int',    'NULL',      '', '', '',
6142       ],
6143       'primary_key' => 'latanum',
6144       'unique' => [],
6145       'index'  => [],
6146     },
6147
6148     'msa' => {
6149       'columns' => [
6150         'msanum',    'int',      '',      '', '', '',
6151         'description',   'varchar',    '',      $char_d, '', '',
6152       ],
6153       'primary_key' => 'msanum',
6154       'unique' => [],
6155       'index'  => [],
6156     },
6157
6158     'rate_center' => {
6159       'columns' => [
6160         'ratecenternum',    'serial',      '',      '', '', '',
6161         'description',   'varchar',    '',      $char_d, '', '',
6162       ],
6163       'primary_key' => 'ratecenternum',
6164       'unique' => [],
6165       'index'  => [],
6166     },
6167
6168     'did_vendor' => {
6169       'columns' => [
6170         'vendornum',    'serial',      '',      '', '', '',
6171         'vendorname',   'varchar',        '',     $char_d, '', '',
6172       ],
6173       'primary_key' => 'vendornum',
6174       'unique' => [],
6175       'index'  => [],
6176     },
6177
6178     'did_order_item' => {
6179       'columns' => [
6180         'orderitemnum',    'serial',      '',      '', '', '',
6181         'ordernum',    'int',      '',      '', '', '',
6182         'msanum',      'int',     'NULL',      '', '', '',
6183         'npa',      'int',     'NULL',      '', '', '',
6184         'latanum',      'int',     'NULL',      '', '', '',
6185         'ratecenternum',      'int',     'NULL',      '', '', '',
6186         'state',       'char',    'NULL',       2, '', '',
6187         'quantity',      'int',     '',      '', '', '',
6188         'custnum',   'int', 'NULL', '', '', '',
6189       ],
6190       'primary_key'  => 'orderitemnum',
6191       'unique'       => [],
6192       'index'        => [],
6193       'foreign_keys' => [
6194                           { columns    => [ 'ordernum' ],
6195                             table      => 'did_order',
6196                           },
6197                           { columns    => [ 'msanum' ],
6198                             table      => 'msa',
6199                           },
6200                           { columns    => [ 'latanum' ],
6201                             table      => 'lata',
6202                           },
6203                           { columns    => [ 'ratecenternum' ],
6204                             table      => 'rate_center',
6205                           },
6206                           { columns    => [ 'custnum' ],
6207                             table      => 'cust_main',
6208                           },
6209                         ],
6210     },
6211
6212     'did_order' => {
6213       'columns' => [
6214         'ordernum',    'serial',      '',      '', '', '',
6215         'vendornum',   'int',       '',      '', '', '',
6216         'vendor_order_id',   'varchar',  'NULL',   $char_d, '', '',
6217         'custnum',   'int', 'NULL', '', '', '',
6218         'submitted',      'int',     '',      '', '', '',
6219         'confirmed',      'int',     'NULL',      '', '', '',
6220         'received',      'int',     'NULL',      '', '', '',
6221       ],
6222       'primary_key'  => 'ordernum',
6223       'unique'       => [ [ 'vendornum', 'vendor_order_id' ] ],
6224       'index'        => [],
6225       'foreign_keys' => [
6226                           { columns    => [ 'vendornum' ],
6227                             table      => 'did_vendor',
6228                           },
6229                           { columns    => [ 'custnum' ],
6230                             table      => 'cust_main',
6231                           },
6232                         ],
6233     },
6234
6235     'reason_type' => {
6236       'columns' => [
6237         'typenum',   'serial',  '', '', '', '',
6238         'class',     'char', '', 1, '', '',
6239         'type',     'varchar', '', $char_d, '', '',
6240       ],
6241       'primary_key' => 'typenum',
6242       'unique' => [],
6243       'index' => [],
6244     },
6245
6246     'reason' => {
6247       'columns' => [
6248         'reasonnum',     'serial',  '', '', '', '',
6249         'reason_type',   'int',  '', '', '', '',
6250         'reason',        'text', '', '', '', '',
6251         'disabled',      'char',    'NULL', 1, '', '',
6252         'unsuspend_pkgpart', 'int',  'NULL', '', '', '',
6253         'unsuspend_hold','char',    'NULL', 1, '', '',
6254         'unused_credit', 'char',    'NULL', 1, '', '',
6255         'feepart',        'int', 'NULL', '', '', '',
6256         'fee_on_unsuspend','char',  'NULL', 1, '', '',
6257         'fee_hold',      'char',    'NULL', 1, '', '',
6258       ],
6259       'primary_key'  => 'reasonnum',
6260       'unique'       => [],
6261       'index'        => [],
6262       'foreign_keys' => [
6263                           { columns    => [ 'reason_type' ],
6264                             table      => 'reason_type',
6265                             references => [ 'typenum' ],
6266                           },
6267                           { columns    => [ 'unsuspend_pkgpart' ],
6268                             table      => 'part_pkg',
6269                             references => [ 'pkgpart' ],
6270                           },
6271                         ],
6272     },
6273
6274     'conf' => {
6275       'columns' => [
6276         'confnum',  'serial',     '',      '', '', '',
6277         'agentnum', 'int',    'NULL',      '', '', '',
6278         'locale',   'varchar','NULL',      16, '', '',
6279         'name',     'varchar',    '', $char_d, '', '',
6280         'value',    'text',   'NULL',      '', '', '',
6281       ],
6282       'primary_key'  => 'confnum',
6283       'unique'       => [ [ 'agentnum', 'locale', 'name' ] ],
6284       'index'        => [],
6285       'foreign_keys' => [
6286                           { columns    => [ 'agentnum' ],
6287                             table      => 'agent',
6288                           },
6289                         ],
6290     },
6291
6292     'pkg_referral' => {
6293       'columns' => [
6294         'pkgrefnum',     'serial', '', '', '', '',
6295         'pkgnum',        'int',    '', '', '', '',
6296         'refnum',        'int',    '', '', '', '',
6297       ],
6298       'primary_key'  => 'pkgrefnum',
6299       'unique'       => [ [ 'pkgnum', 'refnum' ] ],
6300       'index'        => [ [ 'pkgnum' ], [ 'refnum' ] ],
6301       'foreign_keys' => [
6302                           { columns    => [ 'pkgnum' ],
6303                             table      => 'cust_pkg',
6304                           },
6305                           { columns    => [ 'refnum' ],
6306                             table      => 'part_referral',
6307                           },
6308                         ],
6309     },
6310
6311     'svc_pbx' => {
6312       'columns' => [
6313         'svcnum',           'int',     '',      '', '', '',
6314         'id',               'int', 'NULL',      '', '', '',
6315         'uuid',            'char', 'NULL',      36, '', '',
6316         'title',        'varchar', 'NULL', $char_d, '', '',
6317         'max_extensions',   'int', 'NULL',      '', '', '',
6318         'max_simultaneous', 'int', 'NULL',      '', '', '',
6319         'ip_addr',      'varchar', 'NULL',      40, '', '',
6320       ],
6321       'primary_key'  => 'svcnum',
6322       'unique'       => [],
6323       'index'        => [ [ 'id' ], [ 'uuid' ] ],
6324       'foreign_keys' => [
6325                           { columns    => [ 'svcnum' ],
6326                             table      => 'cust_svc',
6327                           },
6328                         ],
6329     },
6330
6331     'pbx_extension' => {
6332       'columns' => [
6333         'extensionnum',  'serial',     '',      '', '', '',
6334         'svcnum',           'int',     '',      '', '', '',
6335         'extension',    'varchar',     '', $char_d, '', '',
6336         'pin',          'varchar', 'NULL', $char_d, '', '',
6337         'sip_password', 'varchar', 'NULL', $char_d, '', '',
6338         'phone_name',   'varchar', 'NULL', $char_d, '', '',
6339       ],
6340       'primary_key'  => 'extensionnum',
6341       'unique'       => [ [ 'svcnum', 'extension' ] ],
6342       'index'        => [ [ 'svcnum' ] ],
6343       'foreign_keys' => [
6344                           { columns    => [ 'svcnum' ],
6345                             table      => 'svc_pbx',
6346                           },
6347                         ],
6348     },
6349
6350     'pbx_device' => {
6351       'columns' => [
6352         'devicenum', 'serial',     '', '', '', '',
6353         'devicepart',   'int',     '', '', '', '',
6354         'svcnum',       'int',     '', '', '', '',
6355         'mac_addr', 'varchar', 'NULL', 12, '', '',
6356       ],
6357       'primary_key'  => 'devicenum',
6358       'unique'       => [ [ 'mac_addr' ], ],
6359       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6360       'foreign_keys' => [
6361                           { columns    => [ 'devicepart' ],
6362                             table      => 'part_device',
6363                           },
6364                           { columns    => [ 'svcnum' ],
6365                             table      => 'svc_pbx',
6366                           },
6367                         ],
6368     },
6369
6370     'extension_device' => {
6371       'columns' => [
6372         'extensiondevicenum', 'serial', '', '', '', '',
6373         'extensionnum',          'int', '', '', '', '',
6374         'devicenum',             'int', '', '', '', '',
6375       ],
6376       'primary_key'  => 'extensiondevicenum',
6377       'unique'       => [ [ 'extensionnum', 'devicenum' ] ],
6378       'index'        => [],#both?  which way do we need to query?
6379       'foreign_keys' => [
6380                           { columns  => [ 'extensionnum' ],
6381                             table    => 'pbx_extension',
6382                           },
6383                           { columns  => [ 'devicenum' ],
6384                             table    => 'pbx_device',
6385                           },
6386                         ],
6387     },
6388
6389     'svc_mailinglist' => { #svc_group?
6390       'columns' => [
6391         'svcnum',            'int',     '',            '', '', '',
6392         'username',      'varchar',     '', $username_len, '', '',
6393         'domsvc',            'int',     '',            '', '', '',
6394         'listnum',           'int',     '',            '', '', '',
6395         'reply_to',         'char', 'NULL',             1, '', '',#SetReplyTo
6396         'remove_from',      'char', 'NULL',             1, '', '',#RemoveAuthor
6397         'reject_auto',      'char', 'NULL',             1, '', '',#RejectAuto
6398         'remove_to_and_cc', 'char', 'NULL',             1, '', '',#RemoveToAndCc
6399       ],
6400       'primary_key'  => 'svcnum',
6401       'unique'       => [],
6402       'index'        => [ ['username'], ['domsvc'], ['listnum'] ],
6403       'foreign_keys' => [
6404                           { columns    => [ 'svcnum' ],
6405                             table      => 'cust_svc',
6406                           },
6407                           { columns    => [ 'domsvc' ],
6408                             table      => 'svc_domain', #'cust_svc',
6409                             references => [ 'svcnum' ],
6410                           },
6411                           { columns    => [ 'listnum' ],
6412                             table      => 'mailinglist',
6413                           },
6414                         ],
6415     },
6416
6417     'mailinglist' => {
6418       'columns' => [
6419         'listnum',   'serial', '',      '', '', '',
6420         'listname', 'varchar', '', $char_d, '', '',
6421       ],
6422       'primary_key' => 'listnum',
6423       'unique' => [],
6424       'index'  => [],
6425     },
6426
6427     'mailinglistmember' => {
6428       'columns' => [
6429         'membernum',        'serial',     '',   '', '', '',
6430         'listnum',             'int',     '',   '', '', '',
6431         'svcnum',              'int', 'NULL',   '', '', '',
6432         'contactemailnum',     'int', 'NULL',   '', '', '',
6433         'email',           'varchar', 'NULL',  255, '', '',
6434       ],
6435       'primary_key'  => 'membernum',
6436       'unique'       => [],
6437       'index'        => [['listnum'],['svcnum'],['contactemailnum'],['email']],
6438       'foreign_keys' => [
6439                           { columns    => [ 'listnum' ],
6440                             table      => 'mailinglist',
6441                           },
6442                           { columns    => [ 'svcnum' ],
6443                             table      => 'svc_acct',
6444                           },
6445                           { columns    => [ 'contactemailnum' ],
6446                             table      => 'contact_email',
6447                           },
6448                         ],
6449     },
6450
6451     'bill_batch' => {
6452       'columns' => [
6453         'batchnum',         'serial',     '',  '', '', '',
6454         'agentnum',            'int', 'NULL',  '', '', '',
6455         'status',             'char', 'NULL', '1', '', '',
6456         'pdf',                'blob', 'NULL',  '', '', '',
6457       ],
6458       'primary_key'  => 'batchnum',
6459       'unique'       => [],
6460       'index'        => [ ['agentnum'] ],
6461       'foreign_keys' => [
6462                           { columns    => [ 'agentnum' ],
6463                             table      => 'agent',
6464                           },
6465                         ],
6466     },
6467
6468     'cust_bill_batch' => {
6469       'columns' => [
6470         'billbatchnum',     'serial',     '', '', '', '',
6471         'batchnum',            'int',     '', '', '', '',
6472         'invnum',              'int',     '', '', '', '',
6473       ],
6474       'primary_key'  => 'billbatchnum',
6475       'unique'       => [],
6476       'index'        => [ [ 'batchnum' ], [ 'invnum' ] ],
6477       'foreign_keys' => [
6478                           { columns    => [ 'batchnum' ],
6479                             table      => 'bill_batch',
6480                           },
6481                           { columns    => [ 'invnum' ],
6482                             table      => 'cust_bill',
6483                           },
6484                         ],
6485     },
6486
6487     'cust_bill_batch_option' => {
6488       'columns' => [
6489         'optionnum', 'serial', '', '', '', '',
6490         'billbatchnum', 'int', '', '', '', '',
6491         'optionname', 'varchar', '', $char_d, '', '',
6492         'optionvalue', 'text', 'NULL', '', '', '',
6493       ],
6494       'primary_key'  => 'optionnum',
6495       'unique'       => [],
6496       'index'        => [ [ 'billbatchnum' ], [ 'optionname' ] ],
6497       'foreign_keys' => [
6498                           { columns    => [ 'billbatchnum' ],
6499                             table      => 'cust_bill_batch',
6500                           },
6501                         ],
6502      },
6503
6504     'msg_template' => {
6505       'columns' => [
6506         'msgnum',     'serial',     '',      '', '', '',
6507         'msgname',   'varchar',     '', $char_d, '', '',
6508         'agentnum',      'int', 'NULL',      '', '', '',
6509         'subject',   'varchar', 'NULL',     512, '', '',
6510         'mime_type', 'varchar',     '', $char_d, '', '',
6511         'body',         'blob', 'NULL',      '', '', '',
6512         'disabled',     'char', 'NULL',       1, '', '',
6513           # migrate these to msg_template_email
6514         'from_addr', 'varchar', 'NULL',     255, '', '',
6515         'bcc_addr',  'varchar', 'NULL',     255, '', '',
6516           # change to not null on v5
6517         'msgclass',  'varchar', 'NULL',      16, '', '',
6518       ],
6519       'primary_key'  => 'msgnum',
6520       'unique'       => [ ],
6521       'index'        => [ ['agentnum'], ],
6522       'foreign_keys' => [
6523                           { columns    => [ 'agentnum' ],
6524                             table      => 'agent',
6525                           },
6526                         ],
6527     },
6528
6529     'msg_template_http' => {
6530       'columns' => [
6531         'num',          'serial',     '',      '', '', '',
6532         'msgnum',          'int',     '',      '', '', '',
6533         'prepare_url', 'varchar', 'NULL',     255, '', '',
6534         'send_url',    'varchar', 'NULL',     255, '', '',
6535         'username',    'varchar', 'NULL', $char_d, '', '',
6536         'password',    'varchar', 'NULL', $char_d, '', '',
6537         'content',        'text', 'NULL',      '', '', '',
6538       ],
6539       'primary_key'  => 'num',
6540       'unique'       => [ [ 'msgnum' ], ],
6541       'index'        => [ ],
6542       'foreign_keys' => [
6543                           { columns    => [ 'msgnum' ],
6544                             table      => 'msg_template',
6545                           },
6546                         ],
6547     },
6548
6549     'template_content' => {
6550       'columns' => [
6551         'contentnum', 'serial',     '',      '', '', '',
6552         'msgnum',        'int',     '',      '', '', '',
6553         'locale',    'varchar', 'NULL',      16, '', '',
6554         'subject',   'varchar', 'NULL',     512, '', '',
6555         'body',         'text', 'NULL',      '', '', '',
6556       ],
6557       'primary_key'  => 'contentnum',
6558       'unique'       => [ ['msgnum', 'locale'] ],
6559       'index'        => [ ],
6560       'foreign_keys' => [
6561                           { columns    => [ 'msgnum' ],
6562                             table      => 'msg_template',
6563                           },
6564                         ],
6565     },
6566
6567     'template_image' => {
6568       'columns' => [
6569         'imgnum',     'serial',     '',      '', '', '',
6570         'name',      'varchar',     '', $char_d, '', '',
6571         'agentnum',      'int', 'NULL',      '', '', '',
6572         'mime_type', 'varchar',     '', $char_d, '', '',
6573         'base64',       'text',     '',      '', '', '',
6574       ],
6575       'primary_key'  => 'imgnum',
6576       'unique'       => [ ],
6577       'index'        => [ ['name'], ['agentnum'] ],
6578     },
6579
6580     'cust_msg' => {
6581       'columns' => [
6582         'custmsgnum', 'serial',     '',     '', '', '',
6583         'custnum',       'int', 'NULL',     '', '', '',
6584         'msgnum',        'int', 'NULL',     '', '', '',
6585         '_date',    @date_type,                 '', '',
6586         'env_from',  'varchar', 'NULL',    255, '', '',
6587         'env_to',    'varchar', 'NULL',    255, '', '',
6588         'header',       'blob', 'NULL',     '', '', '',
6589         'body',         'blob', 'NULL',     '', '', '',
6590         'error',     'varchar', 'NULL',    255, '', '',
6591         'status',    'varchar',     '',$char_d, '', '',
6592         'msgtype',   'varchar', 'NULL',     16, '', '',
6593         'preview',      'text', 'NULL',     '', '', '',
6594       ],
6595       'primary_key'  => 'custmsgnum',
6596       'unique'       => [ ],
6597       'index'        => [ ['custnum'], ],
6598       'foreign_keys' => [
6599                           { columns    => [ 'custnum' ],
6600                             table      => 'cust_main',
6601                           },
6602                           { columns    => [ 'msgnum' ],
6603                             table      => 'msg_template',
6604                           },
6605                         ],
6606     },
6607
6608     'svc_cert' => {
6609       'columns' => [
6610         'svcnum',                'int',     '',      '', '', '',
6611         'recnum',                'int', 'NULL',      '', '', '',
6612         'privatekey',           'text', 'NULL',      '', '', '',
6613         'csr',                  'text', 'NULL',      '', '', '',
6614         'certificate',          'text', 'NULL',      '', '', '',
6615         'cacert',               'text', 'NULL',      '', '', '',
6616         'common_name',       'varchar', 'NULL', $char_d, '', '',
6617         'organization',      'varchar', 'NULL', $char_d, '', '',
6618         'organization_unit', 'varchar', 'NULL', $char_d, '', '',
6619         'city',              'varchar', 'NULL', $char_d, '', '',
6620         'state',             'varchar', 'NULL', $char_d, '', '',
6621         'country',              'char', 'NULL',       2, '', '',
6622         'cert_contact',      'varchar', 'NULL', $char_d, '', '',
6623       ],
6624       'primary_key'  => 'svcnum',
6625       'unique'       => [],
6626       'index'        => [], #recnum
6627       'foreign_keys' => [
6628                           { columns    => [ 'svcnum' ],
6629                             table      => 'cust_svc',
6630                           },
6631                           { columns    => [ 'recnum' ],
6632                             table      => 'domain_record',
6633                           },
6634                         ],
6635     },
6636
6637     'svc_port' => {
6638       'columns' => [
6639         'svcnum',                'int',     '',      '', '', '',
6640         'serviceid', 'varchar', '', 64, '', '', #srvexport / reportfields
6641       ],
6642       'primary_key'  => 'svcnum',
6643       'unique'       => [],
6644       'index'        => [], #recnum
6645       'foreign_keys' => [
6646                           { columns    => [ 'svcnum' ],
6647                             table      => 'cust_svc',
6648                           },
6649                         ],
6650     },
6651
6652     'areacode'  => {
6653       'columns' => [
6654         'areanum',   'serial',        '',      '', '', '',
6655         'code',        'char',        '',       3, '', '',
6656         'country',     'char',    'NULL',       2, '', '',
6657         'state',       'char',    'NULL',       2, '', '',
6658         'description','varchar',  'NULL',     255, '', '',
6659       ],
6660       'primary_key' => 'areanum',
6661       'unique' => [ [ 'areanum' ] ],
6662       'index'  => [],
6663     },
6664
6665     'upgrade_journal' => {
6666       'columns' => [
6667         'upgradenum', 'serial', '', '', '', '',
6668         '_date', 'int', '', '', '', '',
6669         'upgrade', 'varchar', '', $char_d, '', '',
6670         'status', 'varchar', '', $char_d, '', '',
6671         'statustext', 'varchar', 'NULL', $char_d, '', '',
6672       ],
6673       'primary_key' => 'upgradenum',
6674       'unique' => [],
6675       'index' => [ [ 'upgrade' ] ],
6676     },
6677
6678     'upload_target' => {
6679       'columns' => [
6680         'targetnum', 'serial', '', '', '', '',
6681         'agentnum', 'int', 'NULL', '', '', '',
6682         'protocol', 'varchar', '', 10, '', '',
6683         'hostname', 'varchar', '', $char_d, '', '',
6684         'port', 'int', 'NULL', '', '', '',
6685         'username', 'varchar', '', $char_d, '', '',
6686         'password', 'varchar', 'NULL', $char_d, '', '',
6687         'path', 'varchar', 'NULL', $char_d, '', '',
6688         'subject', 'varchar', 'NULL', '255', '', '',
6689         'handling', 'varchar', 'NULL', $char_d, '', '',
6690       ],
6691       'primary_key'   => 'targetnum',
6692       'unique'        => [ [ 'targetnum' ] ],
6693       'index'         => [],
6694       'foreign_keys' => [
6695                           { columns    => [ 'agentnum' ],
6696                             table      => 'agent',
6697                           },
6698                         ],
6699     },
6700
6701     'log' => {
6702       'columns' => [
6703         'lognum',     'serial', '', '', '', '',
6704         '_date',      'int', '', '', '', '',
6705         'agentnum',   'int', 'NULL', '', '', '',
6706         'tablename',  'varchar', 'NULL', $char_d, '', '',
6707         'tablenum',   'int',  'NULL', '', '', '',
6708         'level',      'int',  '', '', '', '',
6709         'message',    'text', '', '', '', '',
6710       ],
6711       'primary_key'  => 'lognum',
6712       'unique'       => [],
6713       'index'        => [ ['_date'], ['level'] ],
6714       'foreign_keys' => [
6715                           { columns    => [ 'agentnum' ],
6716                             table      => 'agent',
6717                           },
6718                         ],
6719     },
6720
6721     'log_context' => {
6722       'columns' => [
6723         'logcontextnum', 'serial', '', '', '', '',
6724         'lognum', 'int', '', '', '', '',
6725         'context', 'varchar', '', $char_d, '', '',
6726       ],
6727       'primary_key'  => 'logcontextnum',
6728       'unique'       => [ [ 'lognum', 'context' ] ],
6729       'index'        => [],
6730       'foreign_keys' => [
6731                           { columns    => [ 'lognum' ],
6732                             table      => 'log',
6733                           },
6734                         ],
6735     },
6736
6737     'log_email' => {
6738       'columns' => [
6739         'logemailnum', 'serial', '', '', '', '',
6740         'context', 'varchar', 'NULL', $char_d, '', '',
6741         'min_level', 'int',  'NULL', '', '', '',
6742         'msgnum', 'int', '',  '', '', '',
6743         'to_addr', 'varchar', 'NULL',     255, '', '',
6744         'context_height',  'int', 'NULL', '', '', '',
6745       ],
6746       'primary_key'  => 'logemailnum',
6747       'unique'       => [],
6748       'index'        => [ ['context'], ['min_level'] ],
6749       'foreign_keys' => [
6750                           { columns    => [ 'msgnum' ],
6751                             table      => 'msg_template',
6752                             references => [ 'msgnum' ],
6753                           },
6754                         ],
6755     },
6756
6757     'svc_alarm' => {
6758       'columns' => [
6759 #       name               type        null   length   default local
6760         'svcnum',          'int',      '',    '',      '',     '',
6761         'alarmsystemnum',  'int',      '',    '',      '',     '',
6762         'alarmtypenum',    'int',      '',    '',      '',     '',
6763         'alarmstationnum', 'int',      '',    '',      '',     '',
6764         'acctnum',         'varchar',  '',    $char_d, '',     '',
6765         '_password',       'varchar',  '',    $char_d, '',     '',
6766         'location',        'varchar', 'NULL', $char_d, '',     '',
6767         'cs_receiver',     'int',     'NULL', '',      '',     '',
6768         'cs_phonenum',     'varchar', 'NULL', $char_d, '',     '',
6769         'serialnum',       'varchar', 'NULL', $char_d, '',     '',
6770         #installer (rep)
6771       ],
6772       'primary_key'  => 'svcnum',
6773       'unique'       => [],
6774       'index'        => [],
6775       'foreign_keys' => [
6776                           { columns    => [ 'svcnum' ],
6777                             table      => 'cust_svc',
6778                           },
6779                           { columns    => [ 'alarmsystemnum' ],
6780                             table      => 'alarm_system',
6781                           },
6782                           { columns    => [ 'alarmtypenum' ],
6783                             table      => 'alarm_type',
6784                           },
6785                           { columns    => [ 'alarmstationnum' ],
6786                             table      => 'alarm_station',
6787                           },
6788                         ],
6789     },
6790
6791     'alarm_system' => { #vendors
6792       'columns' => [
6793         'alarmsystemnum',  'serial',     '',      '', '', '',
6794         'agentnum',           'int', 'NULL',      '', '', '',
6795         'systemname',     'varchar',     '', $char_d, '', '',
6796         'disabled',          'char', 'NULL',       1, '', '',
6797       ],
6798       'primary_key' => 'alarmsystemnum',
6799       'unique'      => [ ['agentnum', 'systemname'] ],
6800       'index'       => [ ['agentnum'], ['disabled'] ],
6801       'foreign_keys' => [
6802                           { columns    => [ 'agentnum' ],
6803                             table      => 'agent',
6804                           },
6805                         ],
6806     },
6807
6808     'alarm_type' => { #inputs and outputs
6809       'columns' => [
6810         'alarmtypenum', 'serial',     '',      '', '', '',
6811         'agentnum',        'int', 'NULL',      '', '', '',
6812         'inputs',          'int',     '', '', '', '',
6813         'outputs',         'int',     '', '', '', '',
6814         'disabled',       'char', 'NULL',       1, '', '',
6815       ],
6816       'primary_key' => 'alarmtypenum',
6817       'unique'      => [ ['agentnum', 'inputs', 'outputs'] ],
6818       'index'       => [ ['agentnum'], ['disabled'] ],
6819       'foreign_keys' => [
6820                           { columns    => [ 'agentnum' ],
6821                             table      => 'agent',
6822                           },
6823                         ],
6824     },
6825
6826     'alarm_station' => { #central station (where the alarm reports to)
6827       'columns' => [
6828         'alarmstationnum', 'serial',     '',      '', '', '',
6829         'agentnum',           'int', 'NULL',      '', '', '',
6830         'stationname',    'varchar',     '', $char_d, '', '',
6831         'disabled',          'char', 'NULL',       1, '', '',
6832       ],
6833       'primary_key' => 'alarmstationnum',
6834       'unique'      => [ ['agentnum', 'stationname'], ],
6835       'index'       => [ ['agentnum'], ['disabled'] ],
6836       'foreign_keys' => [
6837                           { columns    => [ 'agentnum' ],
6838                             table      => 'agent',
6839                           },
6840                         ],
6841     },
6842
6843     'svc_cable' => {
6844       'columns' => [
6845         'svcnum',        'int',     '',      '', '', '',
6846         'providernum',   'int', 'NULL',      '', '', '',
6847         'ordernum',  'varchar', 'NULL', $char_d, '', '',
6848         'modelnum',      'int', 'NULL',      '', '', '',
6849         'serialnum', 'varchar', 'NULL', $char_d, '', '',
6850         'mac_addr',  'varchar', 'NULL',      12, '', '',
6851       ],
6852       'primary_key'  => 'svcnum',
6853       'unique'       => [ ['modelnum', 'serialnum'] , ['mac_addr'] ],
6854       'index'        => [],
6855       'foreign_keys' => [
6856                           { columns    => [ 'svcnum' ],
6857                             table      => 'cust_svc',
6858                           },
6859                           { columns    => [ 'providernum' ],
6860                             table      => 'cable_provider',
6861                           },
6862                           { columns    => [ 'modelnum' ],
6863                             table      => 'cable_model',
6864                           },
6865                         ],
6866     },
6867
6868     'cable_model' => {
6869       'columns' => [
6870         'modelnum',    'serial',     '',      '', '', '',
6871         'model_name', 'varchar',     '', $char_d, '', '',
6872         'disabled',      'char', 'NULL',       1, '', '',
6873       ],
6874       'primary_key' => 'modelnum',
6875       'unique' => [ [ 'model_name' ], ],
6876       'index'  => [],
6877     },
6878
6879     'cable_provider' => {
6880       'columns' => [
6881         'providernum', 'serial',     '',      '', '', '',
6882         'provider',   'varchar',     '', $char_d, '', '',
6883         'disabled',      'char', 'NULL',       1, '', '',
6884       ],
6885       'primary_key' => 'providernum',
6886       'unique' => [ [ 'provider' ], ],
6887       'index'  => [],
6888     },
6889
6890     'svc_conferencing' => {
6891       'columns' => [
6892         'svcnum',            'int',     '',      '', '', '',
6893         'conf_id',           'int', 'NULL',      '', '', '', #"system assigned"
6894         'conf_name',     'varchar',     '', $char_d, '', '',
6895         'conf_password', 'varchar',     '', $char_d, '', '',
6896         'access_code',   'varchar',     '',      16, '', '',
6897         'duration',          'int',     '',      '', '', '',
6898         'participants',      'int',     '',      '', '', '',
6899         'conftypenum',       'int',     '',      '', '', '',
6900         'confqualitynum',    'int',     '',      '', '', '',
6901         'opt_recording',    'char', 'NULL',       1, '', '',
6902         'opt_sip',          'char', 'NULL',       1, '', '',
6903         'opt_phone',        'char', 'NULL',       1, '', '',
6904       ],
6905       'primary_key' => 'svcnum',
6906       'unique' => [],
6907       'index'  => [],
6908       'foreign_keys' => [
6909                           { columns => [ 'svcnum' ],
6910                             table   => 'cust_svc',
6911                           },
6912                           { columns => [ 'conftypenum' ],
6913                             table   => 'conferencing_type',
6914                           },
6915                           { columns => [ 'confqualitynum' ],
6916                             table   => 'conferencing_quality',
6917                           },
6918                         ],
6919     },
6920
6921     'conferencing_type' => {
6922       'columns' => [
6923         'conftypenum',  'int',     '',      '', '', '',
6924         'typeid'      , 'int',     '',      '', '', '',
6925         'typename', 'varchar',     '', $char_d, '', '',
6926         'disabled',    'char', 'NULL',       1, '', '',
6927       ],
6928       'primary_key' => 'conftypenum',
6929       'unique'      => [ [ 'typeid', 'disabled' ], [ 'typename', 'disabled' ] ],
6930       'index'       => [],
6931     },
6932
6933     'conferencing_quality' => {
6934       'columns' => [
6935         'confqualitynum',  'int',     '',      '', '', '',
6936         'qualityid'      , 'int',     '',      '', '', '',
6937         'qualityname', 'varchar',     '', $char_d, '', '',
6938         'disabled',       'char', 'NULL',       1, '', '',
6939       ],
6940       'primary_key' => 'confqualitynum',
6941       'unique'      => [ [ 'qualityid', 'disabled' ], [ 'qualityname', 'disabled' ] ],
6942       'index'       => [],
6943     },
6944
6945     'svc_video' => {
6946       'columns' => [
6947         'svcnum',            'int', '', '', '', '',
6948         'smartcard_num', 'varchar', '', 16, '', '',
6949         'mac_addr',      'varchar', '', 12, '', '',
6950         'duration',          'int', '', '', '', '',
6951       ],
6952       'primary_key' => 'svcnum',
6953       'unique' => [], # [ 'smartcard_num' ], [ 'mac_addr' ], ],
6954       'index'  => [],
6955       'foreign_keys' => [
6956                           { columns => [ 'svcnum' ],
6957                             table   => 'cust_svc',
6958                           },
6959                         ],
6960     },
6961
6962     'circuit_type' => {
6963       'columns' => [
6964         'typenum',     'serial',     '',      '', '', '',
6965         'typename',   'varchar',     '', $char_d, '', '',
6966         'disabled',      'char', 'NULL',       1, '', '',
6967         # speed? number of voice lines? anything else?
6968       ],
6969       'primary_key' => 'typenum',
6970       'unique' => [ [ 'typename' ] ],
6971       'index'  => [],
6972     },
6973
6974     'circuit_provider' => {
6975       'columns' => [
6976         'providernum', 'serial',     '',      '', '', '',
6977         'provider',   'varchar',     '', $char_d, '', '',
6978         'disabled',      'char', 'NULL',       1, '', '',
6979       ],
6980       'primary_key' => 'providernum',
6981       'unique' => [ [ 'provider' ], ],
6982       'index'  => [],
6983     },
6984
6985     'circuit_termination' => {
6986       'columns' => [
6987         'termnum',     'serial',     '',      '', '', '',
6988         'termination','varchar',     '', $char_d, '', '',
6989         'disabled',      'char', 'NULL',       1, '', '',
6990       ],
6991       'primary_key' => 'termnum',
6992       'unique' => [ [ 'termination' ] ],
6993       'index' => [],
6994     },
6995
6996     'svc_circuit' => {
6997       'columns' => [
6998         'svcnum',                   'int',     '', '', '', '',
6999         'typenum',                  'int',     '', '', '', '',
7000         'providernum',              'int',     '', '', '', '',
7001         'termnum',                  'int',     '', '', '', '',
7002         'circuit_id',           'varchar',     '', 64, '', '',
7003         'desired_due_date',         'int', 'NULL', '', '', '',
7004         'due_date',                 'int', 'NULL', '', '', '',
7005         'vendor_order_id',      'varchar', 'NULL', $char_d,  '', '',
7006         'vendor_qual_id',       'varchar', 'NULL', $char_d,  '', '',
7007         'vendor_order_type',    'varchar', 'NULL', $char_d,  '', '',
7008         'vendor_order_status',  'varchar', 'NULL', $char_d,  '', '',
7009         'endpoint_ip_addr',     'varchar', 'NULL', 40, '', '',
7010         'endpoint_mac_addr',    'varchar', 'NULL', 12, '', '',
7011         'internal_circuit_id',  'varchar', 'NULL', 64, '', '',
7012       ],
7013       'primary_key' => 'svcnum',
7014       'unique'      => [],
7015       'index'       => [ [ 'providernum' ], [ 'typenum' ] ],
7016       'foreign_keys' => [
7017                           { columns => [ 'svcnum' ],
7018                             table   => 'cust_svc',
7019                           },
7020                           { columns => [ 'typenum' ],
7021                             table   => 'circuit_type',
7022                           },
7023                           { columns => [ 'providernum' ],
7024                             table   => 'circuit_provider',
7025                           },
7026                           { columns => [ 'termnum' ],
7027                             table   => 'circuit_termination',
7028                           },
7029       ],
7030     },
7031
7032     'svc_fiber' => {
7033       'columns' => [
7034         'svcnum',         'int',     '',      '', '', '',
7035         'oltnum',         'int', 'NULL',      '', '', '',
7036         'shelf',          'int', 'NULL',      '', '', '',
7037         'card',           'int', 'NULL',      '', '', '',
7038         'olt_port',       'int', 'NULL',      '', '', '',
7039         'ont_id',         'int', 'NULL',      '', '', '',
7040         'ont_typenum',    'int', 'NULL',      '', '', '',
7041         'ont_serial', 'varchar', 'NULL', $char_d, '', '',
7042         'ont_port',   'varchar', 'NULL',      16, '', '',
7043         'circuit_id', 'varchar', 'NULL', $char_d, '', '',
7044         'vlan',           'int', 'NULL',      '', '', '',
7045         'signal',     'decimal', 'NULL',  '10,2', '', '',
7046         'speed_up',       'int', 'NULL',      '', '', '',
7047         'speed_down',     'int', 'NULL',      '', '', '',
7048         'ont_install','varchar', 'NULL', $char_d, '', '',
7049       ],
7050       'primary_key' => 'svcnum',
7051       'unique'      => [ ],
7052       'index'       => [ [ 'ont_serial' ] ],
7053       'foreign_keys' => [
7054                           { columns => [ 'svcnum' ],
7055                             table   => 'cust_svc',
7056                           },
7057                           { columns => [ 'oltnum' ],
7058                             table   => 'fiber_olt',
7059                           },
7060                           { columns => [ 'ont_typenum' ],
7061                             table   => 'hardware_type',
7062                             references => [ 'typenum' ],
7063                           },
7064                         ],
7065     },
7066
7067     'fiber_olt' => {
7068       'columns' => [
7069         'oltnum',   'serial', '',       '', '', '',
7070         'oltname', 'varchar', '',  $char_d, '', '',
7071         'sitenum',     'int', 'NULL',   '', '', '',
7072         'serial',  'varchar', '',  $char_d, '', '',
7073         'disabled',   'char', 'NULL',    1, '', '',
7074       ],
7075       'primary_key' => 'oltnum',
7076       'unique' => [ ],
7077       'index'  => [ ],
7078       'foreign_keys' => [
7079                           { columns => [ 'sitenum' ],
7080                             table   => 'olt_site',
7081                           },
7082                         ],
7083     },
7084
7085     'olt_site' => {
7086       'columns' => [
7087         'sitenum',  'serial', '',      '', '', '',
7088         'market',  'varchar', '', $char_d, '', '',
7089         'site',    'varchar', '', $char_d, '', '',
7090       ],
7091       'primary_key' => 'sitenum',
7092       'unique' => [ [ 'market', 'site' ] ],
7093       'index' => [ ],
7094     },
7095
7096
7097
7098
7099
7100     'vend_main' => {
7101       'columns' => [
7102         'vendnum',   'serial',     '',      '', '', '',
7103         'vendname', 'varchar',     '', $char_d, '', '',
7104         'classnum',     'int',     '',      '', '', '',
7105         'disabled',    'char', 'NULL',       1, '', '',
7106       ],
7107       'primary_key'  => 'vendnum',
7108       'unique'       => [ ['vendname', 'disabled'] ],
7109       'index'        => [],
7110       'foreign_keys' => [
7111                           { columns    => [ 'classnum' ],
7112                             table      => 'vend_class',
7113                           },
7114                         ],
7115     },
7116
7117     'vend_class' => {
7118       'columns' => [
7119         'classnum',     'serial',     '',      '', '', '',
7120         'classname',   'varchar',     '', $char_d, '', '',
7121         'disabled',       'char', 'NULL',       1, '', '',
7122       ],
7123       'primary_key' => 'classnum',
7124       'unique'      => [],
7125       'index'       => [ ['disabled'] ],
7126     },
7127
7128     'vend_bill' => {
7129       'columns' => [
7130         'vendbillnum',    'serial',     '',      '', '', '',
7131         'vendnum',           'int',     '',      '', '', '',
7132         #'_date',        @date_type,                  '', '',
7133         '_date',     'int', '', '',                   '', '',
7134         'charged',     @money_type,                  '', '',
7135       ],
7136       'primary_key'  => 'vendbillnum',
7137       'unique'       => [],
7138       'index'        => [ ['vendnum'], ['_date'], ],
7139       'foreign_keys' => [
7140                           { columns    => [ 'vendnum' ],
7141                             table      => 'vend_main',
7142                           },
7143                         ],
7144     },
7145
7146     'vend_pay' => {
7147       'columns' => [
7148         'vendpaynum',   'serial',    '',       '', '', '',
7149         'vendnum',         'int',    '',       '', '', '',
7150         #'_date',     @date_type,                   '', '',
7151         '_date',     'int', '', '',                   '', '',
7152         'paid',      @money_type,                  '', '',
7153       ],
7154       'primary_key'  => 'vendpaynum',
7155       'unique'       => [],
7156       'index'        => [ [ 'vendnum' ], [ '_date' ], ],
7157       'foreign_keys' => [
7158                           { columns    => [ 'vendnum' ],
7159                             table      => 'vend_main',
7160                           },
7161                         ],
7162     },
7163
7164     'vend_bill_pay' => {
7165       'columns' => [
7166         'vendbillpaynum', 'serial',     '',   '', '', '',
7167         'vendbillnum',       'int',     '',   '', '', '',
7168         'vendpaynum',        'int',     '',   '', '', '',
7169         'amount',  @money_type, '', '',
7170         #? '_date',   @date_type, '', '',
7171       ],
7172       'primary_key'  => 'vendbillpaynum',
7173       'unique'       => [],
7174       'index'        => [ [ 'vendbillnum' ], [ 'vendpaynum' ] ],
7175       'foreign_keys' => [
7176                           { columns    => [ 'vendbillnum' ],
7177                             table      => 'vend_bill',
7178                           },
7179                           { columns    => [ 'vendpaynum' ],
7180                             table      => 'vend_pay',
7181                           },
7182                         ],
7183     },
7184
7185     %{ tables_hashref_torrus() },
7186
7187     # tables of ours for doing torrus virtual port combining
7188     'torrus_srvderive' => {
7189       'columns' => [
7190         'derivenum',     'serial',     '', '', '', '',
7191         'serviceid',    'varchar',     '', 64, '', '', #srvexport / reportfields
7192         'last_srv_date',   'date', 'NULL', '', '', '',
7193       ],
7194       'primary_key' => 'derivenum',
7195       'unique' => [ ['serviceid'] ],
7196       'index'  => [],
7197     },
7198
7199     'torrus_srvderive_component' => {
7200       'columns' => [
7201         'componentnum', 'serial', '', '', '', '',
7202         'derivenum',       'int', '', '', '', '',
7203         'serviceid',   'varchar', '', 64, '', '', #srvexport / reportfields
7204       ],
7205       'primary_key'  => 'componentnum',
7206       'unique'       => [ [ 'derivenum', 'serviceid' ], ],
7207       'index'        => [ [ 'derivenum', ], ],
7208       'foreign_keys' => [
7209                           { columns    => [ 'derivenum' ],
7210                             table      => 'torrus_srvderive',
7211                           },
7212                         ],
7213     },
7214
7215     'invoice_mode' => {
7216       'columns' => [
7217         'modenum',      'serial', '', '', '', '',
7218         'agentnum',        'int', 'NULL', '', '', '',
7219         'modename',    'varchar', '', 32, '', '',
7220       ],
7221       'primary_key' => 'modenum',
7222       'unique'      => [ ],
7223       'index'       => [ ],
7224       'foreign_keys' => [
7225                           { columns    => [ 'agentnum' ],
7226                             table      => 'agent',
7227                           },
7228                         ],
7229     },
7230
7231     'invoice_conf' => {
7232       'columns' => [
7233         'confnum',              'serial',   '', '', '', '',
7234         'modenum',              'int',      '', '', '', '',
7235         'locale',               'varchar',  'NULL', 16, '', '',
7236         'notice_name',          'varchar',  'NULL', 64, '', '',
7237         'subject',              'varchar',  'NULL', 64, '', '',
7238         'htmlnotes',            'text',     'NULL', '', '', '',
7239         'htmlfooter',           'text',     'NULL', '', '', '',
7240         'htmlsummary',          'text',     'NULL', '', '', '',
7241         'htmlreturnaddress',    'text',     'NULL', '', '', '',
7242         'latexnotes',           'text',     'NULL', '', '', '',
7243         'latexfooter',          'text',     'NULL', '', '', '',
7244         'latexsummary',         'text',     'NULL', '', '', '',
7245         'latexsmallfooter',     'text',     'NULL', '', '', '',
7246         'latexreturnaddress',   'text',     'NULL', '', '', '',
7247         'with_latexcoupon',     'char',     'NULL', '1', '', '',
7248         'htmlwatermark',        'text',     'NULL', '', '', '',
7249         'latexwatermark',       'text',     'NULL', '', '', '',
7250         'lpr',                  'varchar',  'NULL', $char_d, '', '',
7251       ],
7252       'primary_key'  => 'confnum',
7253       'unique'       => [ [ 'modenum', 'locale' ] ],
7254       'index'        => [ ],
7255       'foreign_keys' => [
7256                           { columns    => [ 'modenum' ],
7257                             table      => 'invoice_mode',
7258                           },
7259                         ],
7260     },
7261
7262     'export_batch' => {
7263       'columns' => [
7264         'batchnum',    'serial',     '',      '', '', '',
7265         'exportnum',      'int',     '',      '', '', '',
7266         '_date',          'int',     '',      '', '', '',
7267         'status',     'varchar', 'NULL',      32, '', '',
7268         'statustext',    'text', 'NULL',      '', '', '',
7269       ],
7270       'primary_key'  => 'batchnum',
7271       'unique'       => [],
7272       'index'        => [ [ 'exportnum' ], [ 'status' ] ],
7273       'foreign_keys' => [
7274                           { columns    => [ 'exportnum' ],
7275                             table      => 'part_export',
7276                             references => [ 'exportnum' ]
7277                           },
7278                         ],
7279     },
7280
7281     'export_batch_item' => {
7282       'columns' => [
7283         'itemnum',     'serial',     '',      '', '', '',
7284         'batchnum',       'int',     '',      '', '', '',
7285         'svcnum',         'int',     '',      '', '', '',
7286         'action',     'varchar',     '',      32, '', '',
7287         'data',          'text', 'NULL',      '', '', '',
7288         'frozen',        'char', 'NULL',       1, '', '',
7289       ],
7290       'primary_key'  => 'itemnum',
7291       'unique'       => [],
7292       'index'        => [ [ 'batchnum' ], [ 'svcnum' ] ],
7293       'foreign_keys' => [
7294                           { columns    => [ 'batchnum' ],
7295                             table      => 'export_batch',
7296                             references => [ 'batchnum' ]
7297                           },
7298                         ],
7299     },
7300
7301     # lookup table for states, similar to msa and lata
7302     'state' => {
7303       'columns' => [
7304         'statenum', 'int',  '', '', '', '',
7305         'country',  'char', '',  2, '', '',
7306         'state',    'char', '', $char_d, '', '',
7307         'fips',     'char', '',  3, '', '',
7308       ],
7309       'primary_key' => 'statenum',
7310       'unique' => [ [ 'country', 'state' ], ],
7311       'index' => [],
7312     },
7313
7314     # eventually link to tower/sector?
7315     'deploy_zone' => {
7316       'columns' => [
7317         'zonenum',        'serial',  '',     '',      '', '',
7318         'description',    'char',    'NULL', $char_d, '', '',
7319         'agentnum',       'int',     '',     '',      '', '',
7320         'censusyear',     'char',    'NULL', 4,      '', '',
7321         'dbaname',        'char',    'NULL', $char_d, '', '',
7322         'zonetype',       'char',    '',     1,       '', '',
7323         'technology',     'int',     '',     '',      '', '',
7324         'spectrum',       'int',     'NULL', '',      '', '',
7325         'adv_speed_up',   'decimal', '',     '10,3', '0', '',
7326         'adv_speed_down', 'decimal', '',     '10,3', '0', '',
7327         'cir_speed_up',   'decimal', '',     '10,3', '0', '',
7328         'cir_speed_down', 'decimal', '',     '10,3', '0', '',
7329         'is_broadband',   'char',    'NULL', 1,       '', '',
7330         'is_voice',       'char',    'NULL', 1,       '', '',
7331         'is_consumer',    'char',    'NULL', 1,       '', '',
7332         'is_business',    'char',    'NULL', 1,       '', '',
7333         'active_date',    @date_type,                 '', '',
7334         'expire_date',    @date_type,                 '', '',
7335       ],
7336       'primary_key' => 'zonenum',
7337       'unique' => [],
7338       'index'  => [ [ 'agentnum' ] ],
7339       'foreign_keys' => [
7340                           { columns     => [ 'agentnum' ],
7341                             table       => 'agent',
7342                             references  => [ 'agentnum' ],
7343                           },
7344                         ],
7345     },
7346
7347     'deploy_zone_block' => {
7348       'columns' => [
7349         'blocknum',       'serial',  '',     '',      '', '',
7350         'zonenum',        'int',     '',     '',      '', '',
7351         'censusblock',    'char',    '',     15,      '', '',
7352         'censusyear',     'char','NULL',      4,      '', '',
7353       ],
7354       'primary_key' => 'blocknum',
7355       'unique' => [],
7356       'index'  => [ [ 'zonenum' ] ],
7357       'foreign_keys' => [
7358                           { columns     => [ 'zonenum' ],
7359                             table       => 'deploy_zone',
7360                             references  => [ 'zonenum' ],
7361                           },
7362                         ],
7363     },
7364
7365     'deploy_zone_vertex' => {
7366       'columns' => [
7367         'vertexnum',      'serial',  '',     '',      '', '',
7368         'zonenum',        'int',     '',     '',      '', '',
7369         'latitude',       'decimal', '',     '10,7',  '', '',
7370         'longitude',      'decimal', '',     '10,7',  '', '',
7371       ],
7372       'primary_key' => 'vertexnum',
7373       'unique' => [ ],
7374       'index'  => [ ],
7375       'foreign_keys' => [
7376                           { columns     => [ 'zonenum' ],
7377                             table       => 'deploy_zone',
7378                             references  => [ 'zonenum' ],
7379                           },
7380                         ],
7381     },
7382
7383     'cacti_page' => {
7384       'columns' => [
7385         'cacti_pagenum',  'serial',   '',     '', '', '',
7386         'exportnum',      'int',      'NULL', '', '', '',
7387         'svcnum',         'int',      'NULL', '', '', '',
7388         'graphnum',       'int',      'NULL', '', '', '',
7389         'imported',       @date_type,             '', '',
7390         'content',        'text',     'NULL', '', '', '',
7391         'thumbnail',      'text',     'NULL', '', '', '',
7392       ],
7393       'primary_key' => 'cacti_pagenum',
7394       'unique'  => [ ],
7395       'index'   => [ ['svcnum'], ['imported'] ],
7396       'foreign_keys' => [
7397                           { columns    => [ 'svcnum' ],
7398                             table      => 'cust_svc',
7399                             references => [ 'svcnum' ],
7400                           },
7401                           { columns    => [ 'exportnum' ],
7402                             table      => 'part_export',
7403                             references => [ 'exportnum' ],
7404                           },
7405                         ],
7406     },
7407
7408     'report_batch' => {
7409       'columns' => [
7410         'reportbatchnum', 'serial',      '',  '', '', '',
7411         'reportname',     'varchar',     '', 255, '', '',
7412         'agentnum',           'int', 'NULL',  '', '', '',
7413         'send_date',     @date_type,              '', '',
7414         'sdate',         @date_type,              '', '',
7415         'edate',         @date_type,              '', '',
7416         'usernum',            'int', 'NULL',  '', '', '',
7417         'msgnum',             'int', 'NULL',  '', '', '',
7418         # add report params here as necessary
7419       ],
7420       'primary_key' => 'reportbatchnum',
7421       'unique' => [],
7422       'index'  => [],
7423       'foreign_keys' => [
7424                           { columns    => [ 'agentnum' ],
7425                             table      => 'agent',
7426                             references => [ 'agentnum' ],
7427                           },
7428                           { columns    => [ 'usernum' ],
7429                             table      => 'access_user',
7430                             references => [ 'usernum' ],
7431                           },
7432                           { columns    => [ 'msgnum' ],
7433                             table      => 'msg_template',
7434                             references => [ 'msgnum' ],
7435                           },
7436                         ],
7437     },
7438
7439     'password_history' => {
7440       'columns' => [
7441         'passwordnum',        'serial',  '',          '', '', '',
7442         '_password',          'varchar', 'NULL', $char_d, '', '',
7443         'encryption_method',  'varchar', 'NULL', $char_d, '', '',
7444         'created',   @date_type,   '', '',
7445         # each table that needs password history gets a column here, and
7446         # an entry in foreign_keys.
7447         'svc_acct__svcnum',     'int', 'NULL', '', '', '',
7448         'svc_dsl__svcnum',      'int', 'NULL', '', '', '',
7449         'svc_alarm__svcnum',    'int', 'NULL', '', '', '',
7450         'agent__agentnum',      'int', 'NULL', '', '', '',
7451         'contact__contactnum',  'int', 'NULL', '', '', '',
7452         'access_user__usernum', 'int', 'NULL', '', '', '',
7453       ],
7454       'primary_key' => 'passwordnum',
7455       'unique' => [],
7456       'index'  => [],
7457       'foreign_keys' => [
7458                           { columns     => [ 'svc_acct__svcnum' ],
7459                             table       => 'svc_acct',
7460                             references  => [ 'svcnum' ],
7461                           },
7462                           { columns     => [ 'svc_dsl__svcnum' ],
7463                             table       => 'svc_dsl',
7464                             references  => [ 'svcnum' ],
7465                           },
7466                           { columns     => [ 'svc_alarm__svcnum' ],
7467                             table       => 'svc_alarm',
7468                             references  => [ 'svcnum' ],
7469                           },
7470                           { columns    => [ 'agent__agentnum' ],
7471                             table      => 'agent',
7472                             references => [ 'agentnum' ],
7473                           },
7474                           { columns    => [ 'contact__contactnum' ],
7475                             table      => 'contact',
7476                             references => [ 'contactnum' ],
7477                           },
7478                           { columns    => [ 'access_user__usernum' ],
7479                             table      => 'access_user',
7480                             references => [ 'usernum' ],
7481                           },
7482                         ],
7483     },
7484
7485     'webservice_log' => {
7486       'columns' => [
7487         'webservicelognum',    'serial',      '',      '', '', '', #big? hubrus
7488         'svcnum',                 'int',  'NULL',      '', '', '', #just in case
7489         'custnum',                'int',      '',      '', '', '',
7490         'method',             'varchar',      '', $char_d, '', '',
7491         'quantity',               'int',      '',      '', '', '', #i.e. pages
7492         '_date',             @date_type,                   '', '',
7493         'status',             'varchar',  'NULL', $char_d, '', '',
7494         'rated_price',        'decimal',  'NULL',  '10,2', '', '',
7495       ],
7496       'primary_key'  => 'webservicelognum',
7497       'unique'       => [],
7498       'index'        => [ ['custnum'], ['status'] ],
7499       'foreign_keys' => [
7500                           { columns => [ 'custnum' ],
7501                             table   => 'cust_main',
7502                           },
7503                           #no FK on svcnum... we don't want to purge these on
7504                           # service deletion
7505                         ],
7506     },
7507
7508     'rt_field_charge' => {
7509       'columns' => [
7510         'rtfieldchargenum',    'serial',      '',      '', '', '',
7511         'pkgnum',                 'int',      '',      '', '', '',
7512         'ticketid',               'int',      '',      '', '', '',
7513         'rate',             @money_type,                   '', '',
7514         'units',              'decimal',      '',  '10,4', '', '',
7515         'charge',           @money_type,                   '', '',
7516         '_date',             @date_type,                   '', '',
7517       ],
7518       'primary_key'  => 'rtfieldchargenum',
7519       'unique'       => [],
7520       'index'        => [ ['pkgnum', 'ticketid'] ],
7521       'foreign_keys' => [
7522                           { columns    => [ 'pkgnum' ],
7523                             table      => 'cust_pkg',
7524                           },
7525                         ],
7526     },
7527
7528     'saved_search' => {
7529       'columns' => [
7530         'searchnum',    'serial',  '',          '', '', '',
7531         'usernum',      'int',     'NULL',      '', '', '',
7532         'searchname',   'varchar', '',     $char_d, '', '',
7533         'path',         'varchar', '',     $char_d, '', '',
7534         'params',       'text',    'NULL',      '', '', '',
7535         'disabled',     'char',    'NULL',       1, '', '',
7536         'freq',         'varchar', 'NULL',      16, '', '',
7537         'last_sent',    'int',     'NULL',      '', '', '',
7538         'format',       'varchar', 'NULL',      32, '', '',
7539       ],
7540       'primary_key'   => 'searchnum',
7541       'unique'        => [],
7542       'index'         => [],
7543       'foreign_keys'  => [
7544                            { columns => [ 'usernum' ],
7545                              table   => 'access_user',
7546                            },
7547                          ],
7548     },
7549
7550     'svc_group' => {
7551       'columns' => [
7552         'svcnum',          'int', '', '', '', '',
7553         'max_accounts',    'int', '', '', '', '',
7554       ],
7555       'primary_key'  => 'svcnum',
7556       'unique'       => [],
7557       'index'        => [],
7558       'foreign_keys' => [
7559                           { columns    => [ 'svcnum' ],
7560                             table      => 'cust_svc',
7561                           },
7562                         ],
7563     },
7564
7565
7566     # name type nullability length default local
7567
7568     #'new_table' => {
7569     #  'columns' => [
7570     #    'num', 'serial',       '', '', '', '',
7571     #  ],
7572     #  'primary_key' => 'num',
7573     #  'unique' => [],
7574     #  'index'  => [],
7575     #},
7576
7577   };
7578
7579 }
7580
7581 =back
7582
7583 =head1 BUGS
7584
7585 =head1 SEE ALSO
7586
7587 L<DBIx::DBSchema>
7588
7589 =cut
7590
7591 1;
7592