FS/FS/Schema.pm

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