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         #'paymask',       'varchar', 'NULL', $char_d, '', '',
2740         #'exp',          @date_type,                  '', '',
2741         'exp',           'varchar', 'NULL',      11, '', '',
2742         'payname',       'varchar', 'NULL', $char_d, '', '',
2743         'paytype',       'varchar', 'NULL', $char_d, '', '',
2744         'amount',      @money_type,                  '', '',
2745         'currency',         'char', 'NULL',       3, '', '',
2746         'status',        'varchar', 'NULL', $char_d, '', '',
2747         'failure_status','varchar', 'NULL',      16, '', '',
2748         'error_message', 'varchar', 'NULL', $char_d, '', '',
2749         'paycode',       'varchar', 'NULL', $char_d, '', '',
2750       ],
2751       'primary_key'  => 'paybatchnum',
2752       'unique'       => [],
2753       'index'        => [ ['batchnum'], ['invnum'], ['custnum'] ],
2754       'foreign_keys' => [
2755                           { columns    => [ 'batchnum' ],
2756                             table      => 'pay_batch',
2757                           },
2758                           #{ columns    => [ 'invnum' ],
2759                           #  table      => 'cust_bill',
2760                           #},
2761                           { columns    => [ 'custnum' ],
2762                             table      => 'cust_main',
2763                           },
2764                         ],
2765     },
2766
2767     'fcc477map' => {
2768       'columns' => [
2769         'formkey',   'varchar',     '', 255, '', '',
2770         'formvalue',    'text', 'NULL',  '', '', '',
2771       ],
2772       'primary_key' => 'formkey',
2773       'unique'      => [],
2774       'index'       => [],
2775     },
2776
2777     'cust_pkg' => {
2778       'columns' => [
2779         'pkgnum',           'serial',     '', '', '', '',
2780         'custnum',             'int',     '', '', '', '',
2781         'pkgpart',             'int',     '', '', '', '',
2782         'pkgbatch',        'varchar', 'NULL', $char_d, '', '',
2783         'contactnum',          'int', 'NULL', '', '', '',
2784         'locationnum',         'int', 'NULL', '', '', '',
2785         'otaker',          'varchar', 'NULL', 32, '', '',
2786         'usernum',             'int', 'NULL', '', '', '',
2787         'salesnum',            'int', 'NULL', '', '', '',
2788         'order_date',     @date_type,             '', '',
2789         'start_date',     @date_type,             '', '',
2790         'setup',          @date_type,             '', '',
2791         'bill',           @date_type,             '', '',
2792         'last_bill',      @date_type,             '', '',
2793         'susp',           @date_type,             '', '',
2794         'adjourn',        @date_type,             '', '',
2795         'resume',         @date_type,             '', '',
2796         'cancel',         @date_type,             '', '',
2797         'uncancel',       @date_type,             '', '',
2798         'uncancel_pkgnum',     'int', 'NULL', '', '', '',
2799         'expire',         @date_type,             '', '',
2800         'contract_end',   @date_type,             '', '',
2801         'dundate',        @date_type,             '', '',
2802         'change_date',    @date_type,             '', '',
2803         'change_pkgnum',       'int', 'NULL', '', '', '',
2804         'change_pkgpart',      'int', 'NULL', '', '', '',
2805         'change_locationnum',  'int', 'NULL', '', '', '',
2806         'change_custnum',      'int', 'NULL', '', '', '',
2807         'main_pkgnum',         'int', 'NULL', '', '', '',
2808         'pkglinknum',          'int', 'NULL', '', '', '',
2809         'no_auto',            'char', 'NULL',  1, '', '',
2810         'quantity',            'int', 'NULL', '', '', '',
2811         'agent_pkgid',     'varchar', 'NULL', $char_d, '', '',
2812         'waive_setup',        'char', 'NULL',  1, '', '',
2813         'recur_show_zero',    'char', 'NULL',  1, '', '',
2814         'setup_show_zero',    'char', 'NULL',  1, '', '',
2815         'change_to_pkgnum',    'int', 'NULL', '', '', '',
2816         'separate_bill',      'char', 'NULL',  1, '', '',
2817       ],
2818       'primary_key'  => 'pkgnum',
2819       'unique'       => [],
2820       'index'        => [ ['custnum'], ['pkgpart'], ['pkgbatch'],
2821                           ['locationnum'], ['usernum'], ['agent_pkgid'],
2822                           ['order_date'], [ 'start_date' ], ['setup'], ['bill'],
2823                           ['last_bill'], ['susp'], ['adjourn'], ['resume'],
2824                           ['cancel'], ['expire'], ['contract_end'],
2825                           ['change_date'],
2826                           ['no_auto'],
2827                           #['contactnum'],
2828                           ['salesnum'],
2829                           #['uncancel_pkgnum'],
2830                           #['change_pkgnum'], ['change_locationnum'],
2831                           #['change_custnum'],
2832                           ['main_pkgnum'],
2833                           #['pkglinknum'], ['change_to_pkgnum'],
2834                         ],
2835       'foreign_keys' => [
2836                           { columns    => [ 'custnum' ],
2837                             table      => 'cust_main',
2838                           },
2839                           { columns    => [ 'pkgpart' ],
2840                             table      => 'part_pkg',
2841                           },
2842                           { columns    => [ 'contactnum' ],
2843                             table      => 'contact',
2844                           },
2845                           { columns    => [ 'locationnum' ],
2846                             table      => 'cust_location',
2847                           },
2848                           { columns    => [ 'usernum' ],
2849                             table      => 'access_user',
2850                           },
2851                           { columns    => [ 'salesnum' ],
2852                             table      => 'sales',
2853                           },
2854                           { columns    => [ 'uncancel_pkgnum' ],
2855                             table      => 'cust_pkg',
2856                             references => [ 'pkgnum' ],
2857                           },
2858                           { columns    => [ 'change_pkgnum' ],
2859                             table      => 'cust_pkg',
2860                             references => [ 'pkgnum' ],
2861                           },
2862                           { columns    => [ 'change_pkgpart' ],
2863                             table      => 'part_pkg',
2864                             references => [ 'pkgpart' ],
2865                           },
2866                           { columns    => [ 'change_locationnum' ],
2867                             table      => 'cust_location',
2868                             references => [ 'locationnum' ],
2869                           },
2870                           { columns    => [ 'change_custnum' ],
2871                             table      => 'cust_main',
2872                             references => [ 'custnum' ],
2873                           },
2874                           { columns    => [ 'main_pkgnum' ],
2875                             table      => 'cust_pkg',
2876                             references => [ 'pkgnum' ],
2877                           },
2878                           { columns    => [ 'pkglinknum' ],
2879                             table      => 'part_pkg_link',
2880                           },
2881                           { columns    => [ 'change_to_pkgnum' ],
2882                             table      => 'cust_pkg',
2883                             references => [ 'pkgnum' ],
2884                           },
2885                         ],
2886    },
2887
2888     'cust_pkg_option' => {
2889       'columns' => [
2890         'optionnum', 'serial', '', '', '', '',
2891         'pkgnum', 'int', '', '', '', '',
2892         'optionname', 'varchar', '', $char_d, '', '',
2893         'optionvalue', 'text', 'NULL', '', '', '',
2894       ],
2895       'primary_key'  => 'optionnum',
2896       'unique'       => [],
2897       'index'        => [ [ 'pkgnum' ], [ 'optionname' ] ],
2898       'foreign_keys' => [
2899                           { columns    => [ 'pkgnum' ],
2900                             table      => 'cust_pkg',
2901                           },
2902                         ],
2903     },
2904
2905     'cust_pkg_detail' => {
2906       'columns' => [
2907         'pkgdetailnum', 'serial', '',        '', '', '',
2908         'pkgnum',          'int', '',        '', '', '',
2909         'detail',      'varchar', '', 2*$char_d, '', '',
2910         'detailtype',     'char', '',         1, '', '', #"I"nvoice or "C"omment
2911         'weight',          'int', '',        '', '', '',
2912       ],
2913       'primary_key'  => 'pkgdetailnum',
2914       'unique'       => [],
2915       'index'        => [ [ 'pkgnum', 'detailtype' ] ],
2916       'foreign_keys' => [
2917                           { columns    => [ 'pkgnum' ],
2918                             table      => 'cust_pkg',
2919                           },
2920                         ],
2921     },
2922
2923     'cust_pkg_reason' => {
2924       'columns' => [
2925         'num',      'serial',    '',   '', '', '',
2926         'pkgnum',   'int',    '',   '', '', '',
2927         'reasonnum','int',    '',   '', '', '',
2928         'action',   'char', 'NULL', 1, '', '',     #should not be nullable
2929         'otaker',   'varchar', 'NULL', 32, '', '',
2930         'usernum',   'int', 'NULL', '', '', '',
2931         'date',     @date_type, '', '',
2932       ],
2933       'primary_key'  => 'num',
2934       'unique'       => [],
2935       'index'        => [ ['pkgnum'], ['reasonnum'], ['action'], ['usernum'], ],
2936       'foreign_keys' => [
2937                           { columns    => [ 'pkgnum' ],
2938                             table      => 'cust_pkg',
2939                           },
2940                           { columns    => [ 'reasonnum' ],
2941                             table      => 'reason',
2942                           },
2943                           { columns    => [ 'usernum' ],
2944                             table      => 'access_user',
2945                           },
2946                         ],
2947     },
2948
2949     'cust_pkg_reason_fee' => {
2950       'columns' => [
2951         'pkgreasonfeenum', 'serial', '', '', '', '',
2952         'pkgreasonnum',       'int', '', '', '', '',
2953         'billpkgnum',         'int', 'NULL', '', '', '',
2954         'feepart',            'int', '', '', '', '',
2955         'nextbill',          'char', 'NULL',  1, '', '',
2956       ],
2957       'primary_key'  => 'pkgreasonfeenum',
2958       'unique' => [ [ 'billpkgnum' ], [ 'pkgreasonnum' ] ], # one-to-one link
2959       'index'  => [ [ 'feepart' ] ],
2960       'foreign_keys' => [
2961                           { columns     => [ 'pkgreasonnum' ],
2962                             table       => 'cust_pkg_reason',
2963                             references  => [ 'num' ],
2964                           },
2965                           { columns     => [ 'feepart' ],
2966                             table       => 'part_fee',
2967                           },
2968                           # can't link billpkgnum, because of voids
2969       ],
2970     },
2971
2972     'cust_pkg_discount' => {
2973       'columns' => [
2974         'pkgdiscountnum', 'serial', '',        '', '', '',
2975         'pkgnum',            'int', '',        '', '', '',
2976         'discountnum',       'int', '',        '', '', '',
2977         'months_used',   'decimal', 'NULL', '7,4', '', '',
2978         'end_date',     @date_type,                '', '',
2979         'otaker',        'varchar', 'NULL',    32, '', '',
2980         'usernum',           'int', 'NULL',    '', '', '',
2981         'disabled',         'char', 'NULL',     1, '', '',
2982         'setuprecur',       'char', 'NULL',     5, '', '',
2983       ],
2984       'primary_key'  => 'pkgdiscountnum',
2985       'unique'       => [],
2986       'index'        => [ [ 'pkgnum' ], [ 'discountnum' ], [ 'usernum' ], ],
2987       'foreign_keys' => [
2988                           { columns    => [ 'pkgnum' ],
2989                             table      => 'cust_pkg',
2990                           },
2991                           { columns    => [ 'discountnum' ],
2992                             table      => 'discount',
2993                           },
2994                           { columns    => [ 'usernum' ],
2995                             table      => 'access_user',
2996                           },
2997                         ],
2998     },
2999
3000     'cust_pkg_usage' => {
3001       'columns' => [
3002         'pkgusagenum', 'serial', '', '', '', '',
3003         'pkgnum',         'int', '', '', '', '',
3004         'minutes',        'double precision', '', '', '', '',
3005         'pkgusagepart',   'int', '', '', '', '',
3006       ],
3007       'primary_key'  => 'pkgusagenum',
3008       'unique'       => [],
3009       'index'        => [ [ 'pkgnum' ], [ 'pkgusagepart' ] ],
3010       'foreign_keys' => [
3011                           { columns    => [ 'pkgnum' ],
3012                             table      => 'cust_pkg',
3013                           },
3014                           { columns    => [ 'pkgusagepart' ],
3015                             table      => 'part_pkg_usage',
3016                           },
3017                         ],
3018     },
3019
3020     'cdr_cust_pkg_usage' => {
3021       'columns' => [
3022         'cdrusagenum', 'bigserial', '', '', '', '',
3023         'acctid',      'bigint',    '', '', '', '',
3024         'pkgusagenum', 'int',       '', '', '', '',
3025         'minutes',     'double precision',       '', '', '', '',
3026       ],
3027       'primary_key'  => 'cdrusagenum',
3028       'unique'       => [],
3029       'index'        => [ [ 'pkgusagenum' ], [ 'acctid' ] ],
3030       'foreign_keys' => [
3031                           { columns    => [ 'acctid' ],
3032                             table      => 'cdr',
3033                           },
3034                           { columns    => [ 'pkgusagenum' ],
3035                             table      => 'cust_pkg_usage',
3036                           },
3037                         ],
3038     },
3039
3040     'cust_bill_pkg_discount' => {
3041       'columns' => [
3042         'billpkgdiscountnum', 'serial',        '', '', '', '',
3043         'billpkgnum',            'int',        '', '', '', '',
3044         'pkgdiscountnum',        'int',        '', '', '', '',
3045         'amount',          @money_type,                '', '',
3046         'months',            'decimal', 'NULL', '7,4', '', '',
3047       ],
3048       'primary_key'  => 'billpkgdiscountnum',
3049       'unique'       => [],
3050       'index'        => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
3051       'foreign_keys' => [
3052                           { columns    => [ 'billpkgnum' ],
3053                             table      => 'cust_bill_pkg',
3054                           },
3055                           { columns    => [ 'pkgdiscountnum' ],
3056                             table      => 'cust_pkg_discount',
3057                           },
3058                         ],
3059     },
3060
3061     'cust_bill_pkg_discount_void' => {
3062       'columns' => [
3063         'billpkgdiscountnum',    'int',        '', '', '', '',
3064         'billpkgnum',            'int',        '', '', '', '',
3065         'pkgdiscountnum',        'int',        '', '', '', '',
3066         'amount',          @money_type,                '', '',
3067         'months',            'decimal', 'NULL', '7,4', '', '',
3068       ],
3069       'primary_key'  => 'billpkgdiscountnum',
3070       'unique'       => [],
3071       'index'        => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
3072       'foreign_keys' => [
3073                           { columns    => [ 'billpkgnum' ],
3074                             table      => 'cust_bill_pkg_void',
3075                           },
3076                           { columns    => [ 'pkgdiscountnum' ],
3077                             table      => 'cust_pkg_discount',
3078                           },
3079                         ],
3080     },
3081
3082     'discount' => {
3083       'columns' => [
3084         'discountnum', 'serial',     '',      '', '', '',
3085         #'agentnum',       'int', 'NULL',      '', '', '',
3086         'classnum',       'int', 'NULL',      '', '', '',
3087         'name',       'varchar', 'NULL', $char_d, '', '',
3088         'amount',   @money_type,                  '', '',
3089         'percent',    'decimal',     '',   '7,4', '', '',
3090         'months',     'decimal', 'NULL',   '7,4', '', '',
3091         'disabled',      'char', 'NULL',       1, '', '',
3092         'setup',         'char', 'NULL',       1, '', '',
3093         #'linked',        'char', 'NULL',       1, '', '',
3094       ],
3095       'primary_key'  => 'discountnum',
3096       'unique'       => [],
3097       'index'        => [], # [ 'agentnum' ], ],
3098       'foreign_keys' => [
3099                           { columns    => [ 'classnum' ],
3100                             table      => 'discount_class',
3101                           },
3102                         ],
3103     },
3104
3105     'discount_class' => {
3106       'columns' => [
3107         'classnum',    'serial',   '',      '', '', '',
3108         'classname',   'varchar',  '', $char_d, '', '',
3109         #'categorynum', 'int',  'NULL',      '', '', '',
3110         'disabled',    'char', 'NULL',       1, '', '',
3111       ],
3112       'primary_key' => 'classnum',
3113       'unique' => [],
3114       'index' => [ ['disabled'] ],
3115     },
3116
3117     'cust_refund' => {
3118       'columns' => [
3119         'refundnum',    'serial',    '',   '', '', '',
3120         'custnum',  'int',    '',   '', '', '',
3121         '_date',        @date_type, '', '',
3122         'refund',       @money_type, '', '',
3123         'currency',       'char', 'NULL',       3, '', '',
3124         'otaker',       'varchar',   'NULL',   32, '', '',
3125         'usernum',   'int', 'NULL', '', '', '',
3126         'reason',       'varchar',   'NULL',   $char_d, '', '',
3127         'reasonnum',   'int', 'NULL', '', '', '',
3128         'payby',        'char',   '',     4, '', '', # CARD/BILL/COMP, should
3129                                                      # be index into payby
3130                                                      # table eventually
3131         'payinfo',      'varchar',   'NULL', 512, '', '', #see cust_main above
3132         'paycardtype',  'varchar', 'NULL',   $char_d, '', '',
3133         'paymask', 'varchar', 'NULL', $char_d, '', '',
3134         'paybatch',     'varchar',   'NULL', $char_d, '', '',
3135         'closed',    'char', 'NULL', 1, '', '',
3136         'source_paynum', 'int', 'NULL', '', '', '', # link to cust_payby, to prevent unapply of gateway-generated refunds
3137         # credit card/EFT fields (formerly in paybatch)
3138         'gatewaynum',     'int', 'NULL', '', '', '', # payment_gateway FK
3139         'processor',  'varchar', 'NULL', $char_d, '', '', # module name
3140         'auth',       'varchar','NULL',16, '', '', # CC auth number
3141         'order_number', 'varchar','NULL',$char_d, '', '', # transaction number
3142         'is_tokenized',   'char', 'NULL',    1, '', '',
3143       ],
3144       'primary_key'  => 'refundnum',
3145       'unique'       => [],
3146       'index'        => [ ['custnum'], ['_date'], [ 'usernum' ], ['is_tokenized'] ],
3147       'foreign_keys' => [
3148                           { columns    => [ 'custnum' ],
3149                             table      => 'cust_main',
3150                           },
3151                           { columns    => [ 'usernum' ],
3152                             table      => 'access_user',
3153                           },
3154                           { columns    => [ 'reasonnum' ],
3155                             table      => 'reason',
3156                           },
3157                           { columns    => [ 'gatewaynum' ],
3158                             table      => 'payment_gateway',
3159                           },
3160                           { columns    => [ 'source_paynum' ],
3161                             table      => 'cust_pay',
3162                             references => [ 'paynum' ],
3163                           },
3164                         ],
3165     },
3166
3167     'cust_credit_refund' => {
3168       'columns' => [
3169         'creditrefundnum', 'serial',     '',   '', '', '',
3170         'crednum',  'int',     '',   '', '', '',
3171         'refundnum',  'int',     '',   '', '', '',
3172         'amount',  @money_type, '', '',
3173         '_date',   @date_type, '', '',
3174       ],
3175       'primary_key'  => 'creditrefundnum',
3176       'unique'       => [],
3177       'index'        => [ ['crednum'], ['refundnum'] ],
3178       'foreign_keys' => [
3179                           { columns    => [ 'crednum' ],
3180                             table      => 'cust_credit',
3181                           },
3182                           { columns    => [ 'refundnum' ],
3183                             table      => 'cust_refund',
3184                           },
3185                         ],
3186     },
3187
3188
3189     'cust_svc' => {
3190       'columns' => [
3191         'svcnum',      'serial',     '', '', '', '',
3192         'pkgnum',         'int', 'NULL', '', '', '',
3193         'svcpart',        'int',     '', '', '', '',
3194         'agent_svcid',    'int', 'NULL', '', '', '',
3195         'overlimit',           @date_type,   '', '',
3196       ],
3197       'primary_key'  => 'svcnum',
3198       'unique'       => [],
3199       'index'        => [ ['svcnum'], ['pkgnum'], ['svcpart'],
3200                           ['agent_svcid'],
3201                         ],
3202       'foreign_keys' => [
3203                           { columns    => [ 'pkgnum' ],
3204                             table      => 'cust_pkg',
3205                           },
3206                           { columns    => [ 'svcpart' ],
3207                             table      => 'part_svc',
3208                           },
3209                         ],
3210     },
3211
3212     'cust_svc_option' => {
3213       'columns' => [
3214         'optionnum',   'serial', '', '', '', '',
3215         'svcnum',      'int', '', '', '', '',
3216         'optionname',  'varchar', '', $char_d, '', '',
3217         'optionvalue', 'text', 'NULL', '', '', '',
3218       ],
3219       'primary_key'  => 'optionnum',
3220       'unique'       => [],
3221       'index'        => [ [ 'svcnum' ], [ 'optionname' ] ],
3222       'foreign_keys' => [
3223                           { columns    => [ 'svcnum' ],
3224                             table      => 'cust_svc',
3225                           },
3226                         ],
3227     },
3228
3229     'svc_export_machine' => {
3230       'columns' => [
3231         'svcexportmachinenum', 'serial', '', '', '', '',
3232         'svcnum',                 'int', '', '', '', '',
3233         'exportnum',              'int', '', '', '', '',
3234         'machinenum',             'int', '', '', '', '',
3235       ],
3236       'primary_key'  => 'svcexportmachinenum',
3237       'unique'       => [ ['svcnum', 'exportnum'] ],
3238       'index'        => [],
3239       'foreign_keys' => [
3240                           { columns    => [ 'svcnum' ],
3241                             table      => 'cust_svc',
3242                           },
3243                           { columns    => [ 'exportnum' ],
3244                             table      => 'part_export',
3245                           },
3246                           { columns    => [ 'machinenum' ],
3247                             table      => 'part_export_machine',
3248                           },
3249                         ],
3250     },
3251
3252     'part_export_machine' => {
3253       'columns' => [
3254         'machinenum', 'serial', '', '', '', '',
3255         'exportnum',     'int', '', '', '', '',
3256         'machine',    'varchar', 'NULL', $char_d, '', '',
3257         'disabled',      'char', 'NULL',       1, '', '',
3258       ],
3259       'primary_key'  => 'machinenum',
3260       'unique'       => [ [ 'exportnum', 'machine' ] ],
3261       'index'        => [ [ 'exportnum' ] ],
3262       'foreign_keys' => [
3263                           { columns    => [ 'exportnum' ],
3264                             table      => 'part_export',
3265                           },
3266                         ],
3267     },
3268
3269     'part_pkg' => {
3270       'columns' => [
3271         'pkgpart',       'serial',    '',   '', '', '',
3272         'pkgpartbatch',  'varchar', 'NULL', $char_d, '', '',
3273         'pkg',           'varchar',   '',   104, '', '',
3274         'comment',       'varchar', 'NULL', 2*$char_d, '', '',
3275         'promo_code',    'varchar', 'NULL', $char_d, '', '',
3276         'freq',          'varchar',   '',   $char_d, '', '', #billing frequency
3277         'setuptax',      'char', 'NULL', 1, '', '',
3278         'recurtax',      'char', 'NULL', 1, '', '',
3279         'plan',          'varchar', 'NULL', $char_d, '', '',
3280         'disabled',      'char', 'NULL', 1, '', '',
3281         'custom',        'char', 'NULL', 1, '', '',
3282         'taxclass',      'varchar', 'NULL', $char_d, '', '',
3283         'classnum',      'int',     'NULL', '', '', '',
3284         'addon_classnum','int',     'NULL', '', '', '',
3285         'taxproductnum', 'int',     'NULL', '', '', '',
3286         'setup_cost',    @money_typen,          '', '',
3287         'recur_cost',    @money_typen,          '', '',
3288         'pay_weight',    'real',    'NULL', '', '', '',
3289         'credit_weight', 'real',    'NULL', '', '', '',
3290         'agentnum',      'int',     'NULL', '', '', '',
3291         'fcc_ds0s',      'int',     'NULL', '', '', '',
3292         'fcc_voip_class','char',    'NULL',  1, '', '',
3293         'no_auto',          'char', 'NULL',  1, '', '',
3294         'recur_show_zero',  'char', 'NULL',  1, '', '',
3295         'setup_show_zero',  'char', 'NULL',  1, '', '',
3296         'successor',     'int',     'NULL', '', '', '',
3297         'family_pkgpart','int',     'NULL', '', '', '',
3298         'delay_start',   'int',     'NULL', '', '', '',
3299         'start_on_hold', 'char',    'NULL',  1, '', '',
3300         'agent_pkgpartid', 'varchar', 'NULL', 20, '', '',
3301         'expire_months', 'int',     'NULL', '', '', '',
3302         'adjourn_months', 'int',    'NULL', '', '', '',
3303         'contract_end_months','int','NULL', '', '', '',
3304         'change_to_pkgpart', 'int', 'NULL', '', '', '',
3305         'units_taxproductnum','int','NULL', '', '', '',
3306       ],
3307       'primary_key'  => 'pkgpart',
3308       'unique'       => [],
3309       'index'        => [ [ 'promo_code' ], [ 'disabled' ], [ 'classnum' ],
3310                           [ 'agentnum' ], ['no_auto'], ['agent_pkgpartid'],
3311                         ],
3312       'foreign_keys' => [
3313                           { columns    => [ 'classnum' ],
3314                             table      => 'pkg_class',
3315                           },
3316                           { columns    => [ 'addon_classnum' ],
3317                             table      => 'pkg_class',
3318                             references => [ 'classnum' ],
3319                           },
3320                           { columns    => [ 'taxproductnum' ],
3321                             table      => 'part_pkg_taxproduct',
3322                           },
3323                           { columns    => [ 'units_taxproductnum' ],
3324                             table      => 'part_pkg_taxproduct',
3325                             references => [ 'taxproductnum' ],
3326                           },
3327                           { columns    => [ 'agentnum' ],
3328                             table      => 'agent',
3329                           },
3330                           { columns    => [ 'successor' ],
3331                             table      => 'part_pkg',
3332                             references => [ 'pkgpart' ],
3333                           },
3334                           { columns    => [ 'family_pkgpart' ],
3335                             table      => 'part_pkg',
3336                             references => [ 'pkgpart' ],
3337                           },
3338                           { columns    => [ 'change_to_pkgpart' ],
3339                             table      => 'part_pkg',
3340                             references => [ 'pkgpart' ],
3341                           },
3342                         ],
3343     },
3344
3345     'part_pkg_msgcat' => {
3346       'columns' => [
3347         'pkgpartmsgnum',  'serial',     '',        '', '', '',
3348         'pkgpart',           'int',     '',        '', '', '',
3349         'locale',        'varchar',     '',        16, '', '',
3350         'pkg',           'varchar',     '',   $char_d, '', '', #longer/no limit?
3351         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
3352       ],
3353       'primary_key'  => 'pkgpartmsgnum',
3354       'unique'       => [ [ 'pkgpart', 'locale' ] ],
3355       'index'        => [],
3356       'foreign_keys' => [
3357                           { columns    => [ 'pkgpart' ],
3358                             table      => 'part_pkg',
3359                           },
3360                         ],
3361     },
3362
3363     'part_pkg_currency' => {
3364       'columns' => [
3365         'pkgcurrencynum', 'serial', '',      '', '', '',
3366         'pkgpart',           'int', '',      '', '', '',
3367         'currency',         'char', '',       3, '', '',
3368         'optionname',    'varchar', '', $char_d, '', '',
3369         'optionvalue',      'text', '',      '', '', '',
3370       ],
3371       'primary_key'  => 'pkgcurrencynum',
3372       'unique'       => [ [ 'pkgpart', 'currency', 'optionname' ] ],
3373       'index'        => [ ['pkgpart'] ],
3374       'foreign_keys' => [
3375                           { columns    => [ 'pkgpart' ],
3376                             table      => 'part_pkg',
3377                           },
3378                         ],
3379     },
3380
3381     'currency_exchange' => {
3382       'columns' => [
3383         'currencyratenum', 'serial', '',    '', '', '',
3384         'from_currency',     'char', '',     3, '', '',
3385         'to_currency',       'char', '',     3, '', '',
3386         'rate',           'decimal', '', '7,6', '', '',
3387       ],
3388       'primary_key' => 'currencyratenum',
3389       'unique'      => [ [ 'from_currency', 'to_currency' ] ],
3390       'index'       => [],
3391     },
3392
3393     'part_pkg_usageprice' => {
3394       'columns' => [
3395         'usagepricepart', 'serial',      '',      '', '', '',
3396         'pkgpart',           'int',      '',      '', '', '',
3397         'price',          @money_type,                '', '',
3398         'currency',         'char',  'NULL',       3, '', '',
3399         'action',        'varchar',      '', $char_d, '', '',
3400         'target',        'varchar',      '', $char_d, '', '',
3401         'amount',        'varchar',      '', $char_d, '', '',
3402       ],
3403       'primary_key'  => 'usagepricepart',
3404       'unique'       => [ [ 'pkgpart', 'currency', 'target' ] ],
3405       'index'        => [ [ 'pkgpart' ] ],
3406       'foreign_keys' => [
3407                           { columns    => [ 'pkgpart' ],
3408                             table      => 'part_pkg',
3409                           },
3410                         ],
3411     },
3412
3413     'cust_pkg_usageprice' => {
3414       'columns' => [
3415         'usagepricenum', 'serial',      '',      '', '', '',
3416         'pkgnum',           'int',      '',      '', '', '',
3417         'usagepricepart',   'int',      '',      '', '', '',
3418         'quantity',         'int',      '',      '', '', '',
3419       ],
3420       'primary_key'  => 'usagepricenum',
3421       'unique'       => [ [ 'pkgnum', 'usagepricepart' ] ],
3422       'index'        => [ [ 'pkgnum' ] ],
3423       'foreign_keys' => [
3424                           { columns    => [ 'pkgnum' ],
3425                             table      => 'cust_pkg',
3426                           },
3427                           { columns    => [ 'usagepricepart' ],
3428                             table      => 'part_pkg_usageprice',
3429                           },
3430                         ],
3431     },
3432
3433     'part_fee' => {
3434       'columns' => [
3435         'feepart',       'serial',    '',   '', '', '',
3436         'itemdesc',      'varchar',   '',   $char_d,   '', '',
3437         'comment',       'varchar', 'NULL', 2*$char_d, '', '',
3438         'disabled',      'char',    'NULL',  1, '', '',
3439         'classnum',      'int',     'NULL', '', '', '',
3440         'taxclass',      'varchar', 'NULL', $char_d, '', '',
3441         'taxproductnum', 'int',     'NULL', '', '', '',
3442         'pay_weight',    'real',    'NULL', '', '', '',
3443         'credit_weight', 'real',    'NULL', '', '', '',
3444         'agentnum',      'int',     'NULL', '', '', '',
3445         'amount',   @money_type,                '', '',
3446         'percent',     'decimal',    '', '7,4', '', '',
3447         'basis',         'varchar',  '',    16, '', '',
3448         'minimum',    @money_typen,             '', '',
3449         'maximum',    @money_typen,             '', '',
3450         'limit_credit',  'char',    'NULL',  1, '', '',
3451         'setuprecur',    'char',     '',     5, '', '',
3452         'taxable',       'char',    'NULL',  1, '', '',
3453       ],
3454       'primary_key'  => 'feepart',
3455       'unique'       => [],
3456       'index'        => [ [ 'disabled' ], [ 'classnum' ], [ 'agentnum' ]
3457                         ],
3458       'foreign_keys' => [
3459                           { columns    => [ 'classnum' ],
3460                             table      => 'pkg_class',
3461                           },
3462                           { columns    => [ 'taxproductnum' ],
3463                             table      => 'part_pkg_taxproduct',
3464                           },
3465                           { columns    => [ 'agentnum' ],
3466                             table      => 'agent',
3467                           },
3468                         ],
3469     },
3470
3471     'part_fee_msgcat' => {
3472       'columns' => [
3473         'feepartmsgnum',  'serial',     '',        '', '', '',
3474         'feepart',           'int',     '',        '', '', '',
3475         'locale',        'varchar',     '',        16, '', '',
3476         'itemdesc',      'varchar',     '',   $char_d, '', '', #longer/no limit?
3477         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
3478       ],
3479       'primary_key'  => 'feepartmsgnum',
3480       'unique'       => [ [ 'feepart', 'locale' ] ],
3481       'index'        => [],
3482       'foreign_keys' => [
3483                           { columns    => [ 'feepart' ],
3484                             table      => 'part_fee',
3485                           },
3486                         ],
3487     },
3488
3489     'part_fee_usage' => {
3490       'columns' => [
3491         'feepartusagenum','serial',     '',        '', '', '',
3492         'feepart',           'int',     '',        '', '', '',
3493         'classnum',          'int',     '',        '', '', '',
3494         'amount',   @money_type,                '', '',
3495         'percent',     'decimal',    '', '7,4', '', '',
3496       ],
3497       'primary_key'  => 'feepartusagenum',
3498       'unique'       => [ [ 'feepart', 'classnum' ] ],
3499       'index'        => [],
3500       'foreign_keys' => [
3501                           { columns    => [ 'feepart' ],
3502                             table      => 'part_fee',
3503                           },
3504                           { columns    => [ 'classnum' ],
3505                             table      => 'usage_class',
3506                           },
3507                         ],
3508     },
3509
3510     'part_pkg_link' => {
3511       'columns' => [
3512         'pkglinknum',  'serial',   '',      '', '', '',
3513         'src_pkgpart', 'int',      '',      '', '', '',
3514         'dst_pkgpart', 'int',      '',      '', '', '',
3515         'link_type',   'varchar',  '', $char_d, '', '',
3516         'hidden',      'char', 'NULL',       1, '', '',
3517       ],
3518       'primary_key'  => 'pkglinknum',
3519       'unique'       => [ ['src_pkgpart','dst_pkgpart','link_type','hidden'] ],
3520       'index'        => [ [ 'src_pkgpart' ] ],
3521       'foreign_keys' => [
3522                           { columns    => [ 'src_pkgpart' ],
3523                             table      => 'part_pkg',
3524                             references => [ 'pkgpart' ]
3525                           },
3526                           { columns    => [ 'dst_pkgpart' ],
3527                             table      => 'part_pkg',
3528                             references => [ 'pkgpart' ]
3529                           },
3530                         ],
3531     },
3532     # XXX somewhat borked unique: we don't really want a hidden and unhidden
3533     # it turns out we'd prefer to use svc, bill, and invisibill (or something)
3534
3535     'part_pkg_discount' => {
3536       'columns' => [
3537         'pkgdiscountnum', 'serial',   '',      '', '', '',
3538         'pkgpart',        'int',      '',      '', '', '',
3539         'discountnum',    'int',      '',      '', '', '',
3540       ],
3541       'primary_key'  => 'pkgdiscountnum',
3542       'unique'       => [ [ 'pkgpart', 'discountnum' ] ],
3543       'index'        => [],
3544       'foreign_keys' => [
3545                           { columns    => [ 'pkgpart' ],
3546                             table      => 'part_pkg',
3547                           },
3548                           { columns    => [ 'discountnum' ],
3549                             table      => 'discount',
3550                           },
3551                         ],
3552     },
3553
3554     'part_pkg_taxclass' => {
3555       'columns' => [
3556         'taxclassnum',  'serial', '',       '', '', '',
3557         'taxclass',     'varchar', '', $char_d, '', '',
3558         'disabled', 'char',   'NULL',         1, '', '',
3559       ],
3560       'primary_key' => 'taxclassnum',
3561       'unique'      => [ [ 'taxclass' ] ],
3562       'index'       => [ [ 'disabled' ] ],
3563     },
3564
3565     'part_pkg_taxproduct' => {
3566       'columns' => [
3567         'taxproductnum', 'serial',      '',        '', '', '',
3568         'data_vendor',   'varchar', 'NULL',   $char_d, '', '',
3569         'taxproduct',    'varchar',     '',   $char_d, '', '',
3570         'description',   'varchar',     '', 3*$char_d, '', '',
3571         'note',             'text', 'NULL',        '', '', '',
3572       ],
3573       'primary_key' => 'taxproductnum',
3574       'unique'      => [ [ 'data_vendor', 'taxproduct' ] ],
3575       'index'       => [],
3576     },
3577
3578     'part_pkg_taxrate' => {
3579       'columns' => [
3580         'pkgtaxratenum', 'serial',  '',     '',      '', '',
3581         'data_vendor',   'varchar', 'NULL', $char_d, '', '', # update source
3582         'geocode',       'varchar', 'NULL', $char_d, '', '', # cch provides 10
3583         'taxproductnum', 'int',  '',     '',       '', '',
3584         'city',             'varchar', 'NULL', $char_d, '', '', # tax_location?
3585         'county',           'varchar', 'NULL', $char_d, '', '',
3586         'state',            'varchar', 'NULL', $char_d, '', '',
3587         'local',            'varchar', 'NULL', $char_d, '', '',
3588         'country',          'char',    'NULL', 2,       '', '',
3589         'taxclassnumtaxed', 'int',     'NULL', '',      '', '',
3590         'taxcattaxed',      'varchar', 'NULL', $char_d, '', '',
3591         'taxclassnum',      'int',     'NULL', '',      '', '',
3592         'effdate',          @date_type, '', '',
3593         'taxable',          'char',    'NULL', 1,       '', '',
3594       ],
3595       'primary_key'  => 'pkgtaxratenum',
3596       'unique'       => [],
3597       'index'        => [ [ 'data_vendor', 'geocode', 'taxproductnum' ] ],
3598       'foreign_keys' => [
3599                           { columns    => [ 'taxproductnum' ],
3600                             table      => 'part_pkg_taxproduct',
3601                           },
3602                           { columns    => [ 'taxclassnumtaxed' ],
3603                             table      => 'tax_class',
3604                             references => [ 'taxclassnum' ],
3605                           },
3606                           { columns    => [ 'taxclassnum' ],
3607                             table      => 'tax_class',
3608                           },
3609                         ],
3610     },
3611
3612     'part_pkg_taxoverride' => {
3613       'columns' => [
3614         'taxoverridenum', 'serial', '', '', '', '',
3615         'pkgpart',           'int', '', '', '', '',
3616         'taxclassnum',       'int', '', '', '', '',
3617         'usage_class',    'varchar', 'NULL', $char_d, '', '',
3618       ],
3619       'primary_key'  => 'taxoverridenum',
3620       'unique'       => [],
3621       'index'        => [ [ 'pkgpart' ], [ 'taxclassnum' ] ],
3622       'foreign_keys' => [
3623                           { columns    => [ 'pkgpart' ],
3624                             table      => 'part_pkg',
3625                           },
3626                           { columns    => [ 'taxclassnum' ],
3627                             table      => 'tax_class',
3628                           },
3629                         ],
3630     },
3631
3632 #    'part_title' => {
3633 #      'columns' => [
3634 #        'titlenum',   'int',    '',   '',
3635 #        'title',      'varchar',   '',   $char_d,
3636 #      ],
3637 #      'primary_key' => 'titlenum',
3638 #      'unique' => [ [] ],
3639 #      'index' => [ [] ],
3640 #    },
3641
3642     'pkg_svc' => {
3643       'columns' => [
3644         'pkgsvcnum',   'serial',    '', '', '', '',
3645         'pkgpart',        'int',    '', '', '', '',
3646         'svcpart',        'int',    '', '', '', '',
3647         'quantity',       'int',    '', '', '', '',
3648         'primary_svc',   'char', 'NULL', 1, '', '',
3649         'hidden',        'char', 'NULL', 1, '', '',
3650         'bulk_skip',     'char', 'NULL', 1, '', '',
3651         'provision_hold', 'char', 'NULL', 1, '', '',
3652       ],
3653       'primary_key'  => 'pkgsvcnum',
3654       'unique'       => [ ['pkgpart', 'svcpart'] ],
3655       'index'        => [ ['pkgpart'], ['quantity'] ],
3656       'foreign_keys' => [
3657                           { columns    => [ 'pkgpart' ],
3658                             table      => 'part_pkg',
3659                           },
3660                           { columns    => [ 'svcpart' ],
3661                             table      => 'part_svc',
3662                           },
3663                         ],
3664     },
3665
3666     'part_referral' => {
3667       'columns' => [
3668         'refnum',   'serial',     '',        '', '', '',
3669         'referral', 'varchar',    '',   $char_d, '', '',
3670         'disabled', 'char',   'NULL',         1, '', '',
3671         'agentnum', 'int',    'NULL',        '', '', '',
3672         'title',   'varchar', 'NULL',   $char_d, '', '',
3673       ],
3674       'primary_key'  => 'refnum',
3675       'unique'       => [ ['agentnum', 'title'] ],
3676       'index'        => [ ['disabled'], ['agentnum'], ],
3677       'foreign_keys' => [
3678                           { columns    => [ 'agentnum' ],
3679                             table      => 'agent',
3680                           },
3681                         ],
3682     },
3683
3684     'part_svc' => {
3685       'columns' => [
3686         'svcpart',             'serial',     '',        '', '', '',
3687         'svc',                'varchar',     '',   $char_d, '', '',
3688         'svcdb',              'varchar',     '',   $char_d, '', '',
3689         'disabled',              'char', 'NULL',         1, '', '',
3690         'preserve',              'char', 'NULL',         1, '', '',
3691         'selfservice_access', 'varchar', 'NULL',   $char_d, '', '',
3692         'classnum',               'int', 'NULL',        '', '', '',
3693         'restrict_edit_password','char', 'NULL',         1, '', '',
3694         'has_router',            'char', 'NULL',         1, '', '',
3695 ],
3696       'primary_key'  => 'svcpart',
3697       'unique'       => [],
3698       'index'        => [ [ 'disabled' ] ],
3699       'foreign_keys' => [
3700                           { columns    => [ 'classnum' ],
3701                             table      => 'part_svc_class',
3702                           },
3703                         ],
3704     },
3705
3706     'part_svc_column' => {
3707       'columns' => [
3708         'columnnum',   'serial',      '',      '', '', '',
3709         'svcpart',     'int',         '',      '', '', '',
3710         'columnname',  'varchar',     '',      64, '', '',
3711         'columnlabel', 'varchar', 'NULL', $char_d, '', '',
3712         'columnvalue', 'varchar', 'NULL',     512, '', '',
3713         'columnflag',  'char',    'NULL',       1, '', '',
3714         'required',    'char',    'NULL',       1, '', '',
3715       ],
3716       'primary_key'  => 'columnnum',
3717       'unique'       => [ [ 'svcpart', 'columnname' ] ],
3718       'index'        => [ [ 'svcpart' ] ],
3719       'foreign_keys' => [
3720                           { columns    => [ 'svcpart' ],
3721                             table      => 'part_svc',
3722                           },
3723                         ],
3724     },
3725
3726     'part_svc_class' => {
3727       'columns' => [
3728         'classnum',    'serial',   '',      '', '', '',
3729         'classname',   'varchar',  '', $char_d, '', '',
3730         'disabled',    'char', 'NULL',       1, '', '',
3731       ],
3732       'primary_key' => 'classnum',
3733       'unique' => [],
3734       'index' => [ ['disabled'] ],
3735     },
3736
3737     'part_svc_link' => {
3738       'columns' => [
3739         'svclinknum',  'serial',   '',      '', '', '',
3740         #'linkname',    'varchar', 'NULL', $char_d, '', '',
3741         'agentnum',    'int',     'NULL', '', '', '',
3742         'src_svcpart', 'int',      '',      '', '', '',
3743         'dst_svcpart', 'int',      '',      '', '', '',
3744         'link_type',   'varchar',  '', $char_d, '', '',
3745         'disabled',    'char', 'NULL',   1, '', '',
3746       ],
3747       'primary_key'  => 'svclinknum',
3748       'unique'       => [ ['agentnum','src_svcpart','dst_svcpart','link_type'] ],
3749       'index'        => [ [ 'src_svcpart' ], [ 'src_svcpart', 'link_type' ], [ 'disabled' ] ],
3750       'foreign_keys' => [
3751                           { columns    => [ 'src_svcpart' ],
3752                             table      => 'part_svc',
3753                             references => [ 'svcpart' ]
3754                           },
3755                           { columns    => [ 'dst_svcpart' ],
3756                             table      => 'part_svc',
3757                             references => [ 'svcpart' ]
3758                           },
3759                         ],
3760     },
3761
3762     'part_svc_msgcat' => {
3763       'columns' => [
3764         'svcpartmsgnum',  'serial',     '',        '', '', '',
3765         'svcpart',           'int',     '',        '', '', '',
3766         'locale',        'varchar',     '',        16, '', '',
3767         'svc',           'varchar',     '',   $char_d, '', '',
3768       ],
3769       'primary_key'  => 'svcpartmsgnum',
3770       'unique'       => [ [ 'svcpart', 'locale' ] ],
3771       'index'        => [],
3772       'foreign_keys' => [
3773                           { columns    => [ 'svcpart' ],
3774                             table      => 'part_svc',
3775                           },
3776                         ],
3777     },
3778
3779
3780     #(this should be renamed to part_pop)
3781     'svc_acct_pop' => {
3782       'columns' => [
3783         'popnum',    'serial',    '',   '', '', '',
3784         'city',      'varchar',   '',   $char_d, '', '',
3785         'state',     'varchar',   '',   $char_d, '', '',
3786         'ac',        'char',   '',   3, '', '',
3787         'exch',      'char',   '',   3, '', '',
3788         'loc',       'char',   'NULL',   4, '', '', #NULL for legacy purposes
3789       ],
3790       'primary_key' => 'popnum',
3791       'unique' => [],
3792       'index' => [ [ 'state' ] ],
3793     },
3794
3795     'part_pop_local' => {
3796       'columns' => [
3797         'localnum',  'serial',     '',     '', '', '',
3798         'popnum',    'int',     '',     '', '', '',
3799         'city',      'varchar', 'NULL', $char_d, '', '',
3800         'state',     'char',    'NULL', 2, '', '',
3801         'npa',       'char',    '',     3, '', '',
3802         'nxx',       'char',    '',     3, '', '',
3803       ],
3804       'primary_key'  => 'localnum',
3805       'unique'       => [],
3806       'index'        => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
3807       'foreign_keys' => [
3808                          { columns    => [ 'popnum' ],
3809                            table      => 'svc_acct_pop',
3810                          },
3811                        ],
3812     },
3813
3814     'qual' => {
3815       'columns' => [
3816         'qualnum',  'serial',     '',     '', '', '',
3817         'custnum',    'int',     'NULL',     '', '', '',
3818         'prospectnum',    'int',     'NULL',     '', '', '',
3819         'locationnum',    'int',     'NULL',     '', '', '',
3820         'phonenum',     'varchar', 'NULL',       24, '', '',
3821         'exportnum',      'int', 'NULL', '', '', '',
3822         'vendor_qual_id',      'varchar', 'NULL', $char_d, '', '',
3823         'status',      'char', '', 1, '', '',
3824       ],
3825       'primary_key'  => 'qualnum',
3826       'unique'       => [],
3827       'index'        => [ ['locationnum'], ['custnum'], ['prospectnum'],
3828                           ['phonenum'], ['vendor_qual_id'],
3829                         ],
3830       'foreign_keys' => [
3831                           { columns    => [ 'custnum' ],
3832                             table      => 'cust_main',
3833                           },
3834                           { columns    => [ 'prospectnum' ],
3835                             table      => 'prospect_main',
3836                           },
3837                           { columns    => [ 'locationnum' ],
3838                             table      => 'cust_location',
3839                           },
3840                           { columns    => [ 'exportnum' ],
3841                             table      => 'part_export',
3842                           },
3843                         ],
3844     },
3845
3846     'qual_option' => {
3847       'columns' => [
3848         'optionnum', 'serial', '', '', '', '',
3849         'qualnum',  'int',     '',     '', '', '',
3850         'optionname', 'varchar', '', $char_d, '', '',
3851         'optionvalue', 'text', 'NULL', '', '', '',
3852       ],
3853       'primary_key'  => 'optionnum',
3854       'unique'       => [],
3855       'index'        => [],
3856       'foreign_keys' => [
3857                           { columns    => [ 'qualnum' ],
3858                             table      => 'qual',
3859                           },
3860                         ],
3861     },
3862
3863     'svc_acct' => {
3864       'columns' => [
3865         'svcnum',    'int',    '',   '', '', '',
3866         'username',  'varchar',   '',   $username_len, '', '',
3867         '_password', 'varchar',   'NULL',  512, '', '',
3868         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
3869         'sec_phrase', 'varchar',  'NULL',   $char_d, '', '',
3870         'popnum',    'int',    'NULL',   '', '', '',
3871         'sectornum', 'int', 'NULL',      '', '', '',
3872         'uid',       'int', 'NULL',   '', '', '',
3873         'gid',       'int', 'NULL',   '', '', '',
3874         'finger',    'varchar',   'NULL',   2*$char_d, '', '',
3875         'dir',       'varchar',   'NULL',   $char_d, '', '',
3876         'shell',     'varchar',   'NULL',   $char_d, '', '',
3877         'quota',     'varchar',   'NULL',   $char_d, '', '',
3878         'slipip',    'varchar',   'NULL',   15, '', '', #four TINYINTs, bah.
3879         # IP address mgmt
3880         'routernum', 'int', 'NULL',      '', '', '',
3881         'blocknum',  'int', 'NULL',      '', '', '',
3882         'seconds',   'int', 'NULL',   '', '', '', #uhhhh
3883         'seconds_threshold',   'int', 'NULL',   '', '', '',
3884         'upbytes',   'bigint', 'NULL',   '', '', '',
3885         'upbytes_threshold',   'bigint', 'NULL',   '', '', '',
3886         'downbytes', 'bigint', 'NULL',   '', '', '',
3887         'downbytes_threshold',   'bigint', 'NULL',   '', '', '',
3888         'totalbytes','bigint', 'NULL',   '', '', '',
3889         'totalbytes_threshold',   'bigint', 'NULL',   '', '', '',
3890         'domsvc',    'int',     '', '', '', '',
3891         'pbxsvc',    'int', 'NULL', '', '', '',
3892         'last_login',  @date_type, '', '',
3893         'last_logout', @date_type, '', '',
3894         #cardfortress field(s)
3895         'cf_privatekey',      'text', 'NULL',      '', '', '',
3896         #communigate pro fields (quota = MaxAccountSize)
3897         'cgp_aliases',     'varchar', 'NULL',     255, '', '',
3898         #settings
3899         'cgp_type',        'varchar', 'NULL', $char_d, '', '', #AccountType
3900         'file_quota',      'varchar', 'NULL', $char_d, '', '', #MaxWebSize
3901         'file_maxnum',     'varchar', 'NULL', $char_d, '', '', #MaxWebFiles
3902         'file_maxsize',    'varchar', 'NULL', $char_d, '', '', #MaxFileSize
3903         'cgp_accessmodes', 'varchar', 'NULL',     255, '', '', #AccessModes
3904         'password_selfchange','char', 'NULL',       1, '', '', #PWDAllowed
3905         'password_recover',   'char', 'NULL',       1, 'Y','', #PasswordRecovery
3906         'cgp_rulesallowed','varchar', 'NULL', $char_d, '', '', #RulesAllowed
3907         'cgp_rpopallowed',    'char', 'NULL',       1, '', '', #RPOPAllowed
3908         'cgp_mailtoall',      'char', 'NULL',       1, '', '', #MailToAll
3909         'cgp_addmailtrailer', 'char', 'NULL',       1, '', '', #AddMailTrailer
3910         'cgp_archiveafter',    'int', 'NULL',      '', '', '', #ArchiveMessagesAfter
3911         #XXX mailing lists
3912         #preferences
3913         'cgp_deletemode',     'varchar', 'NULL', $char_d, '', '',#DeleteMode
3914         'cgp_emptytrash',     'varchar', 'NULL', $char_d, '', '',#EmptyTrash
3915         'cgp_language',       'varchar', 'NULL', $char_d, '', '',#Language
3916         'cgp_timezone',       'varchar', 'NULL', $char_d, '', '',#TimeZone
3917         'cgp_skinname',       'varchar', 'NULL', $char_d, '', '',#SkinName
3918         'cgp_prontoskinname', 'varchar', 'NULL', $char_d, '', '',#ProntoSkinName
3919         'cgp_sendmdnmode',    'varchar', 'NULL', $char_d, '', '',#SendMDNMode
3920         #mail
3921         #XXX RPOP settings
3922         #
3923       ],
3924       'primary_key'  => 'svcnum',
3925       #'unique'       => [ [ 'username', 'domsvc' ] ],
3926       'unique'       => [],
3927       'index'        => [ ['username'], ['domsvc'], ['pbxsvc'] ],
3928       'foreign_keys' => [
3929                           { columns    => [ 'svcnum' ],
3930                             table      => 'cust_svc',
3931                           },
3932                           { columns    => [ 'popnum' ],
3933                             table      => 'svc_acct_pop',
3934                           },
3935                           { columns    => [ 'sectornum' ],
3936                             table      => 'tower_sector',
3937                           },
3938                           { columns    => [ 'routernum' ],
3939                             table      => 'router',
3940                           },
3941                           { columns    => [ 'blocknum' ],
3942                             table      => 'addr_block',
3943                           },
3944                           { columns    => [ 'domsvc' ],
3945                             table      => 'svc_domain', #'cust_svc',
3946                             references => [ 'svcnum' ],
3947                           },
3948                           { columns    => [ 'pbxsvc' ],
3949                             table      => 'svc_pbx', #'cust_svc',
3950                             references => [ 'svcnum' ],
3951                           },
3952                         ],
3953     },
3954
3955     'acct_rt_transaction' => {
3956       'columns' => [
3957         'svcrtid',   'int',    '',   '', '', '', #why am i not a serial
3958         'svcnum',    'int',    '',   '', '', '',
3959         'transaction_id',       'int', '',   '', '', '',
3960         '_date',   @date_type, '', '',
3961         'seconds',   'int', '',   '', '', '', #uhhhh
3962         'support',   'int', '',   '', '', '',
3963       ],
3964       'primary_key'  => 'svcrtid',
3965       'unique'       => [],
3966       'index'        => [ ['svcnum', 'transaction_id'] ],
3967       'foreign_keys' => [
3968                           # problems w/deleted services, and as per below, this
3969                           # is our internal hack, not a customer-facing feature
3970                           #{ columns    => [ 'svcnum' ],
3971                           #  table      => 'svc_acct', #'cust_svc',
3972                           #},
3973
3974                           # 1. RT tables aren't part of our data structure, so
3975                           #     we can't make sure Queue is created already
3976                           # 2. This is our internal hack for time tracking, not
3977                           #     a user-facing feature
3978                           #{ columns    => [ 'transaction_id' ],
3979                           #  table      => 'Transaction',
3980                           #  references => [ 'id' ],
3981                           #},
3982                         ],
3983     },
3984
3985     #'svc_charge' => {
3986     #  'columns' => [
3987     #    'svcnum',    'int',    '',   '',
3988     #    'amount',    @money_type,
3989     #  ],
3990     #  'primary_key' => 'svcnum',
3991     #  'unique' => [ [] ],
3992     #  'index' => [ [] ],
3993     #},
3994
3995     'svc_domain' => {
3996       'columns' => [
3997         'svcnum',           'int',    '',        '', '', '',
3998         'domain',       'varchar',    '',   $char_d, '', '',
3999         'suffix',       'varchar', 'NULL',  $char_d, '', '',
4000         'catchall',         'int', 'NULL',       '', '', '',
4001         'parent_svcnum',    'int', 'NULL',       '', '', '',
4002         'quota',        'varchar', 'NULL',  $char_d, '', '',
4003
4004         #registration info
4005         'registrarnum',     'int', 'NULL',       '', '', '',
4006         'registrarkey', 'varchar', 'NULL',      512, '', '',
4007         'setup_date',      @date_type, '', '',
4008         'renewal_interval', 'int', 'NULL',       '', '', '',
4009         'expiration_date', @date_type, '', '',
4010
4011         #some weird shit australia-specific shit?  yuck.. seems totally unused
4012         'au_registrant_name',       'varchar', 'NULL',  $char_d, '', '',
4013         'au_eligibility_type',      'varchar', 'NULL',  $char_d, '', '',
4014
4015         #communigate pro fields (quota = MaxAccountSize)
4016         'max_accounts',     'int', 'NULL',       '', '', '',
4017         'trailer',         'text', 'NULL',       '', '', '',
4018         'cgp_aliases',  'varchar', 'NULL',      255, '', '',
4019         'cgp_accessmodes','varchar','NULL',     255, '', '', #DomainAccessModes
4020         'cgp_certificatetype','varchar','NULL', $char_d, '', '',
4021
4022         #(account default) settings
4023         'acct_def_password_selfchange',   'char', 'NULL',       1,  '', '',
4024         'acct_def_password_recover',      'char', 'NULL',       1, 'Y', '',
4025         'acct_def_cgp_accessmodes',    'varchar', 'NULL',     255,  '', '',
4026         'acct_def_quota',              'varchar', 'NULL', $char_d,  '', '',
4027         'acct_def_file_quota',         'varchar', 'NULL', $char_d,  '', '',
4028         'acct_def_file_maxnum',        'varchar', 'NULL', $char_d,  '', '',
4029         'acct_def_file_maxsize',       'varchar', 'NULL', $char_d,  '', '',
4030         'acct_def_cgp_rulesallowed',   'varchar', 'NULL', $char_d,  '', '',
4031         'acct_def_cgp_rpopallowed',       'char', 'NULL',       1,  '', '',
4032         'acct_def_cgp_mailtoall',         'char', 'NULL',       1,  '', '',
4033         'acct_def_cgp_addmailtrailer',    'char', 'NULL',       1,  '', '',
4034         'acct_def_cgp_archiveafter',       'int', 'NULL',      '',  '', '',
4035
4036         #(account default) preferences
4037         'acct_def_cgp_deletemode',     'varchar', 'NULL', $char_d,  '', '',
4038         'acct_def_cgp_emptytrash',     'varchar', 'NULL', $char_d,  '', '',
4039         'acct_def_cgp_language',       'varchar', 'NULL', $char_d,  '', '',
4040         'acct_def_cgp_timezone',       'varchar', 'NULL', $char_d,  '', '',
4041         'acct_def_cgp_skinname',       'varchar', 'NULL', $char_d,  '', '',
4042         'acct_def_cgp_prontoskinname', 'varchar', 'NULL', $char_d,  '', '',
4043         'acct_def_cgp_sendmdnmode',    'varchar', 'NULL', $char_d,  '', '',
4044       ],
4045       'primary_key'  => 'svcnum',
4046       'unique'       => [],
4047       'index'        => [ ['domain'] ],
4048       'foreign_keys' => [
4049                           { columns    => [ 'svcnum' ],
4050                             table      => 'cust_svc',
4051                           },
4052                           { columns    => [ 'catchall' ],
4053                             table      => 'svc_acct',
4054                             references => [ 'svcnum' ],
4055                           },
4056                           { columns    => [ 'parent_svcnum' ],
4057                             table      => 'cust_svc',
4058                             references => [ 'svcnum' ],
4059                           },
4060                           { columns    => [ 'registrarnum' ],
4061                             table      => 'registrar',
4062                           },
4063                         ],
4064     },
4065
4066     'svc_dsl' => {
4067       'columns' => [
4068         'svcnum',                    'int',    '',        '', '', '',
4069         'pushed',                    'int', 'NULL',       '', '', '',
4070         'desired_due_date',          'int', 'NULL',       '', '', '',
4071         'due_date',                  'int', 'NULL',       '', '', '',
4072         'vendor_order_id',       'varchar', 'NULL', $char_d,  '', '',
4073         'vendor_qual_id',        'varchar', 'NULL', $char_d,  '', '',
4074         'vendor_order_type',     'varchar', 'NULL', $char_d,  '', '',
4075         'vendor_order_status',   'varchar', 'NULL', $char_d,  '', '',
4076         'first',                 'varchar', 'NULL', $char_d,  '', '',
4077         'last',                  'varchar', 'NULL', $char_d,  '', '',
4078         'company',               'varchar', 'NULL', $char_d,  '', '',
4079         'phonenum',              'varchar', 'NULL',      24, '', '',
4080         'gateway_access_number', 'varchar', 'NULL',      24, '', '',
4081         'loop_type',                'char', 'NULL',       1, '', '',
4082         'local_voice_provider',  'varchar', 'NULL', $char_d, '', '',
4083         'circuitnum',            'varchar', 'NULL', $char_d, '', '',
4084         'rate_band',             'varchar', 'NULL', $char_d, '', '',
4085         'vpi',                       'int', 'NULL',      '', '', '',
4086         'vci',                       'int', 'NULL',      '', '', '',
4087         'isp_chg',                  'char', 'NULL',       1, '', '',
4088         'isp_prev',              'varchar', 'NULL', $char_d, '', '',
4089         'username',              'varchar', 'NULL', $char_d, '', '',
4090         'password',              'varchar', 'NULL', $char_d, '', '',
4091         'staticips',                'text', 'NULL',      '', '', '',
4092         'monitored',                'char', 'NULL',       1, '', '',
4093         'last_pull',                 'int', 'NULL',      '', '', '',
4094       ],
4095       'primary_key'  => 'svcnum',
4096       'unique'       => [ ],
4097       'index'        => [ ['phonenum'], ['vendor_order_id'] ],
4098       'foreign_keys' => [
4099                           { columns    => [ 'svcnum' ],
4100                             table      => 'cust_svc',
4101                           },
4102                         ],
4103     },
4104
4105     'dsl_device' => {
4106       'columns' => [
4107         'devicenum', 'serial',     '', '', '', '',
4108         #part_device?  or our own part_dsl_device?
4109         #'devicepart',   'int',     '', '', '', '',
4110         'svcnum',       'int',     '', '', '', '',
4111         'mac_addr', 'varchar',     '', 12, '', '',
4112       ],
4113       'primary_key'  => 'devicenum',
4114       'unique'       => [ [ 'mac_addr' ], ],
4115       'index'        => [ [ 'svcnum' ], ], # [ 'devicepart' ] ],
4116       'foreign_keys' => [
4117                           { columns    => [ 'svcnum' ],
4118                             table      => 'svc_dsl',
4119                           },
4120                         ],
4121     },
4122
4123     'dsl_note' => {
4124       'columns' => [
4125         'notenum',           'serial',    '',        '', '', '',
4126         'svcnum',     'int', '',       '', '', '',
4127         'author',     'varchar', 'NULL', $char_d,  '', '',
4128         'priority',   'char', 'NULL',       1,  '', '',
4129         '_date',     'int', 'NULL',       '', '', '',
4130         'note',     'text', '',       '', '', '',
4131       ],
4132       'primary_key'  => 'notenum',
4133       'unique'       => [],
4134       'index'        => [ ['svcnum'] ],
4135       'foreign_keys' => [
4136                           { columns    => [ 'svcnum' ],
4137                             table      => 'svc_dsl',
4138                           },
4139                         ],
4140     },
4141
4142     'svc_dish' => {
4143       'columns' => [
4144         'svcnum',   'int',     '',     '', '', '',
4145         'acctnum',  'varchar', '',     16, '', '',
4146         'installdate', @date_type,         '', '',
4147         'note',     'text',    'NULL', '', '', '',
4148       ],
4149       'primary_key'  => 'svcnum',
4150       'unique'       => [],
4151       'index'        => [],
4152       'foreign_keys' => [
4153                           { columns    => [ 'svcnum' ],
4154                             table      => 'cust_svc',
4155                           },
4156                         ],
4157     },
4158
4159     'svc_hardware' => {
4160       'columns' => [
4161         'svcnum',   'int',     '',          '', '', '',
4162         'typenum',  'int',     '',          '', '', '',
4163         'serial',   'varchar', 'NULL', $char_d, '', '',
4164         'ip_addr',  'varchar', 'NULL',      40, '', '',
4165         'hw_addr',  'varchar', 'NULL',      12, '', '',
4166         'smartcard','varchar', 'NULL',      30, '', '',
4167         'statusnum','int',     'NULL',      '', '', '',
4168         'note',     'text',    'NULL',      '', '', '',
4169       ],
4170       'primary_key'  => 'svcnum',
4171       'unique'       => [],
4172       'index'        => [],
4173       'foreign_keys' => [
4174                           { columns    => [ 'svcnum' ],
4175                             table      => 'cust_svc',
4176                           },
4177                           { columns    => [ 'typenum' ],
4178                             table      => 'hardware_type',
4179                           },
4180                           { columns    => [ 'statusnum' ],
4181                             table      => 'hardware_status',
4182                           },
4183                         ],
4184     },
4185
4186     'hardware_class' => {
4187       'columns' => [
4188         'classnum',   'serial', '',      '', '', '',
4189         'classname', 'varchar', '', $char_d, '', '',
4190       ],
4191       'primary_key' => 'classnum',
4192       'unique' => [],
4193       'index'  => [],
4194     },
4195
4196     'hardware_type' => {
4197       'columns' => [
4198         'typenum',  'serial',     '',      '', '', '',
4199         'classnum',    'int',     '',      '', '', '',
4200         'model',   'varchar',     '', $char_d, '', '',
4201         'revision','varchar', 'NULL', $char_d, '', '',
4202         'title',   'varchar', 'NULL', $char_d, '', '', # external id
4203       ],
4204       'primary_key'  => 'typenum',
4205       'unique'       => [ [ 'classnum', 'model', 'revision' ] ],
4206       'index'        => [],
4207       'foreign_keys' => [
4208                           { columns    => [ 'classnum' ],
4209                             table      => 'hardware_class',
4210                           },
4211                         ],
4212     },
4213
4214     'hardware_status' => {
4215       'columns' => [
4216         'statusnum', 'serial', '',      '', '', '',
4217         'label'    ,'varchar', '', $char_d, '', '',
4218         'disabled',    'char', 'NULL',   1, '', '',
4219       ],
4220       'primary_key' => 'statusnum',
4221       'unique' => [],
4222       'index'  => [],
4223     },
4224
4225     'domain_record' => {
4226       'columns' => [
4227         'recnum',    'serial',     '',  '', '', '',
4228         'svcnum',    'int',     '',  '', '', '',
4229         'reczone',   'varchar', '',  255, '', '',
4230         'recaf',     'char',    '',  2, '', '',
4231         'rectype',   'varchar',    '',  5, '', '',
4232         'recdata',   'varchar', '',  255, '', '',
4233         'ttl',       'int',     'NULL', '', '', '',
4234       ],
4235       'primary_key'  => 'recnum',
4236       'unique'       => [],
4237       'index'        => [ ['svcnum'] ],
4238       'foreign_keys' => [
4239                           { columns    => [ 'svcnum' ],
4240                             table      => 'svc_domain',
4241                           },
4242                         ],
4243     },
4244
4245     'registrar' => {
4246       'columns' => [
4247         'registrarnum',   'serial', '',      '', '', '',
4248         'registrarname', 'varchar', '', $char_d, '', '',
4249       ],
4250       'primary_key' => 'registrarnum',
4251       'unique'      => [],
4252       'index'       => [],
4253     },
4254
4255     'cgp_rule' => {
4256       'columns' => [
4257         'rulenum',  'serial',     '',      '', '', '',
4258         'name',    'varchar',     '', $char_d, '', '',
4259         'comment', 'varchar', 'NULL', $char_d, '', '',
4260         'svcnum',      'int',     '',      '', '', '',
4261         'priority',    'int',     '',      '', '', '',
4262       ],
4263       'primary_key' => 'rulenum',
4264       'unique'      => [ [ 'svcnum', 'name' ] ],
4265       'index'       => [ [ 'svcnum' ] ],
4266       'foreign_keys' => [
4267                           { columns    => [ 'svcnum' ],
4268                             table      => 'cust_svc', #svc_acct / svc_domain
4269                           },
4270                         ],
4271     },
4272
4273     'cgp_rule_condition' => {
4274       'columns' => [
4275         'ruleconditionnum',  'serial',     '',      '', '', '',
4276         'conditionname',    'varchar',     '', $char_d, '', '',
4277         'op',               'varchar', 'NULL', $char_d, '', '',
4278         'params',           'varchar', 'NULL',     255, '', '',
4279         'rulenum',              'int',     '',      '', '', '',
4280       ],
4281       'primary_key'  => 'ruleconditionnum',
4282       'unique'       => [],
4283       'index'        => [ [ 'rulenum' ] ],
4284       'foreign_keys' => [
4285                           { columns    => [ 'rulenum' ],
4286                             table      => 'cgp_rule',
4287                           },
4288                         ],
4289     },
4290
4291     'cgp_rule_action' => {
4292        'columns' => [
4293         'ruleactionnum',  'serial',     '',      '', '', '',
4294         'action',        'varchar',     '', $char_d, '', '',
4295         'params',        'varchar', 'NULL',     255, '', '',
4296         'rulenum',           'int',     '',      '', '', '',
4297       ],
4298       'primary_key'  => 'ruleactionnum',
4299       'unique'       => [],
4300       'index'        => [ [ 'rulenum' ] ],
4301       'foreign_keys' => [
4302                           { columns    => [ 'rulenum' ],
4303                             table      => 'cgp_rule',
4304                           },
4305                         ],
4306    },
4307
4308     'svc_forward' => {
4309       'columns' => [
4310         'svcnum',   'int',            '',   '', '', '',
4311         'srcsvc',   'int',        'NULL',   '', '', '',
4312         'src',      'varchar',    'NULL',  255, '', '',
4313         'dstsvc',   'int',        'NULL',   '', '', '',
4314         'dst',      'varchar',    'NULL',  255, '', '',
4315       ],
4316       'primary_key'  => 'svcnum',
4317       'unique'       => [],
4318       'index'        => [ ['srcsvc'], ['dstsvc'] ],
4319       'foreign_keys' => [
4320                           { columns    => [ 'svcnum' ],
4321                             table      => 'cust_svc',
4322                           },
4323                           { columns    => [ 'srcsvc' ],
4324                             table      => 'svc_acct',
4325                             references => [ 'svcnum' ]
4326                           },
4327                           { columns    => [ 'dstsvc' ],
4328                             table      => 'svc_acct',
4329                             references => [ 'svcnum' ]
4330                           },
4331                         ],
4332     },
4333
4334     'svc_www' => {
4335       'columns' => [
4336         'svcnum',   'int',      '',  '', '', '',
4337         'recnum',   'int',      '',  '', '', '',
4338         'usersvc',  'int',  'NULL',  '', '', '',
4339         'config',   'text', 'NULL',  '', '', '',
4340       ],
4341       'primary_key' => 'svcnum',
4342       'unique'      => [],
4343       'index'       => [],
4344       'foreign_keys' => [
4345                           { columns    => [ 'svcnum' ],
4346                             table      => 'cust_svc',
4347                           },
4348                           { columns    => [ 'recnum' ],
4349                             table      => 'domain_record',
4350                           },
4351                           { columns    => [ 'usersvc' ],
4352                             table      => 'svc_acct',
4353                             references => [ 'svcnum' ]
4354                           },
4355                         ],
4356     },
4357
4358     #'svc_wo' => {
4359     #  'columns' => [
4360     #    'svcnum',    'int',    '',   '',
4361     #    'svcnum',    'int',    '',   '',
4362     #    'svcnum',    'int',    '',   '',
4363     #    'worker',    'varchar',   '',   $char_d,
4364     #    '_date',     @date_type,
4365     #  ],
4366     #  'primary_key' => 'svcnum',
4367     #  'unique' => [ [] ],
4368     #  'index' => [ [] ],
4369     #},
4370
4371     'prepay_credit' => {
4372       'columns' => [
4373         'prepaynum',   'serial',     '',   '', '', '',
4374         'identifier',  'varchar', '', $char_d, '', '',
4375         'amount',      @money_type, '', '',
4376         'seconds',     'int',     'NULL', '', '', '',
4377         'upbytes',     'bigint',     'NULL', '', '', '',
4378         'downbytes',   'bigint',     'NULL', '', '', '',
4379         'totalbytes',  'bigint',     'NULL', '', '', '',
4380         'agentnum',    'int',     'NULL', '', '', '',
4381       ],
4382       'primary_key'  => 'prepaynum',
4383       'unique'       => [ ['identifier'] ],
4384       'index'        => [ ['agentnum'] ],
4385       'foreign_keys' => [
4386                           { columns    => [ 'agentnum' ],
4387                             table      => 'agent',
4388                           },
4389                         ],
4390     },
4391
4392     'port' => {
4393       'columns' => [
4394         'portnum',  'serial',     '',   '', '', '',
4395         'ip',       'varchar', 'NULL', 15, '', '',
4396         'nasport',  'int',     'NULL', '', '', '',
4397         'nasnum',   'int',     '',   '', '', '',
4398       ],
4399       'primary_key'  => 'portnum',
4400       'unique'       => [],
4401       'index'        => [],
4402       'foreign_keys' => [
4403                           { columns    => [ 'nasnum' ],
4404                             table      => 'nas',
4405                           },
4406                         ],
4407     },
4408
4409     'nas' => {
4410       'columns' => [
4411         'nasnum',       'serial',     '',  '',              '', '',
4412         'nasname',     'varchar',     '', 128,              '', '',
4413         'shortname',   'varchar', 'NULL',  32,              '', '',
4414         'type',        'varchar',     '',  30,         'other', '',
4415         'ports',           'int', 'NULL',  '',              '', '',
4416         'secret',      'varchar',     '',  60,        'secret', '',
4417         'server',      'varchar', 'NULL',  64,              '', '',
4418         'community',   'varchar', 'NULL',  50,              '', '',
4419         'description', 'varchar',     '', 200, 'RADIUS Client', '',
4420         'svcnum',          'int', 'NULL',  '',              '', '',
4421       ],
4422       'primary_key'  => 'nasnum',
4423       'unique'       => [ [ 'nasname' ], ],
4424       'index'        => [],
4425       'foreign_keys' => [
4426                           { columns    => [ 'svcnum' ],
4427                             table      => 'svc_broadband',#no? could be _acct?
4428                                                           #remove or cust_svc?
4429                           },
4430                         ],
4431     },
4432
4433     'export_nas' => {
4434       'columns' => [
4435         'exportnasnum', 'serial', '', '', '', '',
4436         'exportnum',       'int', '', '', '', '',
4437         'nasnum',          'int', '', '', '', '',
4438       ],
4439       'primary_key'  => 'exportnasnum',
4440       'unique'       => [ [ 'exportnum', 'nasnum' ] ],
4441       'index'        => [ [ 'exportnum' ], [ 'nasnum' ] ],
4442       'foreign_keys' => [
4443                           { columns    => [ 'exportnum' ],
4444                             table      => 'part_export',
4445                           },
4446                           { columns    => [ 'nasnum' ],
4447                             table      => 'nas',
4448                           },
4449                         ],
4450     },
4451
4452     'queue' => {
4453       'columns' => [
4454         'jobnum',   'bigserial',     '',      '', '', '',
4455         'job',        'varchar',     '',     512, '', '',
4456         '_date',          'int',     '',      '', '', '',
4457         'status',     'varchar',     '', $char_d, '', '',
4458         'statustext',    'text', 'NULL',      '', '', '',
4459         'svcnum',         'int', 'NULL',      '', '', '',
4460         'custnum',        'int', 'NULL',      '', '', '',
4461         'secure',        'char', 'NULL',       1, '', '',
4462         'priority',       'int', 'NULL',      '', '', '',
4463         'usernum',        'int', 'NULL',      '', '', '',
4464       ],
4465       'primary_key'  => 'jobnum',
4466       'unique'       => [],
4467       'index'        => [ [ 'secure' ], [ 'priority' ],
4468                           [ 'job' ], [ 'svcnum' ], [ 'custnum' ], [ 'status' ],
4469                         ],
4470       'foreign_keys' => [
4471 #                          { columns    => [ 'svcnum' ],
4472 #                            table      => 'cust_svc',
4473 #                          },
4474                           { columns    => [ 'custnum' ],
4475                             table      => 'cust_main',
4476                           },
4477                           { columns    => [ 'usernum' ],
4478                             table      => 'access_user',
4479                           },
4480                         ],
4481     },
4482
4483     'queue_arg' => {
4484       'columns' => [
4485         'argnum', 'bigserial',     '', '', '', '',
4486         'jobnum',    'bigint',     '', '', '', '',
4487         'frozen',      'char', 'NULL',  1, '', '',
4488         'arg',         'text', 'NULL', '', '', '',
4489       ],
4490       'primary_key'  => 'argnum',
4491       'unique'       => [],
4492       'index'        => [ [ 'jobnum' ] ],
4493       'foreign_keys' => [
4494                           { columns    => [ 'jobnum' ],
4495                             table      => 'queue',
4496                             on_delete  => 'CASCADE',
4497                           },
4498                         ],
4499     },
4500
4501     'queue_depend' => {
4502       'columns' => [
4503         'dependnum',  'bigserial', '', '', '', '',
4504         'jobnum',        'bigint', '', '', '', '',
4505         'depend_jobnum', 'bigint', '', '', '', '',
4506       ],
4507       'primary_key'  => 'dependnum',
4508       'unique'       => [],
4509       'index'        => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
4510       'foreign_keys' => [
4511                           { columns    => [ 'jobnum' ],
4512                             table      => 'queue',
4513                           },
4514                           { columns    => [ 'depend_jobnum' ],
4515                             table      => 'queue',
4516                             references => [ 'jobnum' ],
4517                             on_delete  => 'CASCADE',
4518                           },
4519                         ],
4520     },
4521
4522     'queue_stat' => {
4523       'columns' => [
4524         'statnum', 'bigserial',     '',  '', '', '',
4525         'jobnum',     'bigint',     '',  '', '', '',
4526         'job',       'varchar',     '', 512, '', '',
4527         'custnum',       'int', 'NULL',  '', '', '',
4528         'insert_date', @date_type, '', '',
4529         'start_date',  @date_type, '', '',
4530         'end_date',    @date_type, '', '',
4531       ],
4532       'primary_key'  => 'statnum',
4533       'unique'       => [], #[ ['jobnum'] ],
4534       'index'        => [],
4535     },
4536
4537     'export_svc' => {
4538       'columns' => [
4539         'exportsvcnum' => 'serial', '', '', '', '',
4540         'exportnum'    => 'int', '', '', '', '',
4541         'svcpart'      => 'int', '', '', '', '',
4542         'role'         => 'varchar', 'NULL', 16, '', '',
4543       ],
4544       'primary_key'  => 'exportsvcnum',
4545       'unique'       => [ [ 'exportnum', 'svcpart' ] ],
4546       'index'        => [ [ 'exportnum' ], [ 'svcpart' ] ],
4547       'foreign_keys' => [
4548                           { columns    => [ 'exportnum' ],
4549                             table      => 'part_export',
4550                           },
4551                           { columns    => [ 'svcpart' ],
4552                             table      => 'part_svc',
4553                           },
4554                         ],
4555     },
4556
4557     'export_cust_svc' => {
4558       'columns' => [
4559         'exportcustsvcnum', 'serial', '', '', '', '',
4560         'exportnum', 'int', '', '', '', '',
4561         'svcnum', 'int', '', '', '', '',
4562         'remoteid', 'varchar', '', 512, '', '',
4563       ],
4564       'primary_key'  => 'exportcustsvcnum',
4565       'unique'       => [ [ 'exportnum', 'svcnum' ] ],
4566       'index'        => [ [ 'exportnum', 'svcnum' ] ],
4567       'foreign_keys' => [
4568                           { columns    => [ 'exportnum' ],
4569                             table      => 'part_export',
4570                           },
4571                           { columns    => [ 'svcnum' ],
4572                             table      => 'cust_svc',
4573                           },
4574                         ],
4575     },
4576
4577     'export_device' => {
4578       'columns' => [
4579         'exportdevicenum' => 'serial', '', '', '', '',
4580         'exportnum'       => 'int', '', '', '', '',
4581         'devicepart'      => 'int', '', '', '', '',
4582       ],
4583       'primary_key'  => 'exportdevicenum',
4584       'unique'       => [ [ 'exportnum', 'devicepart' ] ],
4585       'index'        => [ [ 'exportnum' ], [ 'devicepart' ] ],
4586       'foreign_keys' => [
4587                           { columns    => [ 'exportnum' ],
4588                             table      => 'part_export',
4589                           },
4590                           { columns    => [ 'devicepart' ],
4591                             table      => 'part_device',
4592                           },
4593                         ],
4594     },
4595
4596     'part_export' => {
4597       'columns' => [
4598         'exportnum',   'serial',     '',      '', '', '',
4599         'exportname', 'varchar', 'NULL', $char_d, '', '',
4600         'machine',    'varchar', 'NULL', $char_d, '', '',
4601         'exporttype', 'varchar',     '', $char_d, '', '',
4602         'nodomain',      'char', 'NULL',       1, '', '',
4603         'default_machine','int', 'NULL',      '', '', '',
4604         'no_suspend',    'char', 'NULL',       1, '', '',
4605         # could also have 'no_insert', 'no_replace', etc.
4606       ],
4607       'primary_key'  => 'exportnum',
4608       'unique'       => [],
4609       'index'        => [ [ 'machine' ], [ 'exporttype' ] ],
4610       'foreign_keys' => [
4611                           { columns    => [ 'default_machine' ],
4612                             table      => 'part_export_machine',
4613                             references => [ 'machinenum' ]
4614                           },
4615                         ],
4616     },
4617
4618     'part_export_option' => {
4619       'columns' => [
4620         'optionnum', 'serial', '', '', '', '',
4621         'exportnum', 'int', '', '', '', '',
4622         'optionname', 'varchar', '', $char_d, '', '',
4623         'optionvalue', 'text', 'NULL', '', '', '',
4624       ],
4625       'primary_key'  => 'optionnum',
4626       'unique'       => [],
4627       'index'        => [ [ 'exportnum' ], [ 'optionname' ] ],
4628       'foreign_keys' => [
4629                           { columns    => [ 'exportnum' ],
4630                             table      => 'part_export',
4631                           },
4632                         ],
4633     },
4634
4635     'radius_usergroup' => {
4636       'columns' => [
4637         'usergroupnum', 'serial', '', '', '', '',
4638         'svcnum',       'int', '', '', '', '',
4639         'groupname',    'varchar', 'NULL', $char_d, '', '', #deprecated
4640         'groupnum',     'int', 'NULL', '', '', '',
4641       ],
4642       'primary_key'  => 'usergroupnum',
4643       'unique'       => [],
4644       'index'        => [ [ 'svcnum' ], [ 'groupname' ] ],
4645       'foreign_keys' => [
4646                           { columns    => [ 'svcnum' ],
4647                             table      => 'cust_svc', #svc_acct / svc_broadband
4648                           },
4649                           { columns    => [ 'groupnum' ],
4650                             table      => 'radius_group',
4651                           },
4652                         ],
4653     },
4654
4655     'radius_group' => {
4656       'columns' => [
4657         'groupnum', 'serial', '', '', '', '',
4658         'groupname',    'varchar', '', $char_d, '', '',
4659         'description',  'varchar', 'NULL', $char_d, '', '',
4660         'priority', 'int', '', '', '1', '',
4661         'speed_up', 'int', 'NULL', '', '', '',
4662         'speed_down', 'int', 'NULL', '', '', '',
4663       ],
4664       'primary_key' => 'groupnum',
4665       'unique'      => [ ['groupname'] ],
4666       'index'       => [],
4667     },
4668
4669     'radius_attr' => {
4670       'columns' => [
4671         'attrnum',   'serial', '',      '', '', '',
4672         'groupnum',     'int', '',      '', '', '',
4673         'attrname', 'varchar', '', $char_d, '', '',
4674         'value',    'varchar', '',     255, '', '',
4675         'attrtype',    'char', '',       1, '', '',
4676         'op',          'char', '',       2, '', '',
4677       ],
4678       'primary_key'  => 'attrnum',
4679       'unique'       => [],
4680       'index'        => [ ['groupnum'], ],
4681       'foreign_keys' => [
4682                           { columns    => [ 'groupnum' ],
4683                             table      => 'radius_group',
4684                           },
4685                         ],
4686     },
4687
4688     'msgcat' => {
4689       'columns' => [
4690         'msgnum', 'serial', '', '', '', '',
4691         'msgcode', 'varchar', '', 255, '', '',
4692         'locale', 'varchar', '', 16, '', '',
4693         'msg', 'text', '', '', '', '',
4694       ],
4695       'primary_key' => 'msgnum',
4696       'unique'      => [ [ 'msgcode', 'locale' ] ],
4697       'index'       => [],
4698     },
4699
4700     'cust_tax_exempt' => {
4701       'columns' => [
4702         'exemptnum', 'serial', '', '', '', '',
4703         'custnum',   'int', '', '', '', '',
4704         'taxnum',    'int', '', '', '', '',
4705         'year',      'int', '', '', '', '',
4706         'month',     'int', '', '', '', '',
4707         'amount',   @money_type, '', '',
4708       ],
4709       'primary_key'  => 'exemptnum',
4710       'unique'       => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
4711       'index'        => [],
4712       'foreign_keys' => [
4713                           { columns    => [ 'custnum' ],
4714                             table      => 'cust_main',
4715                           },
4716                           { columns    => [ 'taxnum' ],
4717                             table      => 'cust_main_county',
4718                           },
4719                         ],
4720     },
4721
4722     'cust_tax_exempt_pkg' => {
4723       'columns' => [
4724         'exemptpkgnum',  'serial', '', '', '', '',
4725         #'custnum',      'int', '', '', '', ''
4726         'billpkgnum',   'int', '', '', '', '',
4727         'taxnum',       'int', '', '', '', '',
4728         'taxtype',  'varchar', 'NULL', $char_d, '', '',
4729         'year',         'int', 'NULL', '', '', '',
4730         'month',        'int', 'NULL', '', '', '',
4731         'creditbillpkgnum', 'int', 'NULL', '', '', '',
4732         'amount',       @money_type, '', '',
4733         # exemption type flags
4734         'exempt_cust',          'char', 'NULL', 1, '', '',
4735         'exempt_setup',         'char', 'NULL', 1, '', '',
4736         'exempt_recur',         'char', 'NULL', 1, '', '',
4737         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
4738         'exempt_monthly',       'char', 'NULL', 1, '', '',
4739       ],
4740       'primary_key'  => 'exemptpkgnum',
4741       'unique'       => [],
4742       'index'        => [ [ 'taxnum', 'year', 'month' ],
4743                           [ 'billpkgnum' ],
4744                           [ 'taxnum', 'taxtype' ],
4745                           [ 'creditbillpkgnum' ],
4746                         ],
4747       'foreign_keys' => [
4748                           { columns    => [ 'billpkgnum' ],
4749                             table      => 'cust_bill_pkg',
4750                           },
4751                           { columns    => [ 'creditbillpkgnum' ],
4752                             table      => 'cust_credit_bill_pkg',
4753                           },
4754                         ],
4755     },
4756
4757     'cust_tax_exempt_pkg_void' => {
4758       'columns' => [
4759         'exemptpkgnum',  'int', '', '', '', '',
4760         #'custnum',      'int', '', '', '', ''
4761         'billpkgnum',   'int', '', '', '', '',
4762         'taxnum',       'int', '', '', '', '',
4763         'taxtype',  'varchar', 'NULL', $char_d, '', '',
4764         'year',         'int', 'NULL', '', '', '',
4765         'month',        'int', 'NULL', '', '', '',
4766         'creditbillpkgnum', 'int', 'NULL', '', '', '',
4767         'amount',       @money_type, '', '',
4768         # exemption type flags
4769         'exempt_cust',          'char', 'NULL', 1, '', '',
4770         'exempt_setup',         'char', 'NULL', 1, '', '',
4771         'exempt_recur',         'char', 'NULL', 1, '', '',
4772         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
4773         'exempt_monthly',       'char', 'NULL', 1, '', '',
4774       ],
4775       'primary_key'  => 'exemptpkgnum',
4776       'unique'       => [],
4777       'index'        => [ [ 'taxnum', 'year', 'month' ],
4778                           [ 'billpkgnum' ],
4779                           [ 'taxnum', 'taxtype' ],
4780                           [ 'creditbillpkgnum' ],
4781                         ],
4782       'foreign_keys' => [
4783                           { columns    => [ 'billpkgnum' ],
4784                             table      => 'cust_bill_pkg_void',
4785                           },
4786                           { columns    => [ 'taxnum' ],
4787                             table      => 'cust_main_county',
4788                           },
4789                           { columns    => [ 'creditbillpkgnum' ],
4790                             table      => 'cust_credit_bill_pkg',
4791                           },
4792                         ],
4793     },
4794
4795     'router' => {
4796       'columns' => [
4797         'routernum', 'serial', '', '', '', '',
4798         'routername', 'varchar', '', $char_d, '', '',
4799         'svcnum', 'int', 'NULL', '', '', '',
4800         'agentnum',   'int', 'NULL', '', '', '',
4801         'manual_addr', 'char', 'NULL', 1, '', '',
4802       ],
4803       'primary_key'  => 'routernum',
4804       'unique'       => [],
4805       'index'        => [],
4806       'foreign_keys' => [
4807                           { columns    => [ 'svcnum' ],
4808                             table      => 'cust_svc', #svc_acct / svc_broadband
4809                           },
4810                           { columns    => [ 'agentnum' ],
4811                             table      => 'agent',
4812                           },
4813                         ],
4814     },
4815
4816     'part_svc_router' => {
4817       'columns' => [
4818         'svcrouternum', 'serial', '', '', '', '',
4819         'svcpart', 'int', '', '', '', '',
4820         'routernum', 'int', '', '', '', '',
4821       ],
4822       'primary_key'  => 'svcrouternum',
4823       'unique'       => [],
4824       'index'        => [],
4825       'foreign_keys' => [
4826                           { columns    => [ 'svcpart' ],
4827                             table      => 'part_svc',
4828                           },
4829                           { columns    => [ 'routernum' ],
4830                             table      => 'router',
4831                           },
4832                         ],
4833     },
4834
4835     'addr_block' => {
4836       'columns' => [
4837         'blocknum', 'serial', '', '', '', '',
4838         'routernum', 'int', '', '', '', '',
4839         'ip_gateway', 'varchar', '', 15, '', '',
4840         'ip_netmask', 'int', '', '', '', '',
4841         'agentnum',   'int', 'NULL', '', '', '',
4842         'manual_flag', 'char', 'NULL', 1, '', '',
4843       ],
4844       'primary_key'  => 'blocknum',
4845       'unique'       => [ [ 'blocknum', 'routernum' ] ],
4846       'index'        => [],
4847       'foreign_keys' => [
4848                           #{ columns    => [ 'routernum' ],
4849                           #   table      => 'router',
4850                           #},
4851                           { columns    => [ 'agentnum' ],
4852                             table      => 'agent',
4853                           },
4854                         ],
4855     },
4856
4857     'addr_range' => {
4858       'columns' => [
4859         'rangenum', 'serial', '', '', '', '',
4860         'start',    'varchar', '', 15, '', '',
4861         'length',   'int', '', '', '', '',
4862         'status',   'varchar', 'NULL', 32, '', '',
4863       ],
4864       'primary_key' => 'rangenum',
4865       'unique'      => [],
4866       'index'       => [],
4867     },
4868
4869     'svc_broadband' => {
4870       'columns' => [
4871         'svcnum',                  'int',     '',        '', '', '',
4872         'description',         'varchar', 'NULL',   $char_d, '', '',
4873         'routernum',               'int', 'NULL',        '', '', '',
4874         'blocknum',                'int', 'NULL',        '', '', '',
4875         'sectornum',               'int', 'NULL',        '', '', '',
4876         'speed_up',                'int', 'NULL',        '', '', '',
4877         'speed_down',              'int', 'NULL',        '', '', '',
4878         'ip_addr',             'varchar', 'NULL',        15, '', '',
4879         'mac_addr',            'varchar', 'NULL',        12, '', '',
4880         'authkey',             'varchar', 'NULL',        32, '', '',
4881         'latitude',            'decimal', 'NULL',    '10,7', '', '',
4882         'longitude',           'decimal', 'NULL',    '10,7', '', '',
4883         'altitude',            'decimal', 'NULL',        '', '', '',
4884         'vlan_profile',        'varchar', 'NULL',   $char_d, '', '',
4885         'performance_profile', 'varchar', 'NULL',   $char_d, '', '',
4886         'plan_id',             'varchar', 'NULL',   $char_d, '', '',
4887         'radio_serialnum',     'varchar', 'NULL',   $char_d, '', '',
4888         'radio_location',      'varchar', 'NULL', 2*$char_d, '', '',
4889         'poe_location',        'varchar', 'NULL', 2*$char_d, '', '',
4890         'rssi',                    'int', 'NULL',        '', '', '',
4891         'suid',                    'int', 'NULL',        '', '', '',
4892         'shared_svcnum',           'int', 'NULL',        '', '', '',
4893         'serviceid',           'varchar', 'NULL',        64, '', '',#srvexport/reportfields
4894       ],
4895       'primary_key'  => 'svcnum',
4896       'unique'       => [ [ 'ip_addr' ], [ 'mac_addr' ] ],
4897       'index'        => [],
4898       'foreign_keys' => [
4899                           { columns    => [ 'svcnum' ],
4900                             table      => 'cust_svc',
4901                           },
4902                           { columns    => [ 'routernum' ],
4903                             table      => 'router',
4904                           },
4905                           { columns    => [ 'blocknum' ],
4906                             table      => 'addr_block',
4907                           },
4908                           { columns    => [ 'sectornum' ],
4909                             table      => 'tower_sector',
4910                           },
4911                           { columns    => [ 'shared_svcnum' ],
4912                             table      => 'svc_broadband',
4913                             references => [ 'svcnum' ],
4914                           },
4915                         ],
4916     },
4917
4918     'tower' => {
4919       'columns' => [
4920         'towernum',    'serial',     '',      '', '', '',
4921         #'agentnum',       'int', 'NULL',      '', '', '',
4922         'towername',  'varchar',     '', $char_d, '', '',
4923         'disabled',      'char', 'NULL',       1, '', '',
4924         'latitude',   'decimal', 'NULL',  '10,7', '', '',
4925         'longitude',  'decimal', 'NULL',  '10,7', '', '',
4926         'coord_auto',    'char', 'NULL',       1, '', '',
4927         'altitude',   'decimal', 'NULL',      '', '', '',
4928         'height',     'decimal', 'NULL',      '', '', '',
4929         'veg_height', 'decimal', 'NULL',      '', '', '',
4930         'color',      'varchar', 'NULL',       6, '', '',
4931         'up_rate_limit',        'int', 'NULL',      '', '', '',
4932         'down_rate_limit',      'int', 'NULL',      '', '', '',
4933       ],
4934       'primary_key' => 'towernum',
4935       'unique'      => [ [ 'towername' ] ], # , 'agentnum' ] ],
4936       'index'       => [],
4937     },
4938
4939     'tower_sector' => {
4940       'columns' => [
4941         'sectornum',     'serial',     '',      '', '', '',
4942         'towernum',         'int',     '',      '', '', '',
4943         'sectorname',   'varchar',     '', $char_d, '', '',
4944         'ip_addr',      'varchar', 'NULL',      15, '', '',
4945         'height',       'decimal', 'NULL',      '', '', '',
4946         'freq_mhz',         'int', 'NULL',      '', '', '',
4947         'direction',        'int', 'NULL',      '', '', '',
4948         'width',            'int', 'NULL',      '', '', '',
4949         'sector_range', 'decimal', 'NULL',      '', '', '',  #?
4950         'downtilt',     'decimal', 'NULL',      '', '', '',
4951         'v_width',          'int', 'NULL',      '', '', '',
4952         'power',        'decimal', 'NULL',      '', '', '',
4953         'line_loss',    'decimal', 'NULL',      '', '', '',
4954         'antenna_gain', 'decimal', 'NULL',     '', '', '',
4955         'hardware_typenum', 'int', 'NULL',     '', '', '',
4956         'db_high',          'int', 'NULL',     '', '', '',
4957         'db_low',           'int', 'NULL',     '', '', '',
4958         'image',           'blob', 'NULL',     '', '', '',
4959         'west',         'decimal', 'NULL', '10,7', '', '',
4960         'east',         'decimal', 'NULL', '10,7', '', '',
4961         'south',        'decimal', 'NULL', '10,7', '', '',
4962         'north',        'decimal', 'NULL', '10,7', '', '',
4963         'title',        'varchar', 'NULL', $char_d,'', '',
4964         'up_rate_limit',          'int', 'NULL',      '', '', '',
4965         'down_rate_limit',        'int', 'NULL',      '', '', '',
4966      ],
4967       'primary_key'  => 'sectornum',
4968       'unique'       => [ [ 'towernum', 'sectorname' ], [ 'ip_addr' ], ],
4969       'index'        => [ [ 'towernum' ] ],
4970       'foreign_keys' => [
4971                           { columns    => [ 'towernum' ],
4972                             table      => 'tower',
4973                           },
4974                           { columns    => [ 'hardware_typenum' ],
4975                             table      => 'hardware_type',
4976                             references => [ 'typenum' ],
4977                           },
4978                         ],
4979     },
4980
4981     'sector_coverage' => {
4982       'columns' => [
4983         'coveragenum', 'serial', '', '', '', '',
4984         'sectornum',     'int', '', '', '', '',
4985         'db_loss',       'int', '', '', '', '',
4986         'geometry',     'text', 'NULL', '', '', '',
4987       ],
4988       'primary_key' => 'coveragenum',
4989       'unique' => [],
4990       'index'  => [],
4991       'foreign_keys' => [
4992                           { columns => [ 'sectornum' ],
4993                             table   => 'tower_sector'
4994                           },
4995                         ],
4996     },
4997
4998     'part_virtual_field' => {
4999       'columns' => [
5000         'vfieldpart', 'serial', '', '', '', '',
5001         'dbtable', 'varchar', '', 32, '', '',
5002         'name', 'varchar', '', 32, '', '',
5003         'length', 'int', 'NULL', '', '', '',
5004         'label', 'varchar', 'NULL', 80, '', '',
5005       ],
5006       'primary_key' => 'vfieldpart',
5007       'unique' => [],
5008       'index' => [],
5009     },
5010
5011     'virtual_field' => {
5012       'columns' => [
5013         'vfieldnum', 'serial', '', '', '', '',
5014         'recnum', 'int', '', '', '', '',
5015         'vfieldpart', 'int', '', '', '', '',
5016         'value', 'varchar', '', 128, '', '',
5017       ],
5018       'primary_key'  => 'vfieldnum',
5019       'unique'       => [ [ 'vfieldpart', 'recnum' ] ],
5020       'index'        => [],
5021       'foreign_keys' => [
5022                           { columns    => [ 'vfieldpart' ],
5023                             table      => 'part_virtual_field',
5024                           },
5025                         ],
5026     },
5027
5028     'acct_snarf' => {
5029       'columns' => [
5030         'snarfnum',    'serial',     '',      '', '', '',
5031         'snarfname',  'varchar', 'NULL', $char_d, '', '',
5032         'svcnum',         'int',     '',      '', '', '',
5033         'machine',    'varchar',     '',     255, '', '',
5034         'protocol',   'varchar',     '', $char_d, '', '',
5035         'username',   'varchar',     '', $char_d, '', '',
5036         '_password',  'varchar',     '', $char_d, '', '',
5037         'check_freq',     'int', 'NULL',      '', '', '',
5038         'leavemail',     'char', 'NULL',       1, '', '',
5039         'apop',          'char', 'NULL',       1, '', '',
5040         'tls',           'char', 'NULL',       1, '', '',
5041         'mailbox',    'varchar', 'NULL', $char_d, '', '',
5042       ],
5043       'primary_key'  => 'snarfnum',
5044       'unique'       => [],
5045       'index'        => [ [ 'svcnum' ] ],
5046       'foreign_keys' => [
5047                           { columns    => [ 'svcnum' ],
5048                             table      => 'svc_acct',
5049                           },
5050                         ],
5051     },
5052
5053     'svc_external' => {
5054       'columns' => [
5055         'svcnum',     'int',     '',      '', '', '',
5056         'id',      'bigint', 'NULL',      '', '', '',
5057         'title',  'varchar', 'NULL', $char_d, '', '',
5058       ],
5059       'primary_key'  => 'svcnum',
5060       'unique'       => [],
5061       'index'        => [],
5062       'foreign_keys' => [
5063                           { columns    => [ 'svcnum' ],
5064                             table      => 'cust_svc',
5065                           },
5066                         ],
5067     },
5068
5069     'cust_pay_refund' => {
5070       'columns' => [
5071         'payrefundnum', 'serial', '', '', '', '',
5072         'paynum',  'int', '', '', '', '',
5073         'refundnum',  'int', '', '', '', '',
5074         '_date',    @date_type, '', '',
5075         'amount',   @money_type, '', '',
5076       ],
5077       'primary_key'  => 'payrefundnum',
5078       'unique'       => [],
5079       'index'        => [ ['paynum'], ['refundnum'] ],
5080       'foreign_keys' => [
5081                           { columns    => [ 'paynum' ],
5082                             table      => 'cust_pay',
5083                           },
5084                           { columns    => [ 'refundnum' ],
5085                             table      => 'cust_refund',
5086                           },
5087                         ],
5088     },
5089
5090     'part_pkg_option' => {
5091       'columns' => [
5092         'optionnum', 'serial', '', '', '', '',
5093         'pkgpart', 'int', '', '', '', '',
5094         'optionname', 'varchar', '', $char_d, '', '',
5095         'optionvalue', 'text', 'NULL', '', '', '',
5096       ],
5097       'primary_key'  => 'optionnum',
5098       'unique'       => [],
5099       'index'        => [ [ 'pkgpart' ], [ 'optionname' ] ],
5100       'foreign_keys' => [
5101                           { columns    => [ 'pkgpart' ],
5102                             table      => 'part_pkg',
5103                           },
5104                         ],
5105     },
5106
5107     'part_pkg_vendor' => {
5108       'columns' => [
5109         'num', 'serial', '', '', '', '',
5110         'pkgpart', 'int', '', '', '', '',
5111         'exportnum', 'int', '', '', '', '',
5112         'vendor_pkg_id', 'varchar', '', $char_d, '', '',
5113       ],
5114       'primary_key'  => 'num',
5115       'unique'       => [ [ 'pkgpart', 'exportnum' ] ],
5116       'index'        => [ [ 'pkgpart' ] ],
5117       'foreign_keys' => [
5118                           { columns    => [ 'pkgpart' ],
5119                             table      => 'part_pkg',
5120                           },
5121                           { columns    => [ 'exportnum' ],
5122                             table      => 'part_export',
5123                           },
5124                         ],
5125     },
5126
5127     'part_pkg_report_option' => {
5128       'columns' => [
5129         'num',      'serial',   '',      '', '', '',
5130         'name',     'varchar',  '', $char_d, '', '',
5131         'disabled', 'char', 'NULL',       1, '', '',
5132       ],
5133       'primary_key' => 'num',
5134       'unique' => [ [ 'name' ] ],
5135       'index' => [ [ 'disabled' ] ],
5136     },
5137
5138     'part_pkg_usage' => {
5139       'columns' => [
5140         'pkgusagepart', 'serial',   '', '', '', '',
5141         'pkgpart',  'int',      '', '', '', '',
5142         'minutes',  'double precision',      '', '', '', '',
5143         'priority', 'int',  'NULL', '', '', '',
5144         'shared',   'char', 'NULL',  1, '', '',
5145         'rollover', 'char', 'NULL',  1, '', '',
5146         'description',  'varchar', 'NULL', $char_d, '', '',
5147       ],
5148       'primary_key'  => 'pkgusagepart',
5149       'unique'       => [],
5150       'index'        => [ [ 'pkgpart' ] ],
5151       'foreign_keys' => [
5152                           { columns    => [ 'pkgpart' ],
5153                             table      => 'part_pkg',
5154                           },
5155                         ],
5156     },
5157
5158     'part_pkg_usage_class' => {
5159       'columns' => [
5160         'num',       'serial',  '', '', '', '',
5161         'pkgusagepart', 'int',  '', '', '', '',
5162         'classnum',     'int','NULL', '', '', '',
5163       ],
5164       'primary_key'  => 'num',
5165       'unique'       => [ [ 'pkgusagepart', 'classnum' ] ],
5166       'index'        => [],
5167       'foreign_keys' => [
5168                           { columns    => [ 'pkgusagepart' ],
5169                             table      => 'part_pkg_usage',
5170                           },
5171                           { columns    => [ 'classnum' ],
5172                             table      => 'usage_class',
5173                           },
5174                         ],
5175     },
5176
5177     'part_pkg_fcc_option' => {
5178       'columns' => [
5179         'num',        'serial', '', '', '', '',
5180         'fccoptionname', 'varchar', '', $char_d, '', '',
5181         'pkgpart',       'int', '', '', '', '',
5182         'optionvalue',   'varchar', 'NULL', $char_d, '', '',
5183       ],
5184       'primary_key' => 'num',
5185       'unique'      => [ [ 'fccoptionname', 'pkgpart' ] ],
5186       'index'       => [],
5187     },
5188
5189     'rate' => {
5190       'columns' => [
5191         'ratenum',          'serial',     '', '', '', '',
5192         'ratename',        'varchar', '',$char_d, '', '',
5193         'agentnum',            'int', 'NULL', '', '', '',
5194         'default_detailnum',   'int', 'NULL', '', '', '',
5195       ],
5196       'primary_key' => 'ratenum',
5197       'unique'      => [],
5198       'index'       => [],
5199       'foreign_keys' => [
5200                           { columns    => [ 'agentnum' ],
5201                             table      => 'agent',
5202                           },
5203                         ],
5204     },
5205
5206     'rate_detail' => {
5207       'columns' => [
5208         'ratedetailnum',   'serial',  '',     '',      '', '',
5209         'ratenum',         'int',     '',     '',      '', '',
5210         'orig_regionnum',  'int', 'NULL',     '',      '', '',
5211         'dest_regionnum',  'int', 'NULL',     '',      '', '',
5212         'min_included',    'int',     '',     '',      '', '',
5213         'conn_charge',     'decimal', '', '10,4', '0.0000', '',
5214         'conn_cost',       'decimal', '', '10,4', '0.0000', '',
5215         'conn_sec',        'int',     '',     '',      '0', '',
5216         'min_charge',      'decimal', '', '10,5',       '', '',
5217         'min_cost',        'decimal', '', '10,5','0.00000', '',
5218         'sec_granularity', 'int',     '',     '',       '', '',
5219         'ratetimenum',     'int', 'NULL',     '',       '', '',
5220         'classnum',        'int', 'NULL',     '',       '', '',
5221         'cdrtypenum',      'int', 'NULL',     '',       '', '',
5222         'region_group',   'char', 'NULL',      1,       '', '',
5223         'upstream_mult_charge',  'decimal',  '', '10,4', '0.0000', '',
5224         'upstream_mult_cost',    'decimal',  '', '10,4', '0.0000', '',
5225       ],
5226       'primary_key'  => 'ratedetailnum',
5227       'unique'       => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
5228       'index'        => [ [ 'ratenum', 'dest_regionnum' ],
5229                           [ 'ratenum', 'ratetimenum' ]
5230                         ],
5231       'foreign_keys' => [
5232                           { columns    => [ 'ratenum' ],
5233                             table      => 'rate',
5234                           },
5235                           { columns    => [ 'orig_regionnum' ],
5236                             table      => 'rate_region',
5237                             references => [ 'regionnum' ],
5238                           },
5239                           { columns    => [ 'dest_regionnum' ],
5240                             table      => 'rate_region',
5241                             references => [ 'regionnum' ],
5242                           },
5243                           { columns    => [ 'ratetimenum' ],
5244                             table      => 'rate_time',
5245                           },
5246                           { columns    => [ 'classnum' ],
5247                             table      => 'usage_class',
5248                           },
5249                           { columns    => [ 'cdrtypenum' ],
5250                             table      => 'cdr_type',
5251                           },
5252                         ],
5253     },
5254
5255     'rate_region' => {
5256       'columns' => [
5257         'regionnum',   'serial',      '', '', '', '',
5258         'regionname',  'varchar',     '', $char_d, '', '',
5259         'exact_match', 'char',    'NULL',  1, '', '',
5260       ],
5261       'primary_key' => 'regionnum',
5262       'unique'      => [],
5263       'index'       => [],
5264     },
5265
5266     'rate_prefix' => {
5267       'columns' => [
5268         'prefixnum',   'serial',      '', '', '', '',
5269         'regionnum',   'int',         '', '', '', '',
5270         'countrycode', 'varchar',     '',  3, '', '',
5271         'npa',         'varchar', 'NULL', 10, '', '', #actually the whole prefix
5272         'nxx',         'varchar', 'NULL',  3, '', '', #actually not used
5273         'latanum',     'int',     'NULL',      '', '', '',
5274         'state',       'char',    'NULL',       2, '', '',
5275         'ocn',         'char',    'NULL',       4, '', '',
5276       ],
5277       'primary_key'  => 'prefixnum',
5278       'unique'       => [ [ 'countrycode', 'npa', 'nxx' ] ],
5279       'index'        => [ [ 'countrycode' ], [ 'npa' ], [ 'regionnum' ] ],
5280       'foreign_keys' => [
5281                           { columns    => [ 'regionnum' ],
5282                             table      => 'rate_region',
5283                           },
5284                           { columns    => [ 'latanum' ],
5285                             table      => 'lata',
5286                           },
5287                         ],
5288     },
5289
5290     'rate_time' => {
5291       'columns' => [
5292         'ratetimenum', 'serial',      '',      '', '', '',
5293         'ratetimename',   'varchar',      '', $char_d, '', '',
5294       ],
5295       'primary_key' => 'ratetimenum',
5296       'unique'      => [],
5297       'index'       => [],
5298     },
5299
5300     'rate_time_interval' => {
5301       'columns' => [
5302         'intervalnum', 'serial', '', '', '', '',
5303         'stime',          'int', '', '', '', '',
5304         'etime',          'int', '', '', '', '',
5305         'ratetimenum',    'int', '', '', '', '',
5306       ],
5307       'primary_key'  => 'intervalnum',
5308       'unique'       => [],
5309       'index'        => [],
5310       'foreign_keys' => [
5311                           { columns    => [ 'ratetimenum' ],
5312                             table      => 'rate_time',
5313                           },
5314                         ],
5315      },
5316
5317     #not really part of the above rate_ stuff (used with flat rate rather than
5318     # rated billing), but could be eventually, and its a rate
5319     'rate_tier' => {
5320       'columns' => [
5321         'tiernum',   'serial', '',      '', '', '',
5322         'tiername', 'varchar', '', $char_d, '', '',
5323       ],
5324       'primary_key' => 'tiernum',
5325       'unique'      => [ [ 'tiername'], ],
5326       'index'       => [],
5327     },
5328
5329     'rate_tier_detail' => {
5330       'columns' => [
5331         'tierdetailnum', 'serial', '',     '', '', '',
5332         'tiernum',          'int', '',     '', '', '',
5333         'min_quan',         'int', '',     '', '', '',
5334         'min_charge',   'decimal', '', '10,4', '', '',
5335       ],
5336       'primary_key'  => 'tierdetailnum',
5337       'unique'       => [],
5338       'index'        => [ ['tiernum'], ],
5339       'foreign_keys' => [
5340                           { columns    => [ 'tiernum' ],
5341                             table      => 'rate_tier',
5342                           },
5343                         ],
5344     },
5345
5346     'usage_class' => {
5347       'columns' => [
5348         'classnum',    'serial',      '',      '', '', '',
5349         'weight',      'int',     'NULL',      '', '', '',
5350         'classname',   'varchar',     '', $char_d, '', '',
5351         'format',      'varchar', 'NULL', $char_d, '', '',
5352         'disabled',    'char',    'NULL',       1, '', '',
5353       ],
5354       'primary_key' => 'classnum',
5355       'unique' => [],
5356       'index' => [ ['disabled'] ],
5357     },
5358
5359     'reg_code' => {
5360       'columns' => [
5361         'codenum',   'serial',    '', '', '', '',
5362         'code',      'varchar',   '', $char_d, '', '',
5363         'agentnum',  'int',       '', '', '', '',
5364       ],
5365       'primary_key'  => 'codenum',
5366       'unique'       => [ [ 'agentnum', 'code' ] ],
5367       'index'        => [ [ 'agentnum' ] ],
5368       'foreign_keys' => [
5369                           { columns    => [ 'agentnum' ],
5370                             table      => 'agent',
5371                           },
5372                         ],
5373      },
5374
5375     'reg_code_pkg' => {
5376       'columns' => [
5377         'codepkgnum', 'serial', '', '', '', '',
5378         'codenum',   'int',    '', '', '', '',
5379         'pkgpart',   'int',    '', '', '', '',
5380       ],
5381       'primary_key'  => 'codepkgnum',
5382       'unique'       => [ [ 'codenum', 'pkgpart' ] ],
5383       'index'        => [ [ 'codenum' ] ],
5384       'foreign_keys' => [
5385                           { columns    => [ 'codenum' ],
5386                             table      => 'reg_code',
5387                           },
5388                           { columns    => [ 'pkgpart' ],
5389                             table      => 'part_pkg',
5390                           },
5391                         ],
5392     },
5393
5394     'clientapi_session' => {
5395       'columns' => [
5396         'sessionnum',  'serial',  '', '', '', '',
5397         'sessionid',  'varchar',  '', $char_d, '', '',
5398         'namespace',  'varchar',  '', $char_d, '', '',
5399       ],
5400       'primary_key' => 'sessionnum',
5401       'unique'      => [ [ 'sessionid', 'namespace' ] ],
5402       'index'       => [],
5403     },
5404
5405     'clientapi_session_field' => {
5406       'columns' => [
5407         'fieldnum',    'serial',     '', '', '', '',
5408         'sessionnum',     'int',     '', '', '', '',
5409         'fieldname',  'varchar',     '', $char_d, '', '',
5410         'fieldvalue',    'text', 'NULL', '', '', '',
5411       ],
5412       'primary_key'  => 'fieldnum',
5413       'unique'       => [ [ 'sessionnum', 'fieldname' ] ],
5414       'index'        => [],
5415       'foreign_keys' => [
5416                           { columns    => [ 'sessionnum' ],
5417                             table      => 'clientapi_session',
5418                           },
5419                         ],
5420     },
5421
5422     'payment_gateway' => {
5423       'columns' => [
5424         'gatewaynum',       'serial',   '',     '', '', '',
5425         'gateway_namespace','varchar',  'NULL', $char_d, '', '',
5426         'gateway_module',   'varchar',  '',     $char_d, '', '',
5427         'gateway_username', 'varchar',  'NULL', $char_d, '', '',
5428         'gateway_password', 'varchar',  'NULL', $char_d, '', '',
5429         'gateway_action',   'varchar',  'NULL', $char_d, '', '',
5430         'gateway_callback_url', 'varchar',  'NULL', 255, '', '',
5431         'gateway_cancel_url',   'varchar',  'NULL', 255, '', '',
5432         'disabled',   'char',  'NULL',   1, '', '',
5433       ],
5434       'primary_key' => 'gatewaynum',
5435       'unique' => [],
5436       'index'  => [ [ 'disabled' ] ],
5437     },
5438
5439     'payment_gateway_option' => {
5440       'columns' => [
5441         'optionnum',   'serial',  '',     '', '', '',
5442         'gatewaynum',  'int',     '',     '', '', '',
5443         'optionname',  'varchar', '',     $char_d, '', '',
5444         'optionvalue', 'text',    'NULL', '', '', '',
5445       ],
5446       'primary_key'  => 'optionnum',
5447       'unique'       => [],
5448       'index'        => [ [ 'gatewaynum' ], [ 'optionname' ] ],
5449       'foreign_keys' => [
5450                           { columns    => [ 'gatewaynum' ],
5451                             table      => 'payment_gateway',
5452                           },
5453                         ],
5454     },
5455
5456     'agent_payment_gateway' => {
5457       'columns' => [
5458         'agentgatewaynum', 'serial', '', '', '', '',
5459         'agentnum',        'int', '', '', '', '',
5460         'gatewaynum',      'int', '', '', '', '',
5461         'cardtype',        'varchar', 'NULL', $char_d, '', '',
5462         'taxclass',        'varchar', 'NULL', $char_d, '', '',
5463       ],
5464       'primary_key'  => 'agentgatewaynum',
5465       'unique'       => [],
5466       'index'        => [ [ 'agentnum', 'cardtype' ], ],
5467
5468       'foreign_keys' => [
5469
5470                           { columns    => [ 'agentnum' ],
5471                             table      => 'agent',
5472                           },
5473                           { columns    => [ 'gatewaynum' ],
5474                             table      => 'payment_gateway',
5475                           },
5476                         ],
5477     },
5478
5479     'banned_pay' => {
5480       'columns' => [
5481         'bannum',        'serial',     '',      '', '', '',
5482         'payby',           'char',     '',       4, '', '',
5483         'payinfo',      'varchar',     '',     128, '', '', #say, a 512-big digest _hex encoded
5484         'payinfo_hash', 'varchar', 'NULL',      32, '', '',
5485         #'paymask',      'varchar',  'NULL', $char_d, '', ''
5486         '_date',                @date_type,         '', '',
5487         'end_date',             @date_type,         '', '',
5488         'otaker',       'varchar', 'NULL',      32, '', '',
5489         'usernum',          'int', 'NULL',      '', '', '',
5490         'bantype',      'varchar', 'NULL', $char_d, '', '',
5491         'reason',       'varchar', 'NULL', $char_d, '', '',
5492       ],
5493       'primary_key'  => 'bannum',
5494       'unique'       => [],
5495       'index'        => [ [ 'payby', 'payinfo' ], [ 'usernum' ], ],
5496       'foreign_keys' => [
5497                           { columns    => [ 'usernum' ],
5498                             table      => 'access_user',
5499                           },
5500                         ],
5501     },
5502
5503     'pkg_category' => {
5504       'columns' => [
5505         'categorynum',        'serial',     '',      '', '', '',
5506         'categoryname',      'varchar',     '', $char_d, '', '',
5507         'weight',                'int', 'NULL',      '', '', '',
5508         'ticketing_queueid',     'int', 'NULL',      '', '', '',
5509         'condense',             'char', 'NULL',       1, '', '',
5510         'disabled',             'char', 'NULL',       1, '', '',
5511       ],
5512       'primary_key' => 'categorynum',
5513       'unique' => [],
5514       'index' => [ ['disabled'] ],
5515     },
5516
5517     'pkg_class' => {
5518       'columns' => [
5519         'classnum',    'serial',   '',      '', '', '',
5520         'classname',   'varchar',  '', $char_d, '', '',
5521         'categorynum', 'int',  'NULL',      '', '', '',
5522         'disabled',    'char', 'NULL',       1, '', '',
5523         'fcc_ds0s',      'int',     'NULL', '', '', '',
5524       ],
5525       'primary_key'  => 'classnum',
5526       'unique'       => [],
5527       'index'        => [ ['disabled'] ],
5528       'foreign_keys' => [
5529                           { columns    => [ 'categorynum' ],
5530                             table      => 'pkg_category',
5531                           },
5532                         ],
5533     },
5534
5535     'cdr' => {
5536       'columns' => [
5537         # qw( name type null length default local );
5538
5539         ###
5540         #asterisk fields
5541         ###
5542
5543         'acctid',   'bigserial',  '', '', '', '',
5544         #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
5545         'calldate', 'timestamp',   '',      '', \'now()', '',
5546         'clid',        'varchar',  '', $char_d, \"''", '',
5547         'src',         'varchar',  '', $char_d, \"''", '',
5548         'dst',         'varchar',  '', $char_d, \"''", '',
5549         'dcontext',    'varchar',  '', $char_d, \"''", '',
5550         'channel',     'varchar',  '', $char_d, \"''", '',
5551         'dstchannel',  'varchar',  '', $char_d, \"''", '',
5552         'lastapp',     'varchar',  '', $char_d, \"''", '',
5553         'lastdata',    'varchar',  '',     255, \"''", '',
5554
5555         #currently only opensips & voipswitch
5556         'src_ip_addr', 'varchar',  'NULL',  15,    '', '',
5557
5558         #currently only opensips
5559         'dst_ip_addr', 'varchar',  'NULL',  15,    '', '',
5560
5561         #currently only u4:
5562         # terminating number (as opposed to dialed destination)
5563         'dst_term',    'varchar',  'NULL', $char_d, '', '',
5564
5565         #these don't seem to be logged by most of the SQL cdr_* modules
5566         #except tds under sql-illegal names, so;
5567         # ... don't rely on them for rating?
5568         # and, what they hey, i went ahead and changed the names and data types
5569         # to freeside-style dates...
5570           #'start',  'timestamp', 'NULL',  '',    '', '',
5571           #'answer', 'timestamp', 'NULL',  '',    '', '',
5572           #'end',    'timestamp', 'NULL',  '',    '', '',
5573         'startdate',  @date_type, '', '',
5574         'answerdate', @date_type, '', '',
5575         'enddate',    @date_type, '', '',
5576         #
5577
5578         'duration',    'int',      '',      '',     0, '',
5579         'billsec',     'int',      '',      '',     0, '',
5580         'disposition', 'varchar',  '',      45, \"''", '',
5581         'amaflags',    'int',      '',      '',     0, '',
5582         'accountcode', 'varchar',  '',      32, \"''", '',
5583         'uniqueid',    'varchar',  '', $char_d, \"''", '',
5584         'userfield',   'varchar',  '',     512, \"''", '',
5585
5586         'max_callers', 'int',  'NULL',      '',    '', '',
5587
5588         ###
5589         # old fields for unitel/RSLCOM/convergent that don't map to asterisk
5590         # ones we adoped moved to "own fields" section below
5591         # charged_party, upstream_price, rated_price, carrierid, cdrtypenum
5592         ###
5593
5594         'upstream_currency',      'char', 'NULL',       3, '', '',
5595         'upstream_rateplanid',     'int', 'NULL',      '', '', '', #?
5596
5597         # how it was rated internally...
5598         'ratedetailnum',           'int', 'NULL',      '', '', '',
5599
5600         'distance',            'decimal', 'NULL',      '', '', '',
5601         'islocal',                 'int', 'NULL',      '', '', '', # '',  '', 0, '' instead?
5602
5603         #cdr_calltype: the big list in appendix 2
5604         'calltypenum',             'int', 'NULL',      '', '', '',
5605
5606         'description',         'varchar', 'NULL', $char_d, '', '',
5607         'quantity',                'int', 'NULL',      '', '', '',
5608
5609         'upstream_rateid',         'int', 'NULL',      '', '', '',
5610
5611         ###
5612         # more fields, for GSM imports
5613         ###
5614         'servicecode',             'int', 'NULL',      '', '', '',
5615         'quantity_able',           'int', 'NULL',      '', '', '',
5616
5617         ###
5618         #and now for our own fields
5619         ###
5620
5621         'cdrtypenum',              'int', 'NULL',      '', '', '',
5622
5623         'charged_party',       'varchar', 'NULL', $char_d, '', '',
5624         'charged_party_imsi',  'varchar', 'NULL', $char_d, '', '',
5625
5626         'upstream_price',      'decimal', 'NULL',  '10,5', '', '',
5627
5628         #currently only voipswitch
5629         #'upstream_rate',      'decimal', 'NULL',  '10,5', '', '',
5630
5631         'upstream_src_regionname', 'varchar', 'NULL', $char_d, '', '',
5632         'upstream_dst_regionname', 'varchar', 'NULL', $char_d, '', '',
5633
5634         # how it was rated internally...
5635         'rated_pretty_dst',       'varchar', 'NULL', $char_d, '', '',
5636         'rated_regionname',       'varchar', 'NULL', $char_d, '', '',
5637         'rated_price',            'decimal', 'NULL',  '10,4', '', '',
5638         'rated_seconds',              'int', 'NULL',      '', '', '',
5639         'rated_minutes', 'double precision', 'NULL',      '', '', '',
5640         'rated_granularity',          'int', 'NULL',      '', '', '',
5641         'rated_ratedetailnum',        'int', 'NULL',      '', '', '',
5642         'rated_classnum',             'int', 'NULL',      '', '', '',
5643         'rated_ratename',         'varchar', 'NULL', $char_d, '', '',
5644         'rated_cost',            'decimal', 'NULL',  '10,4', '', '',
5645
5646         # real endpoints of the call
5647         'src_lrn',             'varchar', 'NULL',     '15', '', '',
5648         'dst_lrn',             'varchar', 'NULL',     '15', '', '',
5649
5650         'carrierid',               'bigint', 'NULL',      '', '', '',
5651
5652         # service it was matched to
5653         'svcnum',             'int',   'NULL',     '',   '', '',
5654
5655         #NULL, done (or something)
5656         'freesidestatus', 'varchar',   'NULL',     32,   '', '',
5657
5658         #NULL, done (or something)
5659         'freesiderewritestatus', 'varchar',   'NULL',     32,   '', '',
5660
5661         #an indexed place to put big numbers
5662         'cdrid',         'bigint',     'NULL',     '',  '', '',
5663
5664         #for taqua accountcode rewriting, for starters
5665         'sessionnum',       'int',    'NULL',      '', '', '',
5666         'subscriber',   'varchar',    'NULL', $char_d, '', '',
5667
5668         'cdrbatchnum',      'int',    'NULL',      '', '', '',
5669
5670         # FK to cust_bill_pkg_detail; having a value here absolutely means
5671         # that the CDR appears on an invoice
5672         'detailnum',     'bigint',    'NULL',      '', '', '',
5673       ],
5674       'primary_key' => 'acctid',
5675       'unique' => [],
5676       'index' => [ [ 'calldate' ],
5677                    [ 'src' ], [ 'dst' ], [ 'dcontext' ], [ 'charged_party' ],
5678                    [ 'startdate' ], [ 'duration' ],
5679                    [ 'cdrtypenum' ], [ 'calltypenum' ],
5680                    [ 'lastapp' ],
5681                    ['accountcode'], ['uniqueid'], ['carrierid'], ['cdrid'],
5682                    [ 'sessionnum' ], [ 'subscriber' ],
5683                    [ 'freesidestatus' ], [ 'freesiderewritestatus' ],
5684                    [ 'cdrbatchnum' ],
5685                    [ 'src_ip_addr' ], [ 'dst_ip_addr' ], [ 'dst_term' ],
5686                    [ 'detailnum' ],
5687                  ],
5688       #no FKs on cdr table... choosing not to throw errors no matter what's
5689       # thrown in here.  better to have the data.
5690     },
5691
5692     'cdr_batch' => {
5693       'columns' => [
5694         'cdrbatchnum',   'serial',    '',   '', '', '',
5695         'cdrbatch', 'varchar', 'NULL', 255, '', '',
5696         '_date',     @date_type, '', '',
5697       ],
5698       'primary_key' => 'cdrbatchnum',
5699       'unique' => [ [ 'cdrbatch' ] ],
5700       'index' => [],
5701     },
5702
5703     'cdr_termination' => {
5704       'columns' => [
5705         'cdrtermnum', 'bigserial',     '',      '', '', '',
5706         'acctid',        'bigint',     '',      '', '', '',
5707         'termpart',         'int',     '',      '', '', '',#future use see below
5708         'rated_price',  'decimal', 'NULL',  '10,4', '', '',
5709         'rated_seconds',    'int', 'NULL',      '', '', '',
5710         'rated_minutes', 'double precision', 'NULL',   '', '', '',
5711         'rated_granularity','int', 'NULL',      '', '', '',
5712         'status',       'varchar', 'NULL',      32, '', '',
5713         'svcnum',           'int', 'NULL',      '', '', '',
5714       ],
5715       'primary_key'  => 'cdrtermnum',
5716       'unique'       => [ [ 'acctid', 'termpart' ] ],
5717       'index'        => [ [ 'acctid' ], [ 'status' ], ],
5718       'foreign_keys' => [
5719                           { columns    => [ 'acctid' ],
5720                             table      => 'cdr',
5721                           },
5722                           { columns    => [ 'svcnum' ],
5723                             table      => 'cust_svc',
5724                           },
5725                         ],
5726     },
5727
5728     #to handle multiple termination/settlement passes...
5729    # 'part_termination' => {
5730    #   'columns' => [
5731    #     'termpart',       'int', '',      '', '', '',
5732    #     'termname',   'varchar', '', $char_d, '', '',
5733    #     'cdr_column', 'varchar', '', $char_d, '', '', #maybe set it here instead of in the price plan?
5734    #   ],
5735    #   'primary_key' => 'termpart',
5736    #   'unique' => [],
5737    #   'index'  => [],
5738    # },
5739
5740     #the remaining cdr_ tables are not really used
5741     'cdr_calltype' => {
5742       'columns' => [
5743         'calltypenum',   'serial',  '', '', '', '',
5744         'calltypename',  'varchar', '', $char_d, '', '',
5745       ],
5746       'primary_key' => 'calltypenum',
5747       'unique'      => [],
5748       'index'       => [],
5749     },
5750
5751     'cdr_type' => {
5752       'columns' => [
5753         'cdrtypenum'  => 'serial',  '', '', '', '',
5754         'cdrtypename' => 'varchar', '', $char_d, '', '',
5755       ],
5756       'primary_key' => 'cdrtypenum',
5757       'unique'      => [],
5758       'index'       => [],
5759     },
5760
5761     'cdr_carrier' => {
5762       'columns' => [
5763         'carrierid'   =>  'serial',     '',      '', '', '',
5764         'carriername' => 'varchar',     '', $char_d, '', '',
5765         'disabled'    =>    'char', 'NULL',       1, '', '',
5766       ],
5767       'primary_key' => 'carrierid',
5768       'unique'      => [],
5769       'index'       => [],
5770     },
5771
5772     #'cdr_file' => {
5773     #  'columns' => [
5774     #    'filenum',    'serial',     '', '', '', '',
5775     #    'filename',  'varchar',     '', '', '', '',
5776     #    'status',    'varchar', 'NULL', '', '', '',
5777     #  ],
5778     #  'primary_key' => 'filenum',
5779     #  'unique' => [ [ 'filename' ], ], #just change the index if we need to
5780     #                                   # agent-virtualize or have a customer
5781     #                                   # with dup-filename needs or something
5782     #                                   # (only used by cdr.http_and_import for
5783     #                                   #  chrissakes)
5784     #  'index'  => [],
5785     #},
5786
5787     'inventory_item' => {
5788       'columns' => [
5789         'itemnum',   'serial',      '',      '', '', '',
5790         'classnum',  'int',         '',      '', '', '',
5791         'agentnum',  'int',     'NULL',      '', '', '',
5792         'item',      'varchar',     '', $char_d, '', '',
5793         'svcnum',    'int',     'NULL',      '', '', '',
5794         'svc_field', 'varchar', 'NULL', $char_d, '', '',
5795       ],
5796       'primary_key'  => 'itemnum',
5797       'unique'       => [ [ 'classnum', 'item' ] ],
5798       'index'        => [ [ 'classnum' ], [ 'agentnum' ], [ 'svcnum' ] ],
5799       'foreign_keys' => [
5800                           { columns    => [ 'classnum' ],
5801                             table      => 'inventory_class',
5802                           },
5803                           { columns    => [ 'agentnum' ],
5804                             table      => 'agent',
5805                           },
5806                           { columns    => [ 'svcnum' ],
5807                             table      => 'cust_svc',
5808                           },
5809                         ],
5810     },
5811
5812     'inventory_class' => {
5813       'columns' => [
5814         'classnum',  'serial',       '',      '', '', '',
5815         'classname', 'varchar',      '', $char_d, '', '',
5816       ],
5817       'primary_key' => 'classnum',
5818       'unique' => [],
5819       'index'  => [],
5820     },
5821
5822     'access_user_session' => {
5823       'columns' => [
5824         'sessionnum',   'serial',  '',      '', '', '',
5825         'sessionkey',  'varchar',  '', $char_d, '', '',
5826         'usernum',         'int',  '',      '', '', '',
5827         'start_date', @date_type,               '', '',
5828         'last_date',  @date_type,               '', '',
5829       ],
5830       'primary_key'  => 'sessionnum',
5831       'unique'       => [ [ 'sessionkey' ] ],
5832       'index'        => [],
5833       'foreign_keys' => [
5834                           { columns    => [ 'usernum' ],
5835                             table      => 'access_user',
5836                           },
5837                         ],
5838     },
5839
5840     'access_user_session_log' => {
5841       'columns' => [
5842         'sessionlognum', 'serial', '',      '', '', '',
5843         'usernum',          'int', '',      '', '', '',
5844         'start_date',  @date_type,              '', '',
5845         'last_date',   @date_type,              '', '',
5846         'logout_date', @date_type,              '', '',
5847         'logout_type',  'varchar', '', $char_d, '', '',
5848       ],
5849       'primary_key' => 'sessionlognum',
5850       'unique'       => [],
5851       'index'        => [],
5852       'foreign_keys' => [
5853                           { columns    => [ 'usernum' ],
5854                             table      => 'access_user',
5855                           },
5856                         ],
5857     },
5858
5859     'access_user' => {
5860       'columns' => [
5861         'usernum',             'serial',     '',      '', '', '',
5862         'username',           'varchar',     '', $char_d, '', '',
5863         '_password',          'varchar', 'NULL', $char_d, '', '',
5864         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
5865         'last',               'varchar', 'NULL', $char_d, '', '',
5866         'first',              'varchar', 'NULL', $char_d, '', '',
5867         'user_custnum',           'int', 'NULL',      '', '', '',
5868         'report_salesnum',        'int', 'NULL',      '', '', '',
5869         'disabled',              'char', 'NULL',       1, '', '',
5870       ],
5871       'primary_key'  => 'usernum',
5872       'unique'       => [ [ 'username' ] ],
5873       'index'        => [ [ 'user_custnum' ] ],
5874       'foreign_keys' => [
5875                           { columns    => [ 'user_custnum' ],
5876                             table      => 'cust_main',
5877                             references => [ 'custnum' ],
5878                           },
5879                           { columns    => [ 'report_salesnum' ],
5880                             table      => 'sales',
5881                             references => [ 'salesnum' ],
5882                           },
5883                         ],
5884     },
5885
5886     'access_user_pref' => {
5887       'columns' => [
5888         'prefnum',    'serial',       '', '', '', '',
5889         'usernum',     'int',       '', '', '', '',
5890         'prefname', 'varchar', '', $char_d, '', '',
5891         'prefvalue', 'text', 'NULL', '', '', '',
5892         'expiration', @date_type, '', '',
5893       ],
5894       'primary_key'  => 'prefnum',
5895       'unique'       => [],
5896       'index'        => [ [ 'usernum' ] ],
5897       'foreign_keys' => [
5898                           { columns    => [ 'usernum' ],
5899                             table      => 'access_user',
5900                           },
5901                         ],
5902     },
5903
5904     'access_group' => {
5905       'columns' => [
5906         'groupnum',        'serial',     '',      '', '', '',
5907         'groupname',      'varchar',     '', $char_d, '', '',
5908         'session_timeout',    'int', 'NULL',      '', '', '',
5909       ],
5910       'primary_key' => 'groupnum',
5911       'unique' => [ [ 'groupname' ] ],
5912       'index'  => [],
5913     },
5914
5915     'access_usergroup' => {
5916       'columns' => [
5917         'usergroupnum', 'serial', '', '', '', '',
5918         'usernum',         'int', '', '', '', '',
5919         'groupnum',        'int', '', '', '', '',
5920       ],
5921       'primary_key'  => 'usergroupnum',
5922       'unique'       => [ [ 'usernum', 'groupnum' ] ],
5923       'index'        => [ [ 'usernum' ] ],
5924       'foreign_keys' => [
5925                           { columns    => [ 'usernum' ],
5926                             table      => 'access_user',
5927                           },
5928                           { columns    => [ 'groupnum' ],
5929                             table      => 'access_group',
5930                           },
5931                         ],
5932      },
5933
5934     'access_groupagent' => {
5935       'columns' => [
5936         'groupagentnum', 'serial', '', '', '', '',
5937         'groupnum',         'int', '', '', '', '',
5938         'agentnum',         'int', '', '', '', '',
5939       ],
5940       'primary_key'  => 'groupagentnum',
5941       'unique'       => [ [ 'groupnum', 'agentnum' ] ],
5942       'index'        => [ [ 'groupnum' ] ],
5943       'foreign_keys' => [
5944                           { columns    => [ 'groupnum' ],
5945                             table      => 'access_group',
5946                           },
5947                           { columns    => [ 'agentnum' ],
5948                             table      => 'agent',
5949                           },
5950                         ],
5951     },
5952
5953     'access_right' => {
5954       'columns' => [
5955         'rightnum',   'serial', '',      '', '', '',
5956         'righttype', 'varchar', '', $char_d, '', '',
5957         'rightobjnum',   'int', '',      '', '', '',
5958         'rightname', 'varchar', '', $char_d, '', '',
5959       ],
5960       'primary_key' => 'rightnum',
5961       'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
5962       'index'  => [],
5963     },
5964
5965     'access_user_log' => {
5966       'columns'      => [
5967         'lognum',          'serial',     '',        '', '', '',
5968         'usernum',            'int',     '',        '', '', '',
5969         'path',           'varchar',     '', 2*$char_d, '', '',
5970         '_date',                   @date_type,          '', '',
5971         'render_seconds',     'int', 'NULL',        '', '', '',
5972         'pid',                'int', 'NULL',        '', '', '',
5973       ],
5974       'primary_key'  => 'lognum',
5975       'unique'       => [],
5976       'index'        => [ ['usernum'], ['path'], ['_date'] ],
5977     },
5978
5979     'access_user_page_pref' => {
5980       'columns'     => [
5981         'prefnum'     =>  'serial',     '',      '', '', '',
5982         'usernum'     =>     'int',     '',      '', '', '',
5983         'path'        =>    'text',     '',      '', '', '',
5984         'tablenum'    =>     'int', 'NULL',      '', '', '',
5985         '_date'       =>    @date_type,              '', '',
5986         'prefname'    =>    'varchar',  '', $char_d, '', '',
5987         'prefvalue'   =>    'text',     '',      '', '', '',
5988       ],
5989       'primary_key' => 'prefnum',
5990       'unique'      => [ [ 'usernum', 'path', 'tablenum', 'prefname' ] ],
5991       'index'       => [],
5992       'foreign_keys' => [
5993                           { columns   => [ 'usernum' ],
5994                             table     => 'access_user'
5995                           },
5996                         ],
5997     },
5998
5999     'sched_item' => {
6000       'columns' => [
6001         'itemnum',   'serial',      '', '', '', '',
6002         'usernum',      'int',  'NULL', '', '', '',
6003         #'itemname', 'varchar', $char_d, '', '', '',
6004         'disabled',    'char',  'NULL',  1, '', '',
6005       ],
6006       'primary_key'  => 'itemnum',
6007       'unique'       => [ [ 'usernum' ] ],
6008       'index'        => [],
6009       'foreign_keys' => [
6010                           { columns    => [ 'usernum' ],
6011                             table      => 'access_user',
6012                           },
6013                         ],
6014     },
6015
6016     #'sched_item_class'
6017
6018     'sched_avail' => {
6019       'columns' => [
6020         'availnum',      'serial', '', '', '', '',
6021         'itemnum',          'int', '', '', '', '',
6022         'wday',             'int', '', '', '', '',
6023         'stime',            'int', '', '', '', '',
6024         'etime',            'int', '', '', '', '',
6025         'override_date',    @date_type,    '', '',
6026       ],
6027       'primary_key'  => 'availnum',
6028       'unique'       => [],
6029       'index'        => [],
6030       'foreign_keys' => [
6031                           { columns    => [ 'itemnum' ],
6032                             table      => 'sched_item',
6033                           },
6034                         ],
6035     },
6036
6037     'svc_phone' => {
6038       'columns' => [
6039         'svcnum',                         'int',     '',      '', '', '',
6040         'countrycode',                'varchar',     '',       3, '', '',
6041         'phonenum',                   'varchar',     '',      25, '', '', #12 ?
6042         'sim_imsi',                   'varchar', 'NULL',      15, '', '',
6043         'pin',                        'varchar', 'NULL', $char_d, '', '',
6044         'sip_password',               'varchar', 'NULL', $char_d, '', '',
6045         'phone_name',                 'varchar', 'NULL', $char_d, '', '',
6046         'pbxsvc',                         'int', 'NULL',      '', '', '',
6047         'domsvc',                         'int', 'NULL',      '', '', '',
6048         'locationnum',                    'int', 'NULL',      '', '', '',
6049         'forward_svcnum',                 'int', 'NULL',      '', '', '',
6050         'forwarddst',                 'varchar', 'NULL',      15, '', '',
6051         'email',                      'varchar', 'NULL',     255, '', '',
6052         'lnp_status',                 'varchar', 'NULL', $char_d, '', '',
6053         'portable',                      'char', 'NULL',       1, '', '',
6054         'lrn',                           'char', 'NULL',      10, '', '',
6055         'lnp_desired_due_date',           'int', 'NULL',      '', '', '',
6056         'lnp_due_date',                   'int', 'NULL',      '', '', '',
6057         'lnp_other_provider',         'varchar', 'NULL', $char_d, '', '',
6058         'lnp_other_provider_account', 'varchar', 'NULL', $char_d, '', '',
6059         'lnp_reject_reason',          'varchar', 'NULL', $char_d, '', '',
6060         'lnp_portid',                 'varchar', 'NULL', $char_d, '', '',
6061         'lnp_signature',                 'char', 'NULL',       1, '', '',
6062         'lnp_bill',                      'char', 'NULL',       1, '', '',
6063         'sms_carrierid',                  'int', 'NULL',      '', '', '',
6064         'sms_account',                'varchar', 'NULL', $char_d, '', '',
6065         'max_simultaneous',               'int', 'NULL',      '', '', '',
6066         'e911_class',                    'char', 'NULL',       1, '', '',
6067         'e911_type',                     'char', 'NULL',       1, '', '',
6068         'circuit_svcnum',                 'int', 'NULL',      '', '', '',
6069         'sip_server',                 'varchar', 'NULL', $char_d, '', '',
6070       ],
6071       'primary_key'  => 'svcnum',
6072       'unique'       => [ [ 'sms_carrierid', 'sms_account'] ],
6073       'index'        => [ ['countrycode', 'phonenum'], ['pbxsvc'], ['domsvc'],
6074                           ['locationnum'], ['sms_carrierid'],
6075                         ],
6076       'foreign_keys' => [
6077                           { columns    => [ 'svcnum' ],
6078                             table      => 'cust_svc',
6079                           },
6080                           { columns    => [ 'pbxsvc' ],
6081                             table      => 'svc_pbx', #'cust_svc',
6082                             references => [ 'svcnum' ],
6083                           },
6084                           { columns    => [ 'domsvc' ],
6085                             table      => 'svc_domain', #'cust_svc',
6086                             references => [ 'svcnum' ],
6087                           },
6088                           { columns    => [ 'locationnum' ],
6089                             table      => 'cust_location',
6090                           },
6091                           { columns    => [ 'sms_carrierid' ],
6092                             table      => 'cdr_carrier',
6093                             references => [ 'carrierid' ],
6094                           },
6095                           { columns    => [ 'circuit_svcnum' ],
6096                             table      => 'svc_circuit',
6097                             references => [ 'svcnum' ],
6098                           },
6099                         ],
6100     },
6101
6102     'phone_device' => {
6103       'columns' => [
6104         'devicenum', 'serial',     '', '', '', '',
6105         'devicepart',   'int',     '', '', '', '',
6106         'svcnum',       'int',     '', '', '', '',
6107         'mac_addr', 'varchar', 'NULL', 12, '', '',
6108       ],
6109       'primary_key'  => 'devicenum',
6110       'unique'       => [ [ 'mac_addr' ], ],
6111       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6112       'foreign_keys' => [
6113                           { columns    => [ 'devicepart' ],
6114                             table      => 'part_device',
6115                           },
6116                           { columns    => [ 'svcnum' ],
6117                             table      => 'svc_phone',
6118                           },
6119                         ],
6120     },
6121
6122     'part_device' => {
6123       'columns' => [
6124         'devicepart', 'serial',  '',      '', '', '',
6125         'devicename', 'varchar', '', $char_d, '', '',
6126         'inventory_classnum', 'int', 'NULL', '', '', '',
6127         'title',      'varchar', 'NULL', $char_d, '', '',
6128       ],
6129       'primary_key'  => 'devicepart',
6130       'unique'       => [ [ 'devicename' ] ], #?
6131       'index'        => [],
6132       'foreign_keys' => [
6133                           { columns    => [ 'inventory_classnum' ],
6134                             table      => 'inventory_class',
6135                             references => [ 'classnum' ],
6136                           },
6137                         ],
6138     },
6139
6140     'phone_avail' => {
6141       'columns' => [
6142         'availnum',    'serial',      '',      '', '', '',
6143         'exportnum',   'int',         '',      '', '', '',
6144         'countrycode', 'varchar',     '',       3, '', '',
6145         'state',       'char',    'NULL',       2, '', '',
6146         'npa',         'char',        '',       3, '', '',
6147         'nxx',         'char',    'NULL',       3, '', '',
6148         'station',     'char',    'NULL',       4, '', '',
6149         'name',        'varchar', 'NULL', $char_d, '', '',
6150         'rate_center_abbrev', 'varchar', 'NULL', $char_d, '', '',
6151         'latanum',      'int',     'NULL',      '', '', '',
6152         'msanum',       'int', 'NULL', '', '', '',
6153         'ordernum',      'int',     'NULL',      '', '', '',
6154         'svcnum',      'int',     'NULL',      '', '', '',
6155         'availbatch', 'varchar',  'NULL', $char_d, '', '',
6156       ],
6157       'primary_key'  => 'availnum',
6158       'unique'       => [],
6159       'index'        => [ ['exportnum','countrycode','state'],    #npa search
6160                           ['exportnum','countrycode','npa'],      #nxx search
6161                           ['exportnum','countrycode','npa','nxx'],#station srch
6162                           [ 'exportnum','countrycode','npa','nxx','station'], #
6163                           [ 'svcnum' ],
6164                           [ 'availbatch' ],
6165                           [ 'latanum' ],
6166                         ],
6167       'foreign_keys' => [
6168                           { columns    => [ 'exportnum' ],
6169                             table      => 'part_export',
6170                           },
6171                           { columns    => [ 'latanum' ],
6172                             table      => 'lata',
6173                           },
6174                           { columns    => [ 'msanum' ],
6175                             table      => 'msa',
6176                           },
6177                           { columns    => [ 'ordernum' ],
6178                             table      => 'did_order',
6179                           },
6180                           { columns    => [ 'svcnum' ],
6181                             table      => 'svc_phone',
6182                           },
6183                         ],
6184     },
6185
6186     'lata' => {
6187       'columns' => [
6188         'latanum',    'int',      '',      '', '', '',
6189         'description',   'varchar',    '',      $char_d, '', '',
6190         'have_usage',   'int',    'NULL',      '', '', '',
6191       ],
6192       'primary_key' => 'latanum',
6193       'unique' => [],
6194       'index'  => [],
6195     },
6196
6197     'msa' => {
6198       'columns' => [
6199         'msanum',    'int',      '',      '', '', '',
6200         'description',   'varchar',    '',      $char_d, '', '',
6201       ],
6202       'primary_key' => 'msanum',
6203       'unique' => [],
6204       'index'  => [],
6205     },
6206
6207     'rate_center' => {
6208       'columns' => [
6209         'ratecenternum',    'serial',      '',      '', '', '',
6210         'description',   'varchar',    '',      $char_d, '', '',
6211       ],
6212       'primary_key' => 'ratecenternum',
6213       'unique' => [],
6214       'index'  => [],
6215     },
6216
6217     'did_vendor' => {
6218       'columns' => [
6219         'vendornum',    'serial',      '',      '', '', '',
6220         'vendorname',   'varchar',        '',     $char_d, '', '',
6221       ],
6222       'primary_key' => 'vendornum',
6223       'unique' => [],
6224       'index'  => [],
6225     },
6226
6227     'did_order_item' => {
6228       'columns' => [
6229         'orderitemnum',    'serial',      '',      '', '', '',
6230         'ordernum',    'int',      '',      '', '', '',
6231         'msanum',      'int',     'NULL',      '', '', '',
6232         'npa',      'int',     'NULL',      '', '', '',
6233         'latanum',      'int',     'NULL',      '', '', '',
6234         'ratecenternum',      'int',     'NULL',      '', '', '',
6235         'state',       'char',    'NULL',       2, '', '',
6236         'quantity',      'int',     '',      '', '', '',
6237         'custnum',   'int', 'NULL', '', '', '',
6238       ],
6239       'primary_key'  => 'orderitemnum',
6240       'unique'       => [],
6241       'index'        => [],
6242       'foreign_keys' => [
6243                           { columns    => [ 'ordernum' ],
6244                             table      => 'did_order',
6245                           },
6246                           { columns    => [ 'msanum' ],
6247                             table      => 'msa',
6248                           },
6249                           { columns    => [ 'latanum' ],
6250                             table      => 'lata',
6251                           },
6252                           { columns    => [ 'ratecenternum' ],
6253                             table      => 'rate_center',
6254                           },
6255                           { columns    => [ 'custnum' ],
6256                             table      => 'cust_main',
6257                           },
6258                         ],
6259     },
6260
6261     'did_order' => {
6262       'columns' => [
6263         'ordernum',    'serial',      '',      '', '', '',
6264         'vendornum',   'int',       '',      '', '', '',
6265         'vendor_order_id',   'varchar',  'NULL',   $char_d, '', '',
6266         'custnum',   'int', 'NULL', '', '', '',
6267         'submitted',      'int',     '',      '', '', '',
6268         'confirmed',      'int',     'NULL',      '', '', '',
6269         'received',      'int',     'NULL',      '', '', '',
6270       ],
6271       'primary_key'  => 'ordernum',
6272       'unique'       => [ [ 'vendornum', 'vendor_order_id' ] ],
6273       'index'        => [],
6274       'foreign_keys' => [
6275                           { columns    => [ 'vendornum' ],
6276                             table      => 'did_vendor',
6277                           },
6278                           { columns    => [ 'custnum' ],
6279                             table      => 'cust_main',
6280                           },
6281                         ],
6282     },
6283
6284     'reason_type' => {
6285       'columns' => [
6286         'typenum',   'serial',  '', '', '', '',
6287         'class',     'char', '', 1, '', '',
6288         'type',     'varchar', '', $char_d, '', '',
6289       ],
6290       'primary_key' => 'typenum',
6291       'unique' => [],
6292       'index' => [],
6293     },
6294
6295     'reason' => {
6296       'columns' => [
6297         'reasonnum',     'serial',  '', '', '', '',
6298         'reason_type',   'int',  '', '', '', '',
6299         'reason',        'text', '', '', '', '',
6300         'disabled',      'char',    'NULL', 1, '', '',
6301         'unsuspend_pkgpart', 'int',  'NULL', '', '', '',
6302         'unsuspend_hold','char',    'NULL', 1, '', '',
6303         'unused_credit', 'char',    'NULL', 1, '', '',
6304         'feepart',        'int', 'NULL', '', '', '',
6305         'fee_on_unsuspend','char',  'NULL', 1, '', '',
6306         'fee_hold',      'char',    'NULL', 1, '', '',
6307       ],
6308       'primary_key'  => 'reasonnum',
6309       'unique'       => [],
6310       'index'        => [],
6311       'foreign_keys' => [
6312                           { columns    => [ 'reason_type' ],
6313                             table      => 'reason_type',
6314                             references => [ 'typenum' ],
6315                           },
6316                           { columns    => [ 'unsuspend_pkgpart' ],
6317                             table      => 'part_pkg',
6318                             references => [ 'pkgpart' ],
6319                           },
6320                         ],
6321     },
6322
6323     'conf' => {
6324       'columns' => [
6325         'confnum',  'serial',     '',      '', '', '',
6326         'agentnum', 'int',    'NULL',      '', '', '',
6327         'locale',   'varchar','NULL',      16, '', '',
6328         'name',     'varchar',    '', $char_d, '', '',
6329         'value',    'text',   'NULL',      '', '', '',
6330       ],
6331       'primary_key'  => 'confnum',
6332       'unique'       => [ [ 'agentnum', 'locale', 'name' ] ],
6333       'index'        => [],
6334       'foreign_keys' => [
6335                           { columns    => [ 'agentnum' ],
6336                             table      => 'agent',
6337                           },
6338                         ],
6339     },
6340
6341     'pkg_referral' => {
6342       'columns' => [
6343         'pkgrefnum',     'serial', '', '', '', '',
6344         'pkgnum',        'int',    '', '', '', '',
6345         'refnum',        'int',    '', '', '', '',
6346       ],
6347       'primary_key'  => 'pkgrefnum',
6348       'unique'       => [ [ 'pkgnum', 'refnum' ] ],
6349       'index'        => [ [ 'pkgnum' ], [ 'refnum' ] ],
6350       'foreign_keys' => [
6351                           { columns    => [ 'pkgnum' ],
6352                             table      => 'cust_pkg',
6353                           },
6354                           { columns    => [ 'refnum' ],
6355                             table      => 'part_referral',
6356                           },
6357                         ],
6358     },
6359
6360     'svc_pbx' => {
6361       'columns' => [
6362         'svcnum',           'int',     '',      '', '', '',
6363         'id',               'int', 'NULL',      '', '', '',
6364         'uuid',            'char', 'NULL',      36, '', '',
6365         'title',        'varchar', 'NULL', $char_d, '', '',
6366         'max_extensions',   'int', 'NULL',      '', '', '',
6367         'max_simultaneous', 'int', 'NULL',      '', '', '',
6368         'ip_addr',      'varchar', 'NULL',      40, '', '',
6369       ],
6370       'primary_key'  => 'svcnum',
6371       'unique'       => [],
6372       'index'        => [ [ 'id' ], [ 'uuid' ] ],
6373       'foreign_keys' => [
6374                           { columns    => [ 'svcnum' ],
6375                             table      => 'cust_svc',
6376                           },
6377                         ],
6378     },
6379
6380     'pbx_extension' => {
6381       'columns' => [
6382         'extensionnum',  'serial',     '',      '', '', '',
6383         'svcnum',           'int',     '',      '', '', '',
6384         'extension',    'varchar',     '', $char_d, '', '',
6385         'pin',          'varchar', 'NULL', $char_d, '', '',
6386         'sip_password', 'varchar', 'NULL', $char_d, '', '',
6387         'phone_name',   'varchar', 'NULL', $char_d, '', '',
6388       ],
6389       'primary_key'  => 'extensionnum',
6390       'unique'       => [ [ 'svcnum', 'extension' ] ],
6391       'index'        => [ [ 'svcnum' ] ],
6392       'foreign_keys' => [
6393                           { columns    => [ 'svcnum' ],
6394                             table      => 'svc_pbx',
6395                           },
6396                         ],
6397     },
6398
6399     'pbx_device' => {
6400       'columns' => [
6401         'devicenum', 'serial',     '', '', '', '',
6402         'devicepart',   'int',     '', '', '', '',
6403         'svcnum',       'int',     '', '', '', '',
6404         'mac_addr', 'varchar', 'NULL', 12, '', '',
6405       ],
6406       'primary_key'  => 'devicenum',
6407       'unique'       => [ [ 'mac_addr' ], ],
6408       'index'        => [ [ 'devicepart' ], [ 'svcnum' ], ],
6409       'foreign_keys' => [
6410                           { columns    => [ 'devicepart' ],
6411                             table      => 'part_device',
6412                           },
6413                           { columns    => [ 'svcnum' ],
6414                             table      => 'svc_pbx',
6415                           },
6416                         ],
6417     },
6418
6419     'extension_device' => {
6420       'columns' => [
6421         'extensiondevicenum', 'serial', '', '', '', '',
6422         'extensionnum',          'int', '', '', '', '',
6423         'devicenum',             'int', '', '', '', '',
6424       ],
6425       'primary_key'  => 'extensiondevicenum',
6426       'unique'       => [ [ 'extensionnum', 'devicenum' ] ],
6427       'index'        => [],#both?  which way do we need to query?
6428       'foreign_keys' => [
6429                           { columns  => [ 'extensionnum' ],
6430                             table    => 'pbx_extension',
6431                           },
6432                           { columns  => [ 'devicenum' ],
6433                             table    => 'pbx_device',
6434                           },
6435                         ],
6436     },
6437
6438     'svc_mailinglist' => { #svc_group?
6439       'columns' => [
6440         'svcnum',            'int',     '',            '', '', '',
6441         'username',      'varchar',     '', $username_len, '', '',
6442         'domsvc',            'int',     '',            '', '', '',
6443         'listnum',           'int',     '',            '', '', '',
6444         'reply_to',         'char', 'NULL',             1, '', '',#SetReplyTo
6445         'remove_from',      'char', 'NULL',             1, '', '',#RemoveAuthor
6446         'reject_auto',      'char', 'NULL',             1, '', '',#RejectAuto
6447         'remove_to_and_cc', 'char', 'NULL',             1, '', '',#RemoveToAndCc
6448       ],
6449       'primary_key'  => 'svcnum',
6450       'unique'       => [],
6451       'index'        => [ ['username'], ['domsvc'], ['listnum'] ],
6452       'foreign_keys' => [
6453                           { columns    => [ 'svcnum' ],
6454                             table      => 'cust_svc',
6455                           },
6456                           { columns    => [ 'domsvc' ],
6457                             table      => 'svc_domain', #'cust_svc',
6458                             references => [ 'svcnum' ],
6459                           },
6460                           { columns    => [ 'listnum' ],
6461                             table      => 'mailinglist',
6462                           },
6463                         ],
6464     },
6465
6466     'mailinglist' => {
6467       'columns' => [
6468         'listnum',   'serial', '',      '', '', '',
6469         'listname', 'varchar', '', $char_d, '', '',
6470       ],
6471       'primary_key' => 'listnum',
6472       'unique' => [],
6473       'index'  => [],
6474     },
6475
6476     'mailinglistmember' => {
6477       'columns' => [
6478         'membernum',        'serial',     '',   '', '', '',
6479         'listnum',             'int',     '',   '', '', '',
6480         'svcnum',              'int', 'NULL',   '', '', '',
6481         'contactemailnum',     'int', 'NULL',   '', '', '',
6482         'email',           'varchar', 'NULL',  255, '', '',
6483       ],
6484       'primary_key'  => 'membernum',
6485       'unique'       => [],
6486       'index'        => [['listnum'],['svcnum'],['contactemailnum'],['email']],
6487       'foreign_keys' => [
6488                           { columns    => [ 'listnum' ],
6489                             table      => 'mailinglist',
6490                           },
6491                           { columns    => [ 'svcnum' ],
6492                             table      => 'svc_acct',
6493                           },
6494                           { columns    => [ 'contactemailnum' ],
6495                             table      => 'contact_email',
6496                           },
6497                         ],
6498     },
6499
6500     'bill_batch' => {
6501       'columns' => [
6502         'batchnum',         'serial',     '',  '', '', '',
6503         'agentnum',            'int', 'NULL',  '', '', '',
6504         'status',             'char', 'NULL', '1', '', '',
6505         'pdf',                'blob', 'NULL',  '', '', '',
6506       ],
6507       'primary_key'  => 'batchnum',
6508       'unique'       => [],
6509       'index'        => [ ['agentnum'] ],
6510       'foreign_keys' => [
6511                           { columns    => [ 'agentnum' ],
6512                             table      => 'agent',
6513                           },
6514                         ],
6515     },
6516
6517     'cust_bill_batch' => {
6518       'columns' => [
6519         'billbatchnum',     'serial',     '', '', '', '',
6520         'batchnum',            'int',     '', '', '', '',
6521         'invnum',              'int',     '', '', '', '',
6522       ],
6523       'primary_key'  => 'billbatchnum',
6524       'unique'       => [],
6525       'index'        => [ [ 'batchnum' ], [ 'invnum' ] ],
6526       'foreign_keys' => [
6527                           { columns    => [ 'batchnum' ],
6528                             table      => 'bill_batch',
6529                           },
6530                           { columns    => [ 'invnum' ],
6531                             table      => 'cust_bill',
6532                           },
6533                         ],
6534     },
6535
6536     'cust_bill_batch_option' => {
6537       'columns' => [
6538         'optionnum', 'serial', '', '', '', '',
6539         'billbatchnum', 'int', '', '', '', '',
6540         'optionname', 'varchar', '', $char_d, '', '',
6541         'optionvalue', 'text', 'NULL', '', '', '',
6542       ],
6543       'primary_key'  => 'optionnum',
6544       'unique'       => [],
6545       'index'        => [ [ 'billbatchnum' ], [ 'optionname' ] ],
6546       'foreign_keys' => [
6547                           { columns    => [ 'billbatchnum' ],
6548                             table      => 'cust_bill_batch',
6549                           },
6550                         ],
6551      },
6552
6553     'msg_template' => {
6554       'columns' => [
6555         'msgnum',     'serial',     '',      '', '', '',
6556         'msgname',   'varchar',     '', $char_d, '', '',
6557         'agentnum',      'int', 'NULL',      '', '', '',
6558         'subject',   'varchar', 'NULL',     512, '', '',
6559         'mime_type', 'varchar',     '', $char_d, '', '',
6560         'body',         'blob', 'NULL',      '', '', '',
6561         'disabled',     'char', 'NULL',       1, '', '',
6562           # migrate these to msg_template_email
6563         'from_addr', 'varchar', 'NULL',     255, '', '',
6564         'bcc_addr',  'varchar', 'NULL',     255, '', '',
6565           # change to not null on v5
6566         'msgclass',  'varchar', 'NULL',      16, '', '',
6567       ],
6568       'primary_key'  => 'msgnum',
6569       'unique'       => [ ],
6570       'index'        => [ ['agentnum'], ],
6571       'foreign_keys' => [
6572                           { columns    => [ 'agentnum' ],
6573                             table      => 'agent',
6574                           },
6575                         ],
6576     },
6577
6578     'msg_template_http' => {
6579       'columns' => [
6580         'num',          'serial',     '',      '', '', '',
6581         'msgnum',          'int',     '',      '', '', '',
6582         'prepare_url', 'varchar', 'NULL',     255, '', '',
6583         'send_url',    'varchar', 'NULL',     255, '', '',
6584         'username',    'varchar', 'NULL', $char_d, '', '',
6585         'password',    'varchar', 'NULL', $char_d, '', '',
6586         'content',        'text', 'NULL',      '', '', '',
6587       ],
6588       'primary_key'  => 'num',
6589       'unique'       => [ [ 'msgnum' ], ],
6590       'index'        => [ ],
6591       'foreign_keys' => [
6592                           { columns    => [ 'msgnum' ],
6593                             table      => 'msg_template',
6594                           },
6595                         ],
6596     },
6597
6598     'template_content' => {
6599       'columns' => [
6600         'contentnum', 'serial',     '',      '', '', '',
6601         'msgnum',        'int',     '',      '', '', '',
6602         'locale',    'varchar', 'NULL',      16, '', '',
6603         'subject',   'varchar', 'NULL',     512, '', '',
6604         'body',         'text', 'NULL',      '', '', '',
6605       ],
6606       'primary_key'  => 'contentnum',
6607       'unique'       => [ ['msgnum', 'locale'] ],
6608       'index'        => [ ],
6609       'foreign_keys' => [
6610                           { columns    => [ 'msgnum' ],
6611                             table      => 'msg_template',
6612                           },
6613                         ],
6614     },
6615
6616     'template_image' => {
6617       'columns' => [
6618         'imgnum',     'serial',     '',      '', '', '',
6619         'name',      'varchar',     '', $char_d, '', '',
6620         'agentnum',      'int', 'NULL',      '', '', '',
6621         'mime_type', 'varchar',     '', $char_d, '', '',
6622         'base64',       'text',     '',      '', '', '',
6623       ],
6624       'primary_key'  => 'imgnum',
6625       'unique'       => [ ],
6626       'index'        => [ ['name'], ['agentnum'] ],
6627     },
6628
6629     'cust_msg' => {
6630       'columns' => [
6631         'custmsgnum', 'serial',     '',     '', '', '',
6632         'custnum',       'int', 'NULL',     '', '', '',
6633         'msgnum',        'int', 'NULL',     '', '', '',
6634         '_date',    @date_type,                 '', '',
6635         'env_from',  'varchar', 'NULL',    255, '', '',
6636         'env_to',    'varchar', 'NULL',    255, '', '',
6637         'header',       'blob', 'NULL',     '', '', '',
6638         'body',         'blob', 'NULL',     '', '', '',
6639         'error',     'varchar', 'NULL',    255, '', '',
6640         'status',    'varchar',     '',$char_d, '', '',
6641         'msgtype',   'varchar', 'NULL',     16, '', '',
6642         'preview',      'text', 'NULL',     '', '', '',
6643       ],
6644       'primary_key'  => 'custmsgnum',
6645       'unique'       => [ ],
6646       'index'        => [ ['custnum'], ],
6647       'foreign_keys' => [
6648                           { columns    => [ 'custnum' ],
6649                             table      => 'cust_main',
6650                           },
6651                           { columns    => [ 'msgnum' ],
6652                             table      => 'msg_template',
6653                           },
6654                         ],
6655     },
6656
6657     'svc_cert' => {
6658       'columns' => [
6659         'svcnum',                'int',     '',      '', '', '',
6660         'recnum',                'int', 'NULL',      '', '', '',
6661         'privatekey',           'text', 'NULL',      '', '', '',
6662         'csr',                  'text', 'NULL',      '', '', '',
6663         'certificate',          'text', 'NULL',      '', '', '',
6664         'cacert',               'text', 'NULL',      '', '', '',
6665         'common_name',       'varchar', 'NULL', $char_d, '', '',
6666         'organization',      'varchar', 'NULL', $char_d, '', '',
6667         'organization_unit', 'varchar', 'NULL', $char_d, '', '',
6668         'city',              'varchar', 'NULL', $char_d, '', '',
6669         'state',             'varchar', 'NULL', $char_d, '', '',
6670         'country',              'char', 'NULL',       2, '', '',
6671         'cert_contact',      'varchar', 'NULL', $char_d, '', '',
6672       ],
6673       'primary_key'  => 'svcnum',
6674       'unique'       => [],
6675       'index'        => [], #recnum
6676       'foreign_keys' => [
6677                           { columns    => [ 'svcnum' ],
6678                             table      => 'cust_svc',
6679                           },
6680                           { columns    => [ 'recnum' ],
6681                             table      => 'domain_record',
6682                           },
6683                         ],
6684     },
6685
6686     'svc_port' => {
6687       'columns' => [
6688         'svcnum',                'int',     '',      '', '', '',
6689         'serviceid', 'varchar', '', 64, '', '', #srvexport / reportfields
6690       ],
6691       'primary_key'  => 'svcnum',
6692       'unique'       => [],
6693       'index'        => [], #recnum
6694       'foreign_keys' => [
6695                           { columns    => [ 'svcnum' ],
6696                             table      => 'cust_svc',
6697                           },
6698                         ],
6699     },
6700
6701     'areacode'  => {
6702       'columns' => [
6703         'areanum',   'serial',        '',      '', '', '',
6704         'code',        'char',        '',       3, '', '',
6705         'country',     'char',    'NULL',       2, '', '',
6706         'state',       'char',    'NULL',       2, '', '',
6707         'description','varchar',  'NULL',     255, '', '',
6708       ],
6709       'primary_key' => 'areanum',
6710       'unique' => [ [ 'areanum' ] ],
6711       'index'  => [],
6712     },
6713
6714     'upgrade_journal' => {
6715       'columns' => [
6716         'upgradenum', 'serial', '', '', '', '',
6717         '_date', 'int', '', '', '', '',
6718         'upgrade', 'varchar', '', $char_d, '', '',
6719         'status', 'varchar', '', $char_d, '', '',
6720         'statustext', 'varchar', 'NULL', $char_d, '', '',
6721       ],
6722       'primary_key' => 'upgradenum',
6723       'unique' => [],
6724       'index' => [ [ 'upgrade' ] ],
6725     },
6726
6727     'upload_target' => {
6728       'columns' => [
6729         'targetnum', 'serial', '', '', '', '',
6730         'agentnum', 'int', 'NULL', '', '', '',
6731         'protocol', 'varchar', '', 10, '', '',
6732         'hostname', 'varchar', '', $char_d, '', '',
6733         'port', 'int', 'NULL', '', '', '',
6734         'username', 'varchar', '', $char_d, '', '',
6735         'password', 'varchar', 'NULL', $char_d, '', '',
6736         'path', 'varchar', 'NULL', $char_d, '', '',
6737         'subject', 'varchar', 'NULL', '255', '', '',
6738         'handling', 'varchar', 'NULL', $char_d, '', '',
6739       ],
6740       'primary_key'   => 'targetnum',
6741       'unique'        => [ [ 'targetnum' ] ],
6742       'index'         => [],
6743       'foreign_keys' => [
6744                           { columns    => [ 'agentnum' ],
6745                             table      => 'agent',
6746                           },
6747                         ],
6748     },
6749
6750     'log' => {
6751       'columns' => [
6752         'lognum',     'serial', '', '', '', '',
6753         '_date',      'int', '', '', '', '',
6754         'agentnum',   'int', 'NULL', '', '', '',
6755         'tablename',  'varchar', 'NULL', $char_d, '', '',
6756         'tablenum',   'int',  'NULL', '', '', '',
6757         'level',      'int',  '', '', '', '',
6758         'message',    'text', '', '', '', '',
6759       ],
6760       'primary_key'  => 'lognum',
6761       'unique'       => [],
6762       'index'        => [ ['_date'], ['level'] ],
6763       'foreign_keys' => [
6764                           { columns    => [ 'agentnum' ],
6765                             table      => 'agent',
6766                           },
6767                         ],
6768     },
6769
6770     'log_context' => {
6771       'columns' => [
6772         'logcontextnum', 'serial', '', '', '', '',
6773         'lognum', 'int', '', '', '', '',
6774         'context', 'varchar', '', $char_d, '', '',
6775       ],
6776       'primary_key'  => 'logcontextnum',
6777       'unique'       => [ [ 'lognum', 'context' ] ],
6778       'index'        => [],
6779       'foreign_keys' => [
6780                           { columns    => [ 'lognum' ],
6781                             table      => 'log',
6782                           },
6783                         ],
6784     },
6785
6786     'log_email' => {
6787       'columns' => [
6788         'logemailnum', 'serial', '', '', '', '',
6789         'context', 'varchar', 'NULL', $char_d, '', '',
6790         'min_level', 'int',  'NULL', '', '', '',
6791         'msgnum', 'int', '',  '', '', '',
6792         'to_addr', 'varchar', 'NULL',     255, '', '',
6793         'context_height',  'int', 'NULL', '', '', '',
6794       ],
6795       'primary_key'  => 'logemailnum',
6796       'unique'       => [],
6797       'index'        => [ ['context'], ['min_level'] ],
6798       'foreign_keys' => [
6799                           { columns    => [ 'msgnum' ],
6800                             table      => 'msg_template',
6801                             references => [ 'msgnum' ],
6802                           },
6803                         ],
6804     },
6805
6806     'svc_alarm' => {
6807       'columns' => [
6808 #       name               type        null   length   default local
6809         'svcnum',          'int',      '',    '',      '',     '',
6810         'alarmsystemnum',  'int',      '',    '',      '',     '',
6811         'alarmtypenum',    'int',      '',    '',      '',     '',
6812         'alarmstationnum', 'int',      '',    '',      '',     '',
6813         'acctnum',         'varchar',  '',    $char_d, '',     '',
6814         '_password',       'varchar',  '',    $char_d, '',     '',
6815         'location',        'varchar', 'NULL', $char_d, '',     '',
6816         'cs_receiver',     'int',     'NULL', '',      '',     '',
6817         'cs_phonenum',     'varchar', 'NULL', $char_d, '',     '',
6818         'serialnum',       'varchar', 'NULL', $char_d, '',     '',
6819         #installer (rep)
6820       ],
6821       'primary_key'  => 'svcnum',
6822       'unique'       => [],
6823       'index'        => [],
6824       'foreign_keys' => [
6825                           { columns    => [ 'svcnum' ],
6826                             table      => 'cust_svc',
6827                           },
6828                           { columns    => [ 'alarmsystemnum' ],
6829                             table      => 'alarm_system',
6830                           },
6831                           { columns    => [ 'alarmtypenum' ],
6832                             table      => 'alarm_type',
6833                           },
6834                           { columns    => [ 'alarmstationnum' ],
6835                             table      => 'alarm_station',
6836                           },
6837                         ],
6838     },
6839
6840     'alarm_system' => { #vendors
6841       'columns' => [
6842         'alarmsystemnum',  'serial',     '',      '', '', '',
6843         'agentnum',           'int', 'NULL',      '', '', '',
6844         'systemname',     'varchar',     '', $char_d, '', '',
6845         'disabled',          'char', 'NULL',       1, '', '',
6846       ],
6847       'primary_key' => 'alarmsystemnum',
6848       'unique'      => [ ['agentnum', 'systemname'] ],
6849       'index'       => [ ['agentnum'], ['disabled'] ],
6850       'foreign_keys' => [
6851                           { columns    => [ 'agentnum' ],
6852                             table      => 'agent',
6853                           },
6854                         ],
6855     },
6856
6857     'alarm_type' => { #inputs and outputs
6858       'columns' => [
6859         'alarmtypenum', 'serial',     '',      '', '', '',
6860         'agentnum',        'int', 'NULL',      '', '', '',
6861         'inputs',          'int',     '', '', '', '',
6862         'outputs',         'int',     '', '', '', '',
6863         'disabled',       'char', 'NULL',       1, '', '',
6864       ],
6865       'primary_key' => 'alarmtypenum',
6866       'unique'      => [ ['agentnum', 'inputs', 'outputs'] ],
6867       'index'       => [ ['agentnum'], ['disabled'] ],
6868       'foreign_keys' => [
6869                           { columns    => [ 'agentnum' ],
6870                             table      => 'agent',
6871                           },
6872                         ],
6873     },
6874
6875     'alarm_station' => { #central station (where the alarm reports to)
6876       'columns' => [
6877         'alarmstationnum', 'serial',     '',      '', '', '',
6878         'agentnum',           'int', 'NULL',      '', '', '',
6879         'stationname',    'varchar',     '', $char_d, '', '',
6880         'disabled',          'char', 'NULL',       1, '', '',
6881       ],
6882       'primary_key' => 'alarmstationnum',
6883       'unique'      => [ ['agentnum', 'stationname'], ],
6884       'index'       => [ ['agentnum'], ['disabled'] ],
6885       'foreign_keys' => [
6886                           { columns    => [ 'agentnum' ],
6887                             table      => 'agent',
6888                           },
6889                         ],
6890     },
6891
6892     'svc_cable' => {
6893       'columns' => [
6894         'svcnum',        'int',     '',      '', '', '',
6895         'providernum',   'int', 'NULL',      '', '', '',
6896         'ordernum',  'varchar', 'NULL', $char_d, '', '',
6897         'modelnum',      'int', 'NULL',      '', '', '',
6898         'serialnum', 'varchar', 'NULL', $char_d, '', '',
6899         'mac_addr',  'varchar', 'NULL',      12, '', '',
6900       ],
6901       'primary_key'  => 'svcnum',
6902       'unique'       => [ ['serialnum'] , ['mac_addr'] ],
6903       'index'        => [],
6904       'foreign_keys' => [
6905                           { columns    => [ 'svcnum' ],
6906                             table      => 'cust_svc',
6907                           },
6908                           { columns    => [ 'providernum' ],
6909                             table      => 'cable_provider',
6910                           },
6911                           { columns    => [ 'modelnum' ],
6912                             table      => 'cable_model',
6913                           },
6914                         ],
6915     },
6916
6917     'cable_model' => {
6918       'columns' => [
6919         'modelnum',    'serial',     '',      '', '', '',
6920         'model_name', 'varchar',     '', $char_d, '', '',
6921         'disabled',      'char', 'NULL',       1, '', '',
6922       ],
6923       'primary_key' => 'modelnum',
6924       'unique' => [ [ 'model_name' ], ],
6925       'index'  => [],
6926     },
6927
6928     'cable_provider' => {
6929       'columns' => [
6930         'providernum', 'serial',     '',      '', '', '',
6931         'provider',   'varchar',     '', $char_d, '', '',
6932         'disabled',      'char', 'NULL',       1, '', '',
6933       ],
6934       'primary_key' => 'providernum',
6935       'unique' => [ [ 'provider' ], ],
6936       'index'  => [],
6937     },
6938
6939     'svc_conferencing' => {
6940       'columns' => [
6941         'svcnum',            'int',     '',      '', '', '',
6942         'conf_id',           'int', 'NULL',      '', '', '', #"system assigned"
6943         'conf_name',     'varchar',     '', $char_d, '', '',
6944         'conf_password', 'varchar',     '', $char_d, '', '',
6945         'access_code',   'varchar',     '',      16, '', '',
6946         'duration',          'int',     '',      '', '', '',
6947         'participants',      'int',     '',      '', '', '',
6948         'conftypenum',       'int',     '',      '', '', '',
6949         'confqualitynum',    'int',     '',      '', '', '',
6950         'opt_recording',    'char', 'NULL',       1, '', '',
6951         'opt_sip',          'char', 'NULL',       1, '', '',
6952         'opt_phone',        'char', 'NULL',       1, '', '',
6953       ],
6954       'primary_key' => 'svcnum',
6955       'unique' => [],
6956       'index'  => [],
6957       'foreign_keys' => [
6958                           { columns => [ 'svcnum' ],
6959                             table   => 'cust_svc',
6960                           },
6961                           { columns => [ 'conftypenum' ],
6962                             table   => 'conferencing_type',
6963                           },
6964                           { columns => [ 'confqualitynum' ],
6965                             table   => 'conferencing_quality',
6966                           },
6967                         ],
6968     },
6969
6970     'conferencing_type' => {
6971       'columns' => [
6972         'conftypenum',  'int',     '',      '', '', '',
6973         'typeid'      , 'int',     '',      '', '', '',
6974         'typename', 'varchar',     '', $char_d, '', '',
6975         'disabled',    'char', 'NULL',       1, '', '',
6976       ],
6977       'primary_key' => 'conftypenum',
6978       'unique'      => [ [ 'typeid', 'disabled' ], [ 'typename', 'disabled' ] ],
6979       'index'       => [],
6980     },
6981
6982     'conferencing_quality' => {
6983       'columns' => [
6984         'confqualitynum',  'int',     '',      '', '', '',
6985         'qualityid'      , 'int',     '',      '', '', '',
6986         'qualityname', 'varchar',     '', $char_d, '', '',
6987         'disabled',       'char', 'NULL',       1, '', '',
6988       ],
6989       'primary_key' => 'confqualitynum',
6990       'unique'      => [ [ 'qualityid', 'disabled' ], [ 'qualityname', 'disabled' ] ],
6991       'index'       => [],
6992     },
6993
6994     'svc_video' => {
6995       'columns' => [
6996         'svcnum',            'int', '', '', '', '',
6997         'smartcard_num', 'varchar', '', 16, '', '',
6998         'mac_addr',      'varchar', '', 12, '', '',
6999         'duration',          'int', '', '', '', '',
7000       ],
7001       'primary_key' => 'svcnum',
7002       'unique' => [], # [ 'smartcard_num' ], [ 'mac_addr' ], ],
7003       'index'  => [],
7004       'foreign_keys' => [
7005                           { columns => [ 'svcnum' ],
7006                             table   => 'cust_svc',
7007                           },
7008                         ],
7009     },
7010
7011     'circuit_type' => {
7012       'columns' => [
7013         'typenum',     'serial',     '',      '', '', '',
7014         'typename',   'varchar',     '', $char_d, '', '',
7015         'disabled',      'char', 'NULL',       1, '', '',
7016         # speed? number of voice lines? anything else?
7017       ],
7018       'primary_key' => 'typenum',
7019       'unique' => [ [ 'typename' ] ],
7020       'index'  => [],
7021     },
7022
7023     'circuit_provider' => {
7024       'columns' => [
7025         'providernum', 'serial',     '',      '', '', '',
7026         'provider',   'varchar',     '', $char_d, '', '',
7027         'disabled',      'char', 'NULL',       1, '', '',
7028       ],
7029       'primary_key' => 'providernum',
7030       'unique' => [ [ 'provider' ], ],
7031       'index'  => [],
7032     },
7033
7034     'circuit_termination' => {
7035       'columns' => [
7036         'termnum',     'serial',     '',      '', '', '',
7037         'termination','varchar',     '', $char_d, '', '',
7038         'disabled',      'char', 'NULL',       1, '', '',
7039       ],
7040       'primary_key' => 'termnum',
7041       'unique' => [ [ 'termination' ] ],
7042       'index' => [],
7043     },
7044
7045     'svc_circuit' => {
7046       'columns' => [
7047         'svcnum',                   'int',     '', '', '', '',
7048         'typenum',                  'int',     '', '', '', '',
7049         'providernum',              'int',     '', '', '', '',
7050         'termnum',                  'int',     '', '', '', '',
7051         'circuit_id',           'varchar',     '', 64, '', '',
7052         'desired_due_date',         'int', 'NULL', '', '', '',
7053         'due_date',                 'int', 'NULL', '', '', '',
7054         'vendor_order_id',      'varchar', 'NULL', $char_d,  '', '',
7055         'vendor_qual_id',       'varchar', 'NULL', $char_d,  '', '',
7056         'vendor_order_type',    'varchar', 'NULL', $char_d,  '', '',
7057         'vendor_order_status',  'varchar', 'NULL', $char_d,  '', '',
7058         'endpoint_ip_addr',     'varchar', 'NULL', 40, '', '',
7059         'endpoint_mac_addr',    'varchar', 'NULL', 12, '', '',
7060         'internal_circuit_id',  'varchar', 'NULL', 64, '', '',
7061       ],
7062       'primary_key' => 'svcnum',
7063       'unique'      => [],
7064       'index'       => [ [ 'providernum' ], [ 'typenum' ] ],
7065       'foreign_keys' => [
7066                           { columns => [ 'svcnum' ],
7067                             table   => 'cust_svc',
7068                           },
7069                           { columns => [ 'typenum' ],
7070                             table   => 'circuit_type',
7071                           },
7072                           { columns => [ 'providernum' ],
7073                             table   => 'circuit_provider',
7074                           },
7075                           { columns => [ 'termnum' ],
7076                             table   => 'circuit_termination',
7077                           },
7078       ],
7079     },
7080
7081     'svc_fiber' => {
7082       'columns' => [
7083         'svcnum',         'int',     '',      '', '', '',
7084         'oltnum',         'int', 'NULL',      '', '', '',
7085         'shelf',          'int', 'NULL',      '', '', '',
7086         'card',           'int', 'NULL',      '', '', '',
7087         'olt_port',       'int', 'NULL',      '', '', '',
7088         'ont_id',         'int', 'NULL',      '', '', '',
7089         'ont_typenum',    'int', 'NULL',      '', '', '',
7090         'ont_serial', 'varchar', 'NULL', $char_d, '', '',
7091         'ont_port',   'varchar', 'NULL',      16, '', '',
7092         'circuit_id', 'varchar', 'NULL', $char_d, '', '',
7093         'vlan',           'int', 'NULL',      '', '', '',
7094         'signal',     'decimal', 'NULL',  '10,2', '', '',
7095         'speed_up',       'int', 'NULL',      '', '', '',
7096         'speed_down',     'int', 'NULL',      '', '', '',
7097         'ont_install','varchar', 'NULL', $char_d, '', '',
7098       ],
7099       'primary_key' => 'svcnum',
7100       'unique'      => [ ],
7101       'index'       => [ [ 'ont_serial' ] ],
7102       'foreign_keys' => [
7103                           { columns => [ 'svcnum' ],
7104                             table   => 'cust_svc',
7105                           },
7106                           { columns => [ 'oltnum' ],
7107                             table   => 'fiber_olt',
7108                           },
7109                           { columns => [ 'ont_typenum' ],
7110                             table   => 'hardware_type',
7111                             references => [ 'typenum' ],
7112                           },
7113                         ],
7114     },
7115
7116     'fiber_olt' => {
7117       'columns' => [
7118         'oltnum',   'serial', '',       '', '', '',
7119         'oltname', 'varchar', '',  $char_d, '', '',
7120         'sitenum',     'int', 'NULL',   '', '', '',
7121         'serial',  'varchar', '',  $char_d, '', '',
7122         'disabled',   'char', 'NULL',    1, '', '',
7123       ],
7124       'primary_key' => 'oltnum',
7125       'unique' => [ ],
7126       'index'  => [ ],
7127       'foreign_keys' => [
7128                           { columns => [ 'sitenum' ],
7129                             table   => 'olt_site',
7130                           },
7131                         ],
7132     },
7133
7134     'olt_site' => {
7135       'columns' => [
7136         'sitenum',  'serial', '',      '', '', '',
7137         'market',  'varchar', '', $char_d, '', '',
7138         'site',    'varchar', '', $char_d, '', '',
7139       ],
7140       'primary_key' => 'sitenum',
7141       'unique' => [ [ 'market', 'site' ] ],
7142       'index' => [ ],
7143     },
7144
7145
7146
7147
7148
7149     'vend_main' => {
7150       'columns' => [
7151         'vendnum',   'serial',     '',      '', '', '',
7152         'vendname', 'varchar',     '', $char_d, '', '',
7153         'classnum',     'int',     '',      '', '', '',
7154         'disabled',    'char', 'NULL',       1, '', '',
7155       ],
7156       'primary_key'  => 'vendnum',
7157       'unique'       => [ ['vendname', 'disabled'] ],
7158       'index'        => [],
7159       'foreign_keys' => [
7160                           { columns    => [ 'classnum' ],
7161                             table      => 'vend_class',
7162                           },
7163                         ],
7164     },
7165
7166     'vend_class' => {
7167       'columns' => [
7168         'classnum',     'serial',     '',      '', '', '',
7169         'classname',   'varchar',     '', $char_d, '', '',
7170         'disabled',       'char', 'NULL',       1, '', '',
7171       ],
7172       'primary_key' => 'classnum',
7173       'unique'      => [],
7174       'index'       => [ ['disabled'] ],
7175     },
7176
7177     'vend_bill' => {
7178       'columns' => [
7179         'vendbillnum',    'serial',     '',      '', '', '',
7180         'vendnum',           'int',     '',      '', '', '',
7181         #'_date',        @date_type,                  '', '',
7182         '_date',     'int', '', '',                   '', '',
7183         'charged',     @money_type,                  '', '',
7184       ],
7185       'primary_key'  => 'vendbillnum',
7186       'unique'       => [],
7187       'index'        => [ ['vendnum'], ['_date'], ],
7188       'foreign_keys' => [
7189                           { columns    => [ 'vendnum' ],
7190                             table      => 'vend_main',
7191                           },
7192                         ],
7193     },
7194
7195     'vend_pay' => {
7196       'columns' => [
7197         'vendpaynum',   'serial',    '',       '', '', '',
7198         'vendnum',         'int',    '',       '', '', '',
7199         #'_date',     @date_type,                   '', '',
7200         '_date',     'int', '', '',                   '', '',
7201         'paid',      @money_type,                  '', '',
7202       ],
7203       'primary_key'  => 'vendpaynum',
7204       'unique'       => [],
7205       'index'        => [ [ 'vendnum' ], [ '_date' ], ],
7206       'foreign_keys' => [
7207                           { columns    => [ 'vendnum' ],
7208                             table      => 'vend_main',
7209                           },
7210                         ],
7211     },
7212
7213     'vend_bill_pay' => {
7214       'columns' => [
7215         'vendbillpaynum', 'serial',     '',   '', '', '',
7216         'vendbillnum',       'int',     '',   '', '', '',
7217         'vendpaynum',        'int',     '',   '', '', '',
7218         'amount',  @money_type, '', '',
7219         #? '_date',   @date_type, '', '',
7220       ],
7221       'primary_key'  => 'vendbillpaynum',
7222       'unique'       => [],
7223       'index'        => [ [ 'vendbillnum' ], [ 'vendpaynum' ] ],
7224       'foreign_keys' => [
7225                           { columns    => [ 'vendbillnum' ],
7226                             table      => 'vend_bill',
7227                           },
7228                           { columns    => [ 'vendpaynum' ],
7229                             table      => 'vend_pay',
7230                           },
7231                         ],
7232     },
7233
7234     %{ tables_hashref_torrus() },
7235
7236     # tables of ours for doing torrus virtual port combining
7237     'torrus_srvderive' => {
7238       'columns' => [
7239         'derivenum',     'serial',     '', '', '', '',
7240         'serviceid',    'varchar',     '', 64, '', '', #srvexport / reportfields
7241         'last_srv_date',   'date', 'NULL', '', '', '',
7242       ],
7243       'primary_key' => 'derivenum',
7244       'unique' => [ ['serviceid'] ],
7245       'index'  => [],
7246     },
7247
7248     'torrus_srvderive_component' => {
7249       'columns' => [
7250         'componentnum', 'serial', '', '', '', '',
7251         'derivenum',       'int', '', '', '', '',
7252         'serviceid',   'varchar', '', 64, '', '', #srvexport / reportfields
7253       ],
7254       'primary_key'  => 'componentnum',
7255       'unique'       => [ [ 'derivenum', 'serviceid' ], ],
7256       'index'        => [ [ 'derivenum', ], ],
7257       'foreign_keys' => [
7258                           { columns    => [ 'derivenum' ],
7259                             table      => 'torrus_srvderive',
7260                           },
7261                         ],
7262     },
7263
7264     'invoice_mode' => {
7265       'columns' => [
7266         'modenum',      'serial', '', '', '', '',
7267         'agentnum',        'int', 'NULL', '', '', '',
7268         'modename',    'varchar', '', 32, '', '',
7269       ],
7270       'primary_key' => 'modenum',
7271       'unique'      => [ ],
7272       'index'       => [ ],
7273       'foreign_keys' => [
7274                           { columns    => [ 'agentnum' ],
7275                             table      => 'agent',
7276                           },
7277                         ],
7278     },
7279
7280     'invoice_conf' => {
7281       'columns' => [
7282         'confnum',              'serial',   '', '', '', '',
7283         'modenum',              'int',      '', '', '', '',
7284         'locale',               'varchar',  'NULL', 16, '', '',
7285         'notice_name',          'varchar',  'NULL', 64, '', '',
7286         'subject',              'varchar',  'NULL', 64, '', '',
7287         'htmlnotes',            'text',     'NULL', '', '', '',
7288         'htmlfooter',           'text',     'NULL', '', '', '',
7289         'htmlsummary',          'text',     'NULL', '', '', '',
7290         'htmlreturnaddress',    'text',     'NULL', '', '', '',
7291         'latexnotes',           'text',     'NULL', '', '', '',
7292         'latexfooter',          'text',     'NULL', '', '', '',
7293         'latexsummary',         'text',     'NULL', '', '', '',
7294         'latexsmallfooter',     'text',     'NULL', '', '', '',
7295         'latexreturnaddress',   'text',     'NULL', '', '', '',
7296         'with_latexcoupon',     'char',     'NULL', '1', '', '',
7297         'htmlwatermark',        'text',     'NULL', '', '', '',
7298         'latexwatermark',       'text',     'NULL', '', '', '',
7299         'lpr',                  'varchar',  'NULL', $char_d, '', '',
7300       ],
7301       'primary_key'  => 'confnum',
7302       'unique'       => [ [ 'modenum', 'locale' ] ],
7303       'index'        => [ ],
7304       'foreign_keys' => [
7305                           { columns    => [ 'modenum' ],
7306                             table      => 'invoice_mode',
7307                           },
7308                         ],
7309     },
7310
7311     'export_batch' => {
7312       'columns' => [
7313         'batchnum',    'serial',     '',      '', '', '',
7314         'exportnum',      'int',     '',      '', '', '',
7315         '_date',          'int',     '',      '', '', '',
7316         'status',     'varchar', 'NULL',      32, '', '',
7317         'statustext',    'text', 'NULL',      '', '', '',
7318       ],
7319       'primary_key'  => 'batchnum',
7320       'unique'       => [],
7321       'index'        => [ [ 'exportnum' ], [ 'status' ] ],
7322       'foreign_keys' => [
7323                           { columns    => [ 'exportnum' ],
7324                             table      => 'part_export',
7325                             references => [ 'exportnum' ]
7326                           },
7327                         ],
7328     },
7329
7330     'export_batch_item' => {
7331       'columns' => [
7332         'itemnum',     'serial',     '',      '', '', '',
7333         'batchnum',       'int',     '',      '', '', '',
7334         'svcnum',         'int',     '',      '', '', '',
7335         'action',     'varchar',     '',      32, '', '',
7336         'data',          'text', 'NULL',      '', '', '',
7337         'frozen',        'char', 'NULL',       1, '', '',
7338       ],
7339       'primary_key'  => 'itemnum',
7340       'unique'       => [],
7341       'index'        => [ [ 'batchnum' ], [ 'svcnum' ] ],
7342       'foreign_keys' => [
7343                           { columns    => [ 'batchnum' ],
7344                             table      => 'export_batch',
7345                             references => [ 'batchnum' ]
7346                           },
7347                         ],
7348     },
7349
7350     # lookup table for states, similar to msa and lata
7351     'state' => {
7352       'columns' => [
7353         'statenum', 'int',  '', '', '', '',
7354         'country',  'char', '',  2, '', '',
7355         'state',    'char', '', $char_d, '', '',
7356         'fips',     'char', '',  3, '', '',
7357       ],
7358       'primary_key' => 'statenum',
7359       'unique' => [ [ 'country', 'state' ], ],
7360       'index' => [],
7361     },
7362
7363     # eventually link to tower/sector?
7364     'deploy_zone' => {
7365       'columns' => [
7366         'zonenum',        'serial',  '',     '',      '', '',
7367         'description',    'char',    'NULL', $char_d, '', '',
7368         'agentnum',       'int',     '',     '',      '', '',
7369         'censusyear',     'char',    'NULL', 4,      '', '',
7370         'dbaname',        'char',    'NULL', $char_d, '', '',
7371         'zonetype',       'char',    '',     1,       '', '',
7372         'technology',     'int',     '',     '',      '', '',
7373         'spectrum',       'int',     'NULL', '',      '', '',
7374         'adv_speed_up',   'decimal', '',     '10,3', '0', '',
7375         'adv_speed_down', 'decimal', '',     '10,3', '0', '',
7376         'cir_speed_up',   'decimal', '',     '10,3', '0', '',
7377         'cir_speed_down', 'decimal', '',     '10,3', '0', '',
7378         'is_broadband',   'char',    'NULL', 1,       '', '',
7379         'is_voice',       'char',    'NULL', 1,       '', '',
7380         'is_consumer',    'char',    'NULL', 1,       '', '',
7381         'is_business',    'char',    'NULL', 1,       '', '',
7382         'active_date',    @date_type,                 '', '',
7383         'expire_date',    @date_type,                 '', '',
7384       ],
7385       'primary_key' => 'zonenum',
7386       'unique' => [],
7387       'index'  => [ [ 'agentnum' ] ],
7388       'foreign_keys' => [
7389                           { columns     => [ 'agentnum' ],
7390                             table       => 'agent',
7391                             references  => [ 'agentnum' ],
7392                           },
7393                         ],
7394     },
7395
7396     'deploy_zone_block' => {
7397       'columns' => [
7398         'blocknum',       'serial',  '',     '',      '', '',
7399         'zonenum',        'int',     '',     '',      '', '',
7400         'censusblock',    'char',    '',     15,      '', '',
7401         'censusyear',     'char','NULL',      4,      '', '',
7402       ],
7403       'primary_key' => 'blocknum',
7404       'unique' => [],
7405       'index'  => [ [ 'zonenum' ] ],
7406       'foreign_keys' => [
7407                           { columns     => [ 'zonenum' ],
7408                             table       => 'deploy_zone',
7409                             references  => [ 'zonenum' ],
7410                           },
7411                         ],
7412     },
7413
7414     'deploy_zone_vertex' => {
7415       'columns' => [
7416         'vertexnum',      'serial',  '',     '',      '', '',
7417         'zonenum',        'int',     '',     '',      '', '',
7418         'latitude',       'decimal', '',     '10,7',  '', '',
7419         'longitude',      'decimal', '',     '10,7',  '', '',
7420       ],
7421       'primary_key' => 'vertexnum',
7422       'unique' => [ ],
7423       'index'  => [ ],
7424       'foreign_keys' => [
7425                           { columns     => [ 'zonenum' ],
7426                             table       => 'deploy_zone',
7427                             references  => [ 'zonenum' ],
7428                           },
7429                         ],
7430     },
7431
7432     'cacti_page' => {
7433       'columns' => [
7434         'cacti_pagenum',  'serial',   '',     '', '', '',
7435         'exportnum',      'int',      'NULL', '', '', '',
7436         'svcnum',         'int',      'NULL', '', '', '',
7437         'graphnum',       'int',      'NULL', '', '', '',
7438         'imported',       @date_type,             '', '',
7439         'content',        'text',     'NULL', '', '', '',
7440         'thumbnail',      'text',     'NULL', '', '', '',
7441       ],
7442       'primary_key' => 'cacti_pagenum',
7443       'unique'  => [ ],
7444       'index'   => [ ['svcnum'], ['imported'] ],
7445       'foreign_keys' => [
7446                           { columns    => [ 'svcnum' ],
7447                             table      => 'cust_svc',
7448                             references => [ 'svcnum' ],
7449                           },
7450                           { columns    => [ 'exportnum' ],
7451                             table      => 'part_export',
7452                             references => [ 'exportnum' ],
7453                           },
7454                         ],
7455     },
7456
7457     'report_batch' => {
7458       'columns' => [
7459         'reportbatchnum', 'serial',      '',  '', '', '',
7460         'reportname',     'varchar',     '', 255, '', '',
7461         'agentnum',           'int', 'NULL',  '', '', '',
7462         'send_date',     @date_type,              '', '',
7463         'sdate',         @date_type,              '', '',
7464         'edate',         @date_type,              '', '',
7465         'usernum',            'int', 'NULL',  '', '', '',
7466         'msgnum',             'int', 'NULL',  '', '', '',
7467         # add report params here as necessary
7468       ],
7469       'primary_key' => 'reportbatchnum',
7470       'unique' => [],
7471       'index'  => [],
7472       'foreign_keys' => [
7473                           { columns    => [ 'agentnum' ],
7474                             table      => 'agent',
7475                             references => [ 'agentnum' ],
7476                           },
7477                           { columns    => [ 'usernum' ],
7478                             table      => 'access_user',
7479                             references => [ 'usernum' ],
7480                           },
7481                           { columns    => [ 'msgnum' ],
7482                             table      => 'msg_template',
7483                             references => [ 'msgnum' ],
7484                           },
7485                         ],
7486     },
7487
7488     'password_history' => {
7489       'columns' => [
7490         'passwordnum',        'serial',  '',          '', '', '',
7491         '_password',          'varchar', 'NULL', $char_d, '', '',
7492         'encryption_method',  'varchar', 'NULL', $char_d, '', '',
7493         'created',   @date_type,   '', '',
7494         # each table that needs password history gets a column here, and
7495         # an entry in foreign_keys.
7496         'svc_acct__svcnum',     'int', 'NULL', '', '', '',
7497         'svc_dsl__svcnum',      'int', 'NULL', '', '', '',
7498         'svc_alarm__svcnum',    'int', 'NULL', '', '', '',
7499         'agent__agentnum',      'int', 'NULL', '', '', '',
7500         'contact__contactnum',  'int', 'NULL', '', '', '',
7501         'access_user__usernum', 'int', 'NULL', '', '', '',
7502       ],
7503       'primary_key' => 'passwordnum',
7504       'unique' => [],
7505       'index'  => [],
7506       'foreign_keys' => [
7507                           { columns     => [ 'svc_acct__svcnum' ],
7508                             table       => 'svc_acct',
7509                             references  => [ 'svcnum' ],
7510                           },
7511                           { columns     => [ 'svc_dsl__svcnum' ],
7512                             table       => 'svc_dsl',
7513                             references  => [ 'svcnum' ],
7514                           },
7515                           { columns     => [ 'svc_alarm__svcnum' ],
7516                             table       => 'svc_alarm',
7517                             references  => [ 'svcnum' ],
7518                           },
7519                           { columns    => [ 'agent__agentnum' ],
7520                             table      => 'agent',
7521                             references => [ 'agentnum' ],
7522                           },
7523                           { columns    => [ 'contact__contactnum' ],
7524                             table      => 'contact',
7525                             references => [ 'contactnum' ],
7526                           },
7527                           { columns    => [ 'access_user__usernum' ],
7528                             table      => 'access_user',
7529                             references => [ 'usernum' ],
7530                           },
7531                         ],
7532     },
7533
7534     'webservice_log' => {
7535       'columns' => [
7536         'webservicelognum',    'serial',      '',      '', '', '', #big? hubrus
7537         'svcnum',                 'int',  'NULL',      '', '', '', #just in case
7538         'custnum',                'int',      '',      '', '', '',
7539         'method',             'varchar',      '', $char_d, '', '',
7540         'quantity',               'int',      '',      '', '', '', #i.e. pages
7541         '_date',             @date_type,                   '', '',
7542         'status',             'varchar',  'NULL', $char_d, '', '',
7543         'rated_price',        'decimal',  'NULL',  '10,2', '', '',
7544       ],
7545       'primary_key'  => 'webservicelognum',
7546       'unique'       => [],
7547       'index'        => [ ['custnum'], ['status'] ],
7548       'foreign_keys' => [
7549                           { columns => [ 'custnum' ],
7550                             table   => 'cust_main',
7551                           },
7552                           #no FK on svcnum... we don't want to purge these on
7553                           # service deletion
7554                         ],
7555     },
7556
7557     'rt_field_charge' => {
7558       'columns' => [
7559         'rtfieldchargenum',    'serial',      '',      '', '', '',
7560         'pkgnum',                 'int',      '',      '', '', '',
7561         'ticketid',               'int',      '',      '', '', '',
7562         'rate',             @money_type,                   '', '',
7563         'units',              'decimal',      '',  '10,4', '', '',
7564         'charge',           @money_type,                   '', '',
7565         '_date',             @date_type,                   '', '',
7566       ],
7567       'primary_key'  => 'rtfieldchargenum',
7568       'unique'       => [],
7569       'index'        => [ ['pkgnum', 'ticketid'] ],
7570       'foreign_keys' => [
7571                           { columns    => [ 'pkgnum' ],
7572                             table      => 'cust_pkg',
7573                           },
7574                         ],
7575     },
7576
7577     'commission_schedule' => {
7578       'columns' => [
7579         'schedulenum',    'serial',     '',      '', '', '',
7580         'schedulename',  'varchar',     '', $char_d, '', '',
7581         'reasonnum',         'int', 'NULL',      '', '', '',
7582         'basis',         'varchar', 'NULL',      32, '', '',
7583       ],
7584       'primary_key'  => 'schedulenum',
7585       'unique'       => [],
7586       'index'        => [],
7587     },
7588
7589     'commission_rate' => {
7590       'columns' => [
7591         'commissionratenum', 'serial',     '',      '', '', '',
7592         'schedulenum',       'int',     '',      '', '', '',
7593         'cycle',             'int',     '',      '', '', '',
7594         'amount',            @money_type,          '', '',
7595         'percent',           'decimal','',   '7,4', '', '',
7596       ],
7597       'primary_key'  => 'commissionratenum',
7598       'unique'       => [ [ 'schedulenum', 'cycle', ] ],
7599       'index'        => [],
7600       'foreign_keys' => [
7601                           { columns => [ 'schedulenum' ],
7602                             table   => 'commission_schedule',
7603                           },
7604                         ],
7605     },
7606
7607     'saved_search' => {
7608       'columns' => [
7609         'searchnum',    'serial',  '',          '', '', '',
7610         'usernum',      'int',     'NULL',      '', '', '',
7611         'searchname',   'varchar', '',     $char_d, '', '',
7612         'path',         'varchar', '',     $char_d, '', '',
7613         'params',       'text',    'NULL',      '', '', '',
7614         'disabled',     'char',    'NULL',       1, '', '',
7615         'freq',         'varchar', 'NULL',      16, '', '',
7616         'last_sent',    'int',     'NULL',      '', '', '',
7617         'format',       'varchar', 'NULL',      32, '', '',
7618       ],
7619       'primary_key'   => 'searchnum',
7620       'unique'        => [],
7621       'index'         => [],
7622       'foreign_keys'  => [
7623                            { columns => [ 'usernum' ],
7624                              table   => 'access_user',
7625                            },
7626                          ],
7627     },
7628
7629     'addr_status' => {
7630       'columns' => [
7631         'addrnum',  'serial',      '', '', '', '',
7632         'ip_addr',  'varchar', 'NULL', 40, '', '',
7633         '_date',    @date_type,            '', '',
7634         'up',       'char',    'NULL',  1, '', '',
7635         'delay',    'int',     'NULL', '', '', '',
7636       ],
7637       'primary_key'   => 'addrnum',
7638       'unique'        => [ [ 'ip_addr' ] ],
7639       'index'         => [ [ '_date' ] ],
7640       'foreign_keys'  => [],
7641     },
7642
7643     'realestate_unit' => {
7644       'columns' => [
7645         'realestatenum',    'serial',  '',     '',      '',  '',
7646         'realestatelocnum', 'int',     '',     '',      '',  '',
7647         'agentnum',         'int',     'NULL', '',      '',  '',
7648         'unit_title',       'varchar', '',     $char_d, '',  '',
7649         'disabled',         'char',    'NULL', 1,       '',  '',
7650       ],
7651       'primary_key'  => 'realestatenum',
7652       'unique'       => [ ['unit_title'] ],
7653       'index'        => [
7654         ['agentnum'],
7655         ['realestatelocnum'],
7656         ['disabled'],
7657         ['unit_title'],
7658       ],
7659       'foreign_keys' => [
7660         {columns => ['agentnum'], table => 'agent'},
7661         {columns => ['realestatelocnum'] => table => 'realestate_location'},
7662       ],
7663     },
7664
7665     realestate_location => {
7666       'columns' => [
7667         'realestatelocnum', 'serial',  '',     '',      '', '',
7668         'agentnum',         'int',     'NULL', '',      '', '',
7669        'location_title',   'varchar', '',     $char_d, '', '',
7670         'address1',         'varchar', 'NULL', $char_d, '',  '',
7671         'address2',         'varchar', 'NULL', $char_d, '',  '',
7672         'city',             'varchar', 'NULL', $char_d, '',  '',
7673         'state',            'varchar', 'NULL', $char_d, '',  '',
7674         'zip',              'char',    'NULL', 5,       '',  '',
7675         'disabled',         'char',    'NULL', 1,       '',  '',
7676       ],
7677       primary_key  => 'realestatelocnum',
7678       'unique'     => [ ['location_title'] ],
7679       'index'      => [ ['agentnum'], ['disabled'] ],
7680       'foreign_keys' => [
7681         {columns => ['agentnum'], table => 'agent'},
7682       ],
7683     },
7684
7685     svc_realestate => {
7686       columns => [
7687         'svcnum',        'serial',  '',     '',      '', '',
7688         'realestatenum', 'int',     'NULL', '',      '', '',
7689       ],
7690       primary_key => 'svcnum',
7691       index => [],
7692     },
7693
7694     # name type nullability length default local
7695
7696     #'new_table' => {
7697     #  'columns' => [
7698     #    'num', 'serial',       '', '', '', '',
7699     #  ],
7700     #  'primary_key' => 'num',
7701     #  'unique' => [],
7702     #  'index'  => [],
7703     #},
7704
7705   };
7706
7707 }
7708
7709 =back
7710
7711 =head1 BUGS
7712
7713 =head1 SEE ALSO
7714
7715 L<DBIx::DBSchema>
7716
7717 =cut
7718
7719 1;