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