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         'agent_rateid',    'varchar', 'NULL', $char_d, '', '',
5141       ],
5142       'primary_key' => 'ratenum',
5143       'unique'      => [ ['agentnum','agent_rateid'], ],
5144       'index'       => [],
5145       'foreign_keys' => [
5146                           { columns    => [ 'agentnum' ],
5147                             table      => 'agent',
5148                           },
5149                         ],
5150     },
5151
5152     'rate_detail' => {
5153       'columns' => [
5154         'ratedetailnum',   'serial',  '',     '',      '', '',
5155         'ratenum',         'int',     '',     '',      '', '',
5156         'orig_regionnum',  'int', 'NULL',     '',      '', '',
5157         'dest_regionnum',  'int', 'NULL',     '',      '', '',
5158         'min_included',    'int',     '',     '',      '', '',
5159         'conn_charge',     'decimal', '', '10,4', '0.0000', '',
5160         'conn_cost',       'decimal', '', '10,4', '0.0000', '',
5161         'conn_sec',        'int',     '',     '',      '0', '',
5162         'min_charge',      'decimal', '', '10,5',       '', '',
5163         'min_cost',        'decimal', '', '10,5','0.00000', '',
5164         'sec_granularity', 'int',     '',     '',       '', '',
5165         'ratetimenum',     'int', 'NULL',     '',       '', '',
5166         'classnum',        'int', 'NULL',     '',       '', '',
5167         'cdrtypenum',      'int', 'NULL',     '',       '', '',
5168         'region_group',   'char', 'NULL',      1,       '', '',
5169         'upstream_mult_charge',  'decimal',  '', '10,4', '0.0000', '',
5170         'upstream_mult_cost',    'decimal',  '', '10,4', '0.0000', '',
5171       ],
5172       'primary_key'  => 'ratedetailnum',
5173       'unique'       => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
5174       'index'        => [ [ 'ratenum', 'dest_regionnum' ],
5175                           [ 'ratenum', 'ratetimenum' ]
5176                         ],
5177       'foreign_keys' => [
5178                           { columns    => [ 'ratenum' ],
5179                             table      => 'rate',
5180                           },
5181                           { columns    => [ 'orig_regionnum' ],
5182                             table      => 'rate_region',
5183                             references => [ 'regionnum' ],
5184                           },
5185                           { columns    => [ 'dest_regionnum' ],
5186                             table      => 'rate_region',
5187                             references => [ 'regionnum' ],
5188                           },
5189                           { columns    => [ 'ratetimenum' ],
5190                             table      => 'rate_time',
5191                           },
5192                           { columns    => [ 'classnum' ],
5193                             table      => 'usage_class',
5194                           },
5195                           { columns    => [ 'cdrtypenum' ],
5196                             table      => 'cdr_type',
5197                           },
5198                         ],
5199     },
5200
5201     'rate_region' => {
5202       'columns' => [
5203         'regionnum',   'serial',      '', '', '', '',
5204         'regionname',  'varchar',     '', $char_d, '', '',
5205         'exact_match', 'char',    'NULL',  1, '', '',
5206       ],
5207       'primary_key' => 'regionnum',
5208       'unique'      => [],
5209       'index'       => [],
5210     },
5211
5212     'rate_prefix' => {
5213       'columns' => [
5214         'prefixnum',   'serial',      '', '', '', '',
5215         'regionnum',   'int',         '', '', '', '',
5216         'countrycode', 'varchar',     '',  3, '', '',
5217         'npa',         'varchar', 'NULL', 10, '', '', #actually the whole prefix
5218         'nxx',         'varchar', 'NULL',  3, '', '', #actually not used
5219         'latanum',     'int',     'NULL',      '', '', '',
5220         'state',       'char',    'NULL',       2, '', '',
5221         'ocn',         'char',    'NULL',       4, '', '',
5222       ],
5223       'primary_key'  => 'prefixnum',
5224       'unique'       => [ [ 'countrycode', 'npa', 'nxx' ] ],
5225       'index'        => [ [ 'countrycode' ], [ 'npa' ], [ 'regionnum' ] ],
5226       'foreign_keys' => [
5227                           { columns    => [ 'regionnum' ],
5228                             table      => 'rate_region',
5229                           },
5230                           { columns    => [ 'latanum' ],
5231                             table      => 'lata',
5232                           },
5233                         ],
5234     },
5235
5236     'rate_time' => {
5237       'columns' => [
5238         'ratetimenum', 'serial',      '',      '', '', '',
5239         'ratetimename',   'varchar',      '', $char_d, '', '',
5240       ],
5241       'primary_key' => 'ratetimenum',
5242       'unique'      => [],
5243       'index'       => [],
5244     },
5245
5246     'rate_time_interval' => {
5247       'columns' => [
5248         'intervalnum', 'serial', '', '', '', '',
5249         'stime',          'int', '', '', '', '',
5250         'etime',          'int', '', '', '', '',
5251         'ratetimenum',    'int', '', '', '', '',
5252       ],
5253       'primary_key'  => 'intervalnum',
5254       'unique'       => [],
5255       'index'        => [],
5256       'foreign_keys' => [
5257                           { columns    => [ 'ratetimenum' ],
5258                             table      => 'rate_time',
5259                           },
5260                         ],
5261      },
5262
5263     #not really part of the above rate_ stuff (used with flat rate rather than
5264     # rated billing), but could be eventually, and its a rate
5265     'rate_tier' => {
5266       'columns' => [
5267         'tiernum',   'serial', '',      '', '', '',
5268         'tiername', 'varchar', '', $char_d, '', '',
5269       ],
5270       'primary_key' => 'tiernum',
5271       'unique'      => [ [ 'tiername'], ],
5272       'index'       => [],
5273     },
5274
5275     'rate_tier_detail' => {
5276       'columns' => [
5277         'tierdetailnum', 'serial', '',     '', '', '',
5278         'tiernum',          'int', '',     '', '', '',
5279         'min_quan',         'int', '',     '', '', '',
5280         'min_charge',   'decimal', '', '10,4', '', '',
5281       ],
5282       'primary_key'  => 'tierdetailnum',
5283       'unique'       => [],
5284       'index'        => [ ['tiernum'], ],
5285       'foreign_keys' => [
5286                           { columns    => [ 'tiernum' ],
5287                             table      => 'rate_tier',
5288                           },
5289                         ],
5290     },
5291
5292     'usage_class' => {
5293       'columns' => [
5294         'classnum',    'serial',      '',      '', '', '',
5295         'weight',      'int',     'NULL',      '', '', '',
5296         'classname',   'varchar',     '', $char_d, '', '',
5297         'format',      'varchar', 'NULL', $char_d, '', '',
5298         'disabled',    'char',    'NULL',       1, '', '',
5299       ],
5300       'primary_key' => 'classnum',
5301       'unique' => [],
5302       'index' => [ ['disabled'] ],
5303     },
5304
5305     'reg_code' => {
5306       'columns' => [
5307         'codenum',   'serial',    '', '', '', '',
5308         'code',      'varchar',   '', $char_d, '', '',
5309         'agentnum',  'int',       '', '', '', '',
5310       ],
5311       'primary_key'  => 'codenum',
5312       'unique'       => [ [ 'agentnum', 'code' ] ],
5313       'index'        => [ [ 'agentnum' ] ],
5314       'foreign_keys' => [
5315                           { columns    => [ 'agentnum' ],
5316                             table      => 'agent',
5317                           },
5318                         ],
5319      },
5320
5321     'reg_code_pkg' => {
5322       'columns' => [
5323         'codepkgnum', 'serial', '', '', '', '',
5324         'codenum',   'int',    '', '', '', '',
5325         'pkgpart',   'int',    '', '', '', '',
5326       ],
5327       'primary_key'  => 'codepkgnum',
5328       'unique'       => [ [ 'codenum', 'pkgpart' ] ],
5329       'index'        => [ [ 'codenum' ] ],
5330       'foreign_keys' => [
5331                           { columns    => [ 'codenum' ],
5332                             table      => 'reg_code',
5333                           },
5334                           { columns    => [ 'pkgpart' ],
5335                             table      => 'part_pkg',
5336                           },
5337                         ],
5338     },
5339
5340     'clientapi_session' => {
5341       'columns' => [
5342         'sessionnum',  'serial',  '', '', '', '',
5343         'sessionid',  'varchar',  '', $char_d, '', '',
5344         'namespace',  'varchar',  '', $char_d, '', '',
5345       ],
5346       'primary_key' => 'sessionnum',
5347       'unique'      => [ [ 'sessionid', 'namespace' ] ],
5348       'index'       => [],
5349     },
5350
5351     'clientapi_session_field' => {
5352       'columns' => [
5353         'fieldnum',    'serial',     '', '', '', '',
5354         'sessionnum',     'int',     '', '', '', '',
5355         'fieldname',  'varchar',     '', $char_d, '', '',
5356         'fieldvalue',    'text', 'NULL', '', '', '',
5357       ],
5358       'primary_key'  => 'fieldnum',
5359       'unique'       => [ [ 'sessionnum', 'fieldname' ] ],
5360       'index'        => [],
5361       'foreign_keys' => [
5362                           { columns    => [ 'sessionnum' ],
5363                             table      => 'clientapi_session',
5364                           },
5365                         ],
5366     },
5367
5368     'payment_gateway' => {
5369       'columns' => [
5370         'gatewaynum',       'serial',   '',     '', '', '',
5371         'gateway_namespace','varchar',  'NULL', $char_d, '', '',
5372         'gateway_module',   'varchar',  '',     $char_d, '', '',
5373         'gateway_username', 'varchar',  'NULL', $char_d, '', '',
5374         'gateway_password', 'varchar',  'NULL', $char_d, '', '',
5375         'gateway_action',   'varchar',  'NULL', $char_d, '', '',
5376         'gateway_callback_url', 'varchar',  'NULL', 255, '', '',
5377         'gateway_cancel_url',   'varchar',  'NULL', 255, '', '',
5378         'disabled',   'char',  'NULL',   1, '', '',
5379       ],
5380       'primary_key' => 'gatewaynum',
5381       'unique' => [],
5382       'index'  => [ [ 'disabled' ] ],
5383     },
5384
5385     'payment_gateway_option' => {
5386       'columns' => [
5387         'optionnum',   'serial',  '',     '', '', '',
5388         'gatewaynum',  'int',     '',     '', '', '',
5389         'optionname',  'varchar', '',     $char_d, '', '',
5390         'optionvalue', 'text',    'NULL', '', '', '',
5391       ],
5392       'primary_key'  => 'optionnum',
5393       'unique'       => [],
5394       'index'        => [ [ 'gatewaynum' ], [ 'optionname' ] ],
5395       'foreign_keys' => [
5396                           { columns    => [ 'gatewaynum' ],
5397                             table      => 'payment_gateway',
5398                           },
5399                         ],
5400     },
5401
5402     'agent_payment_gateway' => {
5403       'columns' => [
5404         'agentgatewaynum', 'serial', '', '', '', '',
5405         'agentnum',        'int', '', '', '', '',
5406         'gatewaynum',      'int', '', '', '', '',
5407         'cardtype',        'varchar', 'NULL', $char_d, '', '',
5408         'taxclass',        'varchar', 'NULL', $char_d, '', '',
5409       ],
5410       'primary_key'  => 'agentgatewaynum',
5411       'unique'       => [],
5412       'index'        => [ [ 'agentnum', 'cardtype' ], ],
5413
5414       'foreign_keys' => [
5415
5416                           { columns    => [ 'agentnum' ],
5417                             table      => 'agent',
5418                           },
5419                           { columns    => [ 'gatewaynum' ],
5420                             table      => 'payment_gateway',
5421                           },
5422                         ],
5423     },
5424
5425     'banned_pay' => {
5426       'columns' => [
5427         'bannum',        'serial',     '',      '', '', '',
5428         'payby',           'char',     '',       4, '', '',
5429         'payinfo',      'varchar',     '',     128, '', '', #say, a 512-big digest _hex encoded
5430         'payinfo_hash', 'varchar', 'NULL',      32, '', '',
5431         #'paymask',      'varchar',  'NULL', $char_d, '', ''
5432         '_date',                @date_type,         '', '',
5433         'end_date',             @date_type,         '', '',
5434         'otaker',       'varchar', 'NULL',      32, '', '',
5435         'usernum',          'int', 'NULL',      '', '', '',
5436         'bantype',      'varchar', 'NULL', $char_d, '', '',
5437         'reason',       'varchar', 'NULL', $char_d, '', '',
5438       ],
5439       'primary_key'  => 'bannum',
5440       'unique'       => [],
5441       'index'        => [ [ 'payby', 'payinfo' ], [ 'usernum' ], ],
5442       'foreign_keys' => [
5443                           { columns    => [ 'usernum' ],
5444                             table      => 'access_user',
5445                           },
5446                         ],
5447     },
5448
5449     'pkg_category' => {
5450       'columns' => [
5451         'categorynum',        'serial',     '',      '', '', '',
5452         'categoryname',      'varchar',     '', $char_d, '', '',
5453         'weight',                'int', 'NULL',      '', '', '',
5454         'ticketing_queueid',     'int', 'NULL',      '', '', '',
5455         'condense',             'char', 'NULL',       1, '', '',
5456         'disabled',             'char', 'NULL',       1, '', '',
5457       ],
5458       'primary_key' => 'categorynum',
5459       'unique' => [],
5460       'index' => [ ['disabled'] ],
5461     },
5462
5463     'pkg_class' => {
5464       'columns' => [
5465         'classnum',    'serial',   '',      '', '', '',
5466         'classname',   'varchar',  '', $char_d, '', '',
5467         'categorynum', 'int',  'NULL',      '', '', '',
5468         'disabled',    'char', 'NULL',       1, '', '',
5469         'fcc_ds0s',      'int',     'NULL', '', '', '',
5470       ],
5471       'primary_key'  => 'classnum',
5472       'unique'       => [],
5473       'index'        => [ ['disabled'] ],
5474       'foreign_keys' => [
5475                           { columns    => [ 'categorynum' ],
5476                             table      => 'pkg_category',
5477                           },
5478                         ],
5479     },
5480
5481     'cdr' => {
5482       'columns' => [
5483         # qw( name type null length default local );
5484
5485         ###
5486         #asterisk fields
5487         ###
5488
5489         'acctid',   'bigserial',  '', '', '', '',
5490         #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
5491         'calldate', 'timestamp',   '',      '', \'now()', '',
5492         'clid',        'varchar',  '', $char_d, \"''", '',
5493         'src',         'varchar',  '', $char_d, \"''", '',
5494         'dst',         'varchar',  '', $char_d, \"''", '',
5495         'dcontext',    'varchar',  '', $char_d, \"''", '',
5496         'channel',     'varchar',  '', $char_d, \"''", '',
5497         'dstchannel',  'varchar',  '', $char_d, \"''", '',
5498         'lastapp',     'varchar',  '', $char_d, \"''", '',
5499         'lastdata',    'varchar',  '',     255, \"''", '',
5500
5501         #currently only opensips & voipswitch
5502         'src_ip_addr', 'varchar',  'NULL',  15,    '', '',
5503
5504         #currently only opensips
5505         'dst_ip_addr', 'varchar',  'NULL',  15,    '', '',
5506
5507         #currently only u4:
5508         # terminating number (as opposed to dialed destination)
5509         'dst_term',    'varchar',  'NULL', $char_d, '', '',
5510
5511         #these don't seem to be logged by most of the SQL cdr_* modules
5512         #except tds under sql-illegal names, so;
5513         # ... don't rely on them for rating?
5514         # and, what they hey, i went ahead and changed the names and data types
5515         # to freeside-style dates...
5516           #'start',  'timestamp', 'NULL',  '',    '', '',
5517           #'answer', 'timestamp', 'NULL',  '',    '', '',
5518           #'end',    'timestamp', 'NULL',  '',    '', '',
5519         'startdate',  @date_type, '', '',
5520         'answerdate', @date_type, '', '',
5521         'enddate',    @date_type, '', '',
5522         #
5523
5524         'duration',    'int',      '',      '',     0, '',
5525         'billsec',     'int',      '',      '',     0, '',
5526         'disposition', 'varchar',  '',      45, \"''", '',
5527         'amaflags',    'int',      '',      '',     0, '',
5528         'accountcode', 'varchar',  '',      32, \"''", '',
5529         'uniqueid',    'varchar',  '', $char_d, \"''", '',
5530         'userfield',   'varchar',  '',     512, \"''", '',
5531
5532         'max_callers', 'int',  'NULL',      '',    '', '',
5533
5534         ###
5535         # old fields for unitel/RSLCOM/convergent that don't map to asterisk
5536         # ones we adoped moved to "own fields" section below
5537         # charged_party, upstream_price, rated_price, carrierid, cdrtypenum
5538         ###
5539
5540         'upstream_currency',      'char', 'NULL',       3, '', '',
5541         'upstream_rateplanid',     'int', 'NULL',      '', '', '', #?
5542
5543         # how it was rated internally...
5544         'ratedetailnum',           'int', 'NULL',      '', '', '',
5545
5546         'distance',            'decimal', 'NULL',      '', '', '',
5547         'islocal',                 'int', 'NULL',      '', '', '', # '',  '', 0, '' instead?
5548
5549         #cdr_calltype: the big list in appendix 2
5550         'calltypenum',             'int', 'NULL',      '', '', '',
5551
5552         'description',         'varchar', 'NULL', $char_d, '', '',
5553         'quantity',                'int', 'NULL',      '', '', '',
5554
5555         'upstream_rateid',         'int', 'NULL',      '', '', '',
5556
5557         ###
5558         # more fields, for GSM imports
5559         ###
5560         'servicecode',             'int', 'NULL',      '', '', '',
5561         'quantity_able',           'int', 'NULL',      '', '', '',
5562
5563         ###
5564         #and now for our own fields
5565         ###
5566
5567         'cdrtypenum',              'int', 'NULL',      '', '', '',
5568
5569         'charged_party',       'varchar', 'NULL', $char_d, '', '',
5570         'charged_party_imsi',  'varchar', 'NULL', $char_d, '', '',
5571
5572         'upstream_price',      'decimal', 'NULL',  '10,5', '', '',
5573
5574         #currently only voipswitch
5575         #'upstream_rate',      'decimal', 'NULL',  '10,5', '', '',
5576
5577         'upstream_src_regionname', 'varchar', 'NULL', $char_d, '', '',
5578         'upstream_dst_regionname', 'varchar', 'NULL', $char_d, '', '',
5579
5580         # how it was rated internally...
5581         'rated_pretty_dst',       'varchar', 'NULL', $char_d, '', '',
5582         'rated_regionname',       'varchar', 'NULL', $char_d, '', '',
5583         'rated_price',            'decimal', 'NULL',  '10,4', '', '',
5584         'rated_seconds',              'int', 'NULL',      '', '', '',
5585         'rated_minutes', 'double precision', 'NULL',      '', '', '',
5586         'rated_granularity',          'int', 'NULL',      '', '', '',
5587         'rated_ratedetailnum',        'int', 'NULL',      '', '', '',
5588         'rated_classnum',             'int', 'NULL',      '', '', '',
5589         'rated_ratename',         'varchar', 'NULL', $char_d, '', '',
5590         'rated_cost',            'decimal', 'NULL',  '10,4', '', '',
5591
5592         # real endpoints of the call
5593         'src_lrn',             'varchar', 'NULL',     '15', '', '',
5594         'dst_lrn',             'varchar', 'NULL',     '15', '', '',
5595
5596         'carrierid',               'bigint', 'NULL',      '', '', '',
5597
5598         # service it was matched to
5599         'svcnum',             'int',   'NULL',     '',   '', '',
5600
5601         #NULL, done (or something)
5602         'freesidestatus', 'varchar',   'NULL',     32,   '', '',
5603
5604         #additional status info (i.e. reason for "skipped" freesidestatus)
5605         'freesidestatustext', 'text',  'NULL',     '',   '', '',
5606
5607         #NULL, done (or something)
5608         'freesiderewritestatus', 'varchar',   'NULL',     32,   '', '',
5609
5610         #an indexed place to put big numbers
5611         'cdrid',         'bigint',     'NULL',     '',  '', '',
5612
5613         #for taqua accountcode rewriting, for starters
5614         'sessionnum',       'int',    'NULL',      '', '', '',
5615         'subscriber',   'varchar',    'NULL', $char_d, '', '',
5616
5617         #old
5618         'cdrbatch',     'varchar',    'NULL',     255, '', '',
5619         #new
5620         'cdrbatchnum',      'int',    'NULL',      '', '', '',
5621
5622         # FK to cust_bill_pkg_detail; having a value here absolutely means
5623         # that the CDR appears on an invoice
5624         'detailnum',     'bigint',    'NULL',      '', '', '',
5625       ],
5626       'primary_key' => 'acctid',
5627       'unique' => [],
5628       'index' => [ [ 'calldate' ],
5629                    [ 'src' ], [ 'dst' ], [ 'dcontext' ], [ 'charged_party' ],
5630                    [ 'startdate' ], [ 'duration' ],
5631                    [ 'cdrtypenum' ], [ 'calltypenum' ],
5632                    [ 'lastapp' ],
5633                    ['accountcode'], ['uniqueid'], ['carrierid'], ['cdrid'],
5634                    [ 'sessionnum' ], [ 'subscriber' ],
5635                    [ 'freesidestatus' ], [ 'freesiderewritestatus' ],
5636                    [ 'cdrbatch' ], [ 'cdrbatchnum' ],
5637                    [ 'src_ip_addr' ], [ 'dst_ip_addr' ], [ 'dst_term' ],
5638                    [ 'detailnum' ],
5639                  ],
5640       #no FKs on cdr table... choosing not to throw errors no matter what's
5641       # thrown in here.  better to have the data.
5642     },
5643
5644     'cdr_batch' => {
5645       'columns' => [
5646         'cdrbatchnum',   'serial',    '',   '', '', '',
5647         'cdrbatch', 'varchar', 'NULL', 255, '', '',
5648         '_date',     @date_type, '', '',
5649       ],
5650       'primary_key' => 'cdrbatchnum',
5651       'unique' => [ [ 'cdrbatch' ] ],
5652       'index' => [],
5653     },
5654
5655     'cdr_termination' => {
5656       'columns' => [
5657         'cdrtermnum', 'bigserial',     '',      '', '', '',
5658         'acctid',        'bigint',     '',      '', '', '',
5659         'termpart',         'int',     '',      '', '', '',#future use see below
5660         'rated_price',  'decimal', 'NULL',  '10,4', '', '',
5661         'rated_seconds',    'int', 'NULL',      '', '', '',
5662         'rated_minutes', 'double precision', 'NULL',   '', '', '',
5663         'rated_granularity','int', 'NULL',      '', '', '',
5664         'status',       'varchar', 'NULL',      32, '', '',
5665         'svcnum',           'int', 'NULL',      '', '', '',
5666       ],
5667       'primary_key'  => 'cdrtermnum',
5668       'unique'       => [ [ 'acctid', 'termpart' ] ],
5669       'index'        => [ [ 'acctid' ], [ 'status' ], ],
5670       'foreign_keys' => [
5671                           { columns    => [ 'acctid' ],
5672                             table      => 'cdr',
5673                           },
5674                           { columns    => [ 'svcnum' ],
5675                             table      => 'cust_svc',
5676                           },
5677                         ],
5678     },
5679
5680     #to handle multiple termination/settlement passes...
5681    # 'part_termination' => {
5682    #   'columns' => [
5683    #     'termpart',       'int', '',      '', '', '',
5684    #     'termname',   'varchar', '', $char_d, '', '',
5685    #     'cdr_column', 'varchar', '', $char_d, '', '', #maybe set it here instead of in the price plan?
5686    #   ],
5687    #   'primary_key' => 'termpart',
5688    #   'unique' => [],
5689    #   'index'  => [],
5690    # },
5691
5692     #the remaining cdr_ tables are not really used
5693     'cdr_calltype' => {
5694       'columns' => [
5695         'calltypenum',   'serial',  '', '', '', '',
5696         'calltypename',  'varchar', '', $char_d, '', '',
5697       ],
5698       'primary_key' => 'calltypenum',
5699       'unique'      => [],
5700       'index'       => [],
5701     },
5702
5703     'cdr_type' => {
5704       'columns' => [
5705         'cdrtypenum'  => 'serial',  '', '', '', '',
5706         'cdrtypename' => 'varchar', '', $char_d, '', '',
5707       ],
5708       'primary_key' => 'cdrtypenum',
5709       'unique'      => [],
5710       'index'       => [],
5711     },
5712
5713     'cdr_carrier' => {
5714       'columns' => [
5715         'carrierid'   =>  'serial',     '',      '', '', '',
5716         'carriername' => 'varchar',     '', $char_d, '', '',
5717         'disabled'    =>    'char', 'NULL',       1, '', '',
5718       ],
5719       'primary_key' => 'carrierid',
5720       'unique'      => [],
5721       'index'       => [],
5722     },
5723
5724     #'cdr_file' => {
5725     #  'columns' => [
5726     #    'filenum',    'serial',     '', '', '', '',
5727     #    'filename',  'varchar',     '', '', '', '',
5728     #    'status',    'varchar', 'NULL', '', '', '',
5729     #  ],
5730     #  'primary_key' => 'filenum',
5731     #  'unique' => [ [ 'filename' ], ], #just change the index if we need to
5732     #                                   # agent-virtualize or have a customer
5733     #                                   # with dup-filename needs or something
5734     #                                   # (only used by cdr.http_and_import for
5735     #                                   #  chrissakes)
5736     #  'index'  => [],
5737     #},
5738
5739     'inventory_item' => {
5740       'columns' => [
5741         'itemnum',   'serial',      '',      '', '', '',
5742         'classnum',  'int',         '',      '', '', '',
5743         'agentnum',  'int',     'NULL',      '', '', '',
5744         'item',      'varchar',     '', $char_d, '', '',
5745         'svcnum',    'int',     'NULL',      '', '', '',
5746         'svc_field', 'varchar', 'NULL', $char_d, '', '',
5747       ],
5748       'primary_key'  => 'itemnum',
5749       'unique'       => [ [ 'classnum', 'item' ] ],
5750       'index'        => [ [ 'classnum' ], [ 'agentnum' ], [ 'svcnum' ] ],
5751       'foreign_keys' => [
5752                           { columns    => [ 'classnum' ],
5753                             table      => 'inventory_class',
5754                           },
5755                           { columns    => [ 'agentnum' ],
5756                             table      => 'agent',
5757                           },
5758                           { columns    => [ 'svcnum' ],
5759                             table      => 'cust_svc',
5760                           },
5761                         ],
5762     },
5763
5764     'inventory_class' => {
5765       'columns' => [
5766         'classnum',  'serial',       '',      '', '', '',
5767         'classname', 'varchar',      '', $char_d, '', '',
5768       ],
5769       'primary_key' => 'classnum',
5770       'unique' => [],
5771       'index'  => [],
5772     },
5773
5774     'access_user_session' => {
5775       'columns' => [
5776         'sessionnum',   'serial',  '',      '', '', '',
5777         'sessionkey',  'varchar',  '', $char_d, '', '',
5778         'usernum',         'int',  '',      '', '', '',
5779         'start_date', @date_type,               '', '',
5780         'last_date',  @date_type,               '', '',
5781       ],
5782       'primary_key'  => 'sessionnum',
5783       'unique'       => [ [ 'sessionkey' ] ],
5784       'index'        => [],
5785       'foreign_keys' => [
5786                           { columns    => [ 'usernum' ],
5787                             table      => 'access_user',
5788                           },
5789                         ],
5790     },
5791
5792     'access_user_session_log' => {
5793       'columns' => [
5794         'sessionlognum', 'serial', '',      '', '', '',
5795         'usernum',          'int', '',      '', '', '',
5796         'start_date',  @date_type,              '', '',
5797         'last_date',   @date_type,              '', '',
5798         'logout_date', @date_type,              '', '',
5799         'logout_type',  'varchar', '', $char_d, '', '',
5800       ],
5801       'primary_key' => 'sessionlognum',
5802       'unique'       => [],
5803       'index'        => [],
5804       'foreign_keys' => [
5805                           { columns    => [ 'usernum' ],
5806                             table      => 'access_user',
5807                           },
5808                         ],
5809     },
5810
5811     'access_user' => {
5812       'columns' => [
5813         'usernum',             'serial',     '',      '', '', '',
5814         'username',           'varchar',     '', $char_d, '', '',
5815         '_password',          'varchar', 'NULL', $char_d, '', '',
5816         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
5817         'last',               'varchar', 'NULL', $char_d, '', '',
5818         'first',              'varchar', 'NULL', $char_d, '', '',
5819         'user_custnum',           'int', 'NULL',      '', '', '',
5820         'report_salesnum',        'int', 'NULL',      '', '', '',
5821         'disabled',              'char', 'NULL',       1, '', '',
5822       ],
5823       'primary_key'  => 'usernum',
5824       'unique'       => [ [ 'username' ] ],
5825       'index'        => [ [ 'user_custnum' ] ],
5826       'foreign_keys' => [
5827                           { columns    => [ 'user_custnum' ],
5828                             table      => 'cust_main',
5829                             references => [ 'custnum' ],
5830                           },
5831                           { columns    => [ 'report_salesnum' ],
5832                             table      => 'sales',
5833                             references => [ 'salesnum' ],
5834                           },
5835                         ],
5836     },
5837
5838     'access_user_pref' => {
5839       'columns' => [
5840         'prefnum',    'serial',       '', '', '', '',
5841         'usernum',     'int',       '', '', '', '',
5842         'prefname', 'varchar', '', $char_d, '', '',
5843         'prefvalue', 'text', 'NULL', '', '', '',
5844         'expiration', @date_type, '', '',
5845       ],
5846       'primary_key'  => 'prefnum',
5847       'unique'       => [],
5848       'index'        => [ [ 'usernum' ] ],
5849       'foreign_keys' => [
5850                           { columns    => [ 'usernum' ],
5851                             table      => 'access_user',
5852                           },
5853                         ],
5854     },
5855
5856     'access_group' => {
5857       'columns' => [
5858         'groupnum',        'serial',     '',      '', '', '',
5859         'groupname',      'varchar',     '', $char_d, '', '',
5860         'session_timeout',    'int', 'NULL',      '', '', '',
5861       ],
5862       'primary_key' => 'groupnum',
5863       'unique' => [ [ 'groupname' ] ],
5864       'index'  => [],
5865     },
5866
5867     'access_usergroup' => {
5868       'columns' => [
5869         'usergroupnum', 'serial', '', '', '', '',
5870         'usernum',         'int', '', '', '', '',
5871         'groupnum',        'int', '', '', '', '',
5872       ],
5873       'primary_key'  => 'usergroupnum',
5874       'unique'       => [ [ 'usernum', 'groupnum' ] ],
5875       'index'        => [ [ 'usernum' ] ],
5876       'foreign_keys' => [
5877                           { columns    => [ 'usernum' ],
5878                             table      => 'access_user',
5879                           },
5880                           { columns    => [ 'groupnum' ],
5881                             table      => 'access_group',
5882                           },
5883                         ],
5884      },
5885
5886     'access_groupagent' => {
5887       'columns' => [
5888         'groupagentnum', 'serial', '', '', '', '',
5889         'groupnum',         'int', '', '', '', '',
5890         'agentnum',         'int', '', '', '', '',
5891       ],
5892       'primary_key'  => 'groupagentnum',
5893       'unique'       => [ [ 'groupnum', 'agentnum' ] ],
5894       'index'        => [ [ 'groupnum' ] ],
5895       'foreign_keys' => [
5896                           { columns    => [ 'groupnum' ],
5897                             table      => 'access_group',
5898                           },
5899                           { columns    => [ 'agentnum' ],
5900                             table      => 'agent',
5901                           },
5902                         ],
5903     },
5904
5905     'access_right' => {
5906       'columns' => [
5907         'rightnum',   'serial', '',      '', '', '',
5908         'righttype', 'varchar', '', $char_d, '', '',
5909         'rightobjnum',   'int', '',      '', '', '',
5910         'rightname', 'varchar', '', $char_d, '', '',
5911       ],
5912       'primary_key' => 'rightnum',
5913       'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
5914       'index'  => [],
5915     },
5916
5917     'access_user_log' => {
5918       'columns'      => [
5919         'lognum',          'serial',     '',        '', '', '',
5920         'usernum',            'int',     '',        '', '', '',
5921         'path',           'varchar',     '', 2*$char_d, '', '',
5922         '_date',                   @date_type,          '', '',
5923         'render_seconds',     'int', 'NULL',        '', '', '',
5924         'pid',                'int', 'NULL',        '', '', '',
5925       ],
5926       'primary_key'  => 'lognum',
5927       'unique'       => [],
5928       'index'        => [ ['usernum'], ['path'], ['_date'] ],
5929     },
5930
5931     'access_user_page_pref' => {
5932       'columns'     => [
5933         'prefnum'     =>  'serial',     '',      '', '', '',
5934         'usernum'     =>     'int',     '',      '', '', '',
5935         'path'        =>    'text',     '',      '', '', '',
5936         'tablenum'    =>     'int', 'NULL',      '', '', '',
5937         '_date'       =>    @date_type,              '', '',
5938         'prefname'    =>    'varchar',  '', $char_d, '', '',
5939         'prefvalue'   =>    'text',     '',      '', '', '',
5940       ],
5941       'primary_key' => 'prefnum',
5942       'unique'      => [ [ 'usernum', 'path', 'tablenum', 'prefname' ] ],
5943       'index'       => [],
5944       'foreign_keys' => [
5945                           { columns   => [ 'usernum' ],
5946                             table     => 'access_user'
5947                           },
5948                         ],
5949     },
5950
5951     'sched_item' => {
5952       'columns' => [
5953         'itemnum',   'serial',      '', '', '', '',
5954         'usernum',      'int',  'NULL', '', '', '',
5955         #'itemname', 'varchar', $char_d, '', '', '',
5956         'disabled',    'char',  'NULL',  1, '', '',
5957       ],
5958       'primary_key'  => 'itemnum',
5959       'unique'       => [ [ 'usernum' ] ],
5960       'index'        => [],
5961       'foreign_keys' => [
5962                           { columns    => [ 'usernum' ],
5963                             table      => 'access_user',
5964                           },
5965                         ],
5966     },
5967
5968     #'sched_item_class'
5969
5970     'sched_avail' => {
5971       'columns' => [
5972         'availnum',      'serial', '', '', '', '',
5973         'itemnum',          'int', '', '', '', '',
5974         'wday',             'int', '', '', '', '',
5975         'stime',            'int', '', '', '', '',
5976         'etime',            'int', '', '', '', '',
5977         'override_date',    @date_type,    '', '',
5978       ],
5979       'primary_key'  => 'availnum',
5980       'unique'       => [],
5981       'index'        => [],
5982       'foreign_keys' => [
5983                           { columns    => [ 'itemnum' ],
5984                             table      => 'sched_item',
5985                           },
5986                         ],
5987     },
5988
5989     'svc_phone' => {
5990       'columns' => [
5991         'svcnum',                         'int',     '',      '', '', '',
5992         'countrycode',                'varchar',     '',       3, '', '',
5993         'phonenum',                   'varchar',     '',      25, '', '', #12 ?
5994         'sim_imsi',                   'varchar', 'NULL',      15, '', '',
5995         'pin',                        'varchar', 'NULL', $char_d, '', '',
5996         'sip_password',               'varchar', 'NULL', $char_d, '', '',
5997         'phone_name',                 'varchar', 'NULL', $char_d, '', '',
5998         'pbxsvc',                         'int', 'NULL',      '', '', '',
5999         'domsvc',                         'int', 'NULL',      '', '', '',
6000         'locationnum',                    'int', 'NULL',      '', '', '',
6001         'forward_svcnum',                 'int', 'NULL',      '', '', '',
6002         'forwarddst',                 'varchar', 'NULL',      15, '', '',
6003         'email',                      'varchar', 'NULL',     255, '', '',
6004         'lnp_status',                 'varchar', 'NULL', $char_d, '', '',
6005         'portable',                      'char', 'NULL',       1, '', '',
6006         'lrn',                           'char', 'NULL',      10, '', '',
6007         'lnp_desired_due_date',           'int', 'NULL',      '', '', '',
6008         'lnp_due_date',                   'int', 'NULL',      '', '', '',
6009         'lnp_other_provider',         'varchar', 'NULL', $char_d, '', '',
6010         'lnp_other_provider_account', 'varchar', 'NULL', $char_d, '', '',
6011         'lnp_reject_reason',          'varchar', 'NULL', $char_d, '', '',
6012         'lnp_portid',                 'varchar', 'NULL', $char_d, '', '',
6013         'lnp_signature',                 'char', 'NULL',       1, '', '',
6014         'lnp_bill',                      'char', 'NULL',       1, '', '',
6015         'sms_carrierid',                  'int', 'NULL',      '', '', '',
6016         'sms_account',                'varchar', 'NULL', $char_d, '', '',
6017         'max_simultaneous',               'int', 'NULL',      '', '', '',
6018         'e911_class',                    'char', 'NULL',       1, '', '',
6019         'e911_type',                     'char', 'NULL',       1, '', '',
6020         'circuit_svcnum',                 'int', 'NULL',      '', '', '',
6021         'sip_server',                 'varchar', 'NULL', $char_d, '', '',
6022       ],
6023       'primary_key'  => 'svcnum',
6024       'unique'       => [ [ 'sms_carrierid', 'sms_account'] ],
6025       'index'        => [ ['countrycode', 'phonenum'], ['pbxsvc'], ['domsvc'],
6026                           ['locationnum'], ['sms_carrierid'],
6027                         ],
6028       'foreign_keys' => [
6029                           { columns    => [ 'svcnum' ],
6030                             table      => 'cust_svc',
6031                           },
6032                           { columns    => [ 'pbxsvc' ],
6033                             table      => 'svc_pbx', #'cust_svc',
6034                             references => [ 'svcnum' ],
6035                           },
6036                           { columns    => [ 'domsvc' ],
6037                             table      => 'svc_domain', #'cust_svc',
6038                             references => [ 'svcnum' ],
6039                           },
6040                           { columns    => [ 'locationnum' ],
6041                             table      => 'cust_location',
6042                           },
6043                           { columns    => [ 'sms_carrierid' ],
6044                             table      => 'cdr_carrier',
6045                             references => [ 'carrierid' ],
6046                           },
6047                           { columns    => [ 'circuit_svcnum' ],
6048                             table      => 'svc_circuit',
6049                             references => [ 'svcnum' ],
6050                           },
6051                         ],
6052     },
6053
6054     'phone_device' => {
6055       'columns' => [
6056         'devicenum', 'serial',     '', '', '', '',
6057         'devicepart',   'int',     '', '', '', '',
6058         'svcnum',       'int',     '', '', '', '',
6059         'mac_addr', 'varchar', 'NULL', 12, '', '',
6060       ],
6061       'primary_key'  => 'devicenum',
6062       'unique'       => [ [ 'mac_addr' ], ],
6063       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6064       'foreign_keys' => [
6065                           { columns    => [ 'devicepart' ],
6066                             table      => 'part_device',
6067                           },
6068                           { columns    => [ 'svcnum' ],
6069                             table      => 'svc_phone',
6070                           },
6071                         ],
6072     },
6073
6074     'part_device' => {
6075       'columns' => [
6076         'devicepart', 'serial',  '',      '', '', '',
6077         'devicename', 'varchar', '', $char_d, '', '',
6078         'inventory_classnum', 'int', 'NULL', '', '', '',
6079         'title',      'varchar', 'NULL', $char_d, '', '',
6080       ],
6081       'primary_key'  => 'devicepart',
6082       'unique'       => [ [ 'devicename' ] ], #?
6083       'index'        => [],
6084       'foreign_keys' => [
6085                           { columns    => [ 'inventory_classnum' ],
6086                             table      => 'inventory_class',
6087                             references => [ 'classnum' ],
6088                           },
6089                         ],
6090     },
6091
6092     'phone_avail' => {
6093       'columns' => [
6094         'availnum',    'serial',      '',      '', '', '',
6095         'exportnum',   'int',         '',      '', '', '',
6096         'countrycode', 'varchar',     '',       3, '', '',
6097         'state',       'char',    'NULL',       2, '', '',
6098         'npa',         'char',        '',       3, '', '',
6099         'nxx',         'char',    'NULL',       3, '', '',
6100         'station',     'char',    'NULL',       4, '', '',
6101         'name',        'varchar', 'NULL', $char_d, '', '',
6102         'rate_center_abbrev', 'varchar', 'NULL', $char_d, '', '',
6103         'latanum',      'int',     'NULL',      '', '', '',
6104         'msanum',       'int', 'NULL', '', '', '',
6105         'ordernum',      'int',     'NULL',      '', '', '',
6106         'svcnum',      'int',     'NULL',      '', '', '',
6107         'availbatch', 'varchar',  'NULL', $char_d, '', '',
6108       ],
6109       'primary_key'  => 'availnum',
6110       'unique'       => [],
6111       'index'        => [ ['exportnum','countrycode','state'],    #npa search
6112                           ['exportnum','countrycode','npa'],      #nxx search
6113                           ['exportnum','countrycode','npa','nxx'],#station srch
6114                           [ 'exportnum','countrycode','npa','nxx','station'], #
6115                           [ 'svcnum' ],
6116                           [ 'availbatch' ],
6117                           [ 'latanum' ],
6118                         ],
6119       'foreign_keys' => [
6120                           { columns    => [ 'exportnum' ],
6121                             table      => 'part_export',
6122                           },
6123                           { columns    => [ 'latanum' ],
6124                             table      => 'lata',
6125                           },
6126                           { columns    => [ 'msanum' ],
6127                             table      => 'msa',
6128                           },
6129                           { columns    => [ 'ordernum' ],
6130                             table      => 'did_order',
6131                           },
6132                           { columns    => [ 'svcnum' ],
6133                             table      => 'svc_phone',
6134                           },
6135                         ],
6136     },
6137
6138     'lata' => {
6139       'columns' => [
6140         'latanum',    'int',      '',      '', '', '',
6141         'description',   'varchar',    '',      $char_d, '', '',
6142         'have_usage',   'int',    'NULL',      '', '', '',
6143       ],
6144       'primary_key' => 'latanum',
6145       'unique' => [],
6146       'index'  => [],
6147     },
6148
6149     'msa' => {
6150       'columns' => [
6151         'msanum',    'int',      '',      '', '', '',
6152         'description',   'varchar',    '',      $char_d, '', '',
6153       ],
6154       'primary_key' => 'msanum',
6155       'unique' => [],
6156       'index'  => [],
6157     },
6158
6159     'rate_center' => {
6160       'columns' => [
6161         'ratecenternum',    'serial',      '',      '', '', '',
6162         'description',   'varchar',    '',      $char_d, '', '',
6163       ],
6164       'primary_key' => 'ratecenternum',
6165       'unique' => [],
6166       'index'  => [],
6167     },
6168
6169     'did_vendor' => {
6170       'columns' => [
6171         'vendornum',    'serial',      '',      '', '', '',
6172         'vendorname',   'varchar',        '',     $char_d, '', '',
6173       ],
6174       'primary_key' => 'vendornum',
6175       'unique' => [],
6176       'index'  => [],
6177     },
6178
6179     'did_order_item' => {
6180       'columns' => [
6181         'orderitemnum',    'serial',      '',      '', '', '',
6182         'ordernum',    'int',      '',      '', '', '',
6183         'msanum',      'int',     'NULL',      '', '', '',
6184         'npa',      'int',     'NULL',      '', '', '',
6185         'latanum',      'int',     'NULL',      '', '', '',
6186         'ratecenternum',      'int',     'NULL',      '', '', '',
6187         'state',       'char',    'NULL',       2, '', '',
6188         'quantity',      'int',     '',      '', '', '',
6189         'custnum',   'int', 'NULL', '', '', '',
6190       ],
6191       'primary_key'  => 'orderitemnum',
6192       'unique'       => [],
6193       'index'        => [],
6194       'foreign_keys' => [
6195                           { columns    => [ 'ordernum' ],
6196                             table      => 'did_order',
6197                           },
6198                           { columns    => [ 'msanum' ],
6199                             table      => 'msa',
6200                           },
6201                           { columns    => [ 'latanum' ],
6202                             table      => 'lata',
6203                           },
6204                           { columns    => [ 'ratecenternum' ],
6205                             table      => 'rate_center',
6206                           },
6207                           { columns    => [ 'custnum' ],
6208                             table      => 'cust_main',
6209                           },
6210                         ],
6211     },
6212
6213     'did_order' => {
6214       'columns' => [
6215         'ordernum',    'serial',      '',      '', '', '',
6216         'vendornum',   'int',       '',      '', '', '',
6217         'vendor_order_id',   'varchar',  'NULL',   $char_d, '', '',
6218         'custnum',   'int', 'NULL', '', '', '',
6219         'submitted',      'int',     '',      '', '', '',
6220         'confirmed',      'int',     'NULL',      '', '', '',
6221         'received',      'int',     'NULL',      '', '', '',
6222       ],
6223       'primary_key'  => 'ordernum',
6224       'unique'       => [ [ 'vendornum', 'vendor_order_id' ] ],
6225       'index'        => [],
6226       'foreign_keys' => [
6227                           { columns    => [ 'vendornum' ],
6228                             table      => 'did_vendor',
6229                           },
6230                           { columns    => [ 'custnum' ],
6231                             table      => 'cust_main',
6232                           },
6233                         ],
6234     },
6235
6236     'reason_type' => {
6237       'columns' => [
6238         'typenum',   'serial',  '', '', '', '',
6239         'class',     'char', '', 1, '', '',
6240         'type',     'varchar', '', $char_d, '', '',
6241       ],
6242       'primary_key' => 'typenum',
6243       'unique' => [],
6244       'index' => [],
6245     },
6246
6247     'reason' => {
6248       'columns' => [
6249         'reasonnum',     'serial',  '', '', '', '',
6250         'reason_type',   'int',  '', '', '', '',
6251         'reason',        'text', '', '', '', '',
6252         'disabled',      'char',    'NULL', 1, '', '',
6253         'unsuspend_pkgpart', 'int',  'NULL', '', '', '',
6254         'unsuspend_hold','char',    'NULL', 1, '', '',
6255         'unused_credit', 'char',    'NULL', 1, '', '',
6256         'feepart',        'int', 'NULL', '', '', '',
6257         'fee_on_unsuspend','char',  'NULL', 1, '', '',
6258         'fee_hold',      'char',    'NULL', 1, '', '',
6259       ],
6260       'primary_key'  => 'reasonnum',
6261       'unique'       => [],
6262       'index'        => [],
6263       'foreign_keys' => [
6264                           { columns    => [ 'reason_type' ],
6265                             table      => 'reason_type',
6266                             references => [ 'typenum' ],
6267                           },
6268                           { columns    => [ 'unsuspend_pkgpart' ],
6269                             table      => 'part_pkg',
6270                             references => [ 'pkgpart' ],
6271                           },
6272                         ],
6273     },
6274
6275     'conf' => {
6276       'columns' => [
6277         'confnum',  'serial',     '',      '', '', '',
6278         'agentnum', 'int',    'NULL',      '', '', '',
6279         'locale',   'varchar','NULL',      16, '', '',
6280         'name',     'varchar',    '', $char_d, '', '',
6281         'value',    'text',   'NULL',      '', '', '',
6282       ],
6283       'primary_key'  => 'confnum',
6284       'unique'       => [ [ 'agentnum', 'locale', 'name' ] ],
6285       'index'        => [],
6286       'foreign_keys' => [
6287                           { columns    => [ 'agentnum' ],
6288                             table      => 'agent',
6289                           },
6290                         ],
6291     },
6292
6293     'pkg_referral' => {
6294       'columns' => [
6295         'pkgrefnum',     'serial', '', '', '', '',
6296         'pkgnum',        'int',    '', '', '', '',
6297         'refnum',        'int',    '', '', '', '',
6298       ],
6299       'primary_key'  => 'pkgrefnum',
6300       'unique'       => [ [ 'pkgnum', 'refnum' ] ],
6301       'index'        => [ [ 'pkgnum' ], [ 'refnum' ] ],
6302       'foreign_keys' => [
6303                           { columns    => [ 'pkgnum' ],
6304                             table      => 'cust_pkg',
6305                           },
6306                           { columns    => [ 'refnum' ],
6307                             table      => 'part_referral',
6308                           },
6309                         ],
6310     },
6311
6312     'svc_pbx' => {
6313       'columns' => [
6314         'svcnum',           'int',     '',      '', '', '',
6315         'id',               'int', 'NULL',      '', '', '',
6316         'uuid',            'char', 'NULL',      36, '', '',
6317         'title',        'varchar', 'NULL', $char_d, '', '',
6318         'max_extensions',   'int', 'NULL',      '', '', '',
6319         'max_simultaneous', 'int', 'NULL',      '', '', '',
6320         'ip_addr',      'varchar', 'NULL',      40, '', '',
6321       ],
6322       'primary_key'  => 'svcnum',
6323       'unique'       => [],
6324       'index'        => [ [ 'id' ], [ 'uuid' ] ],
6325       'foreign_keys' => [
6326                           { columns    => [ 'svcnum' ],
6327                             table      => 'cust_svc',
6328                           },
6329                         ],
6330     },
6331
6332     'pbx_extension' => {
6333       'columns' => [
6334         'extensionnum',  'serial',     '',      '', '', '',
6335         'svcnum',           'int',     '',      '', '', '',
6336         'extension',    'varchar',     '', $char_d, '', '',
6337         'pin',          'varchar', 'NULL', $char_d, '', '',
6338         'sip_password', 'varchar', 'NULL', $char_d, '', '',
6339         'phone_name',   'varchar', 'NULL', $char_d, '', '',
6340       ],
6341       'primary_key'  => 'extensionnum',
6342       'unique'       => [ [ 'svcnum', 'extension' ] ],
6343       'index'        => [ [ 'svcnum' ] ],
6344       'foreign_keys' => [
6345                           { columns    => [ 'svcnum' ],
6346                             table      => 'svc_pbx',
6347                           },
6348                         ],
6349     },
6350
6351     'pbx_device' => {
6352       'columns' => [
6353         'devicenum', 'serial',     '', '', '', '',
6354         'devicepart',   'int',     '', '', '', '',
6355         'svcnum',       'int',     '', '', '', '',
6356         'mac_addr', 'varchar', 'NULL', 12, '', '',
6357       ],
6358       'primary_key'  => 'devicenum',
6359       'unique'       => [ [ 'mac_addr' ], ],
6360       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6361       'foreign_keys' => [
6362                           { columns    => [ 'devicepart' ],
6363                             table      => 'part_device',
6364                           },
6365                           { columns    => [ 'svcnum' ],
6366                             table      => 'svc_pbx',
6367                           },
6368                         ],
6369     },
6370
6371     'extension_device' => {
6372       'columns' => [
6373         'extensiondevicenum', 'serial', '', '', '', '',
6374         'extensionnum',          'int', '', '', '', '',
6375         'devicenum',             'int', '', '', '', '',
6376       ],
6377       'primary_key'  => 'extensiondevicenum',
6378       'unique'       => [ [ 'extensionnum', 'devicenum' ] ],
6379       'index'        => [],#both?  which way do we need to query?
6380       'foreign_keys' => [
6381                           { columns  => [ 'extensionnum' ],
6382                             table    => 'pbx_extension',
6383                           },
6384                           { columns  => [ 'devicenum' ],
6385                             table    => 'pbx_device',
6386                           },
6387                         ],
6388     },
6389
6390     'svc_mailinglist' => { #svc_group?
6391       'columns' => [
6392         'svcnum',            'int',     '',            '', '', '',
6393         'username',      'varchar',     '', $username_len, '', '',
6394         'domsvc',            'int',     '',            '', '', '',
6395         'listnum',           'int',     '',            '', '', '',
6396         'reply_to',         'char', 'NULL',             1, '', '',#SetReplyTo
6397         'remove_from',      'char', 'NULL',             1, '', '',#RemoveAuthor
6398         'reject_auto',      'char', 'NULL',             1, '', '',#RejectAuto
6399         'remove_to_and_cc', 'char', 'NULL',             1, '', '',#RemoveToAndCc
6400       ],
6401       'primary_key'  => 'svcnum',
6402       'unique'       => [],
6403       'index'        => [ ['username'], ['domsvc'], ['listnum'] ],
6404       'foreign_keys' => [
6405                           { columns    => [ 'svcnum' ],
6406                             table      => 'cust_svc',
6407                           },
6408                           { columns    => [ 'domsvc' ],
6409                             table      => 'svc_domain', #'cust_svc',
6410                             references => [ 'svcnum' ],
6411                           },
6412                           { columns    => [ 'listnum' ],
6413                             table      => 'mailinglist',
6414                           },
6415                         ],
6416     },
6417
6418     'mailinglist' => {
6419       'columns' => [
6420         'listnum',   'serial', '',      '', '', '',
6421         'listname', 'varchar', '', $char_d, '', '',
6422       ],
6423       'primary_key' => 'listnum',
6424       'unique' => [],
6425       'index'  => [],
6426     },
6427
6428     'mailinglistmember' => {
6429       'columns' => [
6430         'membernum',        'serial',     '',   '', '', '',
6431         'listnum',             'int',     '',   '', '', '',
6432         'svcnum',              'int', 'NULL',   '', '', '',
6433         'contactemailnum',     'int', 'NULL',   '', '', '',
6434         'email',           'varchar', 'NULL',  255, '', '',
6435       ],
6436       'primary_key'  => 'membernum',
6437       'unique'       => [],
6438       'index'        => [['listnum'],['svcnum'],['contactemailnum'],['email']],
6439       'foreign_keys' => [
6440                           { columns    => [ 'listnum' ],
6441                             table      => 'mailinglist',
6442                           },
6443                           { columns    => [ 'svcnum' ],
6444                             table      => 'svc_acct',
6445                           },
6446                           { columns    => [ 'contactemailnum' ],
6447                             table      => 'contact_email',
6448                           },
6449                         ],
6450     },
6451
6452     'bill_batch' => {
6453       'columns' => [
6454         'batchnum',         'serial',     '',  '', '', '',
6455         'agentnum',            'int', 'NULL',  '', '', '',
6456         'status',             'char', 'NULL', '1', '', '',
6457         'pdf',                'blob', 'NULL',  '', '', '',
6458       ],
6459       'primary_key'  => 'batchnum',
6460       'unique'       => [],
6461       'index'        => [ ['agentnum'] ],
6462       'foreign_keys' => [
6463                           { columns    => [ 'agentnum' ],
6464                             table      => 'agent',
6465                           },
6466                         ],
6467     },
6468
6469     'cust_bill_batch' => {
6470       'columns' => [
6471         'billbatchnum',     'serial',     '', '', '', '',
6472         'batchnum',            'int',     '', '', '', '',
6473         'invnum',              'int',     '', '', '', '',
6474       ],
6475       'primary_key'  => 'billbatchnum',
6476       'unique'       => [],
6477       'index'        => [ [ 'batchnum' ], [ 'invnum' ] ],
6478       'foreign_keys' => [
6479                           { columns    => [ 'batchnum' ],
6480                             table      => 'bill_batch',
6481                           },
6482                           { columns    => [ 'invnum' ],
6483                             table      => 'cust_bill',
6484                           },
6485                         ],
6486     },
6487
6488     'cust_bill_batch_option' => {
6489       'columns' => [
6490         'optionnum', 'serial', '', '', '', '',
6491         'billbatchnum', 'int', '', '', '', '',
6492         'optionname', 'varchar', '', $char_d, '', '',
6493         'optionvalue', 'text', 'NULL', '', '', '',
6494       ],
6495       'primary_key'  => 'optionnum',
6496       'unique'       => [],
6497       'index'        => [ [ 'billbatchnum' ], [ 'optionname' ] ],
6498       'foreign_keys' => [
6499                           { columns    => [ 'billbatchnum' ],
6500                             table      => 'cust_bill_batch',
6501                           },
6502                         ],
6503      },
6504
6505     'msg_template' => {
6506       'columns' => [
6507         'msgnum',     'serial',     '',      '', '', '',
6508         'msgname',   'varchar',     '', $char_d, '', '',
6509         'agentnum',      'int', 'NULL',      '', '', '',
6510         'subject',   'varchar', 'NULL',     512, '', '',
6511         'mime_type', 'varchar',     '', $char_d, '', '',
6512         'body',         'blob', 'NULL',      '', '', '',
6513         'disabled',     'char', 'NULL',       1, '', '',
6514           # migrate these to msg_template_email
6515         'from_addr', 'varchar', 'NULL',     255, '', '',
6516         'bcc_addr',  'varchar', 'NULL',     255, '', '',
6517           # change to not null on v5
6518         'msgclass',  'varchar', 'NULL',      16, '', '',
6519       ],
6520       'primary_key'  => 'msgnum',
6521       'unique'       => [ ],
6522       'index'        => [ ['agentnum'], ],
6523       'foreign_keys' => [
6524                           { columns    => [ 'agentnum' ],
6525                             table      => 'agent',
6526                           },
6527                         ],
6528     },
6529
6530     'msg_template_http' => {
6531       'columns' => [
6532         'num',          'serial',     '',      '', '', '',
6533         'msgnum',          'int',     '',      '', '', '',
6534         'prepare_url', 'varchar', 'NULL',     255, '', '',
6535         'send_url',    'varchar', 'NULL',     255, '', '',
6536         'username',    'varchar', 'NULL', $char_d, '', '',
6537         'password',    'varchar', 'NULL', $char_d, '', '',
6538         'content',        'text', 'NULL',      '', '', '',
6539       ],
6540       'primary_key'  => 'num',
6541       'unique'       => [ [ 'msgnum' ], ],
6542       'index'        => [ ],
6543       'foreign_keys' => [
6544                           { columns    => [ 'msgnum' ],
6545                             table      => 'msg_template',
6546                           },
6547                         ],
6548     },
6549
6550     'template_content' => {
6551       'columns' => [
6552         'contentnum', 'serial',     '',      '', '', '',
6553         'msgnum',        'int',     '',      '', '', '',
6554         'locale',    'varchar', 'NULL',      16, '', '',
6555         'subject',   'varchar', 'NULL',     512, '', '',
6556         'body',         'text', 'NULL',      '', '', '',
6557       ],
6558       'primary_key'  => 'contentnum',
6559       'unique'       => [ ['msgnum', 'locale'] ],
6560       'index'        => [ ],
6561       'foreign_keys' => [
6562                           { columns    => [ 'msgnum' ],
6563                             table      => 'msg_template',
6564                           },
6565                         ],
6566     },
6567
6568     'template_image' => {
6569       'columns' => [
6570         'imgnum',     'serial',     '',      '', '', '',
6571         'name',      'varchar',     '', $char_d, '', '',
6572         'agentnum',      'int', 'NULL',      '', '', '',
6573         'mime_type', 'varchar',     '', $char_d, '', '',
6574         'base64',       'text',     '',      '', '', '',
6575       ],
6576       'primary_key'  => 'imgnum',
6577       'unique'       => [ ],
6578       'index'        => [ ['name'], ['agentnum'] ],
6579     },
6580
6581     'cust_msg' => {
6582       'columns' => [
6583         'custmsgnum', 'serial',     '',     '', '', '',
6584         'custnum',       'int', 'NULL',     '', '', '',
6585         'msgnum',        'int', 'NULL',     '', '', '',
6586         '_date',    @date_type,                 '', '',
6587         'env_from',  'varchar', 'NULL',    255, '', '',
6588         'env_to',    'varchar', 'NULL',    255, '', '',
6589         'header',       'blob', 'NULL',     '', '', '',
6590         'body',         'blob', 'NULL',     '', '', '',
6591         'error',     'varchar', 'NULL',    255, '', '',
6592         'status',    'varchar',     '',$char_d, '', '',
6593         'msgtype',   'varchar', 'NULL',     16, '', '',
6594         'preview',      'text', 'NULL',     '', '', '',
6595       ],
6596       'primary_key'  => 'custmsgnum',
6597       'unique'       => [ ],
6598       'index'        => [ ['custnum'], ],
6599       'foreign_keys' => [
6600                           { columns    => [ 'custnum' ],
6601                             table      => 'cust_main',
6602                           },
6603                           { columns    => [ 'msgnum' ],
6604                             table      => 'msg_template',
6605                           },
6606                         ],
6607     },
6608
6609     'svc_cert' => {
6610       'columns' => [
6611         'svcnum',                'int',     '',      '', '', '',
6612         'recnum',                'int', 'NULL',      '', '', '',
6613         'privatekey',           'text', 'NULL',      '', '', '',
6614         'csr',                  'text', 'NULL',      '', '', '',
6615         'certificate',          'text', 'NULL',      '', '', '',
6616         'cacert',               'text', 'NULL',      '', '', '',
6617         'common_name',       'varchar', 'NULL', $char_d, '', '',
6618         'organization',      'varchar', 'NULL', $char_d, '', '',
6619         'organization_unit', 'varchar', 'NULL', $char_d, '', '',
6620         'city',              'varchar', 'NULL', $char_d, '', '',
6621         'state',             'varchar', 'NULL', $char_d, '', '',
6622         'country',              'char', 'NULL',       2, '', '',
6623         'cert_contact',      'varchar', 'NULL', $char_d, '', '',
6624       ],
6625       'primary_key'  => 'svcnum',
6626       'unique'       => [],
6627       'index'        => [], #recnum
6628       'foreign_keys' => [
6629                           { columns    => [ 'svcnum' ],
6630                             table      => 'cust_svc',
6631                           },
6632                           { columns    => [ 'recnum' ],
6633                             table      => 'domain_record',
6634                           },
6635                         ],
6636     },
6637
6638     'svc_port' => {
6639       'columns' => [
6640         'svcnum',                'int',     '',      '', '', '',
6641         'serviceid', 'varchar', '', 64, '', '', #srvexport / reportfields
6642       ],
6643       'primary_key'  => 'svcnum',
6644       'unique'       => [],
6645       'index'        => [], #recnum
6646       'foreign_keys' => [
6647                           { columns    => [ 'svcnum' ],
6648                             table      => 'cust_svc',
6649                           },
6650                         ],
6651     },
6652
6653     'areacode'  => {
6654       'columns' => [
6655         'areanum',   'serial',        '',      '', '', '',
6656         'code',        'char',        '',       3, '', '',
6657         'country',     'char',    'NULL',       2, '', '',
6658         'state',       'char',    'NULL',       2, '', '',
6659         'description','varchar',  'NULL',     255, '', '',
6660       ],
6661       'primary_key' => 'areanum',
6662       'unique' => [ [ 'areanum' ] ],
6663       'index'  => [],
6664     },
6665
6666     'upgrade_journal' => {
6667       'columns' => [
6668         'upgradenum', 'serial', '', '', '', '',
6669         '_date', 'int', '', '', '', '',
6670         'upgrade', 'varchar', '', $char_d, '', '',
6671         'status', 'varchar', '', $char_d, '', '',
6672         'statustext', 'varchar', 'NULL', $char_d, '', '',
6673       ],
6674       'primary_key' => 'upgradenum',
6675       'unique' => [],
6676       'index' => [ [ 'upgrade' ] ],
6677     },
6678
6679     'upload_target' => {
6680       'columns' => [
6681         'targetnum', 'serial', '', '', '', '',
6682         'agentnum', 'int', 'NULL', '', '', '',
6683         'protocol', 'varchar', '', 10, '', '',
6684         'hostname', 'varchar', '', $char_d, '', '',
6685         'port', 'int', 'NULL', '', '', '',
6686         'username', 'varchar', '', $char_d, '', '',
6687         'password', 'varchar', 'NULL', $char_d, '', '',
6688         'path', 'varchar', 'NULL', $char_d, '', '',
6689         'subject', 'varchar', 'NULL', '255', '', '',
6690         'handling', 'varchar', 'NULL', $char_d, '', '',
6691       ],
6692       'primary_key'   => 'targetnum',
6693       'unique'        => [ [ 'targetnum' ] ],
6694       'index'         => [],
6695       'foreign_keys' => [
6696                           { columns    => [ 'agentnum' ],
6697                             table      => 'agent',
6698                           },
6699                         ],
6700     },
6701
6702     'log' => {
6703       'columns' => [
6704         'lognum',     'serial', '', '', '', '',
6705         '_date',      'int', '', '', '', '',
6706         'agentnum',   'int', 'NULL', '', '', '',
6707         'tablename',  'varchar', 'NULL', $char_d, '', '',
6708         'tablenum',   'int',  'NULL', '', '', '',
6709         'level',      'int',  '', '', '', '',
6710         'message',    'text', '', '', '', '',
6711       ],
6712       'primary_key'  => 'lognum',
6713       'unique'       => [],
6714       'index'        => [ ['_date'], ['level'] ],
6715       'foreign_keys' => [
6716                           { columns    => [ 'agentnum' ],
6717                             table      => 'agent',
6718                           },
6719                         ],
6720     },
6721
6722     'log_context' => {
6723       'columns' => [
6724         'logcontextnum', 'serial', '', '', '', '',
6725         'lognum', 'int', '', '', '', '',
6726         'context', 'varchar', '', $char_d, '', '',
6727       ],
6728       'primary_key'  => 'logcontextnum',
6729       'unique'       => [ [ 'lognum', 'context' ] ],
6730       'index'        => [],
6731       'foreign_keys' => [
6732                           { columns    => [ 'lognum' ],
6733                             table      => 'log',
6734                           },
6735                         ],
6736     },
6737
6738     'log_email' => {
6739       'columns' => [
6740         'logemailnum', 'serial', '', '', '', '',
6741         'context', 'varchar', 'NULL', $char_d, '', '',
6742         'min_level', 'int',  'NULL', '', '', '',
6743         'msgnum', 'int', '',  '', '', '',
6744         'to_addr', 'varchar', 'NULL',     255, '', '',
6745         'context_height',  'int', 'NULL', '', '', '',
6746       ],
6747       'primary_key'  => 'logemailnum',
6748       'unique'       => [],
6749       'index'        => [ ['context'], ['min_level'] ],
6750       'foreign_keys' => [
6751                           { columns    => [ 'msgnum' ],
6752                             table      => 'msg_template',
6753                             references => [ 'msgnum' ],
6754                           },
6755                         ],
6756     },
6757
6758     'svc_alarm' => {
6759       'columns' => [
6760 #       name               type        null   length   default local
6761         'svcnum',          'int',      '',    '',      '',     '',
6762         'alarmsystemnum',  'int',      '',    '',      '',     '',
6763         'alarmtypenum',    'int',      '',    '',      '',     '',
6764         'alarmstationnum', 'int',      '',    '',      '',     '',
6765         'acctnum',         'varchar',  '',    $char_d, '',     '',
6766         '_password',       'varchar',  '',    $char_d, '',     '',
6767         'location',        'varchar', 'NULL', $char_d, '',     '',
6768         'cs_receiver',     'int',     'NULL', '',      '',     '',
6769         'cs_phonenum',     'varchar', 'NULL', $char_d, '',     '',
6770         'serialnum',       'varchar', 'NULL', $char_d, '',     '',
6771         #installer (rep)
6772       ],
6773       'primary_key'  => 'svcnum',
6774       'unique'       => [],
6775       'index'        => [],
6776       'foreign_keys' => [
6777                           { columns    => [ 'svcnum' ],
6778                             table      => 'cust_svc',
6779                           },
6780                           { columns    => [ 'alarmsystemnum' ],
6781                             table      => 'alarm_system',
6782                           },
6783                           { columns    => [ 'alarmtypenum' ],
6784                             table      => 'alarm_type',
6785                           },
6786                           { columns    => [ 'alarmstationnum' ],
6787                             table      => 'alarm_station',
6788                           },
6789                         ],
6790     },
6791
6792     'alarm_system' => { #vendors
6793       'columns' => [
6794         'alarmsystemnum',  'serial',     '',      '', '', '',
6795         'agentnum',           'int', 'NULL',      '', '', '',
6796         'systemname',     'varchar',     '', $char_d, '', '',
6797         'disabled',          'char', 'NULL',       1, '', '',
6798       ],
6799       'primary_key' => 'alarmsystemnum',
6800       'unique'      => [ ['agentnum', 'systemname'] ],
6801       'index'       => [ ['agentnum'], ['disabled'] ],
6802       'foreign_keys' => [
6803                           { columns    => [ 'agentnum' ],
6804                             table      => 'agent',
6805                           },
6806                         ],
6807     },
6808
6809     'alarm_type' => { #inputs and outputs
6810       'columns' => [
6811         'alarmtypenum', 'serial',     '',      '', '', '',
6812         'agentnum',        'int', 'NULL',      '', '', '',
6813         'inputs',          'int',     '', '', '', '',
6814         'outputs',         'int',     '', '', '', '',
6815         'disabled',       'char', 'NULL',       1, '', '',
6816       ],
6817       'primary_key' => 'alarmtypenum',
6818       'unique'      => [ ['agentnum', 'inputs', 'outputs'] ],
6819       'index'       => [ ['agentnum'], ['disabled'] ],
6820       'foreign_keys' => [
6821                           { columns    => [ 'agentnum' ],
6822                             table      => 'agent',
6823                           },
6824                         ],
6825     },
6826
6827     'alarm_station' => { #central station (where the alarm reports to)
6828       'columns' => [
6829         'alarmstationnum', 'serial',     '',      '', '', '',
6830         'agentnum',           'int', 'NULL',      '', '', '',
6831         'stationname',    'varchar',     '', $char_d, '', '',
6832         'disabled',          'char', 'NULL',       1, '', '',
6833       ],
6834       'primary_key' => 'alarmstationnum',
6835       'unique'      => [ ['agentnum', 'stationname'], ],
6836       'index'       => [ ['agentnum'], ['disabled'] ],
6837       'foreign_keys' => [
6838                           { columns    => [ 'agentnum' ],
6839                             table      => 'agent',
6840                           },
6841                         ],
6842     },
6843
6844     'svc_cable' => {
6845       'columns' => [
6846         'svcnum',        'int',     '',      '', '', '',
6847         'providernum',   'int', 'NULL',      '', '', '',
6848         'ordernum',  'varchar', 'NULL', $char_d, '', '',
6849         'modelnum',      'int', 'NULL',      '', '', '',
6850         'serialnum', 'varchar', 'NULL', $char_d, '', '',
6851         'mac_addr',  'varchar', 'NULL',      12, '', '',
6852       ],
6853       'primary_key'  => 'svcnum',
6854       'unique'       => [ ['modelnum', 'serialnum'] , ['mac_addr'] ],
6855       'index'        => [],
6856       'foreign_keys' => [
6857                           { columns    => [ 'svcnum' ],
6858                             table      => 'cust_svc',
6859                           },
6860                           { columns    => [ 'providernum' ],
6861                             table      => 'cable_provider',
6862                           },
6863                           { columns    => [ 'modelnum' ],
6864                             table      => 'cable_model',
6865                           },
6866                         ],
6867     },
6868
6869     'cable_model' => {
6870       'columns' => [
6871         'modelnum',    'serial',     '',      '', '', '',
6872         'model_name', 'varchar',     '', $char_d, '', '',
6873         'disabled',      'char', 'NULL',       1, '', '',
6874       ],
6875       'primary_key' => 'modelnum',
6876       'unique' => [ [ 'model_name' ], ],
6877       'index'  => [],
6878     },
6879
6880     'cable_provider' => {
6881       'columns' => [
6882         'providernum', 'serial',     '',      '', '', '',
6883         'provider',   'varchar',     '', $char_d, '', '',
6884         'disabled',      'char', 'NULL',       1, '', '',
6885       ],
6886       'primary_key' => 'providernum',
6887       'unique' => [ [ 'provider' ], ],
6888       'index'  => [],
6889     },
6890
6891     'svc_conferencing' => {
6892       'columns' => [
6893         'svcnum',            'int',     '',      '', '', '',
6894         'conf_id',           'int', 'NULL',      '', '', '', #"system assigned"
6895         'conf_name',     'varchar',     '', $char_d, '', '',
6896         'conf_password', 'varchar',     '', $char_d, '', '',
6897         'access_code',   'varchar',     '',      16, '', '',
6898         'duration',          'int',     '',      '', '', '',
6899         'participants',      'int',     '',      '', '', '',
6900         'conftypenum',       'int',     '',      '', '', '',
6901         'confqualitynum',    'int',     '',      '', '', '',
6902         'opt_recording',    'char', 'NULL',       1, '', '',
6903         'opt_sip',          'char', 'NULL',       1, '', '',
6904         'opt_phone',        'char', 'NULL',       1, '', '',
6905       ],
6906       'primary_key' => 'svcnum',
6907       'unique' => [],
6908       'index'  => [],
6909       'foreign_keys' => [
6910                           { columns => [ 'svcnum' ],
6911                             table   => 'cust_svc',
6912                           },
6913                           { columns => [ 'conftypenum' ],
6914                             table   => 'conferencing_type',
6915                           },
6916                           { columns => [ 'confqualitynum' ],
6917                             table   => 'conferencing_quality',
6918                           },
6919                         ],
6920     },
6921
6922     'conferencing_type' => {
6923       'columns' => [
6924         'conftypenum',  'int',     '',      '', '', '',
6925         'typeid'      , 'int',     '',      '', '', '',
6926         'typename', 'varchar',     '', $char_d, '', '',
6927         'disabled',    'char', 'NULL',       1, '', '',
6928       ],
6929       'primary_key' => 'conftypenum',
6930       'unique'      => [ [ 'typeid', 'disabled' ], [ 'typename', 'disabled' ] ],
6931       'index'       => [],
6932     },
6933
6934     'conferencing_quality' => {
6935       'columns' => [
6936         'confqualitynum',  'int',     '',      '', '', '',
6937         'qualityid'      , 'int',     '',      '', '', '',
6938         'qualityname', 'varchar',     '', $char_d, '', '',
6939         'disabled',       'char', 'NULL',       1, '', '',
6940       ],
6941       'primary_key' => 'confqualitynum',
6942       'unique'      => [ [ 'qualityid', 'disabled' ], [ 'qualityname', 'disabled' ] ],
6943       'index'       => [],
6944     },
6945
6946     'svc_video' => {
6947       'columns' => [
6948         'svcnum',            'int', '', '', '', '',
6949         'smartcard_num', 'varchar', '', 16, '', '',
6950         'mac_addr',      'varchar', '', 12, '', '',
6951         'duration',          'int', '', '', '', '',
6952       ],
6953       'primary_key' => 'svcnum',
6954       'unique' => [], # [ 'smartcard_num' ], [ 'mac_addr' ], ],
6955       'index'  => [],
6956       'foreign_keys' => [
6957                           { columns => [ 'svcnum' ],
6958                             table   => 'cust_svc',
6959                           },
6960                         ],
6961     },
6962
6963     'circuit_type' => {
6964       'columns' => [
6965         'typenum',     'serial',     '',      '', '', '',
6966         'typename',   'varchar',     '', $char_d, '', '',
6967         'disabled',      'char', 'NULL',       1, '', '',
6968         # speed? number of voice lines? anything else?
6969       ],
6970       'primary_key' => 'typenum',
6971       'unique' => [ [ 'typename' ] ],
6972       'index'  => [],
6973     },
6974
6975     'circuit_provider' => {
6976       'columns' => [
6977         'providernum', 'serial',     '',      '', '', '',
6978         'provider',   'varchar',     '', $char_d, '', '',
6979         'disabled',      'char', 'NULL',       1, '', '',
6980       ],
6981       'primary_key' => 'providernum',
6982       'unique' => [ [ 'provider' ], ],
6983       'index'  => [],
6984     },
6985
6986     'circuit_termination' => {
6987       'columns' => [
6988         'termnum',     'serial',     '',      '', '', '',
6989         'termination','varchar',     '', $char_d, '', '',
6990         'disabled',      'char', 'NULL',       1, '', '',
6991       ],
6992       'primary_key' => 'termnum',
6993       'unique' => [ [ 'termination' ] ],
6994       'index' => [],
6995     },
6996
6997     'svc_circuit' => {
6998       'columns' => [
6999         'svcnum',                   'int',     '', '', '', '',
7000         'typenum',                  'int',     '', '', '', '',
7001         'providernum',              'int',     '', '', '', '',
7002         'termnum',                  'int',     '', '', '', '',
7003         'circuit_id',           'varchar',     '', 64, '', '',
7004         'desired_due_date',         'int', 'NULL', '', '', '',
7005         'due_date',                 'int', 'NULL', '', '', '',
7006         'vendor_order_id',      'varchar', 'NULL', $char_d,  '', '',
7007         'vendor_qual_id',       'varchar', 'NULL', $char_d,  '', '',
7008         'vendor_order_type',    'varchar', 'NULL', $char_d,  '', '',
7009         'vendor_order_status',  'varchar', 'NULL', $char_d,  '', '',
7010         'endpoint_ip_addr',     'varchar', 'NULL', 40, '', '',
7011         'endpoint_mac_addr',    'varchar', 'NULL', 12, '', '',
7012         'internal_circuit_id',  'varchar', 'NULL', 64, '', '',
7013       ],
7014       'primary_key' => 'svcnum',
7015       'unique'      => [],
7016       'index'       => [ [ 'providernum' ], [ 'typenum' ] ],
7017       'foreign_keys' => [
7018                           { columns => [ 'svcnum' ],
7019                             table   => 'cust_svc',
7020                           },
7021                           { columns => [ 'typenum' ],
7022                             table   => 'circuit_type',
7023                           },
7024                           { columns => [ 'providernum' ],
7025                             table   => 'circuit_provider',
7026                           },
7027                           { columns => [ 'termnum' ],
7028                             table   => 'circuit_termination',
7029                           },
7030       ],
7031     },
7032
7033     'svc_fiber' => {
7034       'columns' => [
7035         'svcnum',         'int',     '',      '', '', '',
7036         'oltnum',         'int', 'NULL',      '', '', '',
7037         'shelf',          'int', 'NULL',      '', '', '',
7038         'card',           'int', 'NULL',      '', '', '',
7039         'olt_port',       'int', 'NULL',      '', '', '',
7040         'ont_id',         'int', 'NULL',      '', '', '',
7041         'ont_typenum',    'int', 'NULL',      '', '', '',
7042         'ont_serial', 'varchar', 'NULL', $char_d, '', '',
7043         'ont_port',   'varchar', 'NULL',      16, '', '',
7044         'circuit_id', 'varchar', 'NULL', $char_d, '', '',
7045         'vlan',           'int', 'NULL',      '', '', '',
7046         'signal',     'decimal', 'NULL',  '10,2', '', '',
7047         'speed_up',       'int', 'NULL',      '', '', '',
7048         'speed_down',     'int', 'NULL',      '', '', '',
7049         'ont_install','varchar', 'NULL', $char_d, '', '',
7050       ],
7051       'primary_key' => 'svcnum',
7052       'unique'      => [ ],
7053       'index'       => [ [ 'ont_serial' ] ],
7054       'foreign_keys' => [
7055                           { columns => [ 'svcnum' ],
7056                             table   => 'cust_svc',
7057                           },
7058                           { columns => [ 'oltnum' ],
7059                             table   => 'fiber_olt',
7060                           },
7061                           { columns => [ 'ont_typenum' ],
7062                             table   => 'hardware_type',
7063                             references => [ 'typenum' ],
7064                           },
7065                         ],
7066     },
7067
7068     'fiber_olt' => {
7069       'columns' => [
7070         'oltnum',   'serial', '',       '', '', '',
7071         'oltname', 'varchar', '',  $char_d, '', '',
7072         'sitenum',     'int', 'NULL',   '', '', '',
7073         'serial',  'varchar', '',  $char_d, '', '',
7074         'disabled',   'char', 'NULL',    1, '', '',
7075       ],
7076       'primary_key' => 'oltnum',
7077       'unique' => [ ],
7078       'index'  => [ ],
7079       'foreign_keys' => [
7080                           { columns => [ 'sitenum' ],
7081                             table   => 'olt_site',
7082                           },
7083                         ],
7084     },
7085
7086     'olt_site' => {
7087       'columns' => [
7088         'sitenum',  'serial', '',      '', '', '',
7089         'market',  'varchar', '', $char_d, '', '',
7090         'site',    'varchar', '', $char_d, '', '',
7091       ],
7092       'primary_key' => 'sitenum',
7093       'unique' => [ [ 'market', 'site' ] ],
7094       'index' => [ ],
7095     },
7096
7097
7098
7099
7100
7101     'vend_main' => {
7102       'columns' => [
7103         'vendnum',   'serial',     '',      '', '', '',
7104         'vendname', 'varchar',     '', $char_d, '', '',
7105         'classnum',     'int',     '',      '', '', '',
7106         'disabled',    'char', 'NULL',       1, '', '',
7107       ],
7108       'primary_key'  => 'vendnum',
7109       'unique'       => [ ['vendname', 'disabled'] ],
7110       'index'        => [],
7111       'foreign_keys' => [
7112                           { columns    => [ 'classnum' ],
7113                             table      => 'vend_class',
7114                           },
7115                         ],
7116     },
7117
7118     'vend_class' => {
7119       'columns' => [
7120         'classnum',     'serial',     '',      '', '', '',
7121         'classname',   'varchar',     '', $char_d, '', '',
7122         'disabled',       'char', 'NULL',       1, '', '',
7123       ],
7124       'primary_key' => 'classnum',
7125       'unique'      => [],
7126       'index'       => [ ['disabled'] ],
7127     },
7128
7129     'vend_bill' => {
7130       'columns' => [
7131         'vendbillnum',    'serial',     '',      '', '', '',
7132         'vendnum',           'int',     '',      '', '', '',
7133         #'_date',        @date_type,                  '', '',
7134         '_date',     'int', '', '',                   '', '',
7135         'charged',     @money_type,                  '', '',
7136       ],
7137       'primary_key'  => 'vendbillnum',
7138       'unique'       => [],
7139       'index'        => [ ['vendnum'], ['_date'], ],
7140       'foreign_keys' => [
7141                           { columns    => [ 'vendnum' ],
7142                             table      => 'vend_main',
7143                           },
7144                         ],
7145     },
7146
7147     'vend_pay' => {
7148       'columns' => [
7149         'vendpaynum',   'serial',    '',       '', '', '',
7150         'vendnum',         'int',    '',       '', '', '',
7151         #'_date',     @date_type,                   '', '',
7152         '_date',     'int', '', '',                   '', '',
7153         'paid',      @money_type,                  '', '',
7154       ],
7155       'primary_key'  => 'vendpaynum',
7156       'unique'       => [],
7157       'index'        => [ [ 'vendnum' ], [ '_date' ], ],
7158       'foreign_keys' => [
7159                           { columns    => [ 'vendnum' ],
7160                             table      => 'vend_main',
7161                           },
7162                         ],
7163     },
7164
7165     'vend_bill_pay' => {
7166       'columns' => [
7167         'vendbillpaynum', 'serial',     '',   '', '', '',
7168         'vendbillnum',       'int',     '',   '', '', '',
7169         'vendpaynum',        'int',     '',   '', '', '',
7170         'amount',  @money_type, '', '',
7171         #? '_date',   @date_type, '', '',
7172       ],
7173       'primary_key'  => 'vendbillpaynum',
7174       'unique'       => [],
7175       'index'        => [ [ 'vendbillnum' ], [ 'vendpaynum' ] ],
7176       'foreign_keys' => [
7177                           { columns    => [ 'vendbillnum' ],
7178                             table      => 'vend_bill',
7179                           },
7180                           { columns    => [ 'vendpaynum' ],
7181                             table      => 'vend_pay',
7182                           },
7183                         ],
7184     },
7185
7186     %{ tables_hashref_torrus() },
7187
7188     # tables of ours for doing torrus virtual port combining
7189     'torrus_srvderive' => {
7190       'columns' => [
7191         'derivenum',     'serial',     '', '', '', '',
7192         'serviceid',    'varchar',     '', 64, '', '', #srvexport / reportfields
7193         'last_srv_date',   'date', 'NULL', '', '', '',
7194       ],
7195       'primary_key' => 'derivenum',
7196       'unique' => [ ['serviceid'] ],
7197       'index'  => [],
7198     },
7199
7200     'torrus_srvderive_component' => {
7201       'columns' => [
7202         'componentnum', 'serial', '', '', '', '',
7203         'derivenum',       'int', '', '', '', '',
7204         'serviceid',   'varchar', '', 64, '', '', #srvexport / reportfields
7205       ],
7206       'primary_key'  => 'componentnum',
7207       'unique'       => [ [ 'derivenum', 'serviceid' ], ],
7208       'index'        => [ [ 'derivenum', ], ],
7209       'foreign_keys' => [
7210                           { columns    => [ 'derivenum' ],
7211                             table      => 'torrus_srvderive',
7212                           },
7213                         ],
7214     },
7215
7216     'invoice_mode' => {
7217       'columns' => [
7218         'modenum',      'serial', '', '', '', '',
7219         'agentnum',        'int', 'NULL', '', '', '',
7220         'modename',    'varchar', '', 32, '', '',
7221       ],
7222       'primary_key' => 'modenum',
7223       'unique'      => [ ],
7224       'index'       => [ ],
7225       'foreign_keys' => [
7226                           { columns    => [ 'agentnum' ],
7227                             table      => 'agent',
7228                           },
7229                         ],
7230     },
7231
7232     'invoice_conf' => {
7233       'columns' => [
7234         'confnum',              'serial',   '', '', '', '',
7235         'modenum',              'int',      '', '', '', '',
7236         'locale',               'varchar',  'NULL', 16, '', '',
7237         'notice_name',          'varchar',  'NULL', 64, '', '',
7238         'subject',              'varchar',  'NULL', 64, '', '',
7239         'htmlnotes',            'text',     'NULL', '', '', '',
7240         'htmlfooter',           'text',     'NULL', '', '', '',
7241         'htmlsummary',          'text',     'NULL', '', '', '',
7242         'htmlreturnaddress',    'text',     'NULL', '', '', '',
7243         'latexnotes',           'text',     'NULL', '', '', '',
7244         'latexfooter',          'text',     'NULL', '', '', '',
7245         'latexsummary',         'text',     'NULL', '', '', '',
7246         'latexsmallfooter',     'text',     'NULL', '', '', '',
7247         'latexreturnaddress',   'text',     'NULL', '', '', '',
7248         'with_latexcoupon',     'char',     'NULL', '1', '', '',
7249         'htmlwatermark',        'text',     'NULL', '', '', '',
7250         'latexwatermark',       'text',     'NULL', '', '', '',
7251         'lpr',                  'varchar',  'NULL', $char_d, '', '',
7252       ],
7253       'primary_key'  => 'confnum',
7254       'unique'       => [ [ 'modenum', 'locale' ] ],
7255       'index'        => [ ],
7256       'foreign_keys' => [
7257                           { columns    => [ 'modenum' ],
7258                             table      => 'invoice_mode',
7259                           },
7260                         ],
7261     },
7262
7263     'export_batch' => {
7264       'columns' => [
7265         'batchnum',    'serial',     '',      '', '', '',
7266         'exportnum',      'int',     '',      '', '', '',
7267         '_date',          'int',     '',      '', '', '',
7268         'status',     'varchar', 'NULL',      32, '', '',
7269         'statustext',    'text', 'NULL',      '', '', '',
7270       ],
7271       'primary_key'  => 'batchnum',
7272       'unique'       => [],
7273       'index'        => [ [ 'exportnum' ], [ 'status' ] ],
7274       'foreign_keys' => [
7275                           { columns    => [ 'exportnum' ],
7276                             table      => 'part_export',
7277                             references => [ 'exportnum' ]
7278                           },
7279                         ],
7280     },
7281
7282     'export_batch_item' => {
7283       'columns' => [
7284         'itemnum',     'serial',     '',      '', '', '',
7285         'batchnum',       'int',     '',      '', '', '',
7286         'svcnum',         'int',     '',      '', '', '',
7287         'action',     'varchar',     '',      32, '', '',
7288         'data',          'text', 'NULL',      '', '', '',
7289         'frozen',        'char', 'NULL',       1, '', '',
7290       ],
7291       'primary_key'  => 'itemnum',
7292       'unique'       => [],
7293       'index'        => [ [ 'batchnum' ], [ 'svcnum' ] ],
7294       'foreign_keys' => [
7295                           { columns    => [ 'batchnum' ],
7296                             table      => 'export_batch',
7297                             references => [ 'batchnum' ]
7298                           },
7299                         ],
7300     },
7301
7302     # lookup table for states, similar to msa and lata
7303     'state' => {
7304       'columns' => [
7305         'statenum', 'int',  '', '', '', '',
7306         'country',  'char', '',  2, '', '',
7307         'state',    'char', '', $char_d, '', '',
7308         'fips',     'char', '',  3, '', '',
7309       ],
7310       'primary_key' => 'statenum',
7311       'unique' => [ [ 'country', 'state' ], ],
7312       'index' => [],
7313     },
7314
7315     # eventually link to tower/sector?
7316     'deploy_zone' => {
7317       'columns' => [
7318         'zonenum',        'serial',  '',     '',      '', '',
7319         'description',    'char',    'NULL', $char_d, '', '',
7320         'agentnum',       'int',     '',     '',      '', '',
7321         'censusyear',     'char',    'NULL', 4,      '', '',
7322         'dbaname',        'char',    'NULL', $char_d, '', '',
7323         'zonetype',       'char',    '',     1,       '', '',
7324         'technology',     'int',     '',     '',      '', '',
7325         'spectrum',       'int',     'NULL', '',      '', '',
7326         'adv_speed_up',   'decimal', '',     '10,3', '0', '',
7327         'adv_speed_down', 'decimal', '',     '10,3', '0', '',
7328         'cir_speed_up',   'decimal', '',     '10,3', '0', '',
7329         'cir_speed_down', 'decimal', '',     '10,3', '0', '',
7330         'is_broadband',   'char',    'NULL', 1,       '', '',
7331         'is_voice',       'char',    'NULL', 1,       '', '',
7332         'is_consumer',    'char',    'NULL', 1,       '', '',
7333         'is_business',    'char',    'NULL', 1,       '', '',
7334         'active_date',    @date_type,                 '', '',
7335         'expire_date',    @date_type,                 '', '',
7336       ],
7337       'primary_key' => 'zonenum',
7338       'unique' => [],
7339       'index'  => [ [ 'agentnum' ] ],
7340       'foreign_keys' => [
7341                           { columns     => [ 'agentnum' ],
7342                             table       => 'agent',
7343                             references  => [ 'agentnum' ],
7344                           },
7345                         ],
7346     },
7347
7348     'deploy_zone_block' => {
7349       'columns' => [
7350         'blocknum',       'serial',  '',     '',      '', '',
7351         'zonenum',        'int',     '',     '',      '', '',
7352         'censusblock',    'char',    '',     15,      '', '',
7353         'censusyear',     'char','NULL',      4,      '', '',
7354       ],
7355       'primary_key' => 'blocknum',
7356       'unique' => [],
7357       'index'  => [ [ 'zonenum' ] ],
7358       'foreign_keys' => [
7359                           { columns     => [ 'zonenum' ],
7360                             table       => 'deploy_zone',
7361                             references  => [ 'zonenum' ],
7362                           },
7363                         ],
7364     },
7365
7366     'deploy_zone_vertex' => {
7367       'columns' => [
7368         'vertexnum',      'serial',  '',     '',      '', '',
7369         'zonenum',        'int',     '',     '',      '', '',
7370         'latitude',       'decimal', '',     '10,7',  '', '',
7371         'longitude',      'decimal', '',     '10,7',  '', '',
7372       ],
7373       'primary_key' => 'vertexnum',
7374       'unique' => [ ],
7375       'index'  => [ ],
7376       'foreign_keys' => [
7377                           { columns     => [ 'zonenum' ],
7378                             table       => 'deploy_zone',
7379                             references  => [ 'zonenum' ],
7380                           },
7381                         ],
7382     },
7383
7384     'cacti_page' => {
7385       'columns' => [
7386         'cacti_pagenum',  'serial',   '',     '', '', '',
7387         'exportnum',      'int',      'NULL', '', '', '',
7388         'svcnum',         'int',      'NULL', '', '', '',
7389         'graphnum',       'int',      'NULL', '', '', '',
7390         'imported',       @date_type,             '', '',
7391         'content',        'text',     'NULL', '', '', '',
7392         'thumbnail',      'text',     'NULL', '', '', '',
7393       ],
7394       'primary_key' => 'cacti_pagenum',
7395       'unique'  => [ ],
7396       'index'   => [ ['svcnum'], ['imported'] ],
7397       'foreign_keys' => [
7398                           { columns    => [ 'svcnum' ],
7399                             table      => 'cust_svc',
7400                             references => [ 'svcnum' ],
7401                           },
7402                           { columns    => [ 'exportnum' ],
7403                             table      => 'part_export',
7404                             references => [ 'exportnum' ],
7405                           },
7406                         ],
7407     },
7408
7409     'report_batch' => {
7410       'columns' => [
7411         'reportbatchnum', 'serial',      '',  '', '', '',
7412         'reportname',     'varchar',     '', 255, '', '',
7413         'agentnum',           'int', 'NULL',  '', '', '',
7414         'send_date',     @date_type,              '', '',
7415         'sdate',         @date_type,              '', '',
7416         'edate',         @date_type,              '', '',
7417         'usernum',            'int', 'NULL',  '', '', '',
7418         'msgnum',             'int', 'NULL',  '', '', '',
7419         # add report params here as necessary
7420       ],
7421       'primary_key' => 'reportbatchnum',
7422       'unique' => [],
7423       'index'  => [],
7424       'foreign_keys' => [
7425                           { columns    => [ 'agentnum' ],
7426                             table      => 'agent',
7427                             references => [ 'agentnum' ],
7428                           },
7429                           { columns    => [ 'usernum' ],
7430                             table      => 'access_user',
7431                             references => [ 'usernum' ],
7432                           },
7433                           { columns    => [ 'msgnum' ],
7434                             table      => 'msg_template',
7435                             references => [ 'msgnum' ],
7436                           },
7437                         ],
7438     },
7439
7440     'password_history' => {
7441       'columns' => [
7442         'passwordnum',        'serial',  '',          '', '', '',
7443         '_password',          'varchar', 'NULL', $char_d, '', '',
7444         'encryption_method',  'varchar', 'NULL', $char_d, '', '',
7445         'created',   @date_type,   '', '',
7446         # each table that needs password history gets a column here, and
7447         # an entry in foreign_keys.
7448         'svc_acct__svcnum',     'int', 'NULL', '', '', '',
7449         'svc_dsl__svcnum',      'int', 'NULL', '', '', '',
7450         'svc_alarm__svcnum',    'int', 'NULL', '', '', '',
7451         'agent__agentnum',      'int', 'NULL', '', '', '',
7452         'contact__contactnum',  'int', 'NULL', '', '', '',
7453         'access_user__usernum', 'int', 'NULL', '', '', '',
7454       ],
7455       'primary_key' => 'passwordnum',
7456       'unique' => [],
7457       'index'  => [],
7458       'foreign_keys' => [
7459                           { columns     => [ 'svc_acct__svcnum' ],
7460                             table       => 'svc_acct',
7461                             references  => [ 'svcnum' ],
7462                           },
7463                           { columns     => [ 'svc_dsl__svcnum' ],
7464                             table       => 'svc_dsl',
7465                             references  => [ 'svcnum' ],
7466                           },
7467                           { columns     => [ 'svc_alarm__svcnum' ],
7468                             table       => 'svc_alarm',
7469                             references  => [ 'svcnum' ],
7470                           },
7471                           { columns    => [ 'agent__agentnum' ],
7472                             table      => 'agent',
7473                             references => [ 'agentnum' ],
7474                           },
7475                           { columns    => [ 'contact__contactnum' ],
7476                             table      => 'contact',
7477                             references => [ 'contactnum' ],
7478                           },
7479                           { columns    => [ 'access_user__usernum' ],
7480                             table      => 'access_user',
7481                             references => [ 'usernum' ],
7482                           },
7483                         ],
7484     },
7485
7486     'webservice_log' => {
7487       'columns' => [
7488         'webservicelognum',    'serial',      '',      '', '', '', #big? hubrus
7489         'svcnum',                 'int',  'NULL',      '', '', '', #just in case
7490         'custnum',                'int',      '',      '', '', '',
7491         'method',             'varchar',      '', $char_d, '', '',
7492         'quantity',               'int',      '',      '', '', '', #i.e. pages
7493         '_date',             @date_type,                   '', '',
7494         'status',             'varchar',  'NULL', $char_d, '', '',
7495         'rated_price',        'decimal',  'NULL',  '10,2', '', '',
7496       ],
7497       'primary_key'  => 'webservicelognum',
7498       'unique'       => [],
7499       'index'        => [ ['custnum'], ['status'] ],
7500       'foreign_keys' => [
7501                           { columns => [ 'custnum' ],
7502                             table   => 'cust_main',
7503                           },
7504                           #no FK on svcnum... we don't want to purge these on
7505                           # service deletion
7506                         ],
7507     },
7508
7509     'rt_field_charge' => {
7510       'columns' => [
7511         'rtfieldchargenum',    'serial',      '',      '', '', '',
7512         'pkgnum',                 'int',      '',      '', '', '',
7513         'ticketid',               'int',      '',      '', '', '',
7514         'rate',             @money_type,                   '', '',
7515         'units',              'decimal',      '',  '10,4', '', '',
7516         'charge',           @money_type,                   '', '',
7517         '_date',             @date_type,                   '', '',
7518       ],
7519       'primary_key'  => 'rtfieldchargenum',
7520       'unique'       => [],
7521       'index'        => [ ['pkgnum', 'ticketid'] ],
7522       'foreign_keys' => [
7523                           { columns    => [ 'pkgnum' ],
7524                             table      => 'cust_pkg',
7525                           },
7526                         ],
7527     },
7528
7529     'saved_search' => {
7530       'columns' => [
7531         'searchnum',    'serial',  '',          '', '', '',
7532         'usernum',      'int',     'NULL',      '', '', '',
7533         'searchname',   'varchar', '',     $char_d, '', '',
7534         'path',         'varchar', '',     $char_d, '', '',
7535         'params',       'text',    'NULL',      '', '', '',
7536         'disabled',     'char',    'NULL',       1, '', '',
7537         'freq',         'varchar', 'NULL',      16, '', '',
7538         'last_sent',    'int',     'NULL',      '', '', '',
7539         'format',       'varchar', 'NULL',      32, '', '',
7540       ],
7541       'primary_key'   => 'searchnum',
7542       'unique'        => [],
7543       'index'         => [],
7544       'foreign_keys'  => [
7545                            { columns => [ 'usernum' ],
7546                              table   => 'access_user',
7547                            },
7548                          ],
7549     },
7550
7551     'svc_group' => {
7552       'columns' => [
7553         'svcnum',          'int', '', '', '', '',
7554         'max_accounts',    'int', '', '', '', '',
7555       ],
7556       'primary_key'  => 'svcnum',
7557       'unique'       => [],
7558       'index'        => [],
7559       'foreign_keys' => [
7560                           { columns    => [ 'svcnum' ],
7561                             table      => 'cust_svc',
7562                           },
7563                         ],
7564     },
7565
7566
7567     # name type nullability length default local
7568
7569     #'new_table' => {
7570     #  'columns' => [
7571     #    'num', 'serial',       '', '', '', '',
7572     #  ],
7573     #  'primary_key' => 'num',
7574     #  'unique' => [],
7575     #  'index'  => [],
7576     #},
7577
7578   };
7579
7580 }
7581
7582 =back
7583
7584 =head1 BUGS
7585
7586 =head1 SEE ALSO
7587
7588 L<DBIx::DBSchema>
7589
7590 =cut
7591
7592 1;
7593