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