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