c8f8c815e4f39a2b723bec03337c6f83ac75866c
[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         'paycvv',   'varchar', 'NULL', 512, '', '', 
1182         'paymask', 'varchar', 'NULL', $char_d, '', '', 
1183         #'paydate',  @date_type, '', '', 
1184         'paydate',  'varchar', 'NULL', 10, '', '', 
1185         'paystart_month', 'int', 'NULL', '', '', '', 
1186         'paystart_year',  'int', 'NULL', '', '', '', 
1187         'payissue', 'varchar', 'NULL', 2, '', '', 
1188         'payname',  'varchar', 'NULL', 2*$char_d, '', '', 
1189         'paystate', 'varchar', 'NULL', $char_d, '', '', 
1190         'paytype',  'varchar', 'NULL', $char_d, '', '', 
1191         'payip',    'varchar', 'NULL', 15, '', '', 
1192         'geocode',  'varchar', 'NULL', 20,  '', '',
1193         'censustract', 'varchar', 'NULL', 20,  '', '', # 7 to save space?
1194         'censusyear', 'char', 'NULL', 4, '', '',
1195         'district', 'varchar', 'NULL', 20, '', '',
1196         'tax',      'char', 'NULL', 1, '', '', 
1197         'otaker',   'varchar', 'NULL',    32, '', '', 
1198         'usernum',   'int', 'NULL', '', '', '',
1199         'refnum',   'int',  '',     '', '', '', 
1200         'referral_custnum', 'int',  'NULL', '', '', '', 
1201         'comments', 'text', 'NULL', '', '', '', 
1202         'spool_cdr','char', 'NULL', 1, '', '', 
1203         'squelch_cdr','char', 'NULL', 1, '', '', 
1204         'cdr_termination_percentage', 'decimal', 'NULL', '7,4', '', '',
1205         'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
1206         'credit_limit', @money_typen, '', '',
1207         'archived', 'char', 'NULL', 1, '', '',
1208         'email_csv_cdr', 'char', 'NULL', 1, '', '',
1209         'accountcode_cdr', 'char', 'NULL', 1, '', '',
1210         'billday',   'int', 'NULL', '', '', '',
1211         'prorate_day',   'int', 'NULL', '', '', '',
1212         'edit_subject', 'char', 'NULL', 1, '', '',
1213         'locale', 'varchar', 'NULL', 16, '', '', 
1214         'calling_list_exempt', 'char', 'NULL', 1, '', '',
1215         'invoice_noemail', 'char', 'NULL', 1, '', '',
1216         'message_noemail', 'char', 'NULL', 1, '', '',
1217         'bill_locationnum', 'int', 'NULL', '', '', '',
1218         'ship_locationnum', 'int', 'NULL', '', '', '',
1219         'invoice_ship_address', 'char', 'NULL', 1, '', '',
1220       ],
1221       'primary_key' => 'custnum',
1222       'unique' => [ [ 'agentnum', 'agent_custid' ] ],
1223       #'index' => [ ['last'], ['company'] ],
1224       'index' => [
1225                    [ 'agentnum' ], [ 'refnum' ], [ 'classnum' ], [ 'usernum' ],
1226                    [ 'custbatch' ],
1227                    [ 'referral_custnum' ],
1228                    [ 'payby' ], [ 'paydate' ],
1229                    [ 'archived' ],
1230                    [ 'ship_locationnum' ],
1231                    [ 'bill_locationnum' ],
1232                  ],
1233     },
1234
1235     'cust_recon' => {  # (some sort of not-well understood thing for OnPac)
1236       'columns' => [
1237         'reconid',      'serial',  '',          '', '', '', 
1238         'recondate',    @date_type,                 '', '', 
1239         'custnum',      'int'   ,  '',          '', '', '', 
1240         'agentnum',     'int',     '',          '', '', '', 
1241         'last',         'varchar', '',     $char_d, '', '', 
1242         'first',        'varchar', '',     $char_d, '', '', 
1243         'address1',     'varchar', '',     $char_d, '', '', 
1244         'address2',     'varchar', 'NULL', $char_d, '', '', 
1245         'city',         'varchar', '',     $char_d, '', '', 
1246         'state',        'varchar', 'NULL', $char_d, '', '', 
1247         'zip',          'varchar', 'NULL',      10, '', '', 
1248         'pkg',          'varchar', 'NULL', $char_d, '', '', 
1249         'adjourn',      @date_type,                 '', '',
1250         'status',       'varchar', 'NULL',      10, '', '', 
1251         'agent_custid', 'varchar',  '',    $char_d, '', '',
1252         'agent_pkg',    'varchar', 'NULL', $char_d, '', '', 
1253         'agent_adjourn', @date_type,                '', '',
1254         'comments',     'text',    'NULL',      '', '', '', 
1255       ],
1256       'primary_key' => 'reconid',
1257       'unique' => [],
1258       'index' => [],
1259     },
1260
1261     'contact_class' => {
1262       'columns' => [
1263         'classnum',    'serial',   '',      '', '', '', 
1264         'classname',   'varchar',  '', $char_d, '', '', 
1265         'disabled',    'char', 'NULL',       1, '', '', 
1266       ],
1267       'primary_key' => 'classnum',
1268       'unique' => [],
1269       'index' => [ ['disabled'] ],
1270     },
1271
1272     'contact' => {
1273       'columns' => [
1274         'contactnum', 'serial',     '',      '', '', '',
1275         'prospectnum',   'int', 'NULL',      '', '', '',
1276         'custnum',       'int', 'NULL',      '', '', '',
1277         'locationnum',   'int', 'NULL',      '', '', '', #not yet
1278         'classnum',      'int', 'NULL',      '', '', '',
1279 #        'titlenum',      'int', 'NULL',      '', '', '', #eg Mr. Mrs. Dr. Rev.
1280         'last',      'varchar',     '', $char_d, '', '', 
1281 #        'middle',    'varchar', 'NULL', $char_d, '', '', 
1282         'first',     'varchar',     '', $char_d, '', '', 
1283         'title',     'varchar', 'NULL', $char_d, '', '', #eg Head Bottle Washer
1284         'comment',   'varchar', 'NULL',     255, '', '', 
1285         'selfservice_access',    'char', 'NULL',       1, '', '',
1286         '_password',          'varchar', 'NULL', $char_d, '', '',
1287         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
1288         'disabled',              'char', 'NULL',       1, '', '', 
1289       ],
1290       'primary_key' => 'contactnum',
1291       'unique'      => [],
1292       'index'       => [ [ 'prospectnum' ], [ 'custnum' ], [ 'locationnum' ],
1293                          [ 'last' ], [ 'first' ],
1294                        ],
1295     },
1296
1297     'contact_phone' => {
1298       'columns' => [
1299         'contactphonenum', 'serial',     '', '', '', '',
1300         'contactnum',         'int',     '', '', '', '',
1301         'phonetypenum',       'int',     '', '', '', '',
1302         'countrycode',    'varchar',     '',  3, '', '', 
1303         'phonenum',       'varchar',     '', 14, '', '', 
1304         'extension',      'varchar', 'NULL',  7, '', '',
1305         #?#'comment',        'varchar',     '', $char_d, '', '', 
1306       ],
1307       'primary_key' => 'contactphonenum',
1308       'unique'      => [],
1309       'index'       => [],
1310     },
1311
1312     'phone_type' => {
1313       'columns' => [
1314         'phonetypenum',  'serial', '',      '', '', '',
1315         'typename',     'varchar', '', $char_d, '', '',
1316         'weight',           'int', '',      '', '', '', 
1317       ],
1318       'primary_key' => 'phonetypenum',
1319       'unique'      => [ [ 'typename' ], ],
1320       'index'       => [],
1321     },
1322
1323     'contact_email' => {
1324       'columns' => [
1325         'contactemailnum', 'serial', '',      '', '', '',
1326         'contactnum',         'int', '',      '', '', '',
1327         'emailaddress',   'varchar', '', $char_d, '', '',
1328       ],
1329       'primary_key' => 'contactemailnum',
1330       #'unique'       => [ [ 'contactnum', 'emailaddress' ], ],
1331       'unique'       => [ [ 'emailaddress' ], ],
1332       'index'       => [],
1333     },
1334
1335     'prospect_main' => {
1336       'columns' => [
1337         'prospectnum',  'serial',     '',      '', '', '',
1338         'agentnum',        'int',     '',      '', '', '',
1339         'company',     'varchar', 'NULL', $char_d, '', '',
1340         'add_date',   @date_type,                  '', '', 
1341         'disabled',       'char', 'NULL',       1, '', '', 
1342         'custnum',         'int', 'NULL',      '', '', '',
1343         'refnum',          'int', 'NULL',      '', '', '', 
1344       ],
1345       'primary_key' => 'prospectnum',
1346       'unique'      => [],
1347       'index'        => [ ['company'], ['agentnum'], ['disabled'], ['refnum'] ],
1348     },
1349
1350     'quotation' => {
1351       'columns' => [
1352         #regular fields
1353         'quotationnum',   'serial',     '', '', '', '', 
1354         'prospectnum',       'int', 'NULL', '', '', '',
1355         'custnum',           'int', 'NULL', '', '', '',
1356         '_date',        @date_type,             '', '', 
1357         'disabled',         'char', 'NULL',  1, '', '', 
1358         'usernum',           'int', 'NULL', '', '', '',
1359         'close_date',   @date_type,             '', '', 
1360         'confidence',        'int', 'NULL', '', '', '',
1361         #'total',      @money_type,       '', '', 
1362         #'quotation_term', 'varchar', 'NULL', $char_d, '', '',
1363       ],
1364       'primary_key' => 'quotationnum',
1365       'unique' => [],
1366       'index' => [ [ 'prospectnum' ], ['custnum'], ['disabled'], ],
1367     },
1368
1369     'quotation_pkg' => {
1370       'columns' => [
1371         'quotationpkgnum',   'serial',     '', '', '', '', 
1372         'quotationnum',         'int', 'NULL', '', '', '', #shouldn't be null,
1373                                                            # but history...
1374         'pkgpart',              'int',     '', '', '', '', 
1375         'locationnum',          'int', 'NULL', '', '', '',
1376         'start_date',      @date_type,             '', '', 
1377         'contract_end',    @date_type,             '', '',
1378         'quantity',             'int', 'NULL', '', '', '',
1379         'waive_setup',         'char', 'NULL',  1, '', '', 
1380         'unitsetup',     @money_typen,             '', '',
1381         'unitrecur',     @money_typen,             '', '',
1382       ],
1383       'primary_key' => 'quotationpkgnum',
1384       'unique' => [],
1385       'index' => [ ['pkgpart'], ],
1386     },
1387
1388     'quotation_pkg_detail' => {
1389       'columns' => [
1390         'detailnum', 'serial', '', '', '', '', 
1391         'quotationpkgnum', 'int', '', '', '', '',
1392         'format',  'char', 'NULL', 1, '', '',       # not used for anything
1393         'detail',  'varchar', '', 255, '', '',
1394         'copy_on_order',        'char', 'NULL',  1, '', '', # 'Y' to copy when ordering
1395       ],
1396       'primary_key'  => 'detailnum',
1397       'unique'       => [],
1398       'index'        => [ [ 'quotationpkgnum' ] ],
1399       'foreign_keys' => [
1400                           { columns    => [ 'quotationpkgnum' ],
1401                             table      => 'quotation_pkg',
1402                             references => [ 'quotationpkgnum' ],
1403                           },
1404                         ],
1405     },
1406
1407     'quotation_pkg_discount' => {
1408       'columns' => [
1409         'quotationpkgdiscountnum', 'serial', '', '', '', '',
1410         'quotationpkgnum',            'int', '', '', '', '', 
1411         'discountnum',                'int', '', '', '', '',
1412         'setup_amount',        @money_typen,         '', '',
1413         'recur_amount',        @money_typen,         '', '',
1414         #'end_date',              @date_type,         '', '',
1415       ],
1416       'primary_key' => 'quotationpkgdiscountnum',
1417       'unique' => [],
1418       'index'  => [ [ 'quotationpkgnum' ], ], #[ 'discountnum' ] ],
1419     },
1420
1421     'quotation_pkg_tax' => {
1422       'columns' => [
1423         'quotationtaxnum',  'serial',     '',      '', '', '',
1424         'quotationpkgnum',     'int',     '',      '', '', '',
1425         'itemdesc',        'varchar',     '', $char_d, '', '',
1426         'taxnum',              'int',     '',      '', '', '', 
1427         'taxtype',         'varchar',     '', $char_d, '', '',
1428         'setup_amount',    @money_type,                '', '',
1429         'recur_amount',    @money_type,                '', '',
1430       ],
1431       'primary_key' => 'quotationtaxnum',,
1432       'unique' => [],
1433       'index'  => [ [ 'quotationpkgnum' ] ],
1434     },
1435
1436     'cust_location' => { #'location' now that its prospects too, but...
1437       'columns' => [
1438         'locationnum',      'serial',     '',      '', '', '',
1439         'prospectnum',         'int', 'NULL',      '', '', '',
1440         'custnum',             'int', 'NULL',      '', '', '',
1441         'locationname',    'varchar', 'NULL', $char_d, '', '',
1442         'address1',        'varchar',     '', $char_d, '', '', 
1443         'address2',        'varchar', 'NULL', $char_d, '', '', 
1444         'city',            'varchar', 'NULL', $char_d, '', '', 
1445         'county',          'varchar', 'NULL', $char_d, '', '', 
1446         'state',           'varchar', 'NULL', $char_d, '', '', 
1447         'zip',             'varchar', 'NULL',      10, '', '', 
1448         'latitude',        'decimal', 'NULL',  '10,7', '', '', 
1449         'longitude',       'decimal', 'NULL',  '10,7', '', '', 
1450         'coord_auto',         'char', 'NULL',       1, '', '',
1451         'addr_clean',         'char', 'NULL',       1, '', '',
1452         'country',            'char',     '',       2, '', '', 
1453         'geocode',         'varchar', 'NULL',      20, '', '',
1454         'district',        'varchar', 'NULL',      20, '', '',
1455         'censustract',     'varchar', 'NULL',      20, '', '',
1456         'censusyear',         'char', 'NULL',       4, '', '',
1457         'location_type',   'varchar', 'NULL',      20, '', '',
1458         'location_number', 'varchar', 'NULL',      20, '', '',
1459         'location_kind',      'char', 'NULL',       1, '', '',
1460         'disabled',           'char', 'NULL',       1, '', '', 
1461       ],
1462       'primary_key' => 'locationnum',
1463       'unique'      => [],
1464       'index'       => [ [ 'prospectnum' ], [ 'custnum' ],
1465                          [ 'county' ], [ 'state' ], [ 'country' ], [ 'zip' ],
1466                          [ 'city' ], [ 'district' ]
1467                        ],
1468     },
1469
1470     'cust_main_invoice' => {
1471       'columns' => [
1472         'destnum',  'serial',  '',     '', '', '', 
1473         'custnum',  'int',  '',     '', '', '', 
1474         'dest',     'varchar', '',  $char_d, '', '', 
1475       ],
1476       'primary_key' => 'destnum',
1477       'unique' => [],
1478       'index' => [ ['custnum'], ],
1479     },
1480
1481     'cust_main_credit_limit' => {
1482       'columns' => [
1483         'creditlimitnum',   'serial', '', '', '', '',
1484         'custnum',             'int', '', '', '', '', 
1485         '_date',          @date_type,         '', '', 
1486         'amount',       @money_typen,         '', '',
1487         #'amount_currency', 'char', 'NULL',  3, '', '',
1488         'credit_limit', @money_typen,         '', '',
1489         #'credit_limit_currency', 'char', 'NULL',  3, '', '',
1490       ],
1491       'primary_key'  => 'creditlimitnum',
1492       'unique'       => [],
1493       'index'        => [ ['custnum'], ],
1494     },
1495
1496     'cust_main_note' => {
1497       'columns' => [
1498         'notenum',   'serial',    '',  '', '', '', 
1499         'custnum',      'int',    '',  '', '', '', 
1500         'classnum',     'int', 'NULL', '', '', '', 
1501         '_date',          @date_type,      '', '', 
1502         'otaker',   'varchar', 'NULL', 32, '', '', 
1503         'usernum',      'int', 'NULL', '', '', '',
1504         'comments',    'text', 'NULL', '', '', '', 
1505         'sticky',       'int',     '', '',  0, '',
1506       ],
1507       'primary_key' => 'notenum',
1508       'unique' => [],
1509       'index' => [ [ 'custnum' ], [ '_date' ], [ 'usernum' ], ],
1510     },
1511     
1512     'cust_note_class' => {
1513       'columns' => [
1514         'classnum',    'serial',   '',      '', '', '', 
1515         'classname',   'varchar',  '', $char_d, '', '', 
1516         'disabled',    'char', 'NULL',       1, '', '', 
1517       ],
1518       'primary_key' => 'classnum',
1519       'unique' => [],
1520       'index' => [ ['disabled'] ],
1521     },
1522
1523     'cust_category' => {
1524       'columns' => [
1525         'categorynum',   'serial',  '', '', '', '', 
1526         'categoryname',  'varchar', '', $char_d, '', '', 
1527         'weight',         'int', 'NULL',  '', '', '',
1528         'disabled',      'char', 'NULL',   1, '', '', 
1529       ],
1530       'primary_key' => 'categorynum',
1531       'unique' => [],
1532       'index' => [ ['disabled'] ],
1533     },
1534
1535     'cust_class' => {
1536       'columns' => [
1537         'classnum',     'serial',     '',      '', '', '', 
1538         'classname',   'varchar',     '', $char_d, '', '', 
1539         'categorynum',     'int', 'NULL',      '', '', '', 
1540         'tax',            'char', 'NULL',       1, '', '', 
1541         'disabled',       'char', 'NULL',       1, '', '', 
1542       ],
1543       'primary_key' => 'classnum',
1544       'unique' => [],
1545       'index' => [ ['disabled'] ],
1546     },
1547  
1548     'cust_tag' => {
1549       'columns' => [
1550         'custtagnum', 'serial', '', '', '', '',
1551         'custnum',       'int', '', '', '', '',
1552         'tagnum',        'int', '', '', '', '',
1553       ],
1554       'primary_key' => 'custtagnum',
1555       'unique'      => [ [ 'custnum', 'tagnum' ] ],
1556       'index'       => [ [ 'custnum' ] ],
1557     },
1558
1559     'part_tag' => {
1560       'columns' => [
1561         'tagnum',    'serial',     '',      '', '', '',
1562         'tagname',  'varchar',     '', $char_d, '', '',
1563         'tagdesc',  'varchar', 'NULL', $char_d, '', '',
1564         'tagcolor', 'varchar', 'NULL',       6, '', '',
1565         'by_default',  'char', 'NULL',       1, '', '',
1566         'disabled',    'char', 'NULL',       1, '', '', 
1567       ],
1568       'primary_key' => 'tagnum',
1569       'unique'      => [], #[ [ 'tagname' ] ], #?
1570       'index'       => [ [ 'disabled' ] ],
1571     },
1572
1573     'cust_main_exemption' => {
1574       'columns' => [
1575         'exemptionnum',   'serial',     '',      '', '', '',
1576         'custnum',           'int',     '',      '', '', '', 
1577         'taxname',       'varchar',     '', $char_d, '', '',
1578         'exempt_number', 'varchar', 'NULL', $char_d, '', '',
1579         #start/end dates?  for reporting?
1580       ],
1581       'primary_key' => 'exemptionnum',
1582       'unique'      => [],
1583       'index'       => [ [ 'custnum' ] ],
1584     },
1585
1586     'cust_tax_adjustment' => {
1587       'columns' => [
1588         'adjustmentnum', 'serial',     '',      '', '', '',
1589         'custnum',          'int',     '',      '', '', '',
1590         'taxname',      'varchar',     '', $char_d, '', '',
1591         'amount',    @money_type,                   '', '', 
1592         'comment',     'varchar',  'NULL', $char_d, '', '', 
1593         'billpkgnum',       'int', 'NULL',      '', '', '',
1594         #more?  no cust_bill_pkg_tax_location?
1595       ],
1596       'primary_key' => 'adjustmentnum',
1597       'unique'      => [],
1598       'index'       => [ [ 'custnum' ], [ 'billpkgnum' ] ],
1599     },
1600
1601     'cust_main_county' => { #district+city+county+state+country are checked 
1602                             #off the cust_main_county for validation and to 
1603                             #provide a tax rate.
1604       'columns' => [
1605         'taxnum',   'serial',   '',    '', '', '', 
1606         'district', 'varchar',  'NULL',    20, '', '',
1607         'city',     'varchar',  'NULL',    $char_d, '', '',
1608         'county',   'varchar',  'NULL',    $char_d, '', '', 
1609         'state',    'varchar',  'NULL',    $char_d, '', '', 
1610         'country',  'char',  '', 2, '', '', 
1611         'taxclass',   'varchar', 'NULL', $char_d, '', '', 
1612         'exempt_amount', @money_type, '', '', 
1613         'tax',      'real',  '',    '', '', '', #tax %
1614         'taxname',  'varchar',  'NULL',    $char_d, '', '', 
1615         'setuptax',  'char', 'NULL', 1, '', '', # Y = setup tax exempt
1616         'recurtax',  'char', 'NULL', 1, '', '', # Y = recur tax exempt
1617         'source',   'varchar', 'NULL', $char_d, '', '',
1618       ],
1619       'primary_key' => 'taxnum',
1620       'unique' => [],
1621   #    'unique' => [ ['taxnum'], ['state', 'county'] ],
1622       'index' => [ [ 'district' ], [ 'city' ], [ 'county' ], [ 'state' ], 
1623                    [ 'country' ],
1624                    [ 'taxclass' ],
1625                  ],
1626     },
1627
1628     'tax_rate'    => {
1629       'columns' => [
1630         'taxnum',       'serial',     '',      '', '', '', 
1631         'geocode',     'varchar', 'NULL', $char_d, '', '',#cch provides 10 char
1632         'data_vendor', 'varchar', 'NULL', $char_d, '', '',#auto update source
1633         'location',    'varchar', 'NULL', $char_d, '', '',#provided by tax authority
1634         'taxclassnum', 'int',      '',      '', '', '', 
1635         'effective_date', @date_type, '', '', 
1636         'tax',        @taxrate_type,      '', '',        # tax %
1637         'excessrate', @taxrate_typen,     '', '',        # second tax %
1638         'taxbase',    @money_typen, '', '',              # amount at first tax rate
1639         'taxmax',     @money_typen, '', '',              # maximum about at both rates
1640         'usetax',        @taxrate_typen,     '', '',     # tax % when non-local
1641         'useexcessrate', @taxrate_typen,     '', '',     # second tax % when non-local
1642         'unittype',    'int',  'NULL', '', '', '',      # for fee
1643         'fee',         @taxrate_typen,     '', '',      # amount tax per unit
1644         'excessfee',   @taxrate_typen,     '', '',      # second amount tax per unit
1645         'feebase',     @taxrate_typen,     '', '',      # units taxed at first rate
1646         'feemax',      @taxrate_typen,     '', '',      # maximum number of unit taxed
1647         'maxtype',     'int',  'NULL', '', '', '',      # indicator of how thresholds accumulate
1648         'taxname', 'varchar',  'NULL', $char_d, '', '', # may appear on invoice
1649         'taxauth',     'int',  'NULL', '', '', '',      # tax authority
1650         'basetype',    'int',  'NULL', '', '', '', # indicator of basis for tax
1651         'passtype',    'int',  'NULL', '', '', '', # indicator declaring how item should be shown
1652         'passflag',    'char', 'NULL', 1, '', '',  # Y = required to list as line item, N = Prohibited
1653         'setuptax',    'char', 'NULL', 1, '', '',  # Y = setup tax exempt
1654         'recurtax',    'char', 'NULL', 1, '', '',  # Y = recur tax exempt
1655         'inoutcity',   'char', 'NULL', 1, '', '',  # '', 'I', or 'O'
1656         'inoutlocal',  'char', 'NULL', 1, '', '',  # '', 'I', or 'O'
1657         'manual',      'char', 'NULL', 1, '', '',  # Y = manually edited
1658         'disabled',    'char', 'NULL', 1, '', '',  # Y = tax disabled
1659       ],
1660       'primary_key' => 'taxnum',
1661       'unique' => [],
1662       'index' => [ ['taxclassnum'], ['data_vendor', 'geocode'] ],
1663     },
1664
1665     'tax_rate_location' => { 
1666       'columns' => [
1667         'taxratelocationnum', 'serial',  '',     '', '', '', 
1668         'data_vendor',        'varchar', 'NULL', $char_d, '', '',
1669         'geocode',            'varchar', '',     20,      '', '', 
1670         'city',               'varchar', 'NULL', $char_d, '', '',
1671         'county',             'varchar', 'NULL', $char_d, '', '',
1672         'state',              'char',    'NULL',       2, '', '', 
1673         'disabled',           'char',    'NULL', 1, '', '',
1674       ],
1675       'primary_key' => 'taxratelocationnum',
1676       'unique' => [],
1677       'index' => [ [ 'data_vendor', 'geocode', 'disabled' ] ],
1678     },
1679
1680     'cust_tax_location' => { 
1681       'columns' => [
1682         'custlocationnum', 'serial',  '',     '', '', '', 
1683         'data_vendor',     'varchar', 'NULL', $char_d, '', '', # update source
1684         'city',            'varchar', 'NULL', $char_d, '', '',
1685         'postalcity',      'varchar', 'NULL', $char_d, '', '',
1686         'county',          'varchar', 'NULL', $char_d, '', '',
1687         'zip',             'char',    '',     5,  '', '', 
1688         'state',           'char',    '',     2,  '', '', 
1689         'plus4hi',         'char',    'NULL', 4,  '', '', 
1690         'plus4lo',         'char',    'NULL', 4,  '', '', 
1691         'default_location','char',    'NULL', 1,  '', '', # Y = default for zip
1692         'cityflag',        'char',    'NULL', 1,  '', '', # I(n)/O(out)/B(oth)/NULL
1693         'geocode',         'varchar', '',    20,  '', '', 
1694       ],
1695       'primary_key' => 'custlocationnum',
1696       'unique' => [],
1697       'index' => [ [ 'zip', 'plus4lo', 'plus4hi' ] ],
1698     },
1699
1700     'tax_class' => { 
1701       'columns' => [
1702         'taxclassnum',  'serial',  '',            '', '', '',
1703         'data_vendor',  'varchar', 'NULL',   $char_d, '', '',
1704         'taxclass',     'varchar', '',       $char_d, '', '',          
1705         'description',  'varchar', '',     2*$char_d, '', '',          
1706       ],
1707       'primary_key' => 'taxclassnum',
1708       'unique' => [ [ 'data_vendor', 'taxclass' ] ],
1709       'index' => [],
1710     },
1711
1712     'cust_pay_pending' => {
1713       'columns' => [
1714         'paypendingnum','serial',      '',  '', '', '',
1715         'custnum',      'int',         '',  '', '', '', 
1716         'paid',         @money_type,            '', '', 
1717         '_date',        @date_type,             '', '', 
1718         'payby',        'char',        '',   4, '', '', #CARD/BILL/COMP, should
1719                                                         # be index into payby
1720                                                         # table eventually
1721         'payinfo',      'varchar', 'NULL', 512, '', '', #see cust_main above
1722         'paymask',      'varchar', 'NULL', $char_d, '', '', 
1723         'paydate',      'varchar', 'NULL', 10, '', '', 
1724         'recurring_billing', 'varchar', 'NULL', $char_d, '', '',
1725         #'paybatch',     'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
1726         'payunique',    'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
1727
1728         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
1729         'status',       'varchar',     '', $char_d, '', '', 
1730         'session_id',   'varchar', 'NULL', 1024, '', '', # SHA-512-hex
1731         'statustext',   'text',    'NULL',  '', '', '', 
1732         'gatewaynum',   'int',     'NULL',  '', '', '',
1733         #'cust_balance', @money_type,            '', '',
1734         'paynum',       'int',     'NULL',  '', '', '',
1735         'void_paynum',  'int',     'NULL',  '', '', '',
1736         'jobnum',    'bigint',     'NULL',  '', '', '', 
1737         'invnum',       'int',     'NULL',  '', '', '',
1738         'manual',       'char',    'NULL',   1, '', '',
1739         'discount_term','int',     'NULL',  '', '', '',
1740       ],
1741       'primary_key' => 'paypendingnum',
1742       'unique'      => [ [ 'payunique' ] ],
1743       'index'       => [ [ 'custnum' ], [ 'status' ], ],
1744     },
1745
1746     'cust_pay' => {
1747       'columns' => [
1748         'paynum',   'serial',    '',   '', '', '',
1749         'custnum',  'int',    '',   '', '', '', 
1750         '_date',    @date_type, '', '', 
1751         'paid',     @money_type, '', '', 
1752         'otaker',   'varchar', 'NULL', 32, '', '',
1753         'usernum',   'int', 'NULL', '', '', '',
1754         'payby',    'char',   '',     4, '', '', # CARD/BILL/COMP, should be
1755                                                  # index into payby table
1756                                                  # eventually
1757         'payinfo',  'varchar',   'NULL', 512, '', '', #see cust_main above
1758         'paymask', 'varchar', 'NULL', $char_d, '', '', 
1759         'paydate',  'varchar', 'NULL', 10, '', '', 
1760         'paybatch', 'varchar',   'NULL', $char_d, '', '', #for auditing purposes.
1761         'payunique', 'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
1762         'closed',    'char', 'NULL', 1, '', '', 
1763         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
1764         'no_auto_apply',  'char', 'NULL',       1, '', '', 
1765         # cash/check deposit info fields
1766         'bank',       'varchar', 'NULL', $char_d, '', '',
1767         'depositor',  'varchar', 'NULL', $char_d, '', '',
1768         'account',    'varchar', 'NULL', 20,      '', '',
1769         'teller',     'varchar', 'NULL', 20,      '', '',
1770
1771         'batchnum',       'int', 'NULL', '', '', '', #pay_batch foreign key
1772
1773         # credit card/EFT fields (formerly in paybatch)
1774         'gatewaynum',     'int', 'NULL', '', '', '', # payment_gateway FK
1775         'processor',  'varchar', 'NULL', $char_d, '', '', # module name
1776         'auth',       'varchar','NULL',16, '', '', # CC auth number
1777         'order_number','varchar','NULL',256, '', '', # transaction number
1778       ],
1779       'primary_key' => 'paynum',
1780       #i guess not now, with cust_pay_pending, if we actually make it here, we _do_ want to record it# 'unique' => [ [ 'payunique' ] ],
1781       'index' => [ [ 'custnum' ], [ 'paybatch' ], [ 'payby' ], [ '_date' ], [ 'usernum' ] ],
1782     },
1783
1784     'cust_pay_void' => {
1785       'columns' => [
1786         'paynum',    'int',    '',   '', '', '', 
1787         'custnum',   'int',    '',   '', '', '', 
1788         '_date',     @date_type, '', '', 
1789         'paid',      @money_type, '', '', 
1790         'otaker',   'varchar', 'NULL', 32, '', '', 
1791         'usernum',   'int', 'NULL', '', '', '',
1792         'payby',     'char',   '',     4, '', '', # CARD/BILL/COMP, should be
1793                                                   # index into payby table
1794                                                   # eventually
1795         'payinfo',   'varchar',   'NULL', 512, '', '', #see cust_main above
1796         'paymask', 'varchar', 'NULL', $char_d, '', '', 
1797         #'paydate' ?
1798         'paybatch',  'varchar',   'NULL', $char_d, '', '', #for auditing purposes.
1799         'closed',    'char', 'NULL', 1, '', '', 
1800         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
1801         # cash/check deposit info fields
1802         'bank',       'varchar', 'NULL', $char_d, '', '',
1803         'depositor',  'varchar', 'NULL', $char_d, '', '',
1804         'account',    'varchar', 'NULL', 20,      '', '',
1805         'teller',     'varchar', 'NULL', 20,      '', '',
1806         'batchnum',       'int', 'NULL', '', '', '', #pay_batch foreign key
1807
1808         # credit card/EFT fields (formerly in paybatch)
1809         'gatewaynum',     'int', 'NULL', '', '', '', # payment_gateway FK
1810         'processor',  'varchar', 'NULL', $char_d, '', '', # module name
1811         'auth',       'varchar','NULL',16, '', '', # CC auth number
1812         'order_number', 'varchar','NULL',256, '', '', # transaction number
1813
1814         #void fields
1815         'void_date', @date_type, '', '', 
1816         'reason',    'varchar',   'NULL', $char_d, '', '', 
1817         'void_usernum',   'int', 'NULL', '', '', '',
1818       ],
1819       'primary_key' => 'paynum',
1820       'unique' => [],
1821       'index' => [ [ 'custnum' ], [ 'usernum' ], [ 'void_usernum' ] ],
1822     },
1823
1824     'cust_bill_pay' => {
1825       'columns' => [
1826         'billpaynum', 'serial',     '',   '', '', '', 
1827         'invnum',  'int',     '',   '', '', '', 
1828         'paynum',  'int',     '',   '', '', '', 
1829         'amount',  @money_type, '', '', 
1830         '_date',   @date_type, '', '', 
1831         'pkgnum', 'int', 'NULL', '', '', '', #desired pkgnum for pkg-balances
1832       ],
1833       'primary_key' => 'billpaynum',
1834       'unique' => [],
1835       'index' => [ [ 'paynum' ], [ 'invnum' ] ],
1836     },
1837
1838     'cust_bill_pay_batch' => {
1839       'columns' => [
1840         'billpaynum', 'serial',     '',   '', '', '', 
1841         'invnum',  'int',     '',   '', '', '', 
1842         'paybatchnum',  'int',     '',   '', '', '', 
1843         'amount',  @money_type, '', '', 
1844         '_date',   @date_type, '', '', 
1845       ],
1846       'primary_key' => 'billpaynum',
1847       'unique' => [],
1848       'index' => [ [ 'paybatchnum' ], [ 'invnum' ] ],
1849     },
1850
1851     'cust_bill_pay_pkg' => {
1852       'columns' => [
1853         'billpaypkgnum', 'serial', '', '', '', '',
1854         'billpaynum',       'int', '', '', '', '',
1855         'billpkgnum',       'int', '', '', '', '',
1856         'billpkgtaxlocationnum', 'int', 'NULL', '', '', '',
1857         'billpkgtaxratelocationnum', 'int', 'NULL', '', '', '',
1858         'amount',         @money_type,     '', '',
1859         'setuprecur',      'varchar', '', $char_d, '', '',
1860         'sdate',   @date_type, '', '', 
1861         'edate',   @date_type, '', '', 
1862       ],
1863       'primary_key' => 'billpaypkgnum',
1864       'unique'      => [],
1865       'index'       => [ [ 'billpaynum' ], [ 'billpkgnum' ], ],
1866     },
1867
1868     'pay_batch' => { #batches of payments to an external processor
1869       'columns' => [
1870         'batchnum', 'serial',     '', '', '', '', 
1871         'agentnum',    'int', 'NULL', '', '', '', 
1872         'payby',      'char',     '',  4, '', '', # CARD/CHEK
1873         'status',     'char', 'NULL',  1, '', '', 
1874         'download',       @date_type,     '', '', 
1875         'upload',         @date_type,     '', '', 
1876         'title',   'varchar', 'NULL',255, '', '',
1877         'processor_id',   'varchar', 'NULL',255, '', '',
1878       ],
1879       'primary_key' => 'batchnum',
1880       'unique' => [],
1881       'index' => [],
1882     },
1883
1884     'cust_pay_batch' => { #list of customers in current CARD/CHEK batch
1885       'columns' => [
1886         'paybatchnum',   'serial',    '',   '', '', '', 
1887         'batchnum',   'int',    '',   '', '', '', 
1888         'invnum',   'int',    '',   '', '', '', 
1889         'custnum',   'int',    '',   '', '', '', 
1890         'last',     'varchar', '',     $char_d, '', '', 
1891         'first',    'varchar', '',     $char_d, '', '', 
1892         'address1', 'varchar', '',     $char_d, '', '', 
1893         'address2', 'varchar', 'NULL', $char_d, '', '', 
1894         'city',     'varchar', 'NULL',     $char_d, '', '', 
1895         'state',    'varchar', 'NULL', $char_d, '', '', 
1896         'zip',      'varchar', 'NULL', 10, '', '', 
1897         'country',  'char', '',     2, '', '', 
1898         #        'trancode', 'int', '', '', '', ''
1899         'payby',    'char',        '',       4, '', '',
1900         'payinfo',  'varchar', 'NULL',     512, '', '', 
1901         #'exp',      @date_type, '', ''
1902         'exp',      'varchar', 'NULL',      11, '', '', 
1903         'payname',  'varchar', 'NULL', $char_d, '', '', 
1904         'amount',   @money_type, '', '', 
1905         'status',   'varchar', 'NULL', $char_d, '', '', 
1906         'error_message',   'varchar', 'NULL', $char_d, '', '',
1907       ],
1908       'primary_key' => 'paybatchnum',
1909       'unique' => [],
1910       'index' => [ ['batchnum'], ['invnum'], ['custnum'] ],
1911     },
1912
1913     'fcc477map' => {
1914       'columns' => [
1915         'formkey',   'varchar',     '', 255, '', '',
1916         'formvalue',    'text', 'NULL',  '', '', '',
1917       ],
1918       'primary_key' => 'formkey',
1919       'unique'      => [],
1920       'index'       => [],
1921     },
1922
1923     'cust_pkg' => {
1924       'columns' => [
1925         'pkgnum',           'serial',     '', '', '', '', 
1926         'custnum',             'int',     '', '', '', '', 
1927         'pkgpart',             'int',     '', '', '', '', 
1928         'pkgbatch',        'varchar', 'NULL', $char_d, '', '',
1929         'contactnum',          'int', 'NULL', '', '', '', 
1930         'locationnum',         'int', 'NULL', '', '', '',
1931         'otaker',          'varchar', 'NULL', 32, '', '', 
1932         'usernum',             'int', 'NULL', '', '', '',
1933         'salesnum',            'int', 'NULL', '', '', '',
1934         'order_date',     @date_type,             '', '', 
1935         'start_date',     @date_type,             '', '', 
1936         'setup',          @date_type,             '', '', 
1937         'bill',           @date_type,             '', '', 
1938         'last_bill',      @date_type,             '', '', 
1939         'susp',           @date_type,             '', '', 
1940         'adjourn',        @date_type,             '', '', 
1941         'resume',         @date_type,             '', '', 
1942         'cancel',         @date_type,             '', '', 
1943         'uncancel',       @date_type,             '', '', 
1944         'uncancel_pkgnum',     'int', 'NULL', '', '', '',
1945         'expire',         @date_type,             '', '', 
1946         'contract_end',   @date_type,             '', '',
1947         'dundate',        @date_type,             '', '',
1948         'change_date',    @date_type,             '', '',
1949         'change_pkgnum',       'int', 'NULL', '', '', '',
1950         'change_pkgpart',      'int', 'NULL', '', '', '',
1951         'change_locationnum',  'int', 'NULL', '', '', '',
1952         'change_custnum',      'int', 'NULL', '', '', '',
1953         'main_pkgnum',         'int', 'NULL', '', '', '',
1954         'pkglinknum',          'int', 'NULL', '', '', '',
1955         'manual_flag',        'char', 'NULL',  1, '', '', 
1956         'no_auto',            'char', 'NULL',  1, '', '', 
1957         'quantity',            'int', 'NULL', '', '', '',
1958         'agent_pkgid',     'varchar', 'NULL', $char_d, '', '',
1959         'waive_setup',        'char', 'NULL',  1, '', '', 
1960         'recur_show_zero',    'char', 'NULL',  1, '', '',
1961         'setup_show_zero',    'char', 'NULL',  1, '', '',
1962         'change_to_pkgnum',    'int', 'NULL', '', '', '',
1963         'separate_bill',      'char', 'NULL',  1, '', '',
1964       ],
1965       'primary_key' => 'pkgnum',
1966       'unique' => [],
1967       'index' => [ ['custnum'], ['pkgpart'], [ 'pkgbatch' ], [ 'locationnum' ],
1968                    [ 'usernum' ], [ 'agent_pkgid' ],
1969                    ['order_date'], [ 'start_date' ], ['setup'], ['bill'],
1970                    ['last_bill'], ['susp'], ['adjourn'], ['resume'],
1971                    ['cancel'], ['expire'], ['contract_end'],
1972                    ['change_date'],
1973                    ['no_auto'],
1974                    #['contactnum'],
1975                    ['salesnum'],
1976                    #['uncancel_pkgnum'],
1977                    #['change_pkgnum'], ['change_locationnum'],
1978                    #['change_custnum'],
1979                    ['main_pkgnum'],
1980                    #['pkglinknum'], ['change_to_pkgnum'],
1981                  ],
1982     },
1983
1984     'cust_pkg_option' => {
1985       'columns' => [
1986         'optionnum', 'serial', '', '', '', '', 
1987         'pkgnum', 'int', '', '', '', '', 
1988         'optionname', 'varchar', '', $char_d, '', '', 
1989         'optionvalue', 'text', 'NULL', '', '', '', 
1990       ],
1991       'primary_key' => 'optionnum',
1992       'unique'      => [],
1993       'index'       => [ [ 'pkgnum' ], [ 'optionname' ] ],
1994     },
1995
1996     'cust_pkg_detail' => {
1997       'columns' => [
1998         'pkgdetailnum', 'serial', '',        '', '', '',
1999         'pkgnum',          'int', '',        '', '', '',
2000         'detail',      'varchar', '', 2*$char_d, '', '', 
2001         'detailtype',     'char', '',         1, '', '', #"I"nvoice or "C"omment
2002         'weight',          'int', '',        '', '', '',
2003       ],
2004       'primary_key' => 'pkgdetailnum',
2005       'unique' => [],
2006       'index'  => [ [ 'pkgnum', 'detailtype' ] ],
2007     },
2008
2009     'cust_pkg_reason' => {
2010       'columns' => [
2011         'num',      'serial',    '',   '', '', '', 
2012         'pkgnum',   'int',    '',   '', '', '', 
2013         'reasonnum','int',    '',   '', '', '', 
2014         'action',   'char', 'NULL', 1, '', '',     #should not be nullable
2015         'otaker',   'varchar', 'NULL', 32, '', '', 
2016         'usernum',   'int', 'NULL', '', '', '',
2017         'date',     @date_type, '', '', 
2018       ],
2019       'primary_key' => 'num',
2020       'unique' => [],
2021       'index' => [ [ 'pkgnum' ], [ 'reasonnum' ], ['action'], [ 'usernum' ], ],
2022     },
2023
2024     'cust_pkg_reason_fee' => {
2025       'columns' => [
2026         'pkgreasonfeenum', 'serial', '', '', '', '',
2027         'pkgreasonnum',       'int', '', '', '', '',
2028         'billpkgnum',         'int', 'NULL', '', '', '',
2029         'feepart',            'int', '', '', '', '',
2030         'nextbill',          'char', 'NULL',  1, '', '',
2031       ],
2032       'primary_key'  => 'pkgreasonfeenum',
2033       'unique' => [ [ 'billpkgnum' ], [ 'pkgreasonnum' ] ], # one-to-one link
2034       'index'  => [ [ 'feepart' ] ],
2035     },
2036
2037     'cust_pkg_discount' => {
2038       'columns' => [
2039         'pkgdiscountnum', 'serial', '',        '', '', '',
2040         'pkgnum',            'int', '',        '', '', '', 
2041         'discountnum',       'int', '',        '', '', '',
2042         'months_used',   'decimal', 'NULL', '7,4', '', '',
2043         'end_date',     @date_type,                '', '',
2044         'otaker',        'varchar', 'NULL',    32, '', '', 
2045         'usernum',           'int', 'NULL',    '', '', '',
2046         'disabled',         'char', 'NULL',     1, '', '', 
2047       ],
2048       'primary_key' => 'pkgdiscountnum',
2049       'unique' => [],
2050       'index'  => [ [ 'pkgnum' ], [ 'discountnum' ], [ 'usernum' ], ],
2051     },
2052
2053     'cust_pkg_usage' => {
2054       'columns' => [
2055         'pkgusagenum', 'serial', '', '', '', '',
2056         'pkgnum',         'int', '', '', '', '',
2057         'minutes',        'double precision', '', '', '', '',
2058         'pkgusagepart',   'int', '', '', '', '',
2059       ],
2060       'primary_key' => 'pkgusagenum',
2061       'unique' => [],
2062       'index'  => [ [ 'pkgnum' ], [ 'pkgusagepart' ] ],
2063     },
2064
2065     'cdr_cust_pkg_usage' => {
2066       'columns' => [
2067         'cdrusagenum', 'bigserial', '', '', '', '',
2068         'acctid',      'bigint',    '', '', '', '',
2069         'pkgusagenum', 'int',       '', '', '', '',
2070         'minutes',     'double precision',       '', '', '', '',
2071       ],
2072       'primary_key' => 'cdrusagenum',
2073       'unique' => [],
2074       'index'  => [ [ 'pkgusagenum' ], [ 'acctid' ] ],
2075     },
2076
2077     'cust_bill_pkg_discount' => {
2078       'columns' => [
2079         'billpkgdiscountnum', 'serial',        '', '', '', '',
2080         'billpkgnum',            'int',        '', '', '', '', 
2081         'pkgdiscountnum',        'int',        '', '', '', '', 
2082         'amount',          @money_type,                '', '', 
2083         'months',            'decimal', 'NULL', '7,4', '', '',
2084       ],
2085       'primary_key' => 'billpkgdiscountnum',
2086       'unique' => [],
2087       'index' => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
2088     },
2089
2090     'cust_bill_pkg_discount_void' => {
2091       'columns' => [
2092         'billpkgdiscountnum',    'int',        '', '', '', '',
2093         'billpkgnum',            'int',        '', '', '', '', 
2094         'pkgdiscountnum',        'int',        '', '', '', '', 
2095         'amount',          @money_type,                '', '', 
2096         'months',            'decimal', 'NULL', '7,4', '', '',
2097       ],
2098       'primary_key' => 'billpkgdiscountnum',
2099       'unique' => [],
2100       'index' => [ [ 'billpkgnum' ], [ 'pkgdiscountnum' ] ],
2101     },
2102
2103     'discount' => {
2104       'columns' => [
2105         'discountnum', 'serial',     '',      '', '', '',
2106         #'agentnum',       'int', 'NULL',      '', '', '', 
2107         'classnum',       'int', 'NULL',      '', '', '',
2108         'name',       'varchar', 'NULL', $char_d, '', '',
2109         'amount',   @money_type,                  '', '', 
2110         'percent',    'decimal',     '',   '7,4', '', '',
2111         'months',     'decimal', 'NULL',   '7,4', '', '',
2112         'disabled',      'char', 'NULL',       1, '', '', 
2113         'setup',         'char', 'NULL',       1, '', '', 
2114         #'linked',        'char', 'NULL',       1, '', '',
2115       ],
2116       'primary_key' => 'discountnum',
2117       'unique' => [],
2118       'index'  => [], # [ 'agentnum' ], ],
2119     },
2120
2121     'discount_class' => {
2122       'columns' => [
2123         'classnum',    'serial',   '',      '', '', '', 
2124         'classname',   'varchar',  '', $char_d, '', '', 
2125         #'categorynum', 'int',  'NULL',      '', '', '', 
2126         'disabled',    'char', 'NULL',       1, '', '', 
2127       ],
2128       'primary_key' => 'classnum',
2129       'unique' => [],
2130       'index' => [ ['disabled'] ],
2131     },
2132
2133     'cust_refund' => {
2134       'columns' => [
2135         'refundnum',    'serial',    '',   '', '', '', 
2136         'custnum',  'int',    '',   '', '', '', 
2137         '_date',        @date_type, '', '', 
2138         'refund',       @money_type, '', '', 
2139         'otaker',       'varchar',   'NULL',   32, '', '', 
2140         'usernum',   'int', 'NULL', '', '', '',
2141         'reason',       'varchar',   'NULL',   $char_d, '', '', 
2142         'reasonnum',   'int', 'NULL', '', '', '',
2143         'payby',        'char',   '',     4, '', '', # CARD/BILL/COMP, should
2144                                                      # be index into payby
2145                                                      # table eventually
2146         'payinfo',      'varchar',   'NULL', 512, '', '', #see cust_main above
2147         'paymask', 'varchar', 'NULL', $char_d, '', '', 
2148         'paybatch',     'varchar',   'NULL', $char_d, '', '', 
2149         'closed',    'char', 'NULL', 1, '', '', 
2150         'source_paynum', 'int', 'NULL', '', '', '', # link to cust_payby, to prevent unapply of gateway-generated refunds
2151         # credit card/EFT fields (formerly in paybatch)
2152         'gatewaynum',     'int', 'NULL', '', '', '', # payment_gateway FK
2153         'processor',  'varchar', 'NULL', $char_d, '', '', # module name
2154         'auth',       'varchar','NULL',16, '', '', # CC auth number
2155         'order_number', 'varchar','NULL',$char_d, '', '', # transaction number
2156       ],
2157       'primary_key' => 'refundnum',
2158       'unique' => [],
2159       'index' => [ ['custnum'], ['_date'], [ 'usernum' ], ],
2160     },
2161
2162     'cust_credit_refund' => {
2163       'columns' => [
2164         'creditrefundnum', 'serial',     '',   '', '', '', 
2165         'crednum',  'int',     '',   '', '', '', 
2166         'refundnum',  'int',     '',   '', '', '', 
2167         'amount',  @money_type, '', '', 
2168         '_date',   @date_type, '', '', 
2169       ],
2170       'primary_key' => 'creditrefundnum',
2171       'unique' => [],
2172       'index' => [ ['crednum'], ['refundnum'] ],
2173     },
2174
2175
2176     'cust_svc' => {
2177       'columns' => [
2178         'svcnum',      'serial',     '', '', '', '', 
2179         'pkgnum',         'int', 'NULL', '', '', '', 
2180         'svcpart',        'int',     '', '', '', '', 
2181         'agent_svcid',    'int', 'NULL', '', '', '',
2182         'overlimit',           @date_type,   '', '', 
2183       ],
2184       'primary_key' => 'svcnum',
2185       'unique' => [],
2186       'index' => [ ['svcnum'], ['pkgnum'], ['svcpart'], [ 'agent_svcid' ] ],
2187     },
2188
2189     'cust_svc_option' => {
2190       'columns' => [
2191         'optionnum',   'serial', '', '', '', '', 
2192         'svcnum',      'int', '', '', '', '', 
2193         'optionname',  'varchar', '', $char_d, '', '', 
2194         'optionvalue', 'text', 'NULL', '', '', '', 
2195       ],
2196       'primary_key' => 'optionnum',
2197       'unique'      => [],
2198       'index'       => [ [ 'svcnum' ], [ 'optionname' ] ],
2199     },
2200
2201     'svc_export_machine' => {
2202       'columns' => [
2203         'svcexportmachinenum', 'serial', '', '', '', '',
2204         'svcnum',                 'int', '', '', '', '', 
2205         'exportnum',              'int', '', '', '', '', 
2206         'machinenum',             'int', '', '', '', '',
2207       ],
2208       'primary_key' => 'svcexportmachinenum',
2209       'unique'      => [ ['svcnum', 'exportnum'] ],
2210       'index'       => [],
2211     },
2212
2213     'part_export_machine' => {
2214       'columns' => [
2215         'machinenum', 'serial', '', '', '', '',
2216         'exportnum',     'int', '', '', '', '',
2217         'machine',    'varchar', 'NULL', $char_d, '', '', 
2218         'disabled',      'char', 'NULL',       1, '', '',
2219       ],
2220       'primary_key' => 'machinenum',
2221       'unique'      => [ [ 'exportnum', 'machine' ] ],
2222       'index'       => [ [ 'exportnum' ] ],
2223     },
2224
2225    'part_pkg' => {
2226       'columns' => [
2227         'pkgpart',       'serial',    '',   '', '', '', 
2228         'pkgpartbatch',  'varchar', 'NULL', $char_d, '', '',
2229         'pkg',           'varchar',   '',   $char_d, '', '', 
2230         'comment',       'varchar', 'NULL', 2*$char_d, '', '', 
2231         'promo_code',    'varchar', 'NULL', $char_d, '', '', 
2232         'freq',          'varchar',   '',   $char_d, '', '', #billing frequency
2233         'setuptax',      'char', 'NULL', 1, '', '', 
2234         'recurtax',      'char', 'NULL', 1, '', '', 
2235         'plan',          'varchar', 'NULL', $char_d, '', '', 
2236         'disabled',      'char', 'NULL', 1, '', '', 
2237         'custom',        'char', 'NULL', 1, '', '', 
2238         'taxclass',      'varchar', 'NULL', $char_d, '', '', 
2239         'classnum',      'int',     'NULL', '', '', '', 
2240         'addon_classnum','int',     'NULL', '', '', '', 
2241         'taxproductnum', 'int',     'NULL', '', '', '', 
2242         'setup_cost',    @money_typen,          '', '',
2243         'recur_cost',    @money_typen,          '', '',
2244         'pay_weight',    'real',    'NULL', '', '', '',
2245         'credit_weight', 'real',    'NULL', '', '', '',
2246         'agentnum',      'int',     'NULL', '', '', '', 
2247         'fcc_ds0s',      'int',     'NULL', '', '', '', 
2248         'fcc_voip_class','char',    'NULL',  1, '', '',
2249         'no_auto',          'char', 'NULL',  1, '', '', 
2250         'recur_show_zero',  'char', 'NULL',  1, '', '',
2251         'setup_show_zero',  'char', 'NULL',  1, '', '',
2252         'successor',     'int',     'NULL', '', '', '',
2253         'family_pkgpart','int',     'NULL', '', '', '',
2254         'delay_start',   'int',     'NULL', '', '', '',
2255         'start_on_hold', 'char',    'NULL',  1, '', '',
2256         'agent_pkgpartid', 'varchar', 'NULL', 20, '', '',
2257       ],
2258       'primary_key' => 'pkgpart',
2259       'unique' => [],
2260       'index' => [ [ 'promo_code' ], [ 'disabled' ], [ 'classnum' ],
2261                    [ 'agentnum' ], ['no_auto'], ['agent_pkgpartid'],
2262                  ],
2263     },
2264
2265     'part_pkg_msgcat' => {
2266       'columns' => [
2267         'pkgpartmsgnum',  'serial',     '',        '', '', '',
2268         'pkgpart',           'int',     '',        '', '', '',
2269         'locale',        'varchar',     '',        16, '', '',
2270         'pkg',           'varchar',     '',   $char_d, '', '', #longer/no limit?
2271         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
2272       ],
2273       'primary_key' => 'pkgpartmsgnum',
2274       'unique'      => [ [ 'pkgpart', 'locale' ] ],
2275       'index'       => [],
2276     },
2277
2278     'part_fee' => {
2279       'columns' => [
2280         'feepart',       'serial',    '',   '', '', '',
2281         'itemdesc',      'varchar',   '',   $char_d,   '', '',
2282         'comment',       'varchar', 'NULL', 2*$char_d, '', '',
2283         'disabled',      'char',    'NULL',  1, '', '',
2284         'classnum',      'int',     'NULL', '', '', '',
2285         'taxclass',      'varchar', 'NULL', $char_d, '', '',
2286         'taxproductnum', 'int',     'NULL', '', '', '',
2287         'pay_weight',    'real',    'NULL', '', '', '',
2288         'credit_weight', 'real',    'NULL', '', '', '',
2289         'agentnum',      'int',     'NULL', '', '', '',
2290         'amount',   @money_type,                '', '', 
2291         'percent',     'decimal',    '', '7,4', '', '',
2292         'basis',         'varchar',  '',    16, '', '',
2293         'minimum',    @money_typen,             '', '',
2294         'maximum',    @money_typen,             '', '',
2295         'limit_credit',  'char',    'NULL',  1, '', '',
2296         'setuprecur',    'char',     '',     5, '', '',
2297         'taxable',       'char',    'NULL',  1, '', '',
2298       ],
2299       'primary_key'  => 'feepart',
2300       'unique'       => [],
2301       'index'        => [ [ 'disabled' ], [ 'classnum' ], [ 'agentnum' ]
2302                         ],
2303     },
2304
2305     'part_fee_msgcat' => {
2306       'columns' => [
2307         'feepartmsgnum',  'serial',     '',        '', '', '',
2308         'feepart',           'int',     '',        '', '', '',
2309         'locale',        'varchar',     '',        16, '', '',
2310         'itemdesc',      'varchar',     '',   $char_d, '', '', #longer/no limit?
2311         'comment',       'varchar', 'NULL', 2*$char_d, '', '', #longer/no limit?
2312       ],
2313       'primary_key'  => 'feepartmsgnum',
2314       'unique'       => [ [ 'feepart', 'locale' ] ],
2315       'index'        => [],
2316     },
2317
2318     'part_fee_usage' => {
2319       'columns' => [
2320         'feepartusagenum','serial',     '',        '', '', '',
2321         'feepart',           'int',     '',        '', '', '',
2322         'classnum',          'int',     '',        '', '', '',
2323         'amount',   @money_type,                '', '',
2324         'percent',     'decimal',    '', '7,4', '', '',
2325       ],
2326       'primary_key'  => 'feepartusagenum',
2327       'unique'       => [ [ 'feepart', 'classnum' ] ],
2328       'index'        => [],
2329     },
2330
2331     'part_pkg_link' => {
2332       'columns' => [
2333         'pkglinknum',  'serial',   '',      '', '', '',
2334         'src_pkgpart', 'int',      '',      '', '', '',
2335         'dst_pkgpart', 'int',      '',      '', '', '', 
2336         'link_type',   'varchar',  '', $char_d, '', '',
2337         'hidden',      'char', 'NULL',       1, '', '',
2338       ],
2339       'primary_key' => 'pkglinknum',
2340       'unique' => [ [ 'src_pkgpart', 'dst_pkgpart', 'link_type', 'hidden' ] ],
2341       'index'  => [ [ 'src_pkgpart' ] ],
2342     },
2343     # XXX somewhat borked unique: we don't really want a hidden and unhidden
2344     # it turns out we'd prefer to use svc, bill, and invisibill (or something)
2345
2346     'part_pkg_discount' => {
2347       'columns' => [
2348         'pkgdiscountnum', 'serial',   '',      '', '', '',
2349         'pkgpart',        'int',      '',      '', '', '',
2350         'discountnum',    'int',      '',      '', '', '', 
2351       ],
2352       'primary_key' => 'pkgdiscountnum',
2353       'unique' => [ [ 'pkgpart', 'discountnum' ] ],
2354       'index'  => [],
2355     },
2356
2357     'part_pkg_taxclass' => {
2358       'columns' => [
2359         'taxclassnum',  'serial', '',       '', '', '',
2360         'taxclass',     'varchar', '', $char_d, '', '', 
2361         'disabled', 'char',   'NULL',         1, '', '', 
2362       ],
2363       'primary_key' => 'taxclassnum',
2364       'unique'      => [ [ 'taxclass' ] ],
2365       'index'       => [ [ 'disabled' ] ],
2366     },
2367
2368     'part_pkg_taxproduct' => {
2369       'columns' => [
2370         'taxproductnum', 'serial',      '',        '', '', '',
2371         'data_vendor',   'varchar', 'NULL',   $char_d, '', '', 
2372         'taxproduct',    'varchar',     '',   $char_d, '', '', 
2373         'description',   'varchar',     '', 3*$char_d, '', '', 
2374       ],
2375       'primary_key' => 'taxproductnum',
2376       'unique'      => [ [ 'data_vendor', 'taxproduct' ] ],
2377       'index'       => [],
2378     },
2379
2380     'part_pkg_taxrate' => { 
2381       'columns' => [
2382         'pkgtaxratenum', 'serial',  '',     '',      '', '',
2383         'data_vendor',   'varchar', 'NULL', $char_d, '', '', # update source
2384         'geocode',       'varchar', 'NULL', $char_d, '', '', # cch provides 10
2385         'taxproductnum', 'int',  '',     '',       '', '',          
2386         'city',             'varchar', 'NULL', $char_d, '', '', # tax_location?
2387         'county',           'varchar', 'NULL', $char_d, '', '', 
2388         'state',            'varchar', 'NULL', $char_d, '', '', 
2389         'local',            'varchar', 'NULL', $char_d, '', '', 
2390         'country',          'char',    'NULL', 2,       '', '',
2391         'taxclassnumtaxed', 'int',     'NULL', '',      '', '', 
2392         'taxcattaxed',      'varchar', 'NULL', $char_d, '', '', 
2393         'taxclassnum',      'int',     'NULL', '',      '', '', 
2394         'effdate',          @date_type, '', '', 
2395         'taxable',          'char',    'NULL', 1,       '', '', 
2396       ],
2397       'primary_key' => 'pkgtaxratenum',
2398       'unique' => [],
2399       'index' => [ [ 'data_vendor', 'geocode', 'taxproductnum' ] ],
2400     },
2401
2402     'part_pkg_taxoverride' => { 
2403       'columns' => [
2404         'taxoverridenum', 'serial', '', '', '', '',
2405         'pkgpart',           'int', '', '', '', '',
2406         'taxclassnum',       'int', '', '', '', '',
2407         'usage_class',    'varchar', 'NULL', $char_d, '', '', 
2408       ],
2409       'primary_key' => 'taxoverridenum',
2410       'unique' => [],
2411       'index' => [ [ 'pkgpart' ], [ 'taxclassnum' ] ],
2412     },
2413
2414 #    'part_title' => {
2415 #      'columns' => [
2416 #        'titlenum',   'int',    '',   '',
2417 #        'title',      'varchar',   '',   $char_d,
2418 #      ],
2419 #      'primary_key' => 'titlenum',
2420 #      'unique' => [ [] ],
2421 #      'index' => [ [] ],
2422 #    },
2423
2424     'pkg_svc' => {
2425       'columns' => [
2426         'pkgsvcnum',  'serial', '',  '', '', '', 
2427         'pkgpart',    'int',    '',   '', '', '', 
2428         'svcpart',    'int',    '',   '', '', '', 
2429         'quantity',   'int',    '',   '', '', '', 
2430         'primary_svc','char', 'NULL',  1, '', '', 
2431         'hidden',     'char', 'NULL',  1, '', '',
2432         'provision_hold', 'char', 'NULL', 1, '', '',
2433       ],
2434       'primary_key' => 'pkgsvcnum',
2435       'unique' => [ ['pkgpart', 'svcpart'] ],
2436       'index' => [ ['pkgpart'], ['quantity'] ],
2437     },
2438
2439     'part_referral' => {
2440       'columns' => [
2441         'refnum',   'serial',     '',        '', '', '', 
2442         'referral', 'varchar',    '',   $char_d, '', '', 
2443         'disabled', 'char',   'NULL',         1, '', '', 
2444         'agentnum', 'int',    'NULL',        '', '', '', 
2445       ],
2446       'primary_key' => 'refnum',
2447       'unique' => [],
2448       'index' => [ ['disabled'], ['agentnum'], ],
2449     },
2450
2451     'part_svc' => {
2452       'columns' => [
2453         'svcpart',             'serial',     '',        '', '', '', 
2454         'svc',                'varchar',     '',   $char_d, '', '', 
2455         'svcdb',              'varchar',     '',   $char_d, '', '', 
2456         'disabled',              'char', 'NULL',         1, '', '', 
2457         'preserve',              'char', 'NULL',         1, '', '',
2458         'selfservice_access', 'varchar', 'NULL',   $char_d, '', '',
2459         'classnum',               'int', 'NULL',        '', '', '',
2460         'restrict_edit_password','char', 'NULL',         1, '', '',
2461         'has_router',            'char', 'NULL',         1, '', '',
2462 ],
2463       'primary_key' => 'svcpart',
2464       'unique' => [],
2465       'index' => [ [ 'disabled' ] ],
2466     },
2467
2468     'part_svc_column' => {
2469       'columns' => [
2470         'columnnum',   'serial',      '',      '', '', '', 
2471         'svcpart',     'int',         '',      '', '', '', 
2472         'columnname',  'varchar',     '',      64, '', '', 
2473         'columnlabel', 'varchar', 'NULL', $char_d, '', '',
2474         'columnvalue', 'varchar', 'NULL',     512, '', '', 
2475         'columnflag',  'char',    'NULL',       1, '', '', 
2476         'required',    'char',    'NULL',       1, '', '', 
2477       ],
2478       'primary_key' => 'columnnum',
2479       'unique' => [ [ 'svcpart', 'columnname' ] ],
2480       'index' => [ [ 'svcpart' ] ],
2481     },
2482
2483     'part_svc_class' => {
2484       'columns' => [
2485         'classnum',    'serial',   '',      '', '', '', 
2486         'classname',   'varchar',  '', $char_d, '', '', 
2487         'disabled',    'char', 'NULL',       1, '', '', 
2488       ],
2489       'primary_key' => 'classnum',
2490       'unique' => [],
2491       'index' => [ ['disabled'] ],
2492     },
2493
2494     #(this should be renamed to part_pop)
2495     'svc_acct_pop' => {
2496       'columns' => [
2497         'popnum',    'serial',    '',   '', '', '', 
2498         'city',      'varchar',   '',   $char_d, '', '', 
2499         'state',     'varchar',   '',   $char_d, '', '', 
2500         'ac',        'char',   '',   3, '', '', 
2501         'exch',      'char',   '',   3, '', '', 
2502         'loc',       'char',   'NULL',   4, '', '', #NULL for legacy purposes
2503       ],
2504       'primary_key' => 'popnum',
2505       'unique' => [],
2506       'index' => [ [ 'state' ] ],
2507     },
2508
2509     'part_pop_local' => {
2510       'columns' => [
2511         'localnum',  'serial',     '',     '', '', '', 
2512         'popnum',    'int',     '',     '', '', '', 
2513         'city',      'varchar', 'NULL', $char_d, '', '', 
2514         'state',     'char',    'NULL', 2, '', '', 
2515         'npa',       'char',    '',     3, '', '', 
2516         'nxx',       'char',    '',     3, '', '', 
2517       ],
2518       'primary_key' => 'localnum',
2519       'unique' => [],
2520       'index' => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
2521     },
2522     
2523     'qual' => {
2524       'columns' => [
2525         'qualnum',  'serial',     '',     '', '', '', 
2526         'custnum',    'int',     'NULL',     '', '', '',
2527         'prospectnum',    'int',     'NULL',     '', '', '',
2528         'locationnum',    'int',     'NULL',     '', '', '',
2529         'phonenum',     'varchar', 'NULL',       24, '', '',
2530         'exportnum',      'int', 'NULL', '', '', '', 
2531         'vendor_qual_id',      'varchar', 'NULL', $char_d, '', '', 
2532         'status',      'char', '', 1, '', '', 
2533       ],
2534       'primary_key' => 'qualnum',
2535       'unique' => [],
2536       'index' => [ [ 'locationnum' ], ['custnum'], ['prospectnum'],
2537                     ['phonenum'], ['vendor_qual_id'] ],
2538     },
2539     
2540     'qual_option' => {
2541       'columns' => [
2542         'optionnum', 'serial', '', '', '', '', 
2543         'qualnum',  'int',     '',     '', '', '', 
2544         'optionname', 'varchar', '', $char_d, '', '', 
2545         'optionvalue', 'text', 'NULL', '', '', '', 
2546       ],
2547       'primary_key' => 'optionnum',
2548       'unique' => [],
2549       'index' => [],
2550     },
2551
2552     'svc_acct' => {
2553       'columns' => [
2554         'svcnum',    'int',    '',   '', '', '', 
2555         'username',  'varchar',   '',   $username_len, '', '',
2556         '_password', 'varchar',   'NULL',  512, '', '',
2557         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
2558         'sec_phrase', 'varchar',  'NULL',   $char_d, '', '', 
2559         'popnum',    'int',    'NULL',   '', '', '', 
2560         'sectornum', 'int', 'NULL',      '', '', '',
2561         'uid',       'int', 'NULL',   '', '', '', 
2562         'gid',       'int', 'NULL',   '', '', '', 
2563         'finger',    'varchar',   'NULL',   2*$char_d, '', '', 
2564         'dir',       'varchar',   'NULL',   $char_d, '', '', 
2565         'shell',     'varchar',   'NULL',   $char_d, '', '', 
2566         'quota',     'varchar',   'NULL',   $char_d, '', '', 
2567         'slipip',    'varchar',   'NULL',   15, '', '', #four TINYINTs, bah.
2568         # IP address mgmt
2569         'routernum', 'int', 'NULL',      '', '', '',
2570         'blocknum',  'int', 'NULL',      '', '', '', 
2571         'seconds',   'int', 'NULL',   '', '', '', #uhhhh
2572         'seconds_threshold',   'int', 'NULL',   '', '', '',
2573         'upbytes',   'bigint', 'NULL',   '', '', '', 
2574         'upbytes_threshold',   'bigint', 'NULL',   '', '', '',
2575         'downbytes', 'bigint', 'NULL',   '', '', '',
2576         'downbytes_threshold',   'bigint', 'NULL',   '', '', '',
2577         'totalbytes','bigint', 'NULL',   '', '', '',
2578         'totalbytes_threshold',   'bigint', 'NULL',   '', '', '',
2579         'domsvc',    'int',     '', '', '', '', 
2580         'pbxsvc',    'int', 'NULL', '', '', '',
2581         'last_login',  @date_type, '', '', 
2582         'last_logout', @date_type, '', '', 
2583         #cardfortress field(s)
2584         'cf_privatekey',      'text', 'NULL',      '', '', '',
2585         #communigate pro fields (quota = MaxAccountSize)
2586         'cgp_aliases',     'varchar', 'NULL',     255, '', '',
2587         #settings
2588         'cgp_type',        'varchar', 'NULL', $char_d, '', '', #AccountType
2589         'file_quota',      'varchar', 'NULL', $char_d, '', '', #MaxWebSize
2590         'file_maxnum',     'varchar', 'NULL', $char_d, '', '', #MaxWebFiles
2591         'file_maxsize',    'varchar', 'NULL', $char_d, '', '', #MaxFileSize
2592         'cgp_accessmodes', 'varchar', 'NULL',     255, '', '', #AccessModes
2593         'password_selfchange','char', 'NULL',       1, '', '', #PWDAllowed
2594         'password_recover',   'char', 'NULL',       1, 'Y','', #PasswordRecovery
2595         'cgp_rulesallowed','varchar', 'NULL', $char_d, '', '', #RulesAllowed
2596         'cgp_rpopallowed',    'char', 'NULL',       1, '', '', #RPOPAllowed
2597         'cgp_mailtoall',      'char', 'NULL',       1, '', '', #MailToAll
2598         'cgp_addmailtrailer', 'char', 'NULL',       1, '', '', #AddMailTrailer
2599         'cgp_archiveafter',    'int', 'NULL',      '', '', '', #ArchiveMessagesAfter
2600         #XXX mailing lists
2601         #preferences
2602         'cgp_deletemode',     'varchar', 'NULL', $char_d, '', '',#DeleteMode
2603         'cgp_emptytrash',     'varchar', 'NULL', $char_d, '', '',#EmptyTrash
2604         'cgp_language',       'varchar', 'NULL', $char_d, '', '',#Language
2605         'cgp_timezone',       'varchar', 'NULL', $char_d, '', '',#TimeZone
2606         'cgp_skinname',       'varchar', 'NULL', $char_d, '', '',#SkinName
2607         'cgp_prontoskinname', 'varchar', 'NULL', $char_d, '', '',#ProntoSkinName
2608         'cgp_sendmdnmode',    'varchar', 'NULL', $char_d, '', '',#SendMDNMode
2609         #mail
2610         #XXX RPOP settings
2611         #
2612       ],
2613       'primary_key' => 'svcnum',
2614       #'unique' => [ [ 'username', 'domsvc' ] ],
2615       'unique' => [],
2616       'index' => [ ['username'], ['domsvc'], ['pbxsvc'] ],
2617     },
2618
2619     'acct_rt_transaction' => {
2620       'columns' => [
2621         'svcrtid',   'int',    '',   '', '', '', 
2622         'svcnum',    'int',    '',   '', '', '', 
2623         'transaction_id',       'int', '',   '', '', '', 
2624         '_date',   @date_type, '', '',
2625         'seconds',   'int', '',   '', '', '', #uhhhh
2626         'support',   'int', '',   '', '', '',
2627       ],
2628       'primary_key' => 'svcrtid',
2629       'unique' => [],
2630       'index' => [ ['svcnum', 'transaction_id'] ],
2631     },
2632
2633     #'svc_charge' => {
2634     #  'columns' => [
2635     #    'svcnum',    'int',    '',   '',
2636     #    'amount',    @money_type,
2637     #  ],
2638     #  'primary_key' => 'svcnum',
2639     #  'unique' => [ [] ],
2640     #  'index' => [ [] ],
2641     #},
2642
2643     'svc_domain' => {
2644       'columns' => [
2645         'svcnum',           'int',    '',        '', '', '',
2646         'domain',       'varchar',    '',   $char_d, '', '',
2647         'suffix',       'varchar', 'NULL',  $char_d, '', '',
2648         'catchall',         'int', 'NULL',       '', '', '',
2649         'parent_svcnum',    'int', 'NULL',       '', '', '',
2650         'quota',        'varchar', 'NULL',  $char_d, '', '', 
2651
2652         #registration info
2653         'registrarnum',     'int', 'NULL',       '', '', '',
2654         'registrarkey', 'varchar', 'NULL',      512, '', '',
2655         'setup_date',      @date_type, '', '',
2656         'renewal_interval', 'int', 'NULL',       '', '', '',
2657         'expiration_date', @date_type, '', '',
2658
2659         #some weird shit australia-specific shit?  yuck.. seems totally unused
2660         'au_registrant_name',       'varchar', 'NULL',  $char_d, '', '',
2661         'au_eligibility_type',      'varchar', 'NULL',  $char_d, '', '',
2662
2663         #communigate pro fields (quota = MaxAccountSize)
2664         'max_accounts',     'int', 'NULL',       '', '', '',
2665         'trailer',         'text', 'NULL',       '', '', '',
2666         'cgp_aliases',  'varchar', 'NULL',      255, '', '',
2667         'cgp_accessmodes','varchar','NULL',     255, '', '', #DomainAccessModes
2668         'cgp_certificatetype','varchar','NULL', $char_d, '', '',
2669
2670         #(account default) settings
2671         'acct_def_password_selfchange',   'char', 'NULL',       1,  '', '', 
2672         'acct_def_password_recover',      'char', 'NULL',       1, 'Y', '', 
2673         'acct_def_cgp_accessmodes',    'varchar', 'NULL',     255,  '', '',
2674         'acct_def_quota',              'varchar', 'NULL', $char_d,  '', '',
2675         'acct_def_file_quota',         'varchar', 'NULL', $char_d,  '', '',
2676         'acct_def_file_maxnum',        'varchar', 'NULL', $char_d,  '', '',
2677         'acct_def_file_maxsize',       'varchar', 'NULL', $char_d,  '', '',
2678         'acct_def_cgp_rulesallowed',   'varchar', 'NULL', $char_d,  '', '',
2679         'acct_def_cgp_rpopallowed',       'char', 'NULL',       1,  '', '', 
2680         'acct_def_cgp_mailtoall',         'char', 'NULL',       1,  '', '', 
2681         'acct_def_cgp_addmailtrailer',    'char', 'NULL',       1,  '', '', 
2682         'acct_def_cgp_archiveafter',       'int', 'NULL',      '',  '', '',
2683
2684         #(account default) preferences
2685         'acct_def_cgp_deletemode',     'varchar', 'NULL', $char_d,  '', '',
2686         'acct_def_cgp_emptytrash',     'varchar', 'NULL', $char_d,  '', '',
2687         'acct_def_cgp_language',       'varchar', 'NULL', $char_d,  '', '',
2688         'acct_def_cgp_timezone',       'varchar', 'NULL', $char_d,  '', '',
2689         'acct_def_cgp_skinname',       'varchar', 'NULL', $char_d,  '', '',
2690         'acct_def_cgp_prontoskinname', 'varchar', 'NULL', $char_d,  '', '',
2691         'acct_def_cgp_sendmdnmode',    'varchar', 'NULL', $char_d,  '', '',
2692       ],
2693       'primary_key' => 'svcnum',
2694       'unique' => [ ],
2695       'index' => [ ['domain'] ],
2696     },
2697     
2698     'svc_dsl' => {
2699       'columns' => [
2700         'svcnum',                    'int',    '',        '', '', '',
2701         'pushed',                    'int', 'NULL',       '', '', '',
2702         'desired_due_date',          'int', 'NULL',       '', '', '',
2703         'due_date',                  'int', 'NULL',       '', '', '',
2704         'vendor_order_id',       'varchar', 'NULL', $char_d,  '', '',
2705         'vendor_qual_id',        'varchar', 'NULL', $char_d,  '', '',
2706         'vendor_order_type',     'varchar', 'NULL', $char_d,  '', '',
2707         'vendor_order_status',   'varchar', 'NULL', $char_d,  '', '',
2708         'first',                 'varchar', 'NULL', $char_d,  '', '',
2709         'last',                  'varchar', 'NULL', $char_d,  '', '',
2710         'company',               'varchar', 'NULL', $char_d,  '', '',
2711         'phonenum',              'varchar', 'NULL',      24, '', '',
2712         'gateway_access_number', 'varchar', 'NULL',      24, '', '',
2713         'loop_type',                'char', 'NULL',       1, '', '', 
2714         'local_voice_provider',  'varchar', 'NULL', $char_d, '', '',
2715         'circuitnum',            'varchar', 'NULL', $char_d, '', '',
2716         'rate_band',             'varchar', 'NULL', $char_d, '', '',
2717         'vpi',                       'int', 'NULL',      '', '', '',
2718         'vci',                       'int', 'NULL',      '', '', '',
2719         'isp_chg',                  'char', 'NULL',       1, '', '', 
2720         'isp_prev',              'varchar', 'NULL', $char_d, '', '',
2721         'username',              'varchar', 'NULL', $char_d, '', '',
2722         'password',              'varchar', 'NULL', $char_d, '', '',
2723         'staticips',                'text', 'NULL',      '', '', '',
2724         'monitored',                'char', 'NULL',       1, '', '', 
2725         'last_pull',                 'int', 'NULL',      '', '', '',
2726       ],
2727       'primary_key' => 'svcnum',
2728       'unique' => [ ],
2729       'index' => [ ['phonenum'], ['vendor_order_id'] ],
2730     },
2731
2732     'dsl_device' => {
2733       'columns' => [
2734         'devicenum', 'serial',     '', '', '', '',
2735         #part_device?  or our own part_dsl_device?
2736         #'devicepart',   'int',     '', '', '', '',
2737         'svcnum',       'int',     '', '', '', '', 
2738         'mac_addr', 'varchar',     '', 12, '', '', 
2739       ],
2740       'primary_key' => 'devicenum',
2741       'unique' => [ [ 'mac_addr' ], ],
2742       'index'  => [ [ 'svcnum' ], ], # [ 'devicepart' ] ],
2743     },
2744     
2745     'dsl_note' => {
2746       'columns' => [
2747         'notenum',           'serial',    '',        '', '', '',
2748         'svcnum',     'int', '',       '', '', '',
2749         'author',     'varchar', 'NULL', $char_d,  '', '',
2750         'priority',   'char', 'NULL',       1,  '', '', 
2751         '_date',     'int', 'NULL',       '', '', '',
2752         'note',     'text', '',       '', '', '',
2753       ],
2754       'primary_key' => 'notenum',
2755       'unique' => [ ],
2756       'index' => [ ['svcnum'] ],
2757     },
2758
2759     'svc_dish' => {
2760       'columns' => [
2761         'svcnum',   'int',     '',     '', '', '',
2762         'acctnum',  'varchar', '',     16, '', '',
2763         'installdate', @date_type,         '', '', 
2764         'note',     'text',    'NULL', '', '', '',
2765       ],
2766       'primary_key' => 'svcnum',
2767       'unique' => [ ],
2768       'index' => [ ],
2769     },
2770
2771     'svc_hardware' => {
2772       'columns' => [
2773         'svcnum',   'int',     '',          '', '', '',
2774         'typenum',  'int',     '',          '', '', '',
2775         'serial',   'varchar', 'NULL', $char_d, '', '',
2776         'ip_addr',  'varchar', 'NULL',      40, '', '',
2777         'hw_addr',  'varchar', 'NULL',      12, '', '',
2778         'smartcard','varchar', 'NULL',      30, '', '',
2779         'statusnum','int',     'NULL',      '', '', '',
2780         'note',     'text',    'NULL',      '', '', '',
2781       ],
2782       'primary_key' => 'svcnum',
2783       'unique' => [ ],
2784       'index' => [ ],
2785     },
2786
2787     'hardware_class' => {
2788       'columns' => [
2789         'classnum',   'serial', '',      '', '', '',
2790         'classname', 'varchar', '', $char_d, '', '',
2791       ],
2792       'primary_key' => 'classnum',
2793       'unique' => [ ],
2794       'index'  => [ ],
2795     },
2796
2797     'hardware_type' => {
2798       'columns' => [
2799         'typenum',  'serial',     '',      '', '', '',
2800         'classnum',    'int',     '',      '', '', '',
2801         'model',   'varchar',     '', $char_d, '', '',
2802         'revision','varchar', 'NULL', $char_d, '', '',
2803       ],
2804       'primary_key' => 'typenum',
2805       'unique' => [ [ 'classnum', 'model', 'revision' ] ],
2806       'index'  => [ ],
2807     },
2808
2809     'hardware_status' => {
2810       'columns' => [
2811         'statusnum', 'serial', '',      '', '', '',
2812         'label'    ,'varchar', '', $char_d, '', '',
2813         'disabled',    'char', 'NULL',   1, '', '', 
2814       ],
2815       'primary_key' => 'statusnum',
2816       'unique' => [ ],
2817       'index'  => [ ],
2818     },
2819
2820     'domain_record' => {
2821       'columns' => [
2822         'recnum',    'serial',     '',  '', '', '', 
2823         'svcnum',    'int',     '',  '', '', '', 
2824         'reczone',   'varchar', '',  255, '', '', 
2825         'recaf',     'char',    '',  2, '', '', 
2826         'rectype',   'varchar',    '',  5, '', '', 
2827         'recdata',   'varchar', '',  255, '', '', 
2828         'ttl',       'int',     'NULL', '', '', '',
2829       ],
2830       'primary_key' => 'recnum',
2831       'unique'      => [],
2832       'index'       => [ ['svcnum'] ],
2833     },
2834
2835     'registrar' => {
2836       'columns' => [
2837         'registrarnum',   'serial', '',      '', '', '',
2838         'registrarname', 'varchar', '', $char_d, '', '',
2839       ],
2840       'primary_key' => 'registrarnum',
2841       'unique'      => [],
2842       'index'       => [],
2843     },
2844
2845     'cgp_rule' => {
2846       'columns' => [
2847         'rulenum',  'serial',     '',      '', '', '',
2848         'name',    'varchar',     '', $char_d, '', '',
2849         'comment', 'varchar', 'NULL', $char_d, '', '',
2850         'svcnum',      'int',     '',      '', '', '',
2851         'priority',    'int',     '',      '', '', '',
2852       ],
2853       'primary_key' => 'rulenum',
2854       'unique'      => [ [ 'svcnum', 'name' ] ],
2855       'index'       => [ [ 'svcnum' ] ],
2856     },
2857
2858     'cgp_rule_condition' => {
2859       'columns' => [
2860         'ruleconditionnum',  'serial',     '',      '', '', '',
2861         'conditionname',    'varchar',     '', $char_d, '', '',
2862         'op',               'varchar', 'NULL', $char_d, '', '',
2863         'params',           'varchar', 'NULL',     255, '', '',
2864         'rulenum',              'int',     '',      '', '', '',
2865       ],
2866       'primary_key' => 'ruleconditionnum',
2867       'unique'      => [],
2868       'index'       => [ [ 'rulenum' ] ],
2869     },
2870
2871     'cgp_rule_action' => {
2872        'columns' => [
2873         'ruleactionnum',  'serial',     '',      '', '', '',
2874         'action',        'varchar',     '', $char_d, '', '',
2875         'params',        'varchar', 'NULL',     255, '', '',
2876         'rulenum',           'int',     '',      '', '', '',
2877       ],
2878       'primary_key' => 'ruleactionnum',
2879       'unique'      => [],
2880       'index'       => [ [ 'rulenum' ] ],
2881    },
2882
2883     'svc_forward' => {
2884       'columns' => [
2885         'svcnum',   'int',            '',   '', '', '', 
2886         'srcsvc',   'int',        'NULL',   '', '', '', 
2887         'src',      'varchar',    'NULL',  255, '', '', 
2888         'dstsvc',   'int',        'NULL',   '', '', '', 
2889         'dst',      'varchar',    'NULL',  255, '', '', 
2890       ],
2891       'primary_key' => 'svcnum',
2892       'unique'      => [],
2893       'index'       => [ ['srcsvc'], ['dstsvc'] ],
2894     },
2895
2896     'svc_www' => {
2897       'columns' => [
2898         'svcnum',   'int',      '',  '', '', '', 
2899         'recnum',   'int',      '',  '', '', '', 
2900         'usersvc',  'int',  'NULL',  '', '', '', 
2901         'config',   'text', 'NULL',  '', '', '', 
2902       ],
2903       'primary_key' => 'svcnum',
2904       'unique'      => [],
2905       'index'       => [],
2906     },
2907
2908     #'svc_wo' => {
2909     #  'columns' => [
2910     #    'svcnum',    'int',    '',   '',
2911     #    'svcnum',    'int',    '',   '',
2912     #    'svcnum',    'int',    '',   '',
2913     #    'worker',    'varchar',   '',   $char_d,
2914     #    '_date',     @date_type,
2915     #  ],
2916     #  'primary_key' => 'svcnum',
2917     #  'unique' => [ [] ],
2918     #  'index' => [ [] ],
2919     #},
2920
2921     'prepay_credit' => {
2922       'columns' => [
2923         'prepaynum',   'serial',     '',   '', '', '', 
2924         'identifier',  'varchar', '', $char_d, '', '', 
2925         'amount',      @money_type, '', '', 
2926         'seconds',     'int',     'NULL', '', '', '', 
2927         'upbytes',     'bigint',     'NULL', '', '', '', 
2928         'downbytes',   'bigint',     'NULL', '', '', '', 
2929         'totalbytes',  'bigint',     'NULL', '', '', '', 
2930         'agentnum',    'int',     'NULL', '', '', '', 
2931       ],
2932       'primary_key' => 'prepaynum',
2933       'unique'      => [ ['identifier'] ],
2934       'index'       => [ ['agentnum'] ],
2935     },
2936
2937     'port' => {
2938       'columns' => [
2939         'portnum',  'serial',     '',   '', '', '', 
2940         'ip',       'varchar', 'NULL', 15, '', '', 
2941         'nasport',  'int',     'NULL', '', '', '', 
2942         'nasnum',   'int',     '',   '', '', '', 
2943       ],
2944       'primary_key' => 'portnum',
2945       'unique'      => [],
2946       'index'       => [],
2947     },
2948
2949     'nas' => {
2950       'columns' => [
2951         'nasnum',       'serial',     '',  '',              '', '', 
2952         'nasname',     'varchar',     '', 128,              '', '',
2953         'shortname',   'varchar', 'NULL',  32,              '', '',
2954         'type',        'varchar',     '',  30,         'other', '',
2955         'ports',           'int', 'NULL',  '',              '', '',
2956         'secret',      'varchar',     '',  60,        'secret', '',
2957         'server',      'varchar', 'NULL',  64,              '', '',
2958         'community',   'varchar', 'NULL',  50,              '', '',
2959         'description', 'varchar',     '', 200, 'RADIUS Client', '',
2960         'svcnum',          'int', 'NULL',  '',              '', '',
2961       ],
2962       'primary_key' => 'nasnum',
2963       'unique'      => [ [ 'nasname' ], ],
2964       'index'       => [],
2965     },
2966
2967     'export_nas' => {
2968       'columns' => [
2969         'exportnasnum', 'serial', '', '', '', '', 
2970         'exportnum',       'int', '', '', '', '', 
2971         'nasnum',          'int', '', '', '', '', 
2972       ],
2973       'primary_key' => 'exportnasnum',
2974       'unique'      => [ [ 'exportnum', 'nasnum' ] ],
2975       'index'       => [ [ 'exportnum' ], [ 'nasnum' ] ],
2976     },
2977
2978     'queue' => {
2979       'columns' => [
2980         'jobnum',   'bigserial',     '',      '', '', '', 
2981         'job',        'varchar',     '',     512, '', '', 
2982         '_date',          'int',     '',      '', '', '', 
2983         'status',     'varchar',     '', $char_d, '', '', 
2984         'statustext',    'text', 'NULL',      '', '', '', 
2985         'svcnum',         'int', 'NULL',      '', '', '', 
2986         'custnum',        'int', 'NULL',      '', '', '',
2987         'secure',        'char', 'NULL',       1, '', '',
2988         'priority',       'int', 'NULL',      '', '', '',
2989         'usernum',        'int', 'NULL',      '', '', '',
2990       ],
2991       'primary_key' => 'jobnum',
2992       'unique'      => [],
2993       'index'       => [ [ 'secure' ], [ 'priority' ],
2994                          [ 'job' ], [ 'svcnum' ], [ 'custnum' ], [ 'status' ],
2995                        ],
2996     },
2997
2998     'queue_arg' => {
2999       'columns' => [
3000         'argnum', 'bigserial',     '', '', '', '', 
3001         'jobnum',    'bigint',     '', '', '', '', 
3002         'frozen',      'char', 'NULL',  1, '', '',
3003         'arg',         'text', 'NULL', '', '', '', 
3004       ],
3005       'primary_key' => 'argnum',
3006       'unique'      => [],
3007       'index'       => [ [ 'jobnum' ] ],
3008     },
3009
3010     'queue_depend' => {
3011       'columns' => [
3012         'dependnum',  'bigserial', '', '', '', '', 
3013         'jobnum',        'bigint', '', '', '', '', 
3014         'depend_jobnum', 'bigint', '', '', '', '', 
3015       ],
3016       'primary_key' => 'dependnum',
3017       'unique'      => [],
3018       'index'       => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
3019     },
3020
3021     'queue_stat' => {
3022       'columns' => [
3023         'statnum', 'bigserial',     '',  '', '', '',
3024         'jobnum',     'bigint',     '',  '', '', '',
3025         'job',       'varchar',     '', 512, '', '', 
3026         'custnum',       'int', 'NULL',  '', '', '',
3027         'insert_date', @date_type, '', '',
3028         'start_date',  @date_type, '', '', 
3029         'end_date',    @date_type, '', '', 
3030       ],
3031       'primary_key'  => 'statnum',
3032       'unique'       => [], #[ ['jobnum'] ],
3033       'index'        => [],
3034     },
3035
3036     'export_svc' => {
3037       'columns' => [
3038         'exportsvcnum' => 'serial', '', '', '', '', 
3039         'exportnum'    => 'int', '', '', '', '', 
3040         'svcpart'      => 'int', '', '', '', '', 
3041         'role'         => 'varchar', 'NULL', 16, '', '',
3042       ],
3043       'primary_key' => 'exportsvcnum',
3044       'unique'      => [ [ 'exportnum', 'svcpart' ] ],
3045       'index'       => [ [ 'exportnum' ], [ 'svcpart' ] ],
3046     },
3047
3048     'export_cust_svc' => {
3049       'columns' => [
3050         'exportcustsvcnum', 'serial', '', '', '', '', 
3051         'exportnum', 'int', '', '', '', '', 
3052         'svcnum', 'int', '', '', '', '', 
3053         'remoteid', 'varchar', '', 512, '', '', 
3054       ],
3055       'primary_key'  => 'exportcustsvcnum',
3056       'unique'       => [ [ 'exportnum', 'svcnum' ] ],
3057       'index'        => [ [ 'exportnum', 'svcnum' ] ],
3058       'foreign_keys' => [
3059                           { columns    => [ 'exportnum' ],
3060                             table      => 'part_export',
3061                           },
3062                           { columns    => [ 'svcnum' ],
3063                             table      => 'cust_svc',
3064                           },
3065                         ],
3066     },
3067
3068     'export_device' => {
3069       'columns' => [
3070         'exportdevicenum' => 'serial', '', '', '', '', 
3071         'exportnum'    => 'int', '', '', '', '', 
3072         'devicepart'      => 'int', '', '', '', '', 
3073       ],
3074       'primary_key' => 'exportdevicenum',
3075       'unique'      => [ [ 'exportnum', 'devicepart' ] ],
3076       'index'       => [ [ 'exportnum' ], [ 'devicepart' ] ],
3077     },
3078
3079     'part_export' => {
3080       'columns' => [
3081         'exportnum',   'serial',     '',      '', '', '', 
3082         'exportname', 'varchar', 'NULL', $char_d, '', '',
3083         'machine',    'varchar', 'NULL', $char_d, '', '',
3084         'exporttype', 'varchar',     '', $char_d, '', '', 
3085         'nodomain',      'char', 'NULL',       1, '', '', 
3086         'default_machine','int', 'NULL',      '', '', '',
3087         'no_suspend',    'char', 'NULL',       1, '', '',
3088         # could also have 'no_insert', 'no_replace', etc.
3089       ],
3090       'primary_key' => 'exportnum',
3091       'unique'      => [],
3092       'index'       => [ [ 'machine' ], [ 'exporttype' ] ],
3093     },
3094
3095     'part_export_option' => {
3096       'columns' => [
3097         'optionnum', 'serial', '', '', '', '', 
3098         'exportnum', 'int', '', '', '', '', 
3099         'optionname', 'varchar', '', $char_d, '', '', 
3100         'optionvalue', 'text', 'NULL', '', '', '', 
3101       ],
3102       'primary_key' => 'optionnum',
3103       'unique'      => [],
3104       'index'       => [ [ 'exportnum' ], [ 'optionname' ] ],
3105     },
3106
3107     'radius_usergroup' => {
3108       'columns' => [
3109         'usergroupnum', 'serial', '', '', '', '', 
3110         'svcnum',       'int', '', '', '', '', 
3111         'groupname',    'varchar', 'NULL', $char_d, '', '', 
3112         'groupnum',     'int', 'NULL', '', '', '', 
3113       ],
3114       'primary_key' => 'usergroupnum',
3115       'unique'      => [],
3116       'index'       => [ [ 'svcnum' ], [ 'groupname' ] ],
3117     },
3118     
3119     'radius_group' => {
3120       'columns' => [
3121         'groupnum', 'serial', '', '', '', '', 
3122         'groupname',    'varchar', '', $char_d, '', '', 
3123         'description',  'varchar', 'NULL', $char_d, '', '', 
3124         'priority', 'int', '', '', '1', '',
3125         'speed_up', 'int', 'NULL', '', '', '',
3126         'speed_down', 'int', 'NULL', '', '', '',
3127       ],
3128       'primary_key' => 'groupnum',
3129       'unique'      => [ ['groupname'] ],
3130       'index'       => [],
3131     },
3132
3133     'radius_attr' => {
3134       'columns' => [
3135         'attrnum',   'serial', '',      '', '', '',
3136         'groupnum',     'int', '',      '', '', '',
3137         'attrname', 'varchar', '', $char_d, '', '',
3138         'value',    'varchar', '',     255, '', '',
3139         'attrtype',    'char', '',       1, '', '',
3140         'op',          'char', '',       2, '', '',
3141       ],
3142       'primary_key' => 'attrnum',
3143       'unique'      => [],
3144       'index'       => [ ['groupnum'], ],
3145     },
3146
3147     'msgcat' => {
3148       'columns' => [
3149         'msgnum', 'serial', '', '', '', '', 
3150         'msgcode', 'varchar', '', 255, '', '', 
3151         'locale', 'varchar', '', 16, '', '', 
3152         'msg', 'text', '', '', '', '', 
3153       ],
3154       'primary_key' => 'msgnum',
3155       'unique'      => [ [ 'msgcode', 'locale' ] ],
3156       'index'       => [],
3157     },
3158
3159     'cust_tax_exempt' => {
3160       'columns' => [
3161         'exemptnum', 'serial', '', '', '', '', 
3162         'custnum',   'int', '', '', '', '', 
3163         'taxnum',    'int', '', '', '', '', 
3164         'year',      'int', '', '', '', '', 
3165         'month',     'int', '', '', '', '', 
3166         'amount',   @money_type, '', '', 
3167       ],
3168       'primary_key' => 'exemptnum',
3169       'unique'      => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
3170       'index'       => [],
3171     },
3172
3173     'cust_tax_exempt_pkg' => {
3174       'columns' => [
3175         'exemptpkgnum',  'serial', '', '', '', '', 
3176         #'custnum',      'int', '', '', '', ''
3177         'billpkgnum',   'int', '', '', '', '', 
3178         'taxnum',       'int', '', '', '', '', 
3179         'taxtype',  'varchar', 'NULL', $char_d, '', '',
3180         'year',         'int', 'NULL', '', '', '', 
3181         'month',        'int', 'NULL', '', '', '', 
3182         'creditbillpkgnum', 'int', 'NULL', '', '', '',
3183         'amount',       @money_type, '', '', 
3184         # exemption type flags
3185         'exempt_cust',          'char', 'NULL', 1, '', '',
3186         'exempt_setup',         'char', 'NULL', 1, '', '',
3187         'exempt_recur',         'char', 'NULL', 1, '', '',
3188         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
3189         'exempt_monthly',       'char', 'NULL', 1, '', '',
3190       ],
3191       'primary_key' => 'exemptpkgnum',
3192       'unique' => [],
3193       'index'  => [ [ 'taxnum', 'year', 'month' ],
3194                     [ 'billpkgnum' ],
3195                     [ 'taxnum', 'taxtype' ],
3196                     [ 'creditbillpkgnum' ],
3197                   ],
3198     },
3199
3200     'cust_tax_exempt_pkg_void' => {
3201       'columns' => [
3202         'exemptpkgnum',  'int', '', '', '', '', 
3203         #'custnum',      'int', '', '', '', ''
3204         'billpkgnum',   'int', '', '', '', '', 
3205         'taxnum',       'int', '', '', '', '', 
3206         'taxtype',  'varchar', 'NULL', $char_d, '', '',
3207         'year',         'int', 'NULL', '', '', '', 
3208         'month',        'int', 'NULL', '', '', '', 
3209         'creditbillpkgnum', 'int', 'NULL', '', '', '',
3210         'amount',       @money_type, '', '', 
3211         # exemption type flags
3212         'exempt_cust',          'char', 'NULL', 1, '', '',
3213         'exempt_setup',         'char', 'NULL', 1, '', '',
3214         'exempt_recur',         'char', 'NULL', 1, '', '',
3215         'exempt_cust_taxname',  'char', 'NULL', 1, '', '',
3216         'exempt_monthly',       'char', 'NULL', 1, '', '',
3217       ],
3218       'primary_key' => 'exemptpkgnum',
3219       'unique' => [],
3220       'index'  => [ [ 'taxnum', 'year', 'month' ],
3221                     [ 'billpkgnum' ],
3222                     [ 'taxnum', 'taxtype' ],
3223                     [ 'creditbillpkgnum' ],
3224                   ],
3225     },
3226
3227     'router' => {
3228       'columns' => [
3229         'routernum', 'serial', '', '', '', '', 
3230         'routername', 'varchar', '', $char_d, '', '', 
3231         'svcnum', 'int', 'NULL', '', '', '', 
3232         'agentnum',   'int', 'NULL', '', '', '', 
3233         'manual_addr', 'char', 'NULL', 1, '', '',
3234       ],
3235       'primary_key' => 'routernum',
3236       'unique'      => [],
3237       'index'       => [],
3238     },
3239
3240     'part_svc_router' => {
3241       'columns' => [
3242         'svcrouternum', 'serial', '', '', '', '', 
3243         'svcpart', 'int', '', '', '', '', 
3244         'routernum', 'int', '', '', '', '', 
3245       ],
3246       'primary_key' => 'svcrouternum',
3247       'unique'      => [],
3248       'index'       => [],
3249     },
3250
3251     'addr_block' => {
3252       'columns' => [
3253         'blocknum', 'serial', '', '', '', '', 
3254         'routernum', 'int', '', '', '', '', 
3255         'ip_gateway', 'varchar', '', 15, '', '', 
3256         'ip_netmask', 'int', '', '', '', '', 
3257         'agentnum',   'int', 'NULL', '', '', '', 
3258         'manual_flag', 'char', 'NULL', 1, '', '', 
3259       ],
3260       'primary_key' => 'blocknum',
3261       'unique'      => [ [ 'blocknum', 'routernum' ] ],
3262       'index'       => [],
3263     },
3264
3265     'addr_range' => {
3266       'columns' => [
3267         'rangenum', 'serial', '', '', '', '',
3268         'start',    'varchar', '', 15, '', '',
3269         'length',   'int', '', '', '', '',
3270         'status',   'varchar', 'NULL', 32, '', '',
3271       ],
3272       'primary_key' => 'rangenum',
3273       'unique'      => [],
3274       'index'       => [],
3275     },
3276
3277     'svc_broadband' => {
3278       'columns' => [
3279         'svcnum',                  'int',     '',        '', '', '', 
3280         'description',         'varchar', 'NULL',   $char_d, '', '', 
3281         'routernum',               'int', 'NULL',        '', '', '',
3282         'blocknum',                'int', 'NULL',        '', '', '', 
3283         'sectornum',               'int', 'NULL',        '', '', '',
3284         'speed_up',                'int', 'NULL',        '', '', '', 
3285         'speed_down',              'int', 'NULL',        '', '', '', 
3286         'ip_addr',             'varchar', 'NULL',        15, '', '', 
3287         'mac_addr',            'varchar', 'NULL',        12, '', '', 
3288         'authkey',             'varchar', 'NULL',        32, '', '', 
3289         'latitude',            'decimal', 'NULL',    '10,7', '', '', 
3290         'longitude',           'decimal', 'NULL',    '10,7', '', '', 
3291         'altitude',            'decimal', 'NULL',        '', '', '', 
3292         'vlan_profile',        'varchar', 'NULL',   $char_d, '', '', 
3293         'performance_profile', 'varchar', 'NULL',   $char_d, '', '',
3294         'plan_id',             'varchar', 'NULL',   $char_d, '', '',
3295         'radio_serialnum',     'varchar', 'NULL',   $char_d, '', '',
3296         'radio_location',      'varchar', 'NULL', 2*$char_d, '', '',
3297         'poe_location',        'varchar', 'NULL', 2*$char_d, '', '',
3298         'rssi',                    'int', 'NULL',        '', '', '',
3299         'suid',                    'int', 'NULL',        '', '', '',
3300         'shared_svcnum',           'int', 'NULL',        '', '', '',
3301         'serviceid',           'varchar', 'NULL',        64, '', '',#srvexport/reportfields
3302       ],
3303       'primary_key' => 'svcnum',
3304       'unique'      => [ [ 'ip_addr' ], [ 'mac_addr' ] ],
3305       'index'       => [],
3306     },
3307
3308     'tower' => {
3309       'columns' => [
3310         'towernum',    'serial',     '',      '', '', '',
3311         #'agentnum',       'int', 'NULL',      '', '', '',
3312         'towername',  'varchar',     '', $char_d, '', '',
3313         'disabled',      'char', 'NULL',       1, '', '',
3314         'latitude',   'decimal', 'NULL',  '10,7', '', '', 
3315         'longitude',  'decimal', 'NULL',  '10,7', '', '', 
3316         'coord_auto',    'char', 'NULL',       1, '', '',
3317         'altitude',   'decimal', 'NULL',      '', '', '', 
3318         'height',     'decimal', 'NULL',      '', '', '', 
3319         'veg_height', 'decimal', 'NULL',      '', '', '', 
3320         'color',      'varchar', 'NULL',       6, '', '',
3321       ],
3322       'primary_key' => 'towernum',
3323       'unique'      => [ [ 'towername' ] ], # , 'agentnum' ] ],
3324       'index'       => [],
3325     },
3326
3327     'tower_sector' => {
3328       'columns' => [
3329         'sectornum',     'serial',     '',      '', '', '',
3330         'towernum',         'int',     '',      '', '', '',
3331         'sectorname',   'varchar',     '', $char_d, '', '',
3332         'ip_addr',      'varchar', 'NULL',      15, '', '',
3333         'height',       'decimal', 'NULL',      '', '', '', 
3334         'freq_mhz',         'int', 'NULL',      '', '', '',
3335         'direction',        'int', 'NULL',      '', '', '',
3336         'width',            'int', 'NULL',      '', '', '',
3337         'sector_range', 'decimal', 'NULL',      '', '', '',  #?
3338         'downtilt',     'decimal', 'NULL',      '', '', '',
3339         'v_width',          'int', 'NULL',      '', '', '',
3340         'margin',       'decimal', 'NULL',     '', '', '',
3341         'image',           'blob', 'NULL',     '', '', '',
3342         'west',         'decimal', 'NULL', '10,7', '', '',
3343         'east',         'decimal', 'NULL', '10,7', '', '',
3344         'south',        'decimal', 'NULL', '10,7', '', '',
3345         'north',        'decimal', 'NULL', '10,7', '', '',
3346      ],
3347       'primary_key'  => 'sectornum',
3348       'unique'       => [ [ 'towernum', 'sectorname' ], [ 'ip_addr' ], ],
3349       'index'        => [ [ 'towernum' ] ],
3350     },
3351
3352     'part_virtual_field' => {
3353       'columns' => [
3354         'vfieldpart', 'serial', '', '', '', '', 
3355         'dbtable', 'varchar', '', 32, '', '', 
3356         'name', 'varchar', '', 32, '', '', 
3357         'length', 'int', 'NULL', '', '', '', 
3358         'label', 'varchar', 'NULL', 80, '', '', 
3359       ],
3360       'primary_key' => 'vfieldpart',
3361       'unique' => [],
3362       'index' => [],
3363     },
3364
3365     'virtual_field' => {
3366       'columns' => [
3367         'vfieldnum', 'serial', '', '', '', '', 
3368         'recnum', 'int', '', '', '', '', 
3369         'vfieldpart', 'int', '', '', '', '', 
3370         'value', 'varchar', '', 128, '', '', 
3371       ],
3372       'primary_key' => 'vfieldnum',
3373       'unique' => [ [ 'vfieldpart', 'recnum' ] ],
3374       'index' => [],
3375     },
3376
3377     'acct_snarf' => {
3378       'columns' => [
3379         'snarfnum',    'serial',     '',      '', '', '', 
3380         'snarfname',  'varchar', 'NULL', $char_d, '', '', 
3381         'svcnum',         'int',     '',      '', '', '', 
3382         'machine',    'varchar',     '',     255, '', '', 
3383         'protocol',   'varchar',     '', $char_d, '', '', 
3384         'username',   'varchar',     '', $char_d, '', '', 
3385         '_password',  'varchar',     '', $char_d, '', '', 
3386         'check_freq',     'int', 'NULL',      '', '', '', 
3387         'leavemail',     'char', 'NULL',       1, '', '', 
3388         'apop',          'char', 'NULL',       1, '', '', 
3389         'tls',           'char', 'NULL',       1, '', '', 
3390         'mailbox',    'varchar', 'NULL', $char_d, '', '', 
3391       ],
3392       'primary_key' => 'snarfnum',
3393       'unique' => [],
3394       'index'  => [ [ 'svcnum' ] ],
3395     },
3396
3397     'svc_external' => {
3398       'columns' => [
3399         'svcnum',     'int',     '',      '', '', '', 
3400         'id',      'bigint', 'NULL',      '', '', '', 
3401         'title',  'varchar', 'NULL', $char_d, '', '', 
3402       ],
3403       'primary_key' => 'svcnum',
3404       'unique'      => [],
3405       'index'       => [],
3406     },
3407
3408     'cust_pay_refund' => {
3409       'columns' => [
3410         'payrefundnum', 'serial', '', '', '', '', 
3411         'paynum',  'int', '', '', '', '', 
3412         'refundnum',  'int', '', '', '', '', 
3413         '_date',    @date_type, '', '', 
3414         'amount',   @money_type, '', '', 
3415       ],
3416       'primary_key' => 'payrefundnum',
3417       'unique' => [],
3418       'index' => [ ['paynum'], ['refundnum'] ],
3419     },
3420
3421     'part_pkg_option' => {
3422       'columns' => [
3423         'optionnum', 'serial', '', '', '', '', 
3424         'pkgpart', 'int', '', '', '', '', 
3425         'optionname', 'varchar', '', $char_d, '', '', 
3426         'optionvalue', 'text', 'NULL', '', '', '', 
3427       ],
3428       'primary_key' => 'optionnum',
3429       'unique'      => [],
3430       'index'       => [ [ 'pkgpart' ], [ 'optionname' ] ],
3431     },
3432
3433     'part_pkg_vendor' => {
3434       'columns' => [
3435         'num', 'serial', '', '', '', '', 
3436         'pkgpart', 'int', '', '', '', '', 
3437         'exportnum', 'int', '', '', '', '', 
3438         'vendor_pkg_id', 'varchar', '', $char_d, '', '', 
3439       ],
3440       'primary_key' => 'num',
3441       'unique' => [ [ 'pkgpart', 'exportnum' ] ],
3442       'index'       => [ [ 'pkgpart' ] ],
3443     },
3444     
3445     'part_pkg_report_option' => {
3446       'columns' => [
3447         'num',      'serial',   '',      '', '', '', 
3448         'name',     'varchar',  '', $char_d, '', '', 
3449         'disabled', 'char', 'NULL',       1, '', '', 
3450       ],
3451       'primary_key' => 'num',
3452       'unique' => [ [ 'name' ] ],
3453       'index' => [ [ 'disabled' ] ],
3454     },
3455
3456     'part_pkg_usage' => {
3457       'columns' => [
3458         'pkgusagepart', 'serial',   '', '', '', '',
3459         'pkgpart',  'int',      '', '', '', '',
3460         'minutes',  'double precision',      '', '', '', '',
3461         'priority', 'int',  'NULL', '', '', '',
3462         'shared',   'char', 'NULL',  1, '', '',
3463         'rollover', 'char', 'NULL',  1, '', '',
3464         'description',  'varchar', 'NULL', $char_d, '', '',
3465       ],
3466       'primary_key' => 'pkgusagepart',
3467       'unique'      => [],
3468       'index'       => [ [ 'pkgpart' ] ],
3469     },
3470
3471     'part_pkg_usage_class' => {
3472       'columns' => [
3473         'num',       'serial',  '', '', '', '',
3474         'pkgusagepart', 'int',  '', '', '', '',
3475         'classnum',     'int','NULL', '', '', '',
3476       ],
3477       'primary_key' => 'num',
3478       'unique'      => [ [ 'pkgusagepart', 'classnum' ] ],
3479       'index'       => [],
3480     },
3481
3482     'part_pkg_fcc_option' => {
3483       'columns' => [
3484         'num',        'serial', '', '', '', '',
3485         'fccoptionname', 'varchar', '', $char_d, '', '',
3486         'pkgpart',       'int', '', '', '', '',
3487         'optionvalue',   'varchar', 'NULL', $char_d, '', '',
3488       ],
3489       'primary_key' => 'num',
3490       'unique'      => [ [ 'fccoptionname', 'pkgpart' ] ],
3491       'index'       => [],
3492     },
3493
3494     'rate' => {
3495       'columns' => [
3496         'ratenum',          'serial',     '', '', '', '', 
3497         'ratename',        'varchar', '',$char_d, '', '', 
3498         'agentnum',            'int', 'NULL', '', '', '',
3499         'default_detailnum',   'int', 'NULL', '', '', '',
3500       ],
3501       'primary_key' => 'ratenum',
3502       'unique'      => [],
3503       'index'       => [],
3504     },
3505
3506     'rate_detail' => {
3507       'columns' => [
3508         'ratedetailnum',   'serial',  '',     '',      '', '', 
3509         'ratenum',         'int',     '',     '',      '', '', 
3510         'orig_regionnum',  'int', 'NULL',     '',      '', '', 
3511         'dest_regionnum',  'int', 'NULL',     '',      '', '', 
3512         'min_included',    'int',     '',     '',      '', '', 
3513         'conn_charge',     'decimal', '', '10,4', '0.0000', '',
3514         'conn_cost',       'decimal', '', '10,4', '0.0000', '',
3515         'conn_sec',        'int',     '',     '',      '0', '',
3516         'min_charge',      'decimal', '', '10,5',       '', '',
3517         'min_cost',        'decimal', '', '10,5','0.00000', '',
3518         'sec_granularity', 'int',     '',     '',       '', '', 
3519         'ratetimenum',     'int', 'NULL',     '',       '', '',
3520         'classnum',        'int', 'NULL',     '',       '', '', 
3521         'cdrtypenum',      'int', 'NULL',     '',       '', '',
3522         'region_group',   'char', 'NULL',      1,       '', '', 
3523         'upstream_mult_charge',  'decimal',  '', '10,4', '0.0000', '',
3524         'upstream_mult_cost',    'decimal',  '', '10,4', '0.0000', '',
3525       ],
3526       'primary_key' => 'ratedetailnum',
3527       'unique'      => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
3528       'index'       => [ [ 'ratenum', 'dest_regionnum' ],
3529                          [ 'ratenum', 'ratetimenum' ]
3530                        ],
3531     },
3532
3533     'rate_region' => {
3534       'columns' => [
3535         'regionnum',   'serial',      '', '', '', '', 
3536         'regionname',  'varchar',     '', $char_d, '', '', 
3537         'exact_match', 'char',    'NULL',  1, '', '',
3538       ],
3539       'primary_key' => 'regionnum',
3540       'unique'      => [],
3541       'index'       => [],
3542     },
3543
3544     'rate_prefix' => {
3545       'columns' => [
3546         'prefixnum',   'serial',      '', '', '', '', 
3547         'regionnum',   'int',         '', '', '', '', 
3548         'countrycode', 'varchar',     '',  3, '', '', 
3549         'npa',         'varchar', 'NULL', 10, '', '', #actually the whole prefix
3550         'nxx',         'varchar', 'NULL',  3, '', '', #actually not used
3551         'latanum',     'int',     'NULL',      '', '', '',
3552         'state',       'char',    'NULL',       2, '', '', 
3553         'ocn',         'char',    'NULL',       4, '', '', 
3554       ],
3555       'primary_key' => 'prefixnum',
3556       'unique'      => [],
3557       'index'       => [ [ 'countrycode' ], [ 'npa' ], [ 'regionnum' ] ],
3558     },
3559
3560     'rate_time' => {
3561       'columns' => [
3562         'ratetimenum', 'serial',      '',      '', '', '',
3563         'ratetimename',   'varchar',      '', $char_d, '', '',
3564       ],
3565       'primary_key' => 'ratetimenum',
3566       'unique'      => [],
3567       'index'       => [],
3568     },
3569
3570     'rate_time_interval' => {
3571       'columns' => [
3572         'intervalnum', 'serial', '', '', '', '',
3573         'stime',          'int', '', '', '', '',
3574         'etime',          'int', '', '', '', '',
3575         'ratetimenum',    'int', '', '', '', '',
3576       ],
3577       'primary_key' => 'intervalnum',
3578       'unique'      => [],
3579       'index'       => [],
3580     },
3581
3582     #not really part of the above rate_ stuff (used with flat rate rather than
3583     # rated billing), but could be eventually, and its a rate
3584     'rate_tier' => {
3585       'columns' => [
3586         'tiernum',   'serial', '',      '', '', '',
3587         'tiername', 'varchar', '', $char_d, '', '',
3588       ],
3589       'primary_key' => 'tiernum',
3590       'unique'      => [ [ 'tiername'], ],
3591       'index'       => [],
3592     },
3593
3594     'rate_tier_detail' => {
3595       'columns' => [
3596         'tierdetailnum', 'serial', '',     '', '', '',
3597         'tiernum',          'int', '',     '', '', '',
3598         'min_quan',         'int', '',     '', '', '',
3599         'min_charge',   'decimal', '', '10,4', '', '',
3600       ],
3601       'primary_key' => 'tierdetailnum',
3602       'unique'      => [],
3603       'index'       => [ ['tiernum'], ],
3604     },
3605
3606     'usage_class' => {
3607       'columns' => [
3608         'classnum',    'serial',      '',      '', '', '', 
3609         'weight',      'int',     'NULL',      '', '', '',
3610         'classname',   'varchar',     '', $char_d, '', '', 
3611         'format',      'varchar', 'NULL', $char_d, '', '', 
3612         'disabled',    'char',    'NULL',       1, '', '', 
3613       ],
3614       'primary_key' => 'classnum',
3615       'unique' => [],
3616       'index' => [ ['disabled'] ],
3617     },
3618
3619     'reg_code' => {
3620       'columns' => [
3621         'codenum',   'serial',    '', '', '', '', 
3622         'code',      'varchar',   '', $char_d, '', '', 
3623         'agentnum',  'int',       '', '', '', '', 
3624       ],
3625       'primary_key' => 'codenum',
3626       'unique'      => [ [ 'agentnum', 'code' ] ],
3627       'index'       => [ [ 'agentnum' ] ],
3628     },
3629
3630     'reg_code_pkg' => {
3631       'columns' => [
3632         'codepkgnum', 'serial', '', '', '', '', 
3633         'codenum',   'int',    '', '', '', '', 
3634         'pkgpart',   'int',    '', '', '', '', 
3635       ],
3636       'primary_key' => 'codepkgnum',
3637       'unique'      => [ [ 'codenum', 'pkgpart' ] ],
3638       'index'       => [ [ 'codenum' ] ],
3639     },
3640
3641     'clientapi_session' => {
3642       'columns' => [
3643         'sessionnum',  'serial',  '', '', '', '', 
3644         'sessionid',  'varchar',  '', $char_d, '', '', 
3645         'namespace',  'varchar',  '', $char_d, '', '', 
3646       ],
3647       'primary_key' => 'sessionnum',
3648       'unique'      => [ [ 'sessionid', 'namespace' ] ],
3649       'index'       => [],
3650     },
3651
3652     'clientapi_session_field' => {
3653       'columns' => [
3654         'fieldnum',    'serial',     '', '', '', '', 
3655         'sessionnum',     'int',     '', '', '', '', 
3656         'fieldname',  'varchar',     '', $char_d, '', '', 
3657         'fieldvalue',    'text', 'NULL', '', '', '', 
3658       ],
3659       'primary_key' => 'fieldnum',
3660       'unique'      => [ [ 'sessionnum', 'fieldname' ] ],
3661       'index'       => [],
3662     },
3663
3664     'payment_gateway' => {
3665       'columns' => [
3666         'gatewaynum',       'serial',   '',     '', '', '', 
3667         'gateway_namespace','varchar',  'NULL', $char_d, '', '', 
3668         'gateway_module',   'varchar',  '',     $char_d, '', '', 
3669         'gateway_username', 'varchar',  'NULL', $char_d, '', '', 
3670         'gateway_password', 'varchar',  'NULL', $char_d, '', '', 
3671         'gateway_action',   'varchar',  'NULL', $char_d, '', '', 
3672         'gateway_callback_url', 'varchar',  'NULL', 255, '', '', 
3673         'gateway_cancel_url',   'varchar',  'NULL', 255, '', '',
3674         'disabled',   'char',  'NULL',   1, '', '', 
3675       ],
3676       'primary_key' => 'gatewaynum',
3677       'unique' => [],
3678       'index'  => [ [ 'disabled' ] ],
3679     },
3680
3681     'payment_gateway_option' => {
3682       'columns' => [
3683         'optionnum',   'serial',  '',     '', '', '', 
3684         'gatewaynum',  'int',     '',     '', '', '', 
3685         'optionname',  'varchar', '',     $char_d, '', '', 
3686         'optionvalue', 'text',    'NULL', '', '', '', 
3687       ],
3688       'primary_key' => 'optionnum',
3689       'unique'      => [],
3690       'index'       => [ [ 'gatewaynum' ], [ 'optionname' ] ],
3691     },
3692
3693     'agent_payment_gateway' => {
3694       'columns' => [
3695         'agentgatewaynum', 'serial', '', '', '', '', 
3696         'agentnum',        'int', '', '', '', '', 
3697         'gatewaynum',      'int', '', '', '', '', 
3698         'cardtype',        'varchar', 'NULL', $char_d, '', '', 
3699         'taxclass',        'varchar', 'NULL', $char_d, '', '', 
3700       ],
3701       'primary_key' => 'agentgatewaynum',
3702       'unique'      => [],
3703       'index'       => [ [ 'agentnum', 'cardtype' ], ],
3704     },
3705
3706     'banned_pay' => {
3707       'columns' => [
3708         'bannum',  'serial',   '',     '', '', '', 
3709         'payby',   'char',     '',       4, '', '', 
3710         'payinfo', 'varchar',  '',     128, '', '', #say, a 512-big digest _hex encoded
3711         #'paymask', 'varchar',  'NULL', $char_d, '', ''
3712         '_date',            @date_type,         '', '', 
3713         'end_date',         @date_type,         '', '', 
3714         'otaker',  'varchar',  'NULL',      32, '', '', 
3715         'usernum',     'int',  'NULL',      '', '', '',
3716         'bantype', 'varchar',  'NULL', $char_d, '', '',
3717         'reason',  'varchar',  'NULL', $char_d, '', '', 
3718       ],
3719       'primary_key' => 'bannum',
3720       'unique'      => [],
3721       'index'       => [ [ 'payby', 'payinfo' ], [ 'usernum' ], ],
3722     },
3723
3724     'pkg_category' => {
3725       'columns' => [
3726         'categorynum',        'serial',     '',      '', '', '', 
3727         'categoryname',      'varchar',     '', $char_d, '', '', 
3728         'weight',                'int', 'NULL',      '', '', '',
3729         'ticketing_queueid',     'int', 'NULL',      '', '', '', 
3730         'condense',             'char', 'NULL',       1, '', '', 
3731         'disabled',             'char', 'NULL',       1, '', '', 
3732       ],
3733       'primary_key' => 'categorynum',
3734       'unique' => [],
3735       'index' => [ ['disabled'] ],
3736     },
3737
3738     'pkg_class' => {
3739       'columns' => [
3740         'classnum',    'serial',   '',      '', '', '', 
3741         'classname',   'varchar',  '', $char_d, '', '', 
3742         'categorynum', 'int',  'NULL',      '', '', '', 
3743         'disabled',    'char', 'NULL',       1, '', '', 
3744         'fcc_ds0s',      'int',     'NULL', '', '', '', 
3745       ],
3746       'primary_key' => 'classnum',
3747       'unique' => [],
3748       'index' => [ ['disabled'] ],
3749     },
3750
3751     'cdr' => {
3752       'columns' => [
3753         # qw( name type null length default local );
3754
3755         ###
3756         #asterisk fields
3757         ###
3758
3759         'acctid',   'bigserial',  '', '', '', '', 
3760         #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
3761         'calldate', 'timestamp',   '',      '', \'now()', '',
3762         'clid',        'varchar',  '', $char_d, \"''", '', 
3763         'src',         'varchar',  '', $char_d, \"''", '', 
3764         'dst',         'varchar',  '', $char_d, \"''", '', 
3765         'dcontext',    'varchar',  '', $char_d, \"''", '', 
3766         'channel',     'varchar',  '', $char_d, \"''", '', 
3767         'dstchannel',  'varchar',  '', $char_d, \"''", '', 
3768         'lastapp',     'varchar',  '', $char_d, \"''", '', 
3769         'lastdata',    'varchar',  '',     255, \"''", '', 
3770
3771         #currently only opensips
3772         'src_ip_addr', 'varchar',  'NULL',  15,    '', '',
3773         'dst_ip_addr', 'varchar',  'NULL',  15,    '', '',
3774
3775         #currently only u4:
3776         # terminating number (as opposed to dialed destination)
3777         'dst_term',    'varchar',  'NULL', $char_d, '', '',
3778
3779         #these don't seem to be logged by most of the SQL cdr_* modules
3780         #except tds under sql-illegal names, so;
3781         # ... don't rely on them for rating?
3782         # and, what they hey, i went ahead and changed the names and data types
3783         # to freeside-style dates...
3784           #'start',  'timestamp', 'NULL',  '',    '', '',
3785           #'answer', 'timestamp', 'NULL',  '',    '', '',
3786           #'end',    'timestamp', 'NULL',  '',    '', '',
3787         'startdate',  @date_type, '', '', 
3788         'answerdate', @date_type, '', '', 
3789         'enddate',    @date_type, '', '', 
3790         #
3791
3792         'duration',    'int',      '',      '',     0, '',
3793         'billsec',     'int',      '',      '',     0, '', 
3794         'disposition', 'varchar',  '',      45, \"''", '',
3795         'amaflags',    'int',      '',      '',     0, '',
3796         'accountcode', 'varchar',  '',      32, \"''", '',
3797         'uniqueid',    'varchar',  '', $char_d, \"''", '',
3798         'userfield',   'varchar',  '',     512, \"''", '',
3799
3800         'max_callers', 'int',  'NULL',      '',    '', '',
3801
3802         ###
3803         # old fields for unitel/RSLCOM/convergent that don't map to asterisk
3804         # ones we adoped moved to "own fields" section below
3805         # charged_party, upstream_price, rated_price, carrierid, cdrtypenum
3806         ###
3807
3808         'upstream_currency',      'char', 'NULL',       3, '', '',
3809         'upstream_rateplanid',     'int', 'NULL',      '', '', '', #?
3810
3811         # how it was rated internally...
3812         'ratedetailnum',           'int', 'NULL',      '', '', '',
3813
3814         'distance',            'decimal', 'NULL',      '', '', '',
3815         'islocal',                 'int', 'NULL',      '', '', '', # '',  '', 0, '' instead?
3816
3817         #cdr_calltype: the big list in appendix 2
3818         'calltypenum',             'int', 'NULL',      '', '', '',
3819
3820         'description',         'varchar', 'NULL', $char_d, '', '',
3821         'quantity',                'int', 'NULL',      '', '', '', 
3822
3823         'upstream_rateid',         'int', 'NULL',      '', '', '',
3824
3825         ###
3826         # more fields, for GSM imports
3827         ###
3828         'servicecode',             'int', 'NULL',      '', '', '',
3829         'quantity_able',           'int', 'NULL',      '', '', '', 
3830         
3831         ###
3832         #and now for our own fields
3833         ###
3834
3835         'cdrtypenum',              'int', 'NULL',      '', '', '',
3836
3837         'charged_party',       'varchar', 'NULL', $char_d, '', '',
3838         'charged_party_imsi',  'varchar', 'NULL', $char_d, '', '',
3839
3840         'upstream_price',      'decimal', 'NULL',  '10,5', '', '', 
3841         'upstream_src_regionname', 'varchar', 'NULL', $char_d, '', '',
3842         'upstream_dst_regionname', 'varchar', 'NULL', $char_d, '', '',
3843
3844         # how it was rated internally...
3845         'rated_pretty_dst',       'varchar', 'NULL', $char_d, '', '',
3846         'rated_regionname',       'varchar', 'NULL', $char_d, '', '',
3847         'rated_price',            'decimal', 'NULL',  '10,4', '', '',
3848         'rated_seconds',              'int', 'NULL',      '', '', '',
3849         'rated_minutes', 'double precision', 'NULL',      '', '', '',
3850         'rated_granularity',          'int', 'NULL',      '', '', '',
3851         'rated_ratedetailnum',        'int', 'NULL',      '', '', '',
3852         'rated_classnum',             'int', 'NULL',      '', '', '', 
3853         'rated_ratename',         'varchar', 'NULL', $char_d, '', '', 
3854         'rated_cost',            'decimal', 'NULL',  '10,4', '', '',
3855
3856         'carrierid',               'bigint', 'NULL',      '', '', '',
3857
3858         # service it was matched to
3859         'svcnum',             'int',   'NULL',     '',   '', '', 
3860
3861         #NULL, done (or something)
3862         'freesidestatus', 'varchar',   'NULL',     32,   '', '', 
3863
3864         #NULL, done (or something)
3865         'freesiderewritestatus', 'varchar',   'NULL',     32,   '', '', 
3866
3867         #an indexed place to put big numbers
3868         'cdrid',         'bigint',     'NULL',     '',  '', '', 
3869
3870         #for taqua accountcode rewriting, for starters
3871         'sessionnum',       'int',    'NULL',      '', '', '',
3872         'subscriber',   'varchar',    'NULL', $char_d, '', '',
3873
3874         #old
3875         'cdrbatch',     'varchar',    'NULL',     255, '', '',
3876         #new
3877         'cdrbatchnum',      'int',    'NULL',      '', '', '',
3878
3879         # FK to cust_bill_pkg_detail; having a value here absolutely means
3880         # that the CDR appears on an invoice
3881         'detailnum',     'bigint',    'NULL',      '', '', '',
3882       ],
3883       'primary_key' => 'acctid',
3884       'unique' => [],
3885       'index' => [ [ 'calldate' ],
3886                    [ 'src' ], [ 'dst' ], [ 'dcontext' ], [ 'charged_party' ],
3887                    [ 'lastapp' ],
3888                    ['accountcode'], ['uniqueid'], ['carrierid'], ['cdrid'],
3889                    [ 'sessionnum' ], [ 'subscriber' ],
3890                    [ 'freesidestatus' ], [ 'freesiderewritestatus' ],
3891                    [ 'cdrbatch' ], [ 'cdrbatchnum' ],
3892                    [ 'src_ip_addr' ], [ 'dst_ip_addr' ], [ 'dst_term' ],
3893                  ],
3894     },
3895
3896     'cdr_batch' => {
3897       'columns' => [
3898         'cdrbatchnum',   'serial',    '',   '', '', '', 
3899         'cdrbatch', 'varchar', 'NULL', 255, '', '',
3900         '_date',     @date_type, '', '', 
3901       ],
3902       'primary_key' => 'cdrbatchnum',
3903       'unique' => [ [ 'cdrbatch' ] ],
3904       'index' => [],
3905     },
3906
3907     'cdr_termination' => {
3908       'columns' => [
3909         'cdrtermnum', 'bigserial',     '',      '', '', '',
3910         'acctid',        'bigint',     '',      '', '', '', 
3911         'termpart',         'int',     '',      '', '', '',#future use see below
3912         'rated_price',  'decimal', 'NULL',  '10,4', '', '',
3913         'rated_seconds',    'int', 'NULL',      '', '', '',
3914         'rated_minutes', 'double precision', 'NULL',   '', '', '',
3915         'status',       'varchar', 'NULL',      32, '', '',
3916         'svcnum',           'int', 'NULL',      '', '', '',
3917       ],
3918       'primary_key' => 'cdrtermnum',
3919       'unique'      => [ [ 'acctid', 'termpart' ] ],
3920       'index'       => [ [ 'acctid' ], [ 'status' ], ],
3921     },
3922
3923     #to handle multiple termination/settlement passes...
3924    # 'part_termination' => {
3925    #   'columns' => [
3926    #     'termpart',       'int', '',      '', '', '',
3927    #     'termname',   'varchar', '', $char_d, '', '',
3928    #     'cdr_column', 'varchar', '', $char_d, '', '', #maybe set it here instead of in the price plan?
3929    #   ],
3930    #   'primary_key' => 'termpart',
3931    #   'unique' => [],
3932    #   'index'  => [],
3933    # },
3934
3935     #the remaining cdr_ tables are not really used
3936     'cdr_calltype' => {
3937       'columns' => [
3938         'calltypenum',   'serial',  '', '', '', '', 
3939         'calltypename',  'varchar', '', $char_d, '', '', 
3940       ],
3941       'primary_key' => 'calltypenum',
3942       'unique'      => [],
3943       'index'       => [],
3944     },
3945
3946     'cdr_type' => {
3947       'columns' => [
3948         'cdrtypenum'  => 'serial',  '', '', '', '',
3949         'cdrtypename' => 'varchar', '', $char_d, '', '',
3950       ],
3951       'primary_key' => 'cdrtypenum',
3952       'unique'      => [],
3953       'index'       => [],
3954     },
3955
3956     'cdr_carrier' => {
3957       'columns' => [
3958         'carrierid'   =>  'serial',     '',      '', '', '',
3959         'carriername' => 'varchar',     '', $char_d, '', '',
3960         'disabled'    =>    'char', 'NULL',       1, '', '', 
3961       ],
3962       'primary_key' => 'carrierid',
3963       'unique'      => [],
3964       'index'       => [],
3965     },
3966
3967     #'cdr_file' => {
3968     #  'columns' => [
3969     #    'filenum',    'serial',     '', '', '', '',
3970     #    'filename',  'varchar',     '', '', '', '',
3971     #    'status',    'varchar', 'NULL', '', '', '',
3972     #  ],
3973     #  'primary_key' => 'filenum',
3974     #  'unique' => [ [ 'filename' ], ], #just change the index if we need to
3975     #                                   # agent-virtualize or have a customer
3976     #                                   # with dup-filename needs or something
3977     #                                   # (only used by cdr.http_and_import for
3978     #                                   #  chrissakes)
3979     #  'index'  => [],
3980     #},
3981
3982     'inventory_item' => {
3983       'columns' => [
3984         'itemnum',   'serial',      '',      '', '', '',
3985         'classnum',  'int',         '',      '', '', '',
3986         'agentnum',  'int',     'NULL',      '', '', '',
3987         'item',      'varchar',     '', $char_d, '', '',
3988         'svcnum',    'int',     'NULL',      '', '', '',
3989         'svc_field', 'varchar', 'NULL', $char_d, '', '',
3990       ],
3991       'primary_key' => 'itemnum',
3992       'unique' => [ [ 'classnum', 'item' ] ],
3993       'index'  => [ [ 'classnum' ], [ 'agentnum' ], [ 'svcnum' ] ],
3994     },
3995
3996     'inventory_class' => {
3997       'columns' => [
3998         'classnum',  'serial',       '',      '', '', '',
3999         'classname', 'varchar',      '', $char_d, '', '',
4000       ],
4001       'primary_key' => 'classnum',
4002       'unique' => [],
4003       'index'  => [],
4004     },
4005
4006     'access_user_session' => {
4007       'columns' => [
4008         'sessionnum',   'serial',  '',      '', '', '', 
4009         'sessionkey',  'varchar',  '', $char_d, '', '',
4010         'usernum',         'int',  '',      '', '', '',
4011         'start_date', @date_type,               '', '',
4012         'last_date',  @date_type,               '', '',
4013       ],
4014       'primary_key' => 'sessionnum',
4015       'unique' => [ [ 'sessionkey' ] ],
4016       'index'  => [],
4017     },
4018
4019     'access_user' => {
4020       'columns' => [
4021         'usernum',            'serial',      '',      '', '', '',
4022         'username',           'varchar',     '', $char_d, '', '',
4023         '_password',          'varchar',     '', $char_d, '', '',
4024         'last',               'varchar',     '', $char_d, '', '', 
4025         'first',              'varchar',     '', $char_d, '', '', 
4026         'user_custnum',           'int', 'NULL',      '', '', '',
4027         'report_salesnum',        'int', 'NULL',      '', '', '',
4028         'disabled',              'char', 'NULL',       1, '', '', 
4029       ],
4030       'primary_key' => 'usernum',
4031       'unique' => [ [ 'username' ] ],
4032       'index'  => [ [ 'user_custnum' ] ],
4033     },
4034
4035     'access_user_pref' => {
4036       'columns' => [
4037         'prefnum',    'serial',       '', '', '', '',
4038         'usernum',     'int',       '', '', '', '',
4039         'prefname', 'varchar', '', $char_d, '', '', 
4040         'prefvalue', 'text', 'NULL', '', '', '', 
4041         'expiration', @date_type, '', '',
4042       ],
4043       'primary_key' => 'prefnum',
4044       'unique' => [],
4045       'index'  => [ [ 'usernum' ] ],
4046     },
4047
4048     'access_group' => {
4049       'columns' => [
4050         'groupnum',   'serial', '',      '', '', '',
4051         'groupname', 'varchar', '', $char_d, '', '',
4052       ],
4053       'primary_key' => 'groupnum',
4054       'unique' => [ [ 'groupname' ] ],
4055       'index'  => [],
4056     },
4057
4058     'access_usergroup' => {
4059       'columns' => [
4060         'usergroupnum', 'serial', '', '', '', '',
4061         'usernum',         'int', '', '', '', '',
4062         'groupnum',        'int', '', '', '', '',
4063       ],
4064       'primary_key' => 'usergroupnum',
4065       'unique' => [ [ 'usernum', 'groupnum' ] ],
4066       'index'  => [ [ 'usernum' ] ],
4067     },
4068
4069     'access_groupagent' => {
4070       'columns' => [
4071         'groupagentnum', 'serial', '', '', '', '',
4072         'groupnum',         'int', '', '', '', '',
4073         'agentnum',         'int', '', '', '', '',
4074       ],
4075       'primary_key' => 'groupagentnum',
4076       'unique' => [ [ 'groupnum', 'agentnum' ] ],
4077       'index'  => [ [ 'groupnum' ] ],
4078     },
4079
4080     'access_right' => {
4081       'columns' => [
4082         'rightnum',   'serial', '',      '', '', '',
4083         'righttype', 'varchar', '', $char_d, '', '',
4084         'rightobjnum',   'int', '',      '', '', '',
4085         'rightname', 'varchar', '', $char_d, '', '',
4086       ],
4087       'primary_key' => 'rightnum',
4088       'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
4089       'index'  => [],
4090     },
4091
4092     'access_user_log' => {
4093       'columns'      => [
4094         'lognum',  'serial', '',        '', '', '',
4095         'usernum',    'int', '',        '', '', '',
4096         'path',   'varchar', '', 2*$char_d, '', '',
4097         '_date',         @date_type,        '', '',
4098       ],
4099       'primary_key'  => 'lognum',
4100       'unique'       => [],
4101       'index'        => [ ['usernum'], ['path'], ['_date'] ],
4102     },
4103
4104     'access_user_page_pref' => {
4105       'columns'     => [
4106         'prefnum'     =>  'serial',     '',      '', '', '',
4107         'usernum'     =>     'int',     '',      '', '', '',
4108         'path'        =>    'text',     '',      '', '', '',
4109         'tablenum'    =>     'int', 'NULL',      '', '', '',
4110         '_date'       =>    @date_type,              '', '',
4111         'prefname'    =>    'varchar',  '', $char_d, '', '',
4112         'prefvalue'   =>    'text',     '',      '', '', '',
4113       ],
4114       'primary_key' => 'prefnum',
4115       'unique'      => [ [ 'usernum', 'path', 'tablenum', 'prefname' ] ],
4116       'index'       => [],
4117       'foreign_keys' => [
4118                           { columns   => [ 'usernum' ],
4119                             table     => 'access_user'
4120                           },
4121                         ],
4122     },
4123
4124     'sched_item' => {
4125       'columns' => [
4126         'itemnum',   'serial',      '', '', '', '', 
4127         'usernum',      'int',  'NULL', '', '', '', 
4128         #'itemname', 'varchar', $char_d, '', '', '',
4129         'disabled',    'char',  'NULL',  1, '', '', 
4130       ],
4131       'primary_key'  => 'itemnum',
4132       'unique'       => [ [ 'usernum' ] ],
4133       'index'        => [],
4134     },
4135
4136     #'sched_item_class'
4137
4138     'sched_avail' => {
4139       'columns' => [
4140         'availnum',      'serial', '', '', '', '', 
4141         'itemnum',          'int', '', '', '', '',
4142         'wday',             'int', '', '', '', '',
4143         'stime',            'int', '', '', '', '',
4144         'etime',            'int', '', '', '', '',
4145         'override_date',    @date_type,    '', '',
4146       ],
4147       'primary_key'  => 'availnum',
4148       'unique'       => [],
4149       'index'        => [],
4150     },
4151
4152     'svc_phone' => {
4153       'columns' => [
4154         'svcnum',                         'int',     '',      '', '', '', 
4155         'countrycode',                'varchar',     '',       3, '', '', 
4156         'phonenum',                   'varchar',     '',      25, '', '', #12 ?
4157         'sim_imsi',                   'varchar', 'NULL',      15, '', '',
4158         'pin',                        'varchar', 'NULL', $char_d, '', '',
4159         'sip_password',               'varchar', 'NULL', $char_d, '', '',
4160         'phone_name',                 'varchar', 'NULL', $char_d, '', '',
4161         'pbxsvc',                         'int', 'NULL',      '', '', '',
4162         'domsvc',                         'int', 'NULL',      '', '', '', 
4163         'locationnum',                    'int', 'NULL',      '', '', '',
4164         'forward_svcnum',                 'int', 'NULL',      '', '', '',
4165         'forwarddst',                 'varchar', 'NULL',      15, '', '', 
4166         'email',                      'varchar', 'NULL',     255, '', '', 
4167         'lnp_status',                 'varchar', 'NULL', $char_d, '', '',
4168         'portable',                      'char', 'NULL',       1, '', '', 
4169         'lrn',                           'char', 'NULL',      10, '', '', 
4170         'lnp_desired_due_date',           'int', 'NULL',      '', '', '',
4171         'lnp_due_date',                   'int', 'NULL',      '', '', '',
4172         'lnp_other_provider',         'varchar', 'NULL', $char_d, '', '',
4173         'lnp_other_provider_account', 'varchar', 'NULL', $char_d, '', '',
4174         'lnp_reject_reason',          'varchar', 'NULL', $char_d, '', '',
4175         'sms_carrierid',                  'int', 'NULL',      '', '', '',
4176         'sms_account',                'varchar', 'NULL', $char_d, '', '',
4177         'max_simultaneous',               'int', 'NULL',      '', '', '',
4178         'e911_class',                    'char', 'NULL',       1, '', '',
4179         'e911_type',                     'char', 'NULL',       1, '', '', 
4180         'circuit_svcnum',                 'int', 'NULL',      '', '', '',
4181         'sip_server',                 'varchar', 'NULL', $char_d, '', '',
4182       ],
4183       'primary_key' => 'svcnum',
4184       'unique' => [ [ 'sms_carrierid', 'sms_account'] ],
4185       'index'  => [ ['countrycode', 'phonenum'], ['pbxsvc'], ['domsvc'],
4186                     ['locationnum'], ['sms_carrierid'],
4187                   ],
4188     },
4189
4190     'phone_device' => {
4191       'columns' => [
4192         'devicenum', 'serial',     '', '', '', '',
4193         'devicepart',   'int',     '', '', '', '',
4194         'svcnum',       'int',     '', '', '', '', 
4195         'mac_addr', 'varchar', 'NULL', 12, '', '', 
4196       ],
4197       'primary_key' => 'devicenum',
4198       'unique' => [ [ 'mac_addr' ], ],
4199       'index'  => [ [ 'devicepart' ], [ 'svcnum' ], ],
4200     },
4201
4202     'part_device' => {
4203       'columns' => [
4204         'devicepart', 'serial',  '',      '', '', '',
4205         'devicename', 'varchar', '', $char_d, '', '',
4206         'inventory_classnum', 'int', 'NULL', '', '', '',
4207         'title',      'varchar', 'NULL', $char_d, '', '',
4208       ],
4209       'primary_key' => 'devicepart',
4210       'unique' => [ [ 'devicename' ] ], #?
4211       'index'  => [],
4212     },
4213
4214     'phone_avail' => {
4215       'columns' => [
4216         'availnum',    'serial',      '',      '', '', '', 
4217         'exportnum',   'int',         '',      '', '', '', 
4218         'countrycode', 'varchar',     '',       3, '', '', 
4219         'state',       'char',    'NULL',       2, '', '', 
4220         'npa',         'char',        '',       3, '', '', 
4221         'nxx',         'char',    'NULL',       3, '', '', 
4222         'station',     'char',    'NULL',       4, '', '',
4223         'name',        'varchar', 'NULL', $char_d, '', '',
4224         'rate_center_abbrev', 'varchar', 'NULL', $char_d, '', '',
4225         'latanum',      'int',     'NULL',      '', '', '',
4226         'msanum',       'int', 'NULL', '', '', '',
4227         'ordernum',      'int',     'NULL',      '', '', '',
4228         'svcnum',      'int',     'NULL',      '', '', '',
4229         'availbatch', 'varchar',  'NULL', $char_d, '', '',
4230       ],
4231       'primary_key' => 'availnum',
4232       'unique' => [],
4233       'index'  => [ [ 'exportnum', 'countrycode', 'state' ],     #npa search
4234                     [ 'exportnum', 'countrycode', 'npa' ],       #nxx search
4235                     [ 'exportnum', 'countrycode', 'npa', 'nxx' ],#station search
4236                     [ 'exportnum', 'countrycode', 'npa', 'nxx', 'station' ], # #
4237                     [ 'svcnum' ],
4238                     [ 'availbatch' ],
4239                     [ 'latanum' ],
4240                   ],
4241     },
4242     
4243     'lata' => {
4244       'columns' => [
4245         'latanum',    'int',      '',      '', '', '', 
4246         'description',   'varchar',    '',      $char_d, '', '', 
4247         'have_usage',   'int',    'NULL',      '', '', '', 
4248       ],
4249       'primary_key' => 'latanum',
4250       'unique' => [],
4251       'index'  => [],
4252     },
4253     
4254     'msa' => {
4255       'columns' => [
4256         'msanum',    'int',      '',      '', '', '', 
4257         'description',   'varchar',    '',      $char_d, '', '', 
4258       ],
4259       'primary_key' => 'msanum',
4260       'unique' => [],
4261       'index'  => [],
4262     },
4263     
4264     'rate_center' => {
4265       'columns' => [
4266         'ratecenternum',    'serial',      '',      '', '', '', 
4267         'description',   'varchar',    '',      $char_d, '', '', 
4268       ],
4269       'primary_key' => 'ratecenternum',
4270       'unique' => [],
4271       'index'  => [],
4272     },
4273
4274     'did_vendor' => {
4275       'columns' => [
4276         'vendornum',    'serial',      '',      '', '', '', 
4277         'vendorname',   'varchar',        '',     $char_d, '', '', 
4278       ],
4279       'primary_key' => 'vendornum',
4280       'unique' => [],
4281       'index'  => [],
4282     },
4283     
4284     'did_order_item' => {
4285       'columns' => [
4286         'orderitemnum',    'serial',      '',      '', '', '', 
4287         'ordernum',    'int',      '',      '', '', '', 
4288         'msanum',      'int',     'NULL',      '', '', '',
4289         'npa',      'int',     'NULL',      '', '', '',
4290         'latanum',      'int',     'NULL',      '', '', '',
4291         'ratecenternum',      'int',     'NULL',      '', '', '',
4292         'state',       'char',    'NULL',       2, '', '', 
4293         'quantity',      'int',     '',      '', '', '',
4294         'custnum',   'int', 'NULL', '', '', '',
4295       ],
4296       'primary_key' => 'orderitemnum',
4297       'unique' => [],
4298       'index'  => [],
4299     },
4300
4301     'did_order' => {
4302       'columns' => [
4303         'ordernum',    'serial',      '',      '', '', '', 
4304         'vendornum',   'int',       '',      '', '', '', 
4305         'vendor_order_id',   'varchar',  'NULL',   $char_d, '', '', 
4306         'custnum',   'int', 'NULL', '', '', '',
4307         'submitted',      'int',     '',      '', '', '',
4308         'confirmed',      'int',     'NULL',      '', '', '',
4309         'received',      'int',     'NULL',      '', '', '',
4310       ],
4311       'primary_key' => 'ordernum',
4312       'unique' => [ [ 'vendornum', 'vendor_order_id' ] ],
4313       'index'  => [],
4314     },
4315
4316     'reason_type' => {
4317       'columns' => [
4318         'typenum',   'serial',  '', '', '', '', 
4319         'class',     'char', '', 1, '', '', 
4320         'type',     'varchar', '', $char_d, '', '', 
4321       ],
4322       'primary_key' => 'typenum',
4323       'unique' => [],
4324       'index' => [],
4325     },
4326
4327     'reason' => {
4328       'columns' => [
4329         'reasonnum',     'serial',  '', '', '', '', 
4330         'reason_type',   'int',  '', '', '', '', 
4331         'reason',        'text', '', '', '', '', 
4332         'disabled',      'char',    'NULL', 1, '', '', 
4333         'unsuspend_pkgpart', 'int',  'NULL', '', '', '',
4334         'unsuspend_hold','char',    'NULL', 1, '', '',
4335         'unused_credit', 'char',    'NULL', 1, '', '',
4336         'feepart',        'int', 'NULL', '', '', '',
4337         'fee_on_unsuspend','char',  'NULL', 1, '', '',
4338         'fee_hold',      'char',    'NULL', 1, '', '',
4339       ],
4340       'primary_key' => 'reasonnum',
4341       'unique' => [],
4342       'index' => [],
4343     },
4344
4345     'conf' => {
4346       'columns' => [
4347         'confnum',  'serial',     '',      '', '', '', 
4348         'agentnum', 'int',    'NULL',      '', '', '', 
4349         'locale',   'varchar','NULL',      16, '', '',
4350         'name',     'varchar',    '', $char_d, '', '', 
4351         'value',    'text',   'NULL',      '', '', '',
4352       ],
4353       'primary_key' => 'confnum',
4354       'unique' => [ [ 'agentnum', 'locale', 'name' ] ],
4355       'index' => [],
4356     },
4357
4358     'pkg_referral' => {
4359       'columns' => [
4360         'pkgrefnum',     'serial', '', '', '', '',
4361         'pkgnum',        'int',    '', '', '', '',
4362         'refnum',        'int',    '', '', '', '',
4363       ],
4364       'primary_key' => 'pkgrefnum',
4365       'unique'      => [ [ 'pkgnum', 'refnum' ] ],
4366       'index'       => [ [ 'pkgnum' ], [ 'refnum' ] ],
4367     },
4368
4369     'svc_pbx' => {
4370       'columns' => [
4371         'svcnum',           'int',     '',      '', '', '', 
4372         'id',               'int', 'NULL',      '', '', '', 
4373         'uuid',            'char', 'NULL',      36, '', '',
4374         'title',        'varchar', 'NULL', $char_d, '', '', 
4375         'max_extensions',   'int', 'NULL',      '', '', '',
4376         'max_simultaneous', 'int', 'NULL',      '', '', '',
4377         'ip_addr',      'varchar', 'NULL',      40, '', '',
4378       ],
4379       'primary_key' => 'svcnum',
4380       'unique' => [],
4381       'index'  => [ [ 'id' ], [ 'uuid' ] ],
4382     },
4383
4384     'pbx_extension' => {
4385       'columns' => [
4386         'extensionnum',  'serial',     '',      '', '', '',
4387         'svcnum',           'int',     '',      '', '', '',
4388         'extension',    'varchar',     '', $char_d, '', '',
4389         'pin',          'varchar', 'NULL', $char_d, '', '',
4390         'sip_password', 'varchar', 'NULL', $char_d, '', '',
4391         'phone_name',   'varchar', 'NULL', $char_d, '', '',
4392       ],
4393       'primary_key'  => 'extensionnum',
4394       'unique'       => [ [ 'svcnum', 'extension' ] ],
4395       'index'        => [ [ 'svcnum' ] ],
4396     },
4397
4398     'svc_mailinglist' => { #svc_group?
4399       'columns' => [
4400         'svcnum',            'int',     '',            '', '', '', 
4401         'username',      'varchar',     '', $username_len, '', '',
4402         'domsvc',            'int',     '',            '', '', '', 
4403         'listnum',           'int',     '',            '', '', '',
4404         'reply_to',         'char', 'NULL',             1, '', '',#SetReplyTo
4405         'remove_from',      'char', 'NULL',             1, '', '',#RemoveAuthor
4406         'reject_auto',      'char', 'NULL',             1, '', '',#RejectAuto
4407         'remove_to_and_cc', 'char', 'NULL',             1, '', '',#RemoveToAndCc
4408       ],
4409       'primary_key' => 'svcnum',
4410       'unique' => [],
4411       'index'  => [ ['username'], ['domsvc'], ['listnum'] ],
4412     },
4413
4414     'mailinglist' => {
4415       'columns' => [
4416         'listnum',   'serial', '',      '', '', '',
4417         'listname', 'varchar', '', $char_d, '', '',
4418       ],
4419       'primary_key' => 'listnum',
4420       'unique' => [],
4421       'index'  => [],
4422     },
4423
4424     'mailinglistmember' => {
4425       'columns' => [
4426         'membernum',        'serial',     '',   '', '', '',
4427         'listnum',             'int',     '',   '', '', '',
4428         'svcnum',              'int', 'NULL',   '', '', '', 
4429         'contactemailnum',     'int', 'NULL',   '', '', '', 
4430         'email',           'varchar', 'NULL',  255, '', '', 
4431       ],
4432       'primary_key' => 'membernum',
4433       'unique'      => [],
4434       'index'       => [['listnum'],['svcnum'],['contactemailnum'],['email']],
4435     },
4436
4437     'bill_batch' => {
4438       'columns' => [
4439         'batchnum',         'serial',     '',  '', '', '',
4440         'agentnum',            'int', 'NULL',  '', '', '',
4441         'status',             'char', 'NULL', '1', '', '',
4442         'pdf',                'blob', 'NULL',  '', '', '',
4443       ],
4444       'primary_key' => 'batchnum',
4445       'unique'      => [],
4446       'index'       => [ ['agentnum'] ],
4447     },
4448
4449     'cust_bill_batch' => {
4450       'columns' => [
4451         'billbatchnum',     'serial',     '', '', '', '',
4452         'batchnum',            'int',     '', '', '', '',
4453         'invnum',              'int',     '', '', '', '',
4454       ],
4455       'primary_key' => 'billbatchnum',
4456       'unique'      => [],
4457       'index'       => [ [ 'batchnum' ], [ 'invnum' ] ],
4458     },
4459
4460     'cust_bill_batch_option' => {
4461       'columns' => [
4462         'optionnum', 'serial', '', '', '', '', 
4463         'billbatchnum', 'int', '', '', '', '', 
4464         'optionname', 'varchar', '', $char_d, '', '', 
4465         'optionvalue', 'text', 'NULL', '', '', '', 
4466       ],
4467       'primary_key' => 'optionnum',
4468       'unique'      => [],
4469       'index'       => [ [ 'billbatchnum' ], [ 'optionname' ] ],
4470     },
4471
4472     'msg_template' => {
4473       'columns' => [
4474         'msgnum',     'serial',     '',      '', '', '',
4475         'msgname',   'varchar',     '', $char_d, '', '',
4476         'agentnum',      'int', 'NULL',      '', '', '',
4477         'subject',   'varchar', 'NULL',     512, '', '',
4478         'mime_type', 'varchar',     '', $char_d, '', '',
4479         'body',         'blob', 'NULL',      '', '', '',
4480         'disabled',     'char', 'NULL',       1, '', '', 
4481         'from_addr', 'varchar', 'NULL',     255, '', '',
4482         'bcc_addr',  'varchar', 'NULL',     255, '', '',
4483       ],
4484       'primary_key' => 'msgnum',
4485       'unique'      => [ ],
4486       'index'       => [ ['agentnum'], ],
4487     },
4488
4489     'template_content' => {
4490       'columns' => [
4491         'contentnum', 'serial',     '',      '', '', '',
4492         'msgnum',        'int',     '',      '', '', '',
4493         'locale',    'varchar', 'NULL',      16, '', '',
4494         'subject',   'varchar', 'NULL',     512, '', '',
4495         'body',         'text', 'NULL',      '', '', '',
4496       ],
4497       'primary_key' => 'contentnum',
4498       'unique'      => [ ['msgnum', 'locale'] ],
4499       'index'       => [ ],
4500     },
4501
4502     'cust_msg' => {
4503       'columns' => [
4504         'custmsgnum', 'serial',     '',     '', '', '',
4505         'custnum',       'int', 'NULL',     '', '', '',
4506         'msgnum',        'int', 'NULL',     '', '', '',
4507         '_date',    @date_type,                 '', '',
4508         'env_from',  'varchar', 'NULL',    255, '', '',
4509         'env_to',    'varchar', 'NULL',    255, '', '',
4510         'header',       'blob', 'NULL',     '', '', '',
4511         'body',         'blob', 'NULL',     '', '', '',
4512         'error',     'varchar', 'NULL',    255, '', '',
4513         'status',    'varchar',     '',$char_d, '', '',
4514         'msgtype',   'varchar', 'NULL',     16, '', '',
4515       ],
4516       'primary_key' => 'custmsgnum',
4517       'unique'      => [ ],
4518       'index'       => [ ['custnum'], ],
4519     },
4520
4521     'svc_cert' => {
4522       'columns' => [
4523         'svcnum',                'int',     '',      '', '', '', 
4524         'recnum',                'int', 'NULL',      '', '', '',
4525         'privatekey',           'text', 'NULL',      '', '', '',
4526         'csr',                  'text', 'NULL',      '', '', '',
4527         'certificate',          'text', 'NULL',      '', '', '',
4528         'cacert',               'text', 'NULL',      '', '', '',
4529         'common_name',       'varchar', 'NULL', $char_d, '', '',
4530         'organization',      'varchar', 'NULL', $char_d, '', '',
4531         'organization_unit', 'varchar', 'NULL', $char_d, '', '',
4532         'city',              'varchar', 'NULL', $char_d, '', '',
4533         'state',             'varchar', 'NULL', $char_d, '', '',
4534         'country',              'char', 'NULL',       2, '', '',
4535         'cert_contact',      'varchar', 'NULL', $char_d, '', '',
4536       ],
4537       'primary_key' => 'svcnum',
4538       'unique' => [],
4539       'index'  => [], #recnum
4540     },
4541
4542     'svc_port' => {
4543       'columns' => [
4544         'svcnum',                'int',     '',      '', '', '', 
4545         'serviceid', 'varchar', '', 64, '', '', #srvexport / reportfields
4546       ],
4547       'primary_key' => 'svcnum',
4548       'unique' => [],
4549       'index'  => [], #recnum
4550     },
4551
4552     'areacode'  => {
4553       'columns' => [
4554         'areanum',   'serial',        '',      '', '', '',
4555         'code',        'char',        '',       3, '', '', 
4556         'country',     'char',    'NULL',       2, '', '',
4557         'state',       'char',    'NULL',       2, '', '', 
4558         'description','varchar',  'NULL',     255, '', '',
4559       ], 
4560       'primary_key' => 'areanum',
4561       'unique' => [ [ 'areanum' ] ],
4562       'index'  => [],
4563     },
4564
4565     'upgrade_journal' => {
4566       'columns' => [
4567         'upgradenum', 'serial', '', '', '', '',
4568         '_date', 'int', '', '', '', '',
4569         'upgrade', 'varchar', '', $char_d, '', '',
4570         'status', 'varchar', '', $char_d, '', '',
4571         'statustext', 'varchar', 'NULL', $char_d, '', '',
4572       ],
4573       'primary_key' => 'upgradenum',
4574       'unique' => [],
4575       'index' => [ [ 'upgrade' ] ],
4576     },
4577
4578     'upload_target' => {
4579       'columns' => [
4580         'targetnum', 'serial', '', '', '', '',
4581         'agentnum', 'int', 'NULL', '', '', '',
4582         'protocol', 'varchar', '', 10, '', '',
4583         'hostname', 'varchar', '', $char_d, '', '',
4584         'port', 'int', 'NULL', '', '', '',
4585         'username', 'varchar', '', $char_d, '', '',
4586         'password', 'varchar', 'NULL', $char_d, '', '',
4587         'path', 'varchar', 'NULL', $char_d, '', '',
4588         'subject', 'varchar', 'NULL', '255', '', '',
4589         'handling', 'varchar', 'NULL', $char_d, '', '',
4590       ],
4591       'primary_key' => 'targetnum',
4592       'unique' => [ [ 'targetnum' ] ],
4593       'index' => [],
4594     },
4595
4596     'log' => {
4597       'columns' => [
4598         'lognum',     'serial', '', '', '', '',
4599         '_date',      'int', '', '', '', '',
4600         'agentnum',   'int', 'NULL', '', '', '',
4601         'tablename',  'varchar', 'NULL', $char_d, '', '',
4602         'tablenum',   'int',  'NULL', '', '', '', 
4603         'level',      'int',  '', '', '', '',
4604         'message',    'text', '', '', '', '',
4605       ],
4606       'primary_key' => 'lognum',
4607       'unique'      => [],
4608       'index'       => [ ['_date'], ['level'] ],
4609     },
4610
4611     'log_context' => {
4612       'columns' => [
4613         'logcontextnum', 'serial', '', '', '', '',
4614         'lognum', 'int', '', '', '', '',
4615         'context', 'varchar', '', $char_d, '', '',
4616       ],
4617       'primary_key' => 'logcontextnum',
4618       'unique' => [ [ 'lognum', 'context' ] ],
4619       'index' => [],
4620     },
4621
4622     'svc_alarm' => {
4623       'columns' => [
4624 #       name               type        null   length   default local
4625         'svcnum',          'int',      '',    '',      '',     '', 
4626         'alarmsystemnum',  'int',      '',    '',      '',     '',
4627         'alarmtypenum',    'int',      '',    '',      '',     '',
4628         'alarmstationnum', 'int',      '',    '',      '',     '',
4629         'acctnum',         'varchar',  '',    $char_d, '',     '',
4630         '_password',       'varchar',  '',    $char_d, '',     '',
4631         'location',        'varchar', 'NULL', $char_d, '',     '',
4632         'cs_receiver',     'int',     'NULL', '',      '',     '',
4633         'cs_phonenum',     'varchar', 'NULL', $char_d, '',     '',
4634         'serialnum',       'varchar', 'NULL', $char_d, '',     '',
4635         #installer (rep)
4636       ],
4637       'primary_key' => 'svcnum',
4638       'unique' => [],
4639       'index'  => [],
4640     },
4641
4642     'alarm_system' => { #vendors
4643       'columns' => [
4644         'alarmsystemnum',  'serial',     '',      '', '', '',
4645         'agentnum',           'int', 'NULL',      '', '', '',
4646         'systemname',     'varchar',     '', $char_d, '', '',
4647         'disabled',          'char', 'NULL',       1, '', '', 
4648       ],
4649       'primary_key' => 'alarmsystemnum',
4650       'unique'      => [ ['agentnum', 'systemname'] ],
4651       'index'       => [ ['agentnum'], ['disabled'] ],
4652     },
4653
4654     'alarm_type' => { #inputs and outputs
4655       'columns' => [
4656         'alarmtypenum', 'serial',     '',      '', '', '',
4657         'agentnum',        'int', 'NULL',      '', '', '',
4658         'inputs',          'int',     '', '', '', '',
4659         'outputs',         'int',     '', '', '', '',
4660         'disabled',       'char', 'NULL',       1, '', '', 
4661       ],
4662       'primary_key' => 'alarmtypenum',
4663       'unique'      => [ ['agentnum', 'inputs', 'outputs'] ],
4664       'index'       => [ ['agentnum'], ['disabled'] ],
4665     },
4666
4667     'alarm_station' => { #central station (where the alarm reports to)
4668       'columns' => [
4669         'alarmstationnum', 'serial',     '',      '', '', '',
4670         'agentnum',           'int', 'NULL',      '', '', '',
4671         'stationname',    'varchar',     '', $char_d, '', '',
4672         'disabled',          'char', 'NULL',       1, '', '', 
4673       ],
4674       'primary_key' => 'alarmstationnum',
4675       'unique'      => [ ['agentnum', 'stationname'], ],
4676       'index'       => [ ['agentnum'], ['disabled'] ],
4677     },
4678
4679     'svc_cable' => {
4680       'columns' => [
4681         'svcnum',        'int',     '',      '', '', '', 
4682         'providernum',   'int', 'NULL',      '', '', '',
4683         'ordernum',  'varchar', 'NULL', $char_d, '', '',
4684         'modelnum',      'int', 'NULL',      '', '', '',
4685         'serialnum', 'varchar', 'NULL', $char_d, '', '',
4686         'mac_addr',  'varchar', 'NULL',      12, '', '', 
4687       ],
4688       'primary_key' => 'svcnum',
4689       'unique'       => [ ['serialnum'] , ['mac_addr'] ],
4690       'index'  => [],
4691     },
4692
4693     'cable_model' => {
4694       'columns' => [
4695         'modelnum',    'serial',     '',      '', '', '',
4696         'model_name', 'varchar',     '', $char_d, '', '',
4697         'disabled',      'char', 'NULL',       1, '', '', 
4698       ],
4699       'primary_key' => 'modelnum',
4700       'unique' => [ [ 'model_name' ], ],
4701       'index'  => [],
4702     },
4703
4704     'cable_provider' => {
4705       'columns' => [
4706         'providernum', 'serial',     '',      '', '', '',
4707         'provider',   'varchar',     '', $char_d, '', '',
4708         'disabled',      'char', 'NULL',       1, '', '', 
4709       ],
4710       'primary_key' => 'providernum',
4711       'unique' => [ [ 'provider' ], ],
4712       'index'  => [],
4713     },
4714
4715     'circuit_type' => {
4716       'columns' => [
4717         'typenum',     'serial',     '',      '', '', '',
4718         'typename',   'varchar',     '', $char_d, '', '',
4719         'disabled',      'char', 'NULL',       1, '', '',
4720         # speed? number of voice lines? anything else?
4721       ],
4722       'primary_key' => 'typenum',
4723       'unique' => [ [ 'typename' ] ],
4724       'index'  => [],
4725     },
4726
4727     'circuit_provider' => {
4728       'columns' => [
4729         'providernum', 'serial',     '',      '', '', '',
4730         'provider',   'varchar',     '', $char_d, '', '',
4731         'disabled',      'char', 'NULL',       1, '', '', 
4732       ],
4733       'primary_key' => 'providernum',
4734       'unique' => [ [ 'provider' ], ],
4735       'index'  => [],
4736     },
4737
4738     'circuit_termination' => {
4739       'columns' => [
4740         'termnum',     'serial',     '',      '', '', '',
4741         'termination','varchar',     '', $char_d, '', '',
4742         'disabled',      'char', 'NULL',       1, '', '',
4743       ],
4744       'primary_key' => 'termnum',
4745       'unique' => [ [ 'termination' ] ],
4746       'index' => [],
4747     },
4748
4749     'svc_circuit' => {
4750       'columns' => [
4751         'svcnum',                   'int',     '', '', '', '',
4752         'typenum',                  'int',     '', '', '', '',
4753         'providernum',              'int',     '', '', '', '',
4754         'termnum',                  'int',     '', '', '', '',
4755         'circuit_id',           'varchar',     '', 64, '', '',
4756         'desired_due_date',         'int', 'NULL', '', '', '',
4757         'due_date',                 'int', 'NULL', '', '', '',
4758         'vendor_order_id',      'varchar', 'NULL', $char_d,  '', '',
4759         'vendor_qual_id',       'varchar', 'NULL', $char_d,  '', '',
4760         'vendor_order_type',    'varchar', 'NULL', $char_d,  '', '',
4761         'vendor_order_status',  'varchar', 'NULL', $char_d,  '', '',
4762         'endpoint_ip_addr',     'varchar', 'NULL', 40, '', '',
4763         'endpoint_mac_addr',    'varchar', 'NULL', 12, '', '',
4764       ],
4765       'primary_key' => 'svcnum',
4766       'unique'      => [],
4767       'index'       => [ [ 'providernum' ], [ 'typenum' ] ],
4768     },
4769
4770     'svc_fiber' => {
4771       'columns' => [
4772         'svcnum',         'int',     '',      '', '', '',
4773         'oltnum',         'int', 'NULL',      '', '', '',
4774         'shelf',          'int', 'NULL',      '', '', '',
4775         'card',           'int', 'NULL',      '', '', '',
4776         'olt_port',       'int', 'NULL',      '', '', '',
4777         'ont_id',         'int', 'NULL',      '', '', '',
4778         'ont_typenum',    'int', 'NULL',      '', '', '',
4779         'ont_serial', 'varchar', 'NULL', $char_d, '', '',
4780         'ont_port',   'varchar', 'NULL',      16, '', '',
4781         'circuit_id', 'varchar', 'NULL', $char_d, '', '',
4782         'vlan',           'int', 'NULL',      '', '', '',
4783         'signal',     'decimal', 'NULL',  '10,2', '', '',
4784         'speed_up',       'int', 'NULL',      '', '', '',
4785         'speed_down',     'int', 'NULL',      '', '', '',
4786         'ont_install','varchar', 'NULL', $char_d, '', '',
4787       ],
4788       'primary_key' => 'svcnum',
4789       'unique'      => [ ],
4790       'index'       => [ [ 'ont_serial' ] ],
4791     },
4792
4793     'fiber_olt' => {
4794       'columns' => [
4795         'oltnum',   'serial', '',       '', '', '',
4796         'oltname', 'varchar', '',  $char_d, '', '',
4797         'sitenum',     'int', 'NULL',   '', '', '',
4798         'serial',  'varchar', '',  $char_d, '', '',
4799         'disabled',   'char', 'NULL',    1, '', '',
4800       ],
4801       'primary_key' => 'oltnum',
4802       'unique' => [ ],
4803       'index'  => [ ],
4804       'foreign_keys' => [
4805                           { columns => [ 'sitenum' ],
4806                             table   => 'olt_site',
4807                           },
4808                         ],
4809     },
4810
4811     'olt_site' => {
4812       'columns' => [
4813         'sitenum',  'serial', '',      '', '', '',
4814         'market',  'varchar', '', $char_d, '', '',
4815         'site',    'varchar', '', $char_d, '', '',
4816       ],
4817       'primary_key' => 'sitenum',
4818       'unique' => [ [ 'market', 'site' ] ],
4819       'index' => [ ],
4820     },
4821
4822
4823
4824
4825
4826     'vend_main' => {
4827       'columns' => [
4828         'vendnum',   'serial',     '',      '', '', '',
4829         'vendname', 'varchar',     '', $char_d, '', '',
4830         'classnum',     'int',     '',      '', '', '',
4831         'disabled',    'char', 'NULL',       1, '', '', 
4832       ],
4833       'primary_key'  => 'vendnum',
4834       'unique'       => [ ['vendname', 'disabled'] ],
4835       'index'        => [],
4836       'foreign_keys' => [
4837                           { columns    => [ 'classnum' ],
4838                             table      => 'vend_class',
4839                           },
4840                         ],
4841     },
4842
4843     'vend_class' => {
4844       'columns' => [
4845         'classnum',     'serial',     '',      '', '', '', 
4846         'classname',   'varchar',     '', $char_d, '', '', 
4847         'disabled',       'char', 'NULL',       1, '', '', 
4848       ],
4849       'primary_key' => 'classnum',
4850       'unique'      => [],
4851       'index'       => [ ['disabled'] ],
4852     },
4853
4854     'vend_bill' => {
4855       'columns' => [
4856         'vendbillnum',    'serial',     '',      '', '', '', 
4857         'vendnum',           'int',     '',      '', '', '', 
4858         #'_date',        @date_type,                  '', '', 
4859         '_date',     'int', '', '',                   '', '', 
4860         'charged',     @money_type,                  '', '', 
4861       ],
4862       'primary_key'  => 'vendbillnum',
4863       'unique'       => [],
4864       'index'        => [ ['vendnum'], ['_date'], ],
4865       'foreign_keys' => [
4866                           { columns    => [ 'vendnum' ],
4867                             table      => 'vend_main',
4868                           },
4869                         ],
4870     },
4871
4872     'vend_pay' => {
4873       'columns' => [
4874         'vendpaynum',   'serial',    '',       '', '', '',
4875         'vendnum',         'int',    '',       '', '', '', 
4876         #'_date',     @date_type,                   '', '', 
4877         '_date',     'int', '', '',                   '', '', 
4878         'paid',      @money_type,                  '', '', 
4879       ],
4880       'primary_key'  => 'vendpaynum',
4881       'unique'       => [],
4882       'index'        => [ [ 'vendnum' ], [ '_date' ], ],
4883       'foreign_keys' => [
4884                           { columns    => [ 'vendnum' ],
4885                             table      => 'vend_main',
4886                           },
4887                         ],
4888     },
4889
4890     'vend_bill_pay' => {
4891       'columns' => [
4892         'vendbillpaynum', 'serial',     '',   '', '', '', 
4893         'vendbillnum',       'int',     '',   '', '', '', 
4894         'vendpaynum',        'int',     '',   '', '', '', 
4895         'amount',  @money_type, '', '', 
4896         #? '_date',   @date_type, '', '', 
4897       ],
4898       'primary_key'  => 'vendbillpaynum',
4899       'unique'       => [],
4900       'index'        => [ [ 'vendbillnum' ], [ 'vendpaynum' ] ],
4901       'foreign_keys' => [
4902                           { columns    => [ 'vendbillnum' ],
4903                             table      => 'vend_bill',
4904                           },
4905                           { columns    => [ 'vendpaynum' ],
4906                             table      => 'vend_pay',
4907                           },
4908                         ],
4909     },
4910     %{ tables_hashref_torrus() },
4911
4912     # tables of ours for doing torrus virtual port combining
4913     'torrus_srvderive' => {
4914       'columns' => [
4915         'derivenum',     'serial',     '', '', '', '',
4916         'serviceid',    'varchar',     '', 64, '', '', #srvexport / reportfields
4917         'last_srv_date',   'date', 'NULL', '', '', '',
4918       ],
4919       'primary_key' => 'derivenum',
4920       'unique' => [ ['serviceid'] ],
4921       'index'  => [],
4922     },
4923
4924     'torrus_srvderive_component' => {
4925       'columns' => [
4926         'componentnum', 'serial', '', '', '', '',
4927         'derivenum',       'int', '', '', '', '',
4928         'serviceid',   'varchar', '', 64, '', '', #srvexport / reportfields
4929       ],
4930       'primary_key' => 'componentnum',
4931       'unique'      => [ [ 'derivenum', 'serviceid' ], ],
4932       'index'       => [ [ 'derivenum', ], ],
4933     },
4934
4935     'invoice_mode' => {
4936       'columns' => [
4937         'modenum',      'serial', '', '', '', '',
4938         'agentnum',        'int', 'NULL', '', '', '',
4939         'modename',    'varchar', '', 32, '', '',
4940       ],
4941       'primary_key' => 'modenum',
4942       'unique'      => [ ],
4943       'index'       => [ ],
4944     },
4945
4946     'invoice_conf' => {
4947       'columns' => [
4948         'confnum',              'serial',   '', '', '', '',
4949         'modenum',              'int',      '', '', '', '',
4950         'locale',               'varchar',  'NULL', 16, '', '',
4951         'notice_name',          'varchar',  'NULL', 64, '', '',
4952         'subject',              'varchar',  'NULL', 64, '', '',
4953         'htmlnotes',            'text',     'NULL', '', '', '',
4954         'htmlfooter',           'text',     'NULL', '', '', '',
4955         'htmlsummary',          'text',     'NULL', '', '', '',
4956         'htmlreturnaddress',    'text',     'NULL', '', '', '',
4957         'latexnotes',           'text',     'NULL', '', '', '',
4958         'latexfooter',          'text',     'NULL', '', '', '',
4959         'latexsummary',         'text',     'NULL', '', '', '',
4960         'latexsmallfooter',     'text',     'NULL', '', '', '',
4961         'latexreturnaddress',   'text',     'NULL', '', '', '',
4962         'with_latexcoupon',     'char',     'NULL', '1', '', '',
4963         'htmlwatermark',        'text',     'NULL', '', '', '',
4964         'latexwatermark',       'text',     'NULL', '', '', '',
4965         'lpr',                  'varchar',  'NULL', $char_d, '', '',
4966       ],
4967       'primary_key' => 'confnum',
4968       'unique' => [ [ 'modenum', 'locale' ] ],
4969       'index'  => [ ],
4970     },
4971
4972     'export_batch' => {
4973       'columns' => [
4974         'batchnum',    'serial',     '',      '', '', '',
4975         'exportnum',      'int',     '',      '', '', '',
4976         '_date',          'int',     '',      '', '', '',
4977         'status',     'varchar', 'NULL',      32, '', '',
4978         'statustext',    'text', 'NULL',      '', '', '',
4979       ],
4980       'primary_key'  => 'batchnum',
4981       'unique'       => [],
4982       'index'        => [ [ 'exportnum' ], [ 'status' ] ],
4983     },
4984
4985     'export_batch_item' => {
4986       'columns' => [
4987         'itemnum',     'serial',     '',      '', '', '',
4988         'batchnum',       'int',     '',      '', '', '',
4989         'svcnum',         'int',     '',      '', '', '',
4990         'action',     'varchar',     '',      32, '', '',
4991         'data',          'text', 'NULL',      '', '', '',
4992         'frozen',        'char', 'NULL',       1, '', '',
4993       ],
4994       'primary_key'  => 'itemnum',
4995       'unique'       => [],
4996       'index'        => [ [ 'batchnum' ], [ 'svcnum' ] ],
4997     },
4998
4999     # lookup table for states, similar to msa and lata
5000     'state' => {
5001       'columns' => [
5002         'statenum', 'int',  '', '', '', '', 
5003         'country',  'char', '',  2, '', '',
5004         'state',    'char', '', $char_d, '', '', 
5005         'fips',     'char', '',  3, '', '',
5006       ],
5007       'primary_key' => 'statenum',
5008       'unique' => [ [ 'country', 'state' ], ],
5009       'index' => [],
5010     },
5011
5012     # eventually link to tower/sector?
5013     'deploy_zone' => {
5014       'columns' => [
5015         'zonenum',        'serial',  '',     '',      '', '',
5016         'description',    'char',    'NULL', $char_d, '', '',
5017         'agentnum',       'int',     '',     '',      '', '',
5018         'censusyear',     'char',    'NULL', 4,      '', '',
5019         'dbaname',        'char',    'NULL', $char_d, '', '',
5020         'zonetype',       'char',    '',     1,       '', '',
5021         'technology',     'int',     '',     '',      '', '',
5022         'spectrum',       'int',     'NULL', '',      '', '',
5023         'adv_speed_up',   'decimal', '',     '10,3', '0', '',
5024         'adv_speed_down', 'decimal', '',     '10,3', '0', '',
5025         'cir_speed_up',   'decimal', '',     '10,3', '0', '',
5026         'cir_speed_down', 'decimal', '',     '10,3', '0', '',
5027         'is_broadband',   'char',    'NULL', 1,       '', '',
5028         'is_voice',       'char',    'NULL', 1,       '', '',
5029         'is_consumer',    'char',    'NULL', 1,       '', '',
5030         'is_business',    'char',    'NULL', 1,       '', '',
5031         'active_date',    @date_type,                 '', '',
5032         'expire_date',    @date_type,                 '', '',
5033       ],
5034       'primary_key' => 'zonenum',
5035       'unique' => [],
5036       'index'  => [ [ 'agentnum' ] ],
5037     },
5038
5039     'deploy_zone_block' => {
5040       'columns' => [
5041         'blocknum',       'serial',  '',     '',      '', '',
5042         'zonenum',        'int',     '',     '',      '', '',
5043         'censusblock',    'char',    '',     15,      '', '',
5044         'censusyear',     'char','NULL',      4,      '', '',
5045       ],
5046       'primary_key' => 'blocknum',
5047       'unique' => [],
5048       'index'  => [ [ 'zonenum' ] ],
5049     },
5050
5051     'deploy_zone_vertex' => {
5052       'columns' => [
5053         'vertexnum',      'serial',  '',     '',      '', '',
5054         'zonenum',        'int',     '',     '',      '', '',
5055         'latitude',       'decimal', '',     '10,7',  '', '', 
5056         'longitude',      'decimal', '',     '10,7',  '', '', 
5057       ],
5058       'primary_key' => 'vertexnum',
5059       'unique' => [ ],
5060       'index'  => [ ],
5061     },
5062
5063     'cacti_page' => {
5064       'columns' => [
5065         'cacti_pagenum',  'serial',   '',     '', '', '',
5066         'exportnum',      'int',      'NULL', '', '', '',
5067         'svcnum',         'int',      'NULL', '', '', '', 
5068         'graphnum',       'int',      'NULL', '', '', '', 
5069         'imported',       @date_type,             '', '',
5070         'content',        'text',     'NULL', '', '', '',
5071       ],
5072       'primary_key' => 'cacti_pagenum',
5073       'unique'  => [ ],
5074       'index'   => [ ['svcnum'], ['imported'] ],
5075     },
5076
5077     'report_batch' => {
5078       'columns' => [
5079         'reportbatchnum', 'serial',      '',  '', '', '',
5080         'reportname',     'varchar',     '', 255, '', '',
5081         'agentnum',           'int', 'NULL',  '', '', '',
5082         'send_date',     @date_type,              '', '',
5083         'sdate',         @date_type,              '', '',
5084         'edate',         @date_type,              '', '',
5085         'usernum',            'int', 'NULL',  '', '', '',
5086         'msgnum',             'int', 'NULL',  '', '', '',
5087         # add report params here as necessary
5088       ],
5089       'primary_key' => 'reportbatchnum',
5090       'unique' => [],
5091       'index'  => [],
5092       'foreign_keys' => [
5093                           { columns    => [ 'agentnum' ],
5094                             table      => 'agent',
5095                             references => [ 'agentnum' ],
5096                           },
5097                           { columns    => [ 'usernum' ],
5098                             table      => 'access_user',
5099                             references => [ 'usernum' ],
5100                           },
5101                           { columns    => [ 'msgnum' ],
5102                             table      => 'msg_template',
5103                             references => [ 'msgnum' ],
5104                           },
5105                         ],
5106     },
5107
5108     'password_history' => {
5109       'columns' => [
5110         'passwordnum',        'serial',  '',          '', '', '',
5111         '_password',          'varchar', 'NULL', $char_d, '', '',
5112         'encryption_method',  'varchar', 'NULL', $char_d, '', '',
5113         'created',   @date_type,   '', '',
5114         # each table that needs password history gets a column here, and
5115         # an entry in foreign_keys.
5116         'svc_acct__svcnum',     'int', 'NULL', '', '', '',
5117         'svc_dsl__svcnum',      'int', 'NULL', '', '', '',
5118         'svc_alarm__svcnum',    'int', 'NULL', '', '', '',
5119         'agent__agentnum',      'int', 'NULL', '', '', '',
5120         'contact__contactnum',  'int', 'NULL', '', '', '',
5121         'access_user__usernum', 'int', 'NULL', '', '', '',
5122       ],
5123       'primary_key' => 'passwordnum',
5124       'unique' => [],
5125       'index'  => [],
5126       'foreign_keys' => [
5127                           { columns     => [ 'svc_acct__svcnum' ],
5128                             table       => 'svc_acct',
5129                             references  => [ 'svcnum' ],
5130                           },
5131                           { columns     => [ 'svc_dsl__svcnum' ],
5132                             table       => 'svc_dsl',
5133                             references  => [ 'svcnum' ],
5134                           },
5135                           { columns     => [ 'svc_alarm__svcnum' ],
5136                             table       => 'svc_alarm',
5137                             references  => [ 'svcnum' ],
5138                           },
5139                           { columns    => [ 'agent__agentnum' ],
5140                             table      => 'agent',
5141                             references => [ 'agentnum' ],
5142                           },
5143                           { columns    => [ 'contact__contactnum' ],
5144                             table      => 'contact',
5145                             references => [ 'contactnum' ],
5146                           },
5147                           { columns    => [ 'access_user__usernum' ],
5148                             table      => 'access_user',
5149                             references => [ 'usernum' ],
5150                           },
5151                         ],
5152     },
5153
5154     'webservice_log' => {
5155       'columns' => [
5156         'webservicelognum',    'serial',      '',      '', '', '', #big? hubrus
5157         'svcnum',                 'int',  'NULL',      '', '', '', #just in case
5158         'custnum',                'int',      '',      '', '', '',
5159         'method',             'varchar',      '', $char_d, '', '',
5160         'quantity',               'int',      '',      '', '', '', #i.e. pages
5161         '_date',             @date_type,                   '', '',
5162         'status',             'varchar',  'NULL', $char_d, '', '', 
5163         'rated_price',        'decimal',  'NULL',  '10,2', '', '',
5164       ],
5165       'primary_key'  => 'webservicelognum',
5166       'unique'       => [],
5167       'index'        => [ ['custnum'], ['status'] ],
5168       'foreign_keys' => [
5169                           { columns => [ 'custnum' ],
5170                             table   => 'cust_main',
5171                           },
5172                           #no FK on svcnum... we don't want to purge these on
5173                           # service deletion
5174                         ],
5175     },
5176
5177     # name type nullability length default local
5178
5179     #'new_table' => {
5180     #  'columns' => [
5181     #    'num', 'serial',       '', '', '', '',
5182     #  ],
5183     #  'primary_key' => 'num',
5184     #  'unique' => [],
5185     #  'index'  => [],
5186     #},
5187
5188   };
5189
5190 }
5191
5192 =back
5193
5194 =head1 BUGS
5195
5196 =head1 SEE ALSO
5197
5198 L<DBIx::DBSchema>
5199
5200 =cut
5201
5202 1;
5203