package categories (meta package classes) and grouping invoices by them
[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.33;
7 use DBIx::DBSchema::Table;
8 use DBIx::DBSchema::Column 0.06;
9 use DBIx::DBSchema::Index;
10
11 @ISA = qw(Exporter);
12 @EXPORT_OK = qw( dbdef dbdef_dist reload_dbdef );
13
14 $DEBUG = 0;
15 $me = '[FS::Schema]';
16
17 =head1 NAME
18
19 FS::Schema - Freeside database schema
20
21 =head1 SYNOPSYS
22
23     use FS::Schema qw(dbdef dbdef_dist reload_dbdef);
24
25     $dbdef = reload_dbdef;
26     $dbdef = reload_dbdef "/non/standard/filename";
27     $dbdef = dbdef;
28     $dbdef_dist = dbdef_dist;
29
30 =head1 DESCRIPTION
31
32 This class represents the database schema.
33
34 =head1 METHODS
35
36 =over 4
37
38 =item reload_dbdef([FILENAME])
39
40 Load a database definition (see L<DBIx::DBSchema>), optionally from a
41 non-default filename.  This command is executed at startup unless
42 I<$FS::Schema::setup_hack> is true.  Returns a DBIx::DBSchema object.
43
44 =cut
45
46 sub reload_dbdef {
47   my $file = shift;
48
49   unless ( exists $dbdef_cache{$file} ) {
50     warn "[debug]$me loading dbdef for $file\n" if $DEBUG;
51     $dbdef_cache{$file} = DBIx::DBSchema->load( $file )
52       or die "can't load database schema from $file: $DBIx::DBSchema::errstr\n";
53   } else {
54     warn "[debug]$me re-using cached dbdef for $file\n" if $DEBUG;
55   }
56   $dbdef = $dbdef_cache{$file};
57 }
58
59 =item dbdef
60
61 Returns the current database definition (represents the current database,
62 assuming it is up-to-date).  See L<DBIx::DBSchema>.
63
64 =cut
65
66 sub dbdef { $dbdef; }
67
68 =item dbdef_dist [ DATASRC ]
69
70 Returns the current canoical database definition as defined in this file.
71
72 Optionally, pass a DBI data source to enable syntax specific to that database.
73 Currently, this enables "TYPE=InnoDB" for MySQL databases.
74
75 =cut
76
77 sub dbdef_dist {
78   my $datasrc = @_ ? shift : '';
79   
80   my $local_options = '';
81   if ( $datasrc =~ /^dbi:mysql/i ) {
82     $local_options = 'TYPE=InnoDB';
83   }
84
85   ###
86   # create a dbdef object from the old data structure
87   ###
88
89   my $tables_hashref = tables_hashref();
90
91   #turn it into objects
92   my $dbdef = new DBIx::DBSchema map {  
93
94     my $tablename = $_;
95     my $indexnum = 1;
96
97     my @columns;
98     while (@{$tables_hashref->{$tablename}{'columns'}}) {
99       #my($name, $type, $null, $length, $default, $local) =
100       my @coldef = 
101         splice @{$tables_hashref->{$tablename}{'columns'}}, 0, 6;
102       my %hash = map { $_ => shift @coldef }
103                      qw( name type null length default local );
104
105       unless ( defined $hash{'default'} ) {
106         warn "$tablename:\n".
107              join('', map "$_ => $hash{$_}\n", keys %hash) ;# $stop = <STDIN>;
108       }
109
110       push @columns, new DBIx::DBSchema::Column ( \%hash );
111     }
112
113     #false laziness w/sub indices in DBIx::DBSchema::DBD (well, sorta)
114     #and sub sql_create_table in DBIx::DBSchema::Table (slighty more?)
115     my $unique = $tables_hashref->{$tablename}{'unique'};
116     my $index  = $tables_hashref->{$tablename}{'index'};
117     my @indices = ();
118     push @indices, map {
119                          DBIx::DBSchema::Index->new({
120                            'name'    => $tablename. $indexnum++,
121                            'unique'  => 1,
122                            'columns' => $_,
123                          });
124                        }
125                        @$unique;
126     push @indices, map {
127                          DBIx::DBSchema::Index->new({
128                            'name'    => $tablename. $indexnum++,
129                            'unique'  => 0,
130                            'columns' => $_,
131                          });
132                        }
133                        @$index;
134
135     DBIx::DBSchema::Table->new({
136       'name'          => $tablename,
137       'primary_key'   => $tables_hashref->{$tablename}{'primary_key'},
138       'columns'       => \@columns,
139       'indices'       => \@indices,
140       'local_options' => $local_options,
141     });
142
143   } keys %$tables_hashref;
144
145   if ( $DEBUG ) {
146     warn "[debug]$me initial dbdef_dist created ($dbdef) with tables:\n";
147     warn "[debug]$me   $_\n" foreach $dbdef->tables;
148   }
149   
150   #add radius attributes to svc_acct
151   #
152   #my($svc_acct)=$dbdef->table('svc_acct');
153   # 
154   #my($attribute);
155   #foreach $attribute (@attributes) {
156   #  $svc_acct->addcolumn ( new DBIx::DBSchema::Column (
157   #    'radius_'. $attribute,
158   #    'varchar',
159   #    'NULL',
160   #    $char_d,
161   #  ));
162   #}
163   # 
164   #foreach $attribute (@check_attributes) {
165   #  $svc_acct->addcolumn( new DBIx::DBSchema::Column (
166   #    'rc_'. $attribute,
167   #    'varchar',
168   #    'NULL',
169   #    $char_d,
170   #  ));
171   #}
172
173   #create history tables (false laziness w/create-history-tables)
174   foreach my $table (
175     grep { ! /^clientapi_session/ }
176     grep { ! /^h_/ }
177     $dbdef->tables
178   ) {
179     my $tableobj = $dbdef->table($table)
180       or die "unknown table $table";
181
182     my %indices = $tableobj->indices;
183     
184     my %h_indices = map { 
185                           ( "h_$_" =>
186                               DBIx::DBSchema::Index->new({
187                                 'name'    => 'h_'. $indices{$_}->name,
188                                 'unique'  => 0,
189                                 'columns' => [ @{$indices{$_}->columns} ],
190                               })
191                           );
192                         }
193                         keys %indices;
194
195     $h_indices{"h_${table}_srckey"} = DBIx::DBSchema::Index->new({
196                                         'name'    => "h_${table}_srckey",
197                                         'unique'  => 0,
198                                         'columns' => [ 'history_action', #right?
199                                                        $tableobj->primary_key,
200                                                      ],
201                                       });
202
203     my $h_tableobj = DBIx::DBSchema::Table->new( {
204       'name'          => "h_$table",
205       'primary_key'   => 'historynum',
206       'indices'       => \%h_indices,
207       'local_options' => $local_options,
208       'columns'       => [
209           DBIx::DBSchema::Column->new( {
210             'name'    => 'historynum',
211             'type'    => 'serial',
212             'null'    => 'NOT NULL',
213             'length'  => '',
214             'default' => '',
215             'local'   => '',
216           } ),
217           DBIx::DBSchema::Column->new( {
218             'name'    => 'history_date',
219             'type'    => 'int',
220             'null'    => 'NULL',
221             'length'  => '',
222             'default' => '',
223             'local'   => '',
224           } ),
225           DBIx::DBSchema::Column->new( {
226             'name'    => 'history_user',
227             'type'    => 'varchar',
228             'null'    => 'NOT NULL',
229             'length'  => '80',
230             'default' => '',
231             'local'   => '',
232           } ),
233           DBIx::DBSchema::Column->new( {
234             'name'    => 'history_action',
235             'type'    => 'varchar',
236             'null'    => 'NOT NULL',
237             'length'  => '80',
238             'default' => '',
239             'local'   => '',
240           } ),
241           map {
242             my $column = $tableobj->column($_);
243     
244             #clone so as to not disturb the original
245             $column = DBIx::DBSchema::Column->new( {
246               map { $_ => $column->$_() }
247                 qw( name type null length default local )
248             } );
249     
250             if ( $column->type =~ /^(\w*)SERIAL$/i ) {
251               $column->type('int');
252               $column->null('NULL');
253             }
254             #$column->default('')
255             #  if $column->default =~ /^nextval\(/i;
256             #( my $local = $column->local ) =~ s/AUTO_INCREMENT//i;
257             #$column->local($local);
258             $column;
259           } $tableobj->columns
260       ],
261     } );
262     $dbdef->addtable($h_tableobj);
263   }
264
265   if ( $datasrc =~ /^dbi:mysql/i ) {
266
267     my $dup_lock_table = DBIx::DBSchema::Table->new( {
268       'name'          => 'duplicate_lock',
269       'primary_key'   => 'duplocknum',
270       'local_options' => $local_options,
271       'columns'       => [
272         DBIx::DBSchema::Column->new( {
273           'name'    => 'duplocknum',
274           'type'    => 'serial',
275           'null'    => 'NOT NULL',
276           'length'  => '',
277           'default' => '',
278           'local'   => '',
279         } ),
280         DBIx::DBSchema::Column->new( {
281           'name'    => 'lockname',
282           'type'    => 'varchar',
283           'null'    => 'NOT NULL',
284           'length'  => '80',
285           'default' => '',
286           'local'   => '',
287         } ),
288       ],
289       'indices' => { 'duplicate_lock1' =>
290                        DBIx::DBSchema::Index->new({
291                          'name'    => 'duplicate_lock1',
292                          'unique'  => 1,
293                          'columns' => [ 'lockname' ],
294                        })
295                    },
296     } );
297
298     $dbdef->addtable($dup_lock_table);
299
300   }
301
302   $dbdef;
303
304 }
305
306 sub tables_hashref {
307
308   my $char_d = 80; #default maxlength for text fields
309
310   #my(@date_type)  = ( 'timestamp', '', ''     );
311   my @date_type  = ( 'int', 'NULL', ''     );
312   my @perl_type = ( 'text', 'NULL', ''  ); 
313   my @money_type = ( 'decimal',   '', '10,2' );
314   my @money_typen = ( 'decimal',   'NULL', '10,2' );
315
316   my $username_len = 32; #usernamemax config file
317
318     # name type nullability length default local
319
320   return {
321
322     'agent' => {
323       'columns' => [
324         'agentnum',          'serial',    '',       '', '', '', 
325         'agent',            'varchar',    '',  $char_d, '', '', 
326         'typenum',              'int',    '',       '', '', '', 
327         'disabled',            'char', 'NULL',       1, '', '', 
328         'ticketing_queueid',    'int', 'NULL',      '', '', '', 
329         'invoice_template', 'varchar', 'NULL', $char_d, '', '',
330         'username',         'varchar', 'NULL', $char_d, '', '', #deprecated
331         '_password',        'varchar', 'NULL', $char_d, '', '', #deprecated
332         'freq',              'int', 'NULL', '', '', '', #deprecated (never used)
333         'prog',                     @perl_type, '', '', #deprecated (never used)
334
335       ],
336       'primary_key' => 'agentnum',
337       'unique' => [],
338       'index' => [ ['typenum'], ['disabled'] ],
339     },
340
341     'agent_type' => {
342       'columns' => [
343         'typenum',   'serial',  '', '', '', '', 
344         'atype',     'varchar', '', $char_d, '', '', 
345       ],
346       'primary_key' => 'typenum',
347       'unique' => [],
348       'index' => [],
349     },
350
351     'type_pkgs' => {
352       'columns' => [
353         'typepkgnum', 'serial', '', '', '', '', 
354         'typenum',   'int',  '', '', '', '', 
355         'pkgpart',   'int',  '', '', '', '', 
356       ],
357       'primary_key' => 'typepkgnum',
358       'unique' => [ ['typenum', 'pkgpart'] ],
359       'index' => [ ['typenum'] ],
360     },
361
362     'cust_bill' => {
363       'columns' => [
364         'invnum',    'serial',  '', '', '', '', 
365         'custnum',   'int',  '', '', '', '', 
366         '_date',     @date_type, '', '', 
367         'charged',   @money_type, '', '', 
368         'printed',   'int',  '', '', '', '', 
369         'closed',    'char', 'NULL', 1, '', '', 
370       ],
371       'primary_key' => 'invnum',
372       'unique' => [],
373       'index' => [ ['custnum'], ['_date'] ],
374     },
375
376     'cust_bill_event' => {
377       'columns' => [
378         'eventnum',    'serial',  '', '', '', '', 
379         'invnum',   'int',  '', '', '', '', 
380         'eventpart',   'int',  '', '', '', '', 
381         '_date',     @date_type, '', '', 
382         'status', 'varchar', '', $char_d, '', '', 
383         'statustext', 'text', 'NULL', '', '', '', 
384       ],
385       'primary_key' => 'eventnum',
386       #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
387       'unique' => [],
388       'index' => [ ['invnum'], ['status'] ],
389     },
390
391     'part_bill_event' => {
392       'columns' => [
393         'eventpart',    'serial',  '', '', '', '', 
394         'freq',        'varchar',       'NULL',     $char_d, '', '', 
395         'payby',       'char',  '', 4, '', '', 
396         'event',       'varchar',           '',     $char_d, '', '', 
397         'eventcode',    @perl_type, '', '', 
398         'seconds',     'int', 'NULL', '', '', '', 
399         'weight',      'int', '', '', '', '', 
400         'plan',       'varchar', 'NULL', $char_d, '', '', 
401         'plandata',   'text', 'NULL', '', '', '', 
402         'reason',     'int', 'NULL', '', '', '', 
403         'disabled',     'char', 'NULL', 1, '', '', 
404       ],
405       'primary_key' => 'eventpart',
406       'unique' => [],
407       'index' => [ ['payby'], ['disabled'], ],
408     },
409
410     'part_event' => {
411       'columns' => [
412         'eventpart',   'serial',      '',      '', '', '', 
413         'agentnum',    'int',     'NULL',      '', '', '', 
414         'event',       'varchar',     '', $char_d, '', '', 
415         'eventtable',  'varchar',     '', $char_d, '', '',
416         'check_freq',  'varchar', 'NULL', $char_d, '', '', 
417         'weight',      'int',         '',      '', '', '', 
418         'action',      'varchar',     '', $char_d, '', '',
419         'disabled',     'char',   'NULL',       1, '', '', 
420       ],
421       'primary_key' => 'eventpart',
422       'unique' => [],
423       'index' => [ ['agentnum'], ['eventtable'], ['check_freq'], ['disabled'], ],
424     },
425
426     'part_event_option' => {
427       'columns' => [
428         'optionnum', 'serial', '', '', '', '', 
429         'eventpart', 'int', '', '', '', '', 
430         'optionname', 'varchar', '', $char_d, '', '', 
431         'optionvalue', 'text', 'NULL', '', '', '', 
432       ],
433       'primary_key' => 'optionnum',
434       'unique'      => [],
435       'index'       => [ [ 'eventpart' ], [ 'optionname' ] ],
436     },
437
438     'part_event_condition' => {
439       'columns' => [
440         'eventconditionnum', 'serial', '', '', '', '', 
441         'eventpart', 'int', '', '', '', '', 
442         'conditionname', 'varchar', '', $char_d, '', '', 
443       ],
444       'primary_key' => 'eventconditionnum',
445       'unique'      => [],
446       'index'       => [ [ 'eventpart' ], [ 'conditionname' ] ],
447     },
448
449     'part_event_condition_option' => {
450       'columns' => [
451         'optionnum', 'serial', '', '', '', '', 
452         'eventconditionnum', 'int', '', '', '', '', 
453         'optionname', 'varchar', '', $char_d, '', '', 
454         'optionvalue', 'text', 'NULL', '', '', '', 
455       ],
456       'primary_key' => 'optionnum',
457       'unique'      => [],
458       'index'       => [ [ 'eventconditionnum' ], [ 'optionname' ] ],
459     },
460
461     'part_event_condition_option_option' => {
462       'columns' => [
463         'optionoptionnum', 'serial', '', '', '', '', 
464         'optionnum', 'int', '', '', '', '', 
465         'optionname', 'varchar', '', $char_d, '', '', 
466         'optionvalue', 'text', 'NULL', '', '', '', 
467       ],
468       'primary_key' => 'optionoptionnum',
469       'unique'      => [],
470       'index'       => [ [ 'optionnum' ], [ 'optionname' ] ],
471     },
472
473     'cust_event' => {
474       'columns' => [
475         'eventnum',    'serial',  '', '', '', '', 
476         'eventpart',   'int',  '', '', '', '', 
477         'tablenum',   'int',  '', '', '', '', 
478         '_date',     @date_type, '', '', 
479         'status', 'varchar', '', $char_d, '', '', 
480         'statustext', 'text', 'NULL', '', '', '', 
481       ],
482       'primary_key' => 'eventnum',
483       #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
484       'unique' => [],
485       'index' => [ ['eventpart'], ['tablenum'], ['status'] ],
486     },
487
488     'cust_bill_pkg' => {
489       'columns' => [
490         'billpkgnum', 'serial', '', '', '', '', 
491         'pkgnum',  'int', '', '', '', '', 
492         'pkgpart_override',  'int', 'NULL', '', '', '', 
493         'invnum',  'int', '', '', '', '', 
494         'setup',   @money_type, '', '', 
495         'recur',   @money_type, '', '', 
496         'sdate',   @date_type, '', '', 
497         'edate',   @date_type, '', '', 
498         'itemdesc', 'varchar', 'NULL', $char_d, '', '', 
499         'quantity',  'int', 'NULL', '', '', '',
500         'unitsetup', @money_typen, '', '', 
501         'unitrecur', @money_typen, '', '', 
502       ],
503       'primary_key' => 'billpkgnum',
504       'unique' => [],
505       'index' => [ ['invnum'], [ 'pkgnum' ] ],
506     },
507
508     'cust_bill_pkg_detail' => {
509       'columns' => [
510         'detailnum', 'serial', '', '', '', '', 
511         'pkgnum',  'int', '', '', '', '', 
512         'invnum',  'int', '', '', '', '', 
513         'format',  'char', 'NULL', 1, '', '',
514         'detail',  'varchar', '', $char_d, '', '', 
515       ],
516       'primary_key' => 'detailnum',
517       'unique' => [],
518       'index' => [ [ 'pkgnum', 'invnum' ] ],
519     },
520
521     'cust_credit' => {
522       'columns' => [
523         'crednum',  'serial', '', '', '', '', 
524         'custnum',  'int', '', '', '', '', 
525         '_date',    @date_type, '', '', 
526         'amount',   @money_type, '', '', 
527         'otaker',   'varchar', '', 32, '', '', 
528         'reason',   'text', 'NULL', '', '', '', 
529         'reasonnum', 'int', 'NULL', '', '', '', 
530         'closed',    'char', 'NULL', 1, '', '', 
531       ],
532       'primary_key' => 'crednum',
533       'unique' => [],
534       'index' => [ ['custnum'], ['_date'] ],
535     },
536
537     'cust_credit_bill' => {
538       'columns' => [
539         'creditbillnum', 'serial', '', '', '', '', 
540         'crednum',  'int', '', '', '', '', 
541         'invnum',  'int', '', '', '', '', 
542         '_date',    @date_type, '', '', 
543         'amount',   @money_type, '', '', 
544       ],
545       'primary_key' => 'creditbillnum',
546       'unique' => [],
547       'index' => [ ['crednum'], ['invnum'] ],
548     },
549
550     'cust_credit_bill_pkg' => {
551       'columns' => [
552         'creditbillpkgnum', 'serial', '',      '', '', '',
553         'creditbillnum',       'int', '',      '', '', '',
554         'billpkgnum',          'int', '',      '', '', '',
555         'amount',            @money_type,          '', '',
556         'setuprecur',      'varchar', '', $char_d, '', '',
557         'sdate',   @date_type, '', '', 
558         'edate',   @date_type, '', '', 
559       ],
560       'primary_key' => 'creditbillpkgnum',
561       'unique'      => [],
562       'index'       => [ [ 'creditbillnum' ], [ 'billpkgnum' ], ],
563     },
564
565     'cust_main' => {
566       'columns' => [
567         'custnum',  'serial',  '',     '', '', '', 
568         'agentnum', 'int',  '',     '', '', '', 
569         'agent_custid', 'varchar', 'NULL', $char_d, '', '',
570 #        'titlenum', 'int',  'NULL',   '', '', '', 
571         'last',     'varchar', '',     $char_d, '', '', 
572 #        'middle',   'varchar', 'NULL', $char_d, '', '', 
573         'first',    'varchar', '',     $char_d, '', '', 
574         'ss',       'varchar', 'NULL', 11, '', '', 
575         'stateid', 'varchar', 'NULL', $char_d, '', '', 
576         'stateid_state', 'varchar', 'NULL', $char_d, '', '', 
577         'birthdate' ,@date_type, '', '', 
578         'signupdate',@date_type, '', '', 
579         'company',  'varchar', 'NULL', $char_d, '', '', 
580         'address1', 'varchar', '',     $char_d, '', '', 
581         'address2', 'varchar', 'NULL', $char_d, '', '', 
582         'city',     'varchar', '',     $char_d, '', '', 
583         'county',   'varchar', 'NULL', $char_d, '', '', 
584         'state',    'varchar', 'NULL', $char_d, '', '', 
585         'zip',      'varchar', 'NULL', 10, '', '', 
586         'country',  'char', '',     2, '', '', 
587         'daytime',  'varchar', 'NULL', 20, '', '', 
588         'night',    'varchar', 'NULL', 20, '', '', 
589         'fax',      'varchar', 'NULL', 12, '', '', 
590         'ship_last',     'varchar', 'NULL', $char_d, '', '', 
591 #        'ship_middle',   'varchar', 'NULL', $char_d, '', '', 
592         'ship_first',    'varchar', 'NULL', $char_d, '', '', 
593         'ship_company',  'varchar', 'NULL', $char_d, '', '', 
594         'ship_address1', 'varchar', 'NULL', $char_d, '', '', 
595         'ship_address2', 'varchar', 'NULL', $char_d, '', '', 
596         'ship_city',     'varchar', 'NULL', $char_d, '', '', 
597         'ship_county',   'varchar', 'NULL', $char_d, '', '', 
598         'ship_state',    'varchar', 'NULL', $char_d, '', '', 
599         'ship_zip',      'varchar', 'NULL', 10, '', '', 
600         'ship_country',  'char', 'NULL', 2, '', '', 
601         'ship_daytime',  'varchar', 'NULL', 20, '', '', 
602         'ship_night',    'varchar', 'NULL', 20, '', '', 
603         'ship_fax',      'varchar', 'NULL', 12, '', '', 
604         'payby',    'char', '',     4, '', '', 
605         'payinfo',  'varchar', 'NULL', 512, '', '', 
606         'paycvv',   'varchar', 'NULL', 512, '', '', 
607         'paymask', 'varchar', 'NULL', $char_d, '', '', 
608         #'paydate',  @date_type, '', '', 
609         'paydate',  'varchar', 'NULL', 10, '', '', 
610         'paystart_month', 'int', 'NULL', '', '', '', 
611         'paystart_year',  'int', 'NULL', '', '', '', 
612         'payissue', 'varchar', 'NULL', 2, '', '', 
613         'payname',  'varchar', 'NULL', $char_d, '', '', 
614         'paystate', 'varchar', 'NULL', $char_d, '', '', 
615         'paytype',  'varchar', 'NULL', $char_d, '', '', 
616         'payip',    'varchar', 'NULL', 15, '', '', 
617         'tax',      'char', 'NULL', 1, '', '', 
618         'otaker',   'varchar', '',    32, '', '', 
619         'refnum',   'int',  '',     '', '', '', 
620         'referral_custnum', 'int',  'NULL', '', '', '', 
621         'comments', 'text', 'NULL', '', '', '', 
622         'spool_cdr','char', 'NULL', 1, '', '', 
623         'invoice_terms', 'varchar', 'NULL', $char_d, '', '',
624       ],
625       'primary_key' => 'custnum',
626       'unique' => [ [ 'agentnum', 'agent_custid' ] ],
627       #'index' => [ ['last'], ['company'] ],
628       'index' => [ ['last'], [ 'company' ], [ 'referral_custnum' ],
629                    [ 'daytime' ], [ 'night' ], [ 'fax' ], [ 'refnum' ],
630                    [ 'county' ], [ 'state' ], [ 'country' ], [ 'zip' ],
631                    [ 'ship_last' ], [ 'ship_company' ],
632                    [ 'ship_daytime' ], [ 'ship_night' ], [ 'ship_fax' ],
633                    [ 'payby' ], [ 'paydate' ],
634                  ],
635     },
636
637     'cust_main_invoice' => {
638       'columns' => [
639         'destnum',  'serial',  '',     '', '', '', 
640         'custnum',  'int',  '',     '', '', '', 
641         'dest',     'varchar', '',  $char_d, '', '', 
642       ],
643       'primary_key' => 'destnum',
644       'unique' => [],
645       'index' => [ ['custnum'], ],
646     },
647
648     'cust_main_note' => {
649       'columns' => [
650         'notenum',  'serial',  '',     '', '', '', 
651         'custnum',  'int',  '',     '', '', '', 
652         '_date',    @date_type, '', '', 
653         'otaker',   'varchar', '',    32, '', '', 
654         'comments', 'text', 'NULL', '', '', '', 
655       ],
656       'primary_key' => 'notenum',
657       'unique' => [],
658       'index' => [ [ 'custnum' ], [ '_date' ], ],
659     },
660
661     'cust_main_county' => { #county+state+country are checked off the
662                             #cust_main_county for validation and to provide
663                             # a tax rate.
664       'columns' => [
665         'taxnum',   'serial',   '',    '', '', '', 
666         'state',    'varchar',  'NULL',    $char_d, '', '', 
667         'county',   'varchar',  'NULL',    $char_d, '', '', 
668         'country',  'char',  '', 2, '', '', 
669         'taxclass',   'varchar', 'NULL', $char_d, '', '', 
670         'exempt_amount', @money_type, '', '', 
671         'tax',      'real',  '',    '', '', '', #tax %
672         'taxname',  'varchar',  'NULL',    $char_d, '', '', 
673         'setuptax',  'char', 'NULL', 1, '', '', # Y = setup tax exempt
674         'recurtax',  'char', 'NULL', 1, '', '', # Y = recur tax exempt
675       ],
676       'primary_key' => 'taxnum',
677       'unique' => [],
678   #    'unique' => [ ['taxnum'], ['state', 'county'] ],
679       'index' => [ [ 'county' ], [ 'state' ], [ 'country' ] ],
680     },
681
682     'tax_rate'    => {
683       'columns' => [
684         'taxnum',       'serial',     '',      '', '', '', 
685         'geocode',     'varchar', 'NULL', $char_d, '', '',#cch provides 10 char
686         'data_vendor', 'varchar', 'NULL', $char_d, '', '',#auto update source
687         'location',    'varchar', 'NULL', $char_d, '', '',#provided by tax authority
688         'taxclassnum', 'int',      '',      '', '', '', 
689         'effective_date', @date_type, '', '', 
690         'tax',        'real',  '',    '', '', '',        # tax %
691         'excessrate', 'real',  'NULL','', '', '',        # second tax %
692         'taxbase',    @money_typen, '', '',              # amount at first tax rate
693         'taxmax',     @money_typen, '', '',              # maximum about at both rates
694         'usetax',        'real',  'NULL',    '', '', '', # tax % when non-local
695         'useexcessrate', 'real',  'NULL',    '', '', '', # second tax % when non-local
696         'unittype',    'int',  'NULL', '', '', '',      # for fee
697         'fee',         'real', 'NULL', '', '', '',      # amount tax per unit
698         'excessfee',   'real', 'NULL', '', '', '',      # second amount tax per unit
699         'feebase',     'real', 'NULL', '', '', '',      # units taxed at first rate
700         'feemax',      'real', 'NULL', '', '', '',      # maximum number of unit taxed
701         'maxtype',     'int',  'NULL', '', '', '',      # indicator of how thresholds accumulate
702         'taxname', 'varchar',  'NULL', $char_d, '', '', # may appear on invoice
703         'taxauth',     'int',  'NULL', '', '', '',      # tax authority
704         'basetype',    'int',  'NULL', '', '', '', # indicator of basis for tax
705         'passtype',    'int',  'NULL', '', '', '', # indicator declaring how item should be shown
706         'passflag',    'char', 'NULL', 1, '', '',  # Y = required to list as line item, N = Prohibited
707         'setuptax',    'char', 'NULL', 1, '', '',  # Y = setup tax exempt
708         'recurtax',    'char', 'NULL', 1, '', '',  # Y = recur tax exempt
709         'manual',      'char', 'NULL', 1, '', '',  # Y = manually edited
710       ],
711       'primary_key' => 'taxnum',
712       'unique' => [],
713       'index' => [ ['taxclassnum'], ['data_vendor', 'geocode'] ],
714     },
715
716     'cust_tax_location' => { 
717       'columns' => [
718         'custlocationnum', 'serial',  '',     '', '', '', 
719         'data_vendor',     'varchar', 'NULL', $char_d, '', '', # update source
720         'zip',             'char',    '',     5,  '', '', 
721         'state',           'char',    '',     2,  '', '', 
722         'plus4hi',         'char',    '',     4,  '', '', 
723         'plus4lo',         'char',    '',     4,  '', '', 
724         'default_location','char',    'NULL', 1,  '', '', # Y = default for zip
725         'geocode',         'varchar', '',    20,  '', '', 
726       ],
727       'primary_key' => 'custlocationnum',
728       'unique' => [],
729       'index' => [ [ 'zip', 'plus4lo', 'plus4hi' ] ],
730     },
731
732     'tax_class' => { 
733       'columns' => [
734         'taxclassnum',  'serial',  '',            '', '', '',
735         'data_vendor',  'varchar', 'NULL',   $char_d, '', '',
736         'taxclass',     'varchar', '',       $char_d, '', '',          
737         'description',  'varchar', '',     2*$char_d, '', '',          
738       ],
739       'primary_key' => 'taxclassnum',
740       'unique' => [ [ 'data_vendor', 'taxclass' ] ],
741       'index' => [],
742     },
743
744     'cust_pay_pending' => {
745       'columns' => [
746         'paypendingnum','serial',      '',  '', '', '',
747         'custnum',      'int',         '',  '', '', '', 
748         'paid',         @money_type,            '', '', 
749         '_date',        @date_type,             '', '', 
750         'payby',        'char',        '',   4, '', '', #CARD/BILL/COMP, should
751                                                         # be index into payby
752                                                         # table eventually
753         'payinfo',      'varchar', 'NULL', 512, '', '', #see cust_main above
754         'paymask',      'varchar', 'NULL', $char_d, '', '', 
755         'paydate',      'varchar', 'NULL', 10, '', '', 
756         #'paybatch',     'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
757         'payunique',    'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
758
759         'status',       'varchar',     '', $char_d, '', '', 
760         'statustext',   'text',    'NULL',  '', '', '', 
761         'gatewaynum',   'int',     'NULL',  '', '', '',
762         #'cust_balance', @money_type,            '', '',
763         'paynum',       'int',     'NULL',  '', '', '',
764       ],
765       'primary_key' => 'paypendingnum',
766       'unique'      => [ [ 'payunique' ] ],
767       'index'       => [ [ 'custnum' ], [ 'status' ], ],
768     },
769
770     'cust_pay' => {
771       'columns' => [
772         'paynum',   'serial',    '',   '', '', '',
773         'custnum',  'int',    '',   '', '', '', 
774         '_date',    @date_type, '', '', 
775         'paid',     @money_type, '', '', 
776         'otaker',   'varchar', 'NULL', 32, '', '',  #NULL for the upgrade so we can create & populate the field
777         'payby',    'char',   '',     4, '', '', # CARD/BILL/COMP, should be
778                                                  # index into payby table
779                                                  # eventually
780         'payinfo',  'varchar',   'NULL', 512, '', '', #see cust_main above
781         'paymask', 'varchar', 'NULL', $char_d, '', '', 
782         'paydate',  'varchar', 'NULL', 10, '', '', 
783         'paybatch', 'varchar',   'NULL', $char_d, '', '', #for auditing purposes.
784         'payunique', 'varchar', 'NULL', $char_d, '', '', #separate paybatch "unique" functions from current usage
785         'closed',    'char', 'NULL', 1, '', '', 
786       ],
787       'primary_key' => 'paynum',
788       #i guess not now, with cust_pay_pending, if we actually make it here, we _do_ want to record it# 'unique' => [ [ 'payunique' ] ],
789       'index' => [ [ 'custnum' ], [ 'paybatch' ], [ 'payby' ], [ '_date' ] ],
790     },
791
792     'cust_pay_void' => {
793       'columns' => [
794         'paynum',    'int',    '',   '', '', '', 
795         'custnum',   'int',    '',   '', '', '', 
796         'paid',      @money_type, '', '', 
797         '_date',     @date_type, '', '', 
798         'payby',     'char',   '',     4, '', '', # CARD/BILL/COMP, should be
799                                                   # index into payby table
800                                                   # eventually
801         'payinfo',   'varchar',   'NULL', 512, '', '', #see cust_main above
802         'paymask', 'varchar', 'NULL', $char_d, '', '', 
803         'paybatch',  'varchar',   'NULL', $char_d, '', '', #for auditing purposes.
804         'closed',    'char', 'NULL', 1, '', '', 
805         'void_date', @date_type, '', '', 
806         'reason',    'varchar',   'NULL', $char_d, '', '', 
807         'otaker',   'varchar', '', 32, '', '', 
808       ],
809       'primary_key' => 'paynum',
810       'unique' => [],
811       'index' => [ [ 'custnum' ] ],
812     },
813
814     'cust_bill_pay' => {
815       'columns' => [
816         'billpaynum', 'serial',     '',   '', '', '', 
817         'invnum',  'int',     '',   '', '', '', 
818         'paynum',  'int',     '',   '', '', '', 
819         'amount',  @money_type, '', '', 
820         '_date',   @date_type, '', '', 
821       ],
822       'primary_key' => 'billpaynum',
823       'unique' => [],
824       'index' => [ [ 'paynum' ], [ 'invnum' ] ],
825     },
826
827     'cust_bill_pay_batch' => {
828       'columns' => [
829         'billpaynum', 'serial',     '',   '', '', '', 
830         'invnum',  'int',     '',   '', '', '', 
831         'paybatchnum',  'int',     '',   '', '', '', 
832         'amount',  @money_type, '', '', 
833         '_date',   @date_type, '', '', 
834       ],
835       'primary_key' => 'billpaynum',
836       'unique' => [],
837       'index' => [ [ 'paybatchnum' ], [ 'invnum' ] ],
838     },
839
840     'cust_bill_pay_pkg' => {
841       'columns' => [
842         'billpaypkgnum', 'serial', '', '', '', '',
843         'billpaynum',       'int', '', '', '', '',
844         'billpkgnum',       'int', '', '', '', '',
845         'amount',         @money_type,     '', '',
846         'setuprecur',      'varchar', '', $char_d, '', '',
847         'sdate',   @date_type, '', '', 
848         'edate',   @date_type, '', '', 
849       ],
850       'primary_key' => 'billpaypkgnum',
851       'unique'      => [],
852       'index'       => [ [ 'billpaynum' ], [ 'billpkgnum' ], ],
853     },
854
855     'pay_batch' => { #batches of payments to an external processor
856       'columns' => [
857         'batchnum',   'serial',    '',   '', '', '', 
858         'payby',      'char',      '',    4, '', '', # CARD/CHEK
859         'status',     'char', 'NULL',     1, '', '', 
860         'download',   @date_type, '', '', 
861         'upload',     @date_type, '', '', 
862       ],
863       'primary_key' => 'batchnum',
864       'unique' => [],
865       'index' => [],
866     },
867
868     'cust_pay_batch' => { #what's this used for again?  list of customers
869                           #in current CARD batch? (necessarily CARD?)
870       'columns' => [
871         'paybatchnum',   'serial',    '',   '', '', '', 
872         'batchnum',   'int',    '',   '', '', '', 
873         'invnum',   'int',    '',   '', '', '', 
874         'custnum',   'int',    '',   '', '', '', 
875         'last',     'varchar', '',     $char_d, '', '', 
876         'first',    'varchar', '',     $char_d, '', '', 
877         'address1', 'varchar', '',     $char_d, '', '', 
878         'address2', 'varchar', 'NULL', $char_d, '', '', 
879         'city',     'varchar', '',     $char_d, '', '', 
880         'state',    'varchar', 'NULL', $char_d, '', '', 
881         'zip',      'varchar', 'NULL', 10, '', '', 
882         'country',  'char', '',     2, '', '', 
883         #        'trancode', 'int', '', '', '', ''
884         'payby',    'char',   '',     4, '', '', # CARD/BILL/COMP, should be
885         'payinfo',  'varchar', '',     512, '', '', 
886         #'exp',      @date_type, '', ''
887         'exp',      'varchar', 'NULL',     11, '', '', 
888         'payname',  'varchar', 'NULL', $char_d, '', '', 
889         'amount',   @money_type, '', '', 
890         'status',   'varchar', 'NULL',     $char_d, '', '', 
891       ],
892       'primary_key' => 'paybatchnum',
893       'unique' => [],
894       'index' => [ ['batchnum'], ['invnum'], ['custnum'] ],
895     },
896
897     'cust_pkg' => {
898       'columns' => [
899         'pkgnum',         'serial',    '',   '', '', '', 
900         'custnum',        'int',    '',   '', '', '', 
901         'pkgpart',        'int',    '',   '', '', '', 
902         'otaker',         'varchar', '', 32, '', '', 
903         'setup',          @date_type, '', '', 
904         'bill',           @date_type, '', '', 
905         'last_bill',      @date_type, '', '', 
906         'susp',           @date_type, '', '', 
907         'adjourn',        @date_type, '', '', 
908         'cancel',         @date_type, '', '', 
909         'expire',         @date_type, '', '', 
910         'change_date',    @date_type, '', '',
911         'change_pkgnum',  'int', 'NULL', '', '', '',
912         'change_pkgpart', 'int', 'NULL', '', '', '',
913         'manual_flag',    'char', 'NULL', 1, '', '', 
914         'quantity',       'int', 'NULL', '', '', '',
915       ],
916       'primary_key' => 'pkgnum',
917       'unique' => [],
918       'index' => [ ['custnum'], ['pkgpart'],
919                    ['setup'], ['last_bill'], ['bill'], ['susp'], ['adjourn'],
920                    ['expire'], ['cancel'],
921                    ['change_date'],
922                  ],
923     },
924
925     'cust_pkg_option' => {
926       'columns' => [
927         'optionnum', 'serial', '', '', '', '', 
928         'pkgnum', 'int', '', '', '', '', 
929         'optionname', 'varchar', '', $char_d, '', '', 
930         'optionvalue', 'text', 'NULL', '', '', '', 
931       ],
932       'primary_key' => 'optionnum',
933       'unique'      => [],
934       'index'       => [ [ 'pkgnum' ], [ 'optionname' ] ],
935     },
936
937     'cust_pkg_reason' => {
938       'columns' => [
939         'num',      'serial',    '',   '', '', '', 
940         'pkgnum',   'int',    '',   '', '', '', 
941         'reasonnum','int',    '',   '', '', '', 
942         'otaker',   'varchar', '', 32, '', '', 
943         'date',     @date_type, '', '', 
944       ],
945       'primary_key' => 'num',
946       'unique' => [],
947       'index' => [],
948     },
949
950     'cust_refund' => {
951       'columns' => [
952         'refundnum',    'serial',    '',   '', '', '', 
953         'custnum',  'int',    '',   '', '', '', 
954         '_date',        @date_type, '', '', 
955         'refund',       @money_type, '', '', 
956         'otaker',       'varchar',   '',   32, '', '', 
957         'reason',       'varchar',   '',   $char_d, '', '', 
958         'payby',        'char',   '',     4, '', '', # CARD/BILL/COMP, should
959                                                      # be index into payby
960                                                      # table eventually
961         'payinfo',      'varchar',   'NULL', 512, '', '', #see cust_main above
962         'paymask', 'varchar', 'NULL', $char_d, '', '', 
963         'paybatch',     'varchar',   'NULL', $char_d, '', '', 
964         'closed',    'char', 'NULL', 1, '', '', 
965       ],
966       'primary_key' => 'refundnum',
967       'unique' => [],
968       'index' => [ ['custnum'], ['_date'] ],
969     },
970
971     'cust_credit_refund' => {
972       'columns' => [
973         'creditrefundnum', 'serial',     '',   '', '', '', 
974         'crednum',  'int',     '',   '', '', '', 
975         'refundnum',  'int',     '',   '', '', '', 
976         'amount',  @money_type, '', '', 
977         '_date',   @date_type, '', '', 
978       ],
979       'primary_key' => 'creditrefundnum',
980       'unique' => [],
981       'index' => [ ['crednum'], ['refundnum'] ],
982     },
983
984
985     'cust_svc' => {
986       'columns' => [
987         'svcnum',    'serial',    '',   '', '', '', 
988         'pkgnum',    'int',    'NULL',   '', '', '', 
989         'svcpart',   'int',    '',   '', '', '', 
990         'overlimit', @date_type, '', '', 
991       ],
992       'primary_key' => 'svcnum',
993       'unique' => [],
994       'index' => [ ['svcnum'], ['pkgnum'], ['svcpart'] ],
995     },
996
997     'part_pkg' => {
998       'columns' => [
999         'pkgpart',       'serial',    '',   '', '', '', 
1000         'pkg',           'varchar',   '',   $char_d, '', '', 
1001         'comment',       'varchar',   '',   $char_d, '', '', 
1002         'promo_code',    'varchar', 'NULL', $char_d, '', '', 
1003         'setup',         @perl_type, '', '', 
1004         'freq',          'varchar',   '',   $char_d, '', '', #billing frequency
1005         'recur',         @perl_type, '', '', 
1006         'setuptax',      'char', 'NULL', 1, '', '', 
1007         'recurtax',      'char', 'NULL', 1, '', '', 
1008         'plan',          'varchar', 'NULL', $char_d, '', '', 
1009         'plandata',      'text', 'NULL', '', '', '', 
1010         'disabled',      'char', 'NULL', 1, '', '', 
1011         'taxclass',      'varchar', 'NULL', $char_d, '', '', 
1012         'classnum',      'int',     'NULL', '', '', '', 
1013         'taxproductnum', 'int',     'NULL', '', '', '', 
1014         'pay_weight',    'real',    'NULL', '', '', '',
1015         'credit_weight', 'real',    'NULL', '', '', '',
1016         'agentnum',      'int',     'NULL', '', '', '', 
1017
1018       ],
1019       'primary_key' => 'pkgpart',
1020       'unique' => [],
1021       'index' => [ [ 'promo_code' ], [ 'disabled' ], [ 'agentnum' ], ],
1022     },
1023
1024     'part_pkg_link' => {
1025       'columns' => [
1026         'pkglinknum',  'serial',  '',      '', '', '',
1027         'src_pkgpart', 'int',     '',      '', '', '',
1028         'dst_pkgpart', 'int',     '',      '', '', '', 
1029         'link_type',   'varchar', '', $char_d, '', '',
1030       ],
1031       'primary_key' => 'pkglinknum',
1032       'unique' => [ [ 'src_pkgpart', 'dst_pkgpart', 'link_type' ] ],
1033       'index'  => [ [ 'src_pkgpart' ] ],
1034     },
1035
1036     'part_pkg_taxclass' => {
1037       'columns' => [
1038         'taxclassnum',  'serial', '',       '', '', '',
1039         'taxclass',     'varchar', '', $char_d, '', '', 
1040       ],
1041       'primary_key' => 'taxclassnum',
1042       'unique'      => [ [ 'taxclass' ] ],
1043       'index'       => [],
1044     },
1045
1046     'part_pkg_taxproduct' => {
1047       'columns' => [
1048         'taxproductnum', 'serial',      '',        '', '', '',
1049         'data_vendor',   'varchar', 'NULL',   $char_d, '', '', 
1050         'taxproduct',    'varchar',     '',   $char_d, '', '', 
1051         'description',   'varchar',     '', 2*$char_d, '', '', 
1052       ],
1053       'primary_key' => 'taxproductnum',
1054       'unique'      => [ [ 'data_vendor', 'taxproduct' ] ],
1055       'index'       => [],
1056     },
1057
1058     'part_pkg_taxrate' => { 
1059       'columns' => [
1060         'pkgtaxratenum', 'serial',  '',     '',      '', '',
1061         'data_vendor',   'varchar', 'NULL', $char_d, '', '', # update source
1062         'geocode',       'varchar', 'NULL', $char_d, '', '', # cch provides 10
1063         'taxproductnum', 'int',  '',     '',       '', '',          
1064         'city',             'varchar', 'NULL', $char_d, '', '', # tax_location?
1065         'county',           'varchar', 'NULL', $char_d, '', '', 
1066         'state',            'varchar', 'NULL', $char_d, '', '', 
1067         'local',            'varchar', 'NULL', $char_d, '', '', 
1068         'country',          'char',    'NULL', 2,       '', '',
1069         'taxclassnumtaxed', 'int',     'NULL', '',      '', '', 
1070         'taxcattaxed',      'varchar', 'NULL', $char_d, '', '', 
1071         'taxclassnum',      'int',     'NULL', '',      '', '', 
1072         'effdate',          @date_type, '', '', 
1073         'taxable',          'char',    'NULL', 1,       '', '', 
1074       ],
1075       'primary_key' => 'pkgtaxratenum',
1076       'unique' => [],
1077       'index' => [ [ 'data_vendor', 'geocode', 'taxproductnum' ] ],
1078     },
1079
1080     'part_pkg_taxoverride' => { 
1081       'columns' => [
1082         'taxoverridenum', 'serial', '', '', '', '',
1083         'pkgpart',        'serial', '', '', '', '',
1084         'taxclassnum',    'serial', '', '', '', '',
1085       ],
1086       'primary_key' => 'taxoverridenum',
1087       'unique' => [],
1088       'index' => [ [ 'pkgpart' ], [ 'taxclassnum' ] ],
1089     },
1090
1091 #    'part_title' => {
1092 #      'columns' => [
1093 #        'titlenum',   'int',    '',   '',
1094 #        'title',      'varchar',   '',   $char_d,
1095 #      ],
1096 #      'primary_key' => 'titlenum',
1097 #      'unique' => [ [] ],
1098 #      'index' => [ [] ],
1099 #    },
1100
1101     'pkg_svc' => {
1102       'columns' => [
1103         'pkgsvcnum',  'serial', '',  '', '', '', 
1104         'pkgpart',    'int',    '',   '', '', '', 
1105         'svcpart',    'int',    '',   '', '', '', 
1106         'quantity',   'int',    '',   '', '', '', 
1107         'primary_svc','char', 'NULL',  1, '', '', 
1108       ],
1109       'primary_key' => 'pkgsvcnum',
1110       'unique' => [ ['pkgpart', 'svcpart'] ],
1111       'index' => [ ['pkgpart'] ],
1112     },
1113
1114     'part_referral' => {
1115       'columns' => [
1116         'refnum',   'serial',     '',        '', '', '', 
1117         'referral', 'varchar',    '',   $char_d, '', '', 
1118         'disabled', 'char',   'NULL',         1, '', '', 
1119         'agentnum', 'int',    'NULL',        '', '', '', 
1120       ],
1121       'primary_key' => 'refnum',
1122       'unique' => [],
1123       'index' => [ ['disabled'], ['agentnum'], ],
1124     },
1125
1126     'part_svc' => {
1127       'columns' => [
1128         'svcpart',    'serial',    '',   '', '', '', 
1129         'svc',        'varchar',   '',   $char_d, '', '', 
1130         'svcdb',      'varchar',   '',   $char_d, '', '', 
1131         'disabled',   'char',  'NULL',   1, '', '', 
1132       ],
1133       'primary_key' => 'svcpart',
1134       'unique' => [],
1135       'index' => [ [ 'disabled' ] ],
1136     },
1137
1138     'part_svc_column' => {
1139       'columns' => [
1140         'columnnum',   'serial',         '', '', '', '', 
1141         'svcpart',     'int',         '', '', '', '', 
1142         'columnname',  'varchar',     '', 64, '', '', 
1143         'columnvalue', 'varchar', 'NULL', $char_d, '', '', 
1144         'columnflag',  'char',    'NULL', 1, '', '', 
1145       ],
1146       'primary_key' => 'columnnum',
1147       'unique' => [ [ 'svcpart', 'columnname' ] ],
1148       'index' => [ [ 'svcpart' ] ],
1149     },
1150
1151     #(this should be renamed to part_pop)
1152     'svc_acct_pop' => {
1153       'columns' => [
1154         'popnum',    'serial',    '',   '', '', '', 
1155         'city',      'varchar',   '',   $char_d, '', '', 
1156         'state',     'varchar',   '',   $char_d, '', '', 
1157         'ac',        'char',   '',   3, '', '', 
1158         'exch',      'char',   '',   3, '', '', 
1159         'loc',       'char',   'NULL',   4, '', '', #NULL for legacy purposes
1160       ],
1161       'primary_key' => 'popnum',
1162       'unique' => [],
1163       'index' => [ [ 'state' ] ],
1164     },
1165
1166     'part_pop_local' => {
1167       'columns' => [
1168         'localnum',  'serial',     '',     '', '', '', 
1169         'popnum',    'int',     '',     '', '', '', 
1170         'city',      'varchar', 'NULL', $char_d, '', '', 
1171         'state',     'char',    'NULL', 2, '', '', 
1172         'npa',       'char',    '',     3, '', '', 
1173         'nxx',       'char',    '',     3, '', '', 
1174       ],
1175       'primary_key' => 'localnum',
1176       'unique' => [],
1177       'index' => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
1178     },
1179
1180     'svc_acct' => {
1181       'columns' => [
1182         'svcnum',    'int',    '',   '', '', '', 
1183         'username',  'varchar',   '',   $username_len, '', '',
1184         '_password', 'varchar',   '',  512, '', '',
1185         '_password_encoding', 'varchar', 'NULL', $char_d, '', '',
1186         'sec_phrase', 'varchar',  'NULL',   $char_d, '', '', 
1187         'popnum',    'int',    'NULL',   '', '', '', 
1188         'uid',       'int', 'NULL',   '', '', '', 
1189         'gid',       'int', 'NULL',   '', '', '', 
1190         'finger',    'varchar',   'NULL',   $char_d, '', '', 
1191         'dir',       'varchar',   'NULL',   $char_d, '', '', 
1192         'shell',     'varchar',   'NULL',   $char_d, '', '', 
1193         'quota',     'varchar',   'NULL',   $char_d, '', '', 
1194         'slipip',    'varchar',   'NULL',   15, '', '', #four TINYINTs, bah.
1195         'seconds',   'int', 'NULL',   '', '', '', #uhhhh
1196         'seconds_threshold',   'int', 'NULL',   '', '', '',
1197         'upbytes',   'bigint', 'NULL',   '', '', '', 
1198         'upbytes_threshold',   'bigint', 'NULL',   '', '', '',
1199         'downbytes', 'bigint', 'NULL',   '', '', '',
1200         'downbytes_threshold',   'bigint', 'NULL',   '', '', '',
1201         'totalbytes','bigint', 'NULL',   '', '', '',
1202         'totalbytes_threshold',   'bigint', 'NULL',   '', '', '',
1203         'domsvc',    'int', '',   '', '', '', 
1204         'last_login',  @date_type, '', '', 
1205         'last_logout', @date_type, '', '', 
1206       ],
1207       'primary_key' => 'svcnum',
1208       #'unique' => [ [ 'username', 'domsvc' ] ],
1209       'unique' => [],
1210       'index' => [ ['username'], ['domsvc'] ],
1211     },
1212
1213     'acct_rt_transaction' => {
1214       'columns' => [
1215         'svcrtid',   'int',    '',   '', '', '', 
1216         'svcnum',    'int',    '',   '', '', '', 
1217         'transaction_id',       'int', '',   '', '', '', 
1218         '_date',   @date_type, '', '',
1219         'seconds',   'int', '',   '', '', '', #uhhhh
1220         'support',   'int', '',   '', '', '',
1221       ],
1222       'primary_key' => 'svcrtid',
1223       'unique' => [],
1224       'index' => [ ['svcnum', 'transaction_id'] ],
1225     },
1226
1227     #'svc_charge' => {
1228     #  'columns' => [
1229     #    'svcnum',    'int',    '',   '',
1230     #    'amount',    @money_type,
1231     #  ],
1232     #  'primary_key' => 'svcnum',
1233     #  'unique' => [ [] ],
1234     #  'index' => [ [] ],
1235     #},
1236
1237     'svc_domain' => {
1238       'columns' => [
1239         'svcnum',           'int',    '',        '', '', '',
1240         'domain',       'varchar',    '',   $char_d, '', '',
1241         'suffix',       'varchar', 'NULL',  $char_d, '', '',
1242         'catchall',         'int', 'NULL',       '', '', '',
1243         'parent_svcnum',    'int', 'NULL',       '', '', '',
1244         'registrarnum',     'int', 'NULL',       '', '', '',
1245         'registrarkey', 'varchar', 'NULL',      512, '', '',
1246         'setup_date',  @date_type, '', '',
1247         'renewal_interval', 'int', 'NULL',       '', '', '',
1248         'expiration_date', @date_type, '', '',
1249       ],
1250       'primary_key' => 'svcnum',
1251       'unique' => [ ],
1252       'index' => [ ['domain'] ],
1253     },
1254
1255     'domain_record' => {
1256       'columns' => [
1257         'recnum',    'serial',     '',  '', '', '', 
1258         'svcnum',    'int',     '',  '', '', '', 
1259         'reczone',   'varchar', '',  255, '', '', 
1260         'recaf',     'char',    '',  2, '', '', 
1261         'rectype',   'varchar',    '',  5, '', '', 
1262         'recdata',   'varchar', '',  255, '', '', 
1263       ],
1264       'primary_key' => 'recnum',
1265       'unique'      => [],
1266       'index'       => [ ['svcnum'] ],
1267     },
1268
1269     'registrar' => {
1270       'columns' => [
1271         'registrarnum',   'serial', '',      '', '', '',
1272         'registrarname', 'varchar', '', $char_d, '', '',
1273       ],
1274       'primary_key' => 'registrarnum',
1275       'unique'      => [],
1276       'index'       => [],
1277     },
1278
1279     'svc_forward' => {
1280       'columns' => [
1281         'svcnum',   'int',            '',   '', '', '', 
1282         'srcsvc',   'int',        'NULL',   '', '', '', 
1283         'src',      'varchar',    'NULL',  255, '', '', 
1284         'dstsvc',   'int',        'NULL',   '', '', '', 
1285         'dst',      'varchar',    'NULL',  255, '', '', 
1286       ],
1287       'primary_key' => 'svcnum',
1288       'unique'      => [],
1289       'index'       => [ ['srcsvc'], ['dstsvc'] ],
1290     },
1291
1292     'svc_www' => {
1293       'columns' => [
1294         'svcnum',   'int',      '',  '', '', '', 
1295         'recnum',   'int',      '',  '', '', '', 
1296         'usersvc',  'int',  'NULL',  '', '', '', 
1297         'config',   'text', 'NULL',  '', '', '', 
1298       ],
1299       'primary_key' => 'svcnum',
1300       'unique'      => [],
1301       'index'       => [],
1302     },
1303
1304     #'svc_wo' => {
1305     #  'columns' => [
1306     #    'svcnum',    'int',    '',   '',
1307     #    'svcnum',    'int',    '',   '',
1308     #    'svcnum',    'int',    '',   '',
1309     #    'worker',    'varchar',   '',   $char_d,
1310     #    '_date',     @date_type,
1311     #  ],
1312     #  'primary_key' => 'svcnum',
1313     #  'unique' => [ [] ],
1314     #  'index' => [ [] ],
1315     #},
1316
1317     'prepay_credit' => {
1318       'columns' => [
1319         'prepaynum',   'serial',     '',   '', '', '', 
1320         'identifier',  'varchar', '', $char_d, '', '', 
1321         'amount',      @money_type, '', '', 
1322         'seconds',     'int',     'NULL', '', '', '', 
1323         'upbytes',     'bigint',     'NULL', '', '', '', 
1324         'downbytes',   'bigint',     'NULL', '', '', '', 
1325         'totalbytes',  'bigint',     'NULL', '', '', '', 
1326         'agentnum',    'int',     'NULL', '', '', '', 
1327       ],
1328       'primary_key' => 'prepaynum',
1329       'unique'      => [ ['identifier'] ],
1330       'index'       => [],
1331     },
1332
1333     'port' => {
1334       'columns' => [
1335         'portnum',  'serial',     '',   '', '', '', 
1336         'ip',       'varchar', 'NULL', 15, '', '', 
1337         'nasport',  'int',     'NULL', '', '', '', 
1338         'nasnum',   'int',     '',   '', '', '', 
1339       ],
1340       'primary_key' => 'portnum',
1341       'unique'      => [],
1342       'index'       => [],
1343     },
1344
1345     'nas' => {
1346       'columns' => [
1347         'nasnum',   'serial',     '',    '', '', '', 
1348         'nas',      'varchar', '',    $char_d, '', '', 
1349         'nasip',    'varchar', '',    15, '', '', 
1350         'nasfqdn',  'varchar', '',    $char_d, '', '', 
1351         'last',     'int',     '',    '', '', '', 
1352       ],
1353       'primary_key' => 'nasnum',
1354       'unique'      => [ [ 'nas' ], [ 'nasip' ] ],
1355       'index'       => [ [ 'last' ] ],
1356     },
1357
1358 #    'session' => {
1359 #      'columns' => [
1360 #        'sessionnum', 'serial',       '',   '', '', '', 
1361 #        'portnum',    'int',       '',   '', '', '', 
1362 #        'svcnum',     'int',       '',   '', '', '', 
1363 #        'login',      @date_type, '', '', 
1364 #        'logout',     @date_type, '', '', 
1365 #      ],
1366 #      'primary_key' => 'sessionnum',
1367 #      'unique'      => [],
1368 #      'index'       => [ [ 'portnum' ] ],
1369 #    },
1370
1371     'queue' => {
1372       'columns' => [
1373         'jobnum', 'serial', '', '', '', '', 
1374         'job', 'text', '', '', '', '', 
1375         '_date', 'int', '', '', '', '', 
1376         'status', 'varchar', '', $char_d, '', '', 
1377         'statustext', 'text', 'NULL', '', '', '', 
1378         'svcnum', 'int', 'NULL', '', '', '', 
1379         'secure',  'char', 'NULL', 1, '', '', # Y = needs to be run on machine
1380                                               #     w/private key
1381       ],
1382       'primary_key' => 'jobnum',
1383       'unique'      => [],
1384       'index'       => [ [ 'svcnum' ], [ 'status' ] ],
1385     },
1386
1387     'queue_arg' => {
1388       'columns' => [
1389         'argnum', 'serial', '', '', '', '', 
1390         'jobnum', 'int', '', '', '', '', 
1391         'arg', 'text', 'NULL', '', '', '', 
1392       ],
1393       'primary_key' => 'argnum',
1394       'unique'      => [],
1395       'index'       => [ [ 'jobnum' ] ],
1396     },
1397
1398     'queue_depend' => {
1399       'columns' => [
1400         'dependnum', 'serial', '', '', '', '', 
1401         'jobnum', 'int', '', '', '', '', 
1402         'depend_jobnum', 'int', '', '', '', '', 
1403       ],
1404       'primary_key' => 'dependnum',
1405       'unique'      => [],
1406       'index'       => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
1407     },
1408
1409     'export_svc' => {
1410       'columns' => [
1411         'exportsvcnum' => 'serial', '', '', '', '', 
1412         'exportnum'    => 'int', '', '', '', '', 
1413         'svcpart'      => 'int', '', '', '', '', 
1414       ],
1415       'primary_key' => 'exportsvcnum',
1416       'unique'      => [ [ 'exportnum', 'svcpart' ] ],
1417       'index'       => [ [ 'exportnum' ], [ 'svcpart' ] ],
1418     },
1419
1420     'part_export' => {
1421       'columns' => [
1422         'exportnum', 'serial', '', '', '', '', 
1423         'machine', 'varchar', '', $char_d, '', '', 
1424         'exporttype', 'varchar', '', $char_d, '', '', 
1425         'nodomain',     'char', 'NULL', 1, '', '', 
1426       ],
1427       'primary_key' => 'exportnum',
1428       'unique'      => [],
1429       'index'       => [ [ 'machine' ], [ 'exporttype' ] ],
1430     },
1431
1432     'part_export_option' => {
1433       'columns' => [
1434         'optionnum', 'serial', '', '', '', '', 
1435         'exportnum', 'int', '', '', '', '', 
1436         'optionname', 'varchar', '', $char_d, '', '', 
1437         'optionvalue', 'text', 'NULL', '', '', '', 
1438       ],
1439       'primary_key' => 'optionnum',
1440       'unique'      => [],
1441       'index'       => [ [ 'exportnum' ], [ 'optionname' ] ],
1442     },
1443
1444     'radius_usergroup' => {
1445       'columns' => [
1446         'usergroupnum', 'serial', '', '', '', '', 
1447         'svcnum',       'int', '', '', '', '', 
1448         'groupname',    'varchar', '', $char_d, '', '', 
1449       ],
1450       'primary_key' => 'usergroupnum',
1451       'unique'      => [],
1452       'index'       => [ [ 'svcnum' ], [ 'groupname' ] ],
1453     },
1454
1455     'msgcat' => {
1456       'columns' => [
1457         'msgnum', 'serial', '', '', '', '', 
1458         'msgcode', 'varchar', '', $char_d, '', '', 
1459         'locale', 'varchar', '', 16, '', '', 
1460         'msg', 'text', '', '', '', '', 
1461       ],
1462       'primary_key' => 'msgnum',
1463       'unique'      => [ [ 'msgcode', 'locale' ] ],
1464       'index'       => [],
1465     },
1466
1467     'cust_tax_exempt' => {
1468       'columns' => [
1469         'exemptnum', 'serial', '', '', '', '', 
1470         'custnum',   'int', '', '', '', '', 
1471         'taxnum',    'int', '', '', '', '', 
1472         'year',      'int', '', '', '', '', 
1473         'month',     'int', '', '', '', '', 
1474         'amount',   @money_type, '', '', 
1475       ],
1476       'primary_key' => 'exemptnum',
1477       'unique'      => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
1478       'index'       => [],
1479     },
1480
1481     'cust_tax_exempt_pkg' => {
1482       'columns' => [
1483         'exemptpkgnum',  'serial', '', '', '', '', 
1484         #'custnum',      'int', '', '', '', ''
1485         'billpkgnum',   'int', '', '', '', '', 
1486         'taxnum',       'int', '', '', '', '', 
1487         'year',         'int', '', '', '', '', 
1488         'month',        'int', '', '', '', '', 
1489         'amount',       @money_type, '', '', 
1490       ],
1491       'primary_key' => 'exemptpkgnum',
1492       'unique' => [],
1493       'index'  => [ [ 'taxnum', 'year', 'month' ],
1494                     [ 'billpkgnum' ],
1495                     [ 'taxnum' ]
1496                   ],
1497     },
1498
1499     'router' => {
1500       'columns' => [
1501         'routernum', 'serial', '', '', '', '', 
1502         'routername', 'varchar', '', $char_d, '', '', 
1503         'svcnum', 'int', 'NULL', '', '', '', 
1504         'agentnum',   'int', 'NULL', '', '', '', 
1505       ],
1506       'primary_key' => 'routernum',
1507       'unique'      => [],
1508       'index'       => [],
1509     },
1510
1511     'part_svc_router' => {
1512       'columns' => [
1513         'svcrouternum', 'serial', '', '', '', '', 
1514         'svcpart', 'int', '', '', '', '', 
1515         'routernum', 'int', '', '', '', '', 
1516       ],
1517       'primary_key' => 'svcrouternum',
1518       'unique'      => [],
1519       'index'       => [],
1520     },
1521
1522     'addr_block' => {
1523       'columns' => [
1524         'blocknum', 'serial', '', '', '', '', 
1525         'routernum', 'int', '', '', '', '', 
1526         'ip_gateway', 'varchar', '', 15, '', '', 
1527         'ip_netmask', 'int', '', '', '', '', 
1528         'agentnum',   'int', 'NULL', '', '', '', 
1529       ],
1530       'primary_key' => 'blocknum',
1531       'unique'      => [ [ 'blocknum', 'routernum' ] ],
1532       'index'       => [],
1533     },
1534
1535     'svc_broadband' => {
1536       'columns' => [
1537         'svcnum', 'int', '', '', '', '', 
1538         'description', 'varchar', 'NULL', $char_d, '', '', 
1539         'blocknum', 'int', '', '', '', '', 
1540         'speed_up', 'int', '', '', '', '', 
1541         'speed_down', 'int', '', '', '', '', 
1542         'ip_addr', 'varchar', '', 15, '', '', 
1543         'mac_addr', 'varchar', 'NULL', 12, '', '', 
1544         'authkey',  'varchar', 'NULL', 32, '', '', 
1545         'latitude', 'decimal', 'NULL', '', '', '', 
1546         'longitude', 'decimal', 'NULL', '', '', '', 
1547         'altitude', 'decimal', 'NULL', '', '', '', 
1548         'vlan_profile', 'varchar', 'NULL', $char_d, '', '', 
1549       ],
1550       'primary_key' => 'svcnum',
1551       'unique'      => [],
1552       'index'       => [],
1553     },
1554
1555     'part_virtual_field' => {
1556       'columns' => [
1557         'vfieldpart', 'serial', '', '', '', '', 
1558         'dbtable', 'varchar', '', 32, '', '', 
1559         'name', 'varchar', '', 32, '', '', 
1560         'check_block', 'text', 'NULL', '', '', '', 
1561         'length', 'int', 'NULL', '', '', '', 
1562         'list_source', 'text', 'NULL', '', '', '', 
1563         'label', 'varchar', 'NULL', 80, '', '', 
1564       ],
1565       'primary_key' => 'vfieldpart',
1566       'unique' => [],
1567       'index' => [],
1568     },
1569
1570     'virtual_field' => {
1571       'columns' => [
1572         'vfieldnum', 'serial', '', '', '', '', 
1573         'recnum', 'int', '', '', '', '', 
1574         'vfieldpart', 'int', '', '', '', '', 
1575         'value', 'varchar', '', 128, '', '', 
1576       ],
1577       'primary_key' => 'vfieldnum',
1578       'unique' => [ [ 'vfieldpart', 'recnum' ] ],
1579       'index' => [],
1580     },
1581
1582     'acct_snarf' => {
1583       'columns' => [
1584         'snarfnum',  'int', '', '', '', '', 
1585         'svcnum',    'int', '', '', '', '', 
1586         'machine',   'varchar', '', 255, '', '', 
1587         'protocol',  'varchar', '', $char_d, '', '', 
1588         'username',  'varchar', '', $char_d, '', '', 
1589         '_password', 'varchar', '', $char_d, '', '', 
1590       ],
1591       'primary_key' => 'snarfnum',
1592       'unique' => [],
1593       'index'  => [ [ 'svcnum' ] ],
1594     },
1595
1596     'svc_external' => {
1597       'columns' => [
1598         'svcnum', 'int', '', '', '', '', 
1599         'id',     'int', 'NULL', '', '', '', 
1600         'title',  'varchar', 'NULL', $char_d, '', '', 
1601       ],
1602       'primary_key' => 'svcnum',
1603       'unique'      => [],
1604       'index'       => [],
1605     },
1606
1607     'cust_pay_refund' => {
1608       'columns' => [
1609         'payrefundnum', 'serial', '', '', '', '', 
1610         'paynum',  'int', '', '', '', '', 
1611         'refundnum',  'int', '', '', '', '', 
1612         '_date',    @date_type, '', '', 
1613         'amount',   @money_type, '', '', 
1614       ],
1615       'primary_key' => 'payrefundnum',
1616       'unique' => [],
1617       'index' => [ ['paynum'], ['refundnum'] ],
1618     },
1619
1620     'part_pkg_option' => {
1621       'columns' => [
1622         'optionnum', 'serial', '', '', '', '', 
1623         'pkgpart', 'int', '', '', '', '', 
1624         'optionname', 'varchar', '', $char_d, '', '', 
1625         'optionvalue', 'text', 'NULL', '', '', '', 
1626       ],
1627       'primary_key' => 'optionnum',
1628       'unique'      => [],
1629       'index'       => [ [ 'pkgpart' ], [ 'optionname' ] ],
1630     },
1631
1632     'rate' => {
1633       'columns' => [
1634         'ratenum',  'serial', '', '', '', '', 
1635         'ratename', 'varchar', '', $char_d, '', '', 
1636       ],
1637       'primary_key' => 'ratenum',
1638       'unique'      => [],
1639       'index'       => [],
1640     },
1641
1642     'rate_detail' => {
1643       'columns' => [
1644         'ratedetailnum',   'serial', '', '', '', '', 
1645         'ratenum',         'int',     '', '', '', '', 
1646         'orig_regionnum',  'int', 'NULL', '', '', '', 
1647         'dest_regionnum',  'int',     '', '', '', '', 
1648         'min_included',    'int',     '', '', '', '', 
1649         #'min_charge',      @money_type, '', '', 
1650         'min_charge',      'decimal', '', '10,5', '', '', 
1651         'sec_granularity', 'int',     '', '', '', '', 
1652         #time period (link to table of periods)?
1653       ],
1654       'primary_key' => 'ratedetailnum',
1655       'unique'      => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
1656       'index'       => [ [ 'ratenum', 'dest_regionnum' ] ],
1657     },
1658
1659     'rate_region' => {
1660       'columns' => [
1661         'regionnum',   'serial',      '', '', '', '', 
1662         'regionname',  'varchar',     '', $char_d, '', '', 
1663       ],
1664       'primary_key' => 'regionnum',
1665       'unique'      => [],
1666       'index'       => [],
1667     },
1668
1669     'rate_prefix' => {
1670       'columns' => [
1671         'prefixnum',   'serial',    '', '', '', '', 
1672         'regionnum',   'int',       '', '',, '', '', 
1673         'countrycode', 'varchar',     '', 3, '', '', 
1674         'npa',         'varchar', 'NULL', 6, '', '', 
1675         'nxx',         'varchar', 'NULL', 3, '', '', 
1676       ],
1677       'primary_key' => 'prefixnum',
1678       'unique'      => [],
1679       'index'       => [ [ 'countrycode' ], [ 'regionnum' ] ],
1680     },
1681
1682     'reg_code' => {
1683       'columns' => [
1684         'codenum',   'serial',    '', '', '', '', 
1685         'code',      'varchar',   '', $char_d, '', '', 
1686         'agentnum',  'int',       '', '', '', '', 
1687       ],
1688       'primary_key' => 'codenum',
1689       'unique'      => [ [ 'agentnum', 'code' ] ],
1690       'index'       => [ [ 'agentnum' ] ],
1691     },
1692
1693     'reg_code_pkg' => {
1694       'columns' => [
1695         'codepkgnum', 'serial', '', '', '', '', 
1696         'codenum',   'int',    '', '', '', '', 
1697         'pkgpart',   'int',    '', '', '', '', 
1698       ],
1699       'primary_key' => 'codepkgnum',
1700       'unique'      => [ [ 'codenum', 'pkgpart' ] ],
1701       'index'       => [ [ 'codenum' ] ],
1702     },
1703
1704     'clientapi_session' => {
1705       'columns' => [
1706         'sessionnum',  'serial',  '', '', '', '', 
1707         'sessionid',  'varchar',  '', $char_d, '', '', 
1708         'namespace',  'varchar',  '', $char_d, '', '', 
1709       ],
1710       'primary_key' => 'sessionnum',
1711       'unique'      => [ [ 'sessionid', 'namespace' ] ],
1712       'index'       => [],
1713     },
1714
1715     'clientapi_session_field' => {
1716       'columns' => [
1717         'fieldnum',    'serial',     '', '', '', '', 
1718         'sessionnum',     'int',     '', '', '', '', 
1719         'fieldname',  'varchar',     '', $char_d, '', '', 
1720         'fieldvalue',    'text', 'NULL', '', '', '', 
1721       ],
1722       'primary_key' => 'fieldnum',
1723       'unique'      => [ [ 'sessionnum', 'fieldname' ] ],
1724       'index'       => [],
1725     },
1726
1727     'payment_gateway' => {
1728       'columns' => [
1729         'gatewaynum',       'serial',   '',     '', '', '', 
1730         'gateway_module',   'varchar',  '',     $char_d, '', '', 
1731         'gateway_username', 'varchar',  'NULL', $char_d, '', '', 
1732         'gateway_password', 'varchar',  'NULL', $char_d, '', '', 
1733         'gateway_action',   'varchar',  'NULL', $char_d, '', '', 
1734         'disabled',   'char',  'NULL',   1, '', '', 
1735       ],
1736       'primary_key' => 'gatewaynum',
1737       'unique' => [],
1738       'index'  => [ [ 'disabled' ] ],
1739     },
1740
1741     'payment_gateway_option' => {
1742       'columns' => [
1743         'optionnum',   'serial',  '',     '', '', '', 
1744         'gatewaynum',  'int',     '',     '', '', '', 
1745         'optionname',  'varchar', '',     $char_d, '', '', 
1746         'optionvalue', 'text',    'NULL', '', '', '', 
1747       ],
1748       'primary_key' => 'optionnum',
1749       'unique'      => [],
1750       'index'       => [ [ 'gatewaynum' ], [ 'optionname' ] ],
1751     },
1752
1753     'agent_payment_gateway' => {
1754       'columns' => [
1755         'agentgatewaynum', 'serial', '', '', '', '', 
1756         'agentnum',        'int', '', '', '', '', 
1757         'gatewaynum',      'int', '', '', '', '', 
1758         'cardtype',        'varchar', 'NULL', $char_d, '', '', 
1759         'taxclass',        'varchar', 'NULL', $char_d, '', '', 
1760       ],
1761       'primary_key' => 'agentgatewaynum',
1762       'unique'      => [],
1763       'index'       => [ [ 'agentnum', 'cardtype' ], ],
1764     },
1765
1766     'banned_pay' => {
1767       'columns' => [
1768         'bannum',  'serial',   '',     '', '', '', 
1769         'payby',   'char',     '',       4, '', '', 
1770         'payinfo', 'varchar',  '',     128, '', '', #say, a 512-big digest _hex encoded
1771         #'paymask', 'varchar',  'NULL', $char_d, '', ''
1772         '_date',   @date_type, '', '', 
1773         'otaker',  'varchar',  '',     32, '', '', 
1774         'reason',  'varchar',  'NULL', $char_d, '', '', 
1775       ],
1776       'primary_key' => 'bannum',
1777       'unique'      => [ [ 'payby', 'payinfo' ] ],
1778       'index'       => [],
1779     },
1780
1781     'pkg_category' => {
1782       'columns' => [
1783         'categorynum',   'serial',  '', '', '', '', 
1784         'categoryname',  'varchar', '', $char_d, '', '', 
1785         'disabled',      'char', 'NULL',   1, '', '', 
1786       ],
1787       'primary_key' => 'categorynum',
1788       'unique' => [],
1789       'index' => [ ['disabled'] ],
1790     },
1791
1792     'pkg_class' => {
1793       'columns' => [
1794         'classnum',    'serial',   '',      '', '', '', 
1795         'classname',   'varchar',  '', $char_d, '', '', 
1796         'categorynum', 'int',  'NULL',      '', '', '', 
1797         'disabled',    'char', 'NULL',       1, '', '', 
1798       ],
1799       'primary_key' => 'classnum',
1800       'unique' => [],
1801       'index' => [ ['disabled'] ],
1802     },
1803
1804     'cdr' => {
1805       'columns' => [
1806         # qw( name type null length default local );
1807
1808         ###
1809         #asterisk fields
1810         ###
1811
1812         'acctid',   'bigserial',  '', '', '', '', 
1813         #'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
1814         'calldate', 'timestamp',   '',      '', \'now()', '',
1815         'clid',        'varchar',  '', $char_d, \"''", '', 
1816         'src',         'varchar',  '', $char_d, \"''", '', 
1817         'dst',         'varchar',  '', $char_d, \"''", '', 
1818         'dcontext',    'varchar',  '', $char_d, \"''", '', 
1819         'channel',     'varchar',  '', $char_d, \"''", '', 
1820         'dstchannel',  'varchar',  '', $char_d, \"''", '', 
1821         'lastapp',     'varchar',  '', $char_d, \"''", '', 
1822         'lastdata',    'varchar',  '', $char_d, \"''", '', 
1823
1824         #these don't seem to be logged by most of the SQL cdr_* modules
1825         #except tds under sql-illegal names, so;
1826         # ... don't rely on them for rating?
1827         # and, what they hey, i went ahead and changed the names and data types
1828         # to freeside-style dates...
1829           #'start',  'timestamp', 'NULL',  '',    '', '',
1830           #'answer', 'timestamp', 'NULL',  '',    '', '',
1831           #'end',    'timestamp', 'NULL',  '',    '', '',
1832         'startdate',  @date_type, '', '', 
1833         'answerdate', @date_type, '', '', 
1834         'enddate',    @date_type, '', '', 
1835         #
1836
1837         'duration',    'int',      '',      '',     0, '',
1838         'billsec',     'int',      '',      '',     0, '', 
1839         'disposition', 'varchar',  '',      45, \"''", '',
1840         'amaflags',    'int',      '',      '',     0, '',
1841         'accountcode', 'varchar',  '',      20, \"''", '',
1842         'uniqueid',    'varchar',  '',      32, \"''", '',
1843         'userfield',   'varchar',  '',     255, \"''", '',
1844
1845         ###
1846         # fields for unitel/RSLCOM/convergent that don't map well to asterisk
1847         # defaults
1848         ###
1849
1850         #cdr_type: Usage = 1, S&E = 7, OC&C = 8
1851         'cdrtypenum',              'int', 'NULL',      '', '', '',
1852
1853         'charged_party',       'varchar', 'NULL', $char_d, '', '',
1854
1855         'upstream_currency',      'char', 'NULL',       3, '', '',
1856         'upstream_price',      'decimal', 'NULL',  '10,2', '', '', 
1857         'upstream_rateplanid',     'int', 'NULL',      '', '', '', #?
1858
1859         # how it was rated internally...
1860         'ratedetailnum',           'int', 'NULL',      '', '', '',
1861         'rated_price',         'decimal', 'NULL',  '10,2', '', '',
1862
1863         'distance',            'decimal', 'NULL',      '', '', '',
1864         'islocal',                 'int', 'NULL',      '', '', '', # '',  '', 0, '' instead?
1865
1866         #cdr_calltype: the big list in appendix 2
1867         'calltypenum',             'int', 'NULL',      '', '', '',
1868
1869         'description',         'varchar', 'NULL', $char_d, '', '',
1870         'quantity',                'int', 'NULL',      '', '', '', 
1871
1872         #cdr_carrier: Telstra =1, Optus = 2, RSL COM = 3
1873         'carrierid',               'int', 'NULL',      '', '', '',
1874
1875         'upstream_rateid',         'int', 'NULL',      '', '', '',
1876         
1877         ###
1878         #and now for our own fields
1879         ###
1880
1881         # a svcnum... right..?
1882         'svcnum',             'int',   'NULL',     '',   '', '', 
1883
1884         #NULL, done (or something)
1885         'freesidestatus', 'varchar',   'NULL',     32,   '', '', 
1886
1887       ],
1888       'primary_key' => 'acctid',
1889       'unique' => [],
1890       'index' => [ [ 'calldate' ], [ 'dst' ], [ 'accountcode' ], [ 'freesidestatus' ] ],
1891     },
1892
1893     'cdr_calltype' => {
1894       'columns' => [
1895         'calltypenum',   'serial',  '', '', '', '', 
1896         'calltypename',  'varchar', '', $char_d, '', '', 
1897       ],
1898       'primary_key' => 'calltypenum',
1899       'unique'      => [],
1900       'index'       => [],
1901     },
1902
1903     'cdr_type' => {
1904       'columns' => [
1905         'cdrtypenum'  => 'serial',  '', '', '', '',
1906         'cdrtypename' => 'varchar', '', $char_d, '', '',
1907       ],
1908       'primary_key' => 'cdrtypenum',
1909       'unique'      => [],
1910       'index'       => [],
1911     },
1912
1913     'cdr_carrier' => {
1914       'columns' => [
1915         'carrierid'   => 'serial',  '', '', '', '',
1916         'carriername' => 'varchar', '', $char_d, '', '',
1917       ],
1918       'primary_key' => 'carrierid',
1919       'unique'      => [],
1920       'index'       => [],
1921     },
1922
1923     #map upstream rateid to ours...
1924     'cdr_upstream_rate' => {
1925       'columns' => [
1926         'upstreamratenum', 'serial',  '', '', '', '',
1927         'upstream_rateid', 'varchar', '', $char_d, '', '', 
1928         'ratedetailnum',   'int', 'NULL', '', '', '',
1929       ],
1930       'primary_key' => 'upstreamratenum', #XXX need a primary key
1931       'unique' => [ [ 'upstream_rateid' ] ], #unless we add another field, yeah
1932       'index'  => [],
1933     },
1934
1935     'inventory_item' => {
1936       'columns' => [
1937         'itemnum',  'serial',      '',      '', '', '',
1938         'classnum', 'int',         '',      '', '', '',
1939         'item',     'varchar',     '', $char_d, '', '',
1940         'svcnum',   'int',     'NULL',      '', '', '',
1941       ],
1942       'primary_key' => 'itemnum',
1943       'unique' => [ [ 'classnum', 'item' ] ],
1944       'index'  => [ [ 'classnum' ], [ 'svcnum' ] ],
1945     },
1946
1947     'inventory_class' => {
1948       'columns' => [
1949         'classnum',  'serial',       '',      '', '', '',
1950         'classname', 'varchar',      '', $char_d, '', '',
1951       ],
1952       'primary_key' => 'classnum',
1953       'unique' => [],
1954       'index'  => [],
1955     },
1956
1957     'access_user' => {
1958       'columns' => [
1959         'usernum',   'serial',  '',      '', '', '',
1960         'username',  'varchar', '', $char_d, '', '',
1961         '_password', 'varchar', '', $char_d, '', '',
1962         'last',      'varchar', '', $char_d, '', '', 
1963         'first',     'varchar', '', $char_d, '', '', 
1964         'disabled',     'char', 'NULL',   1, '', '', 
1965       ],
1966       'primary_key' => 'usernum',
1967       'unique' => [ [ 'username' ] ],
1968       'index'  => [],
1969     },
1970
1971     'access_user_pref' => {
1972       'columns' => [
1973         'prefnum',    'serial',       '', '', '', '',
1974         'usernum',     'int',       '', '', '', '',
1975         'prefname', 'varchar', '', $char_d, '', '', 
1976         'prefvalue', 'text', 'NULL', '', '', '', 
1977         'expiration', @date_type, '', '',
1978       ],
1979       'primary_key' => 'prefnum',
1980       'unique' => [],
1981       'index'  => [ [ 'usernum' ] ],
1982     },
1983
1984     'access_group' => {
1985       'columns' => [
1986         'groupnum',   'serial', '',      '', '', '',
1987         'groupname', 'varchar', '', $char_d, '', '',
1988       ],
1989       'primary_key' => 'groupnum',
1990       'unique' => [ [ 'groupname' ] ],
1991       'index'  => [],
1992     },
1993
1994     'access_usergroup' => {
1995       'columns' => [
1996         'usergroupnum', 'serial', '', '', '', '',
1997         'usernum',         'int', '', '', '', '',
1998         'groupnum',        'int', '', '', '', '',
1999       ],
2000       'primary_key' => 'usergroupnum',
2001       'unique' => [ [ 'usernum', 'groupnum' ] ],
2002       'index'  => [ [ 'usernum' ] ],
2003     },
2004
2005     'access_groupagent' => {
2006       'columns' => [
2007         'groupagentnum', 'serial', '', '', '', '',
2008         'groupnum',         'int', '', '', '', '',
2009         'agentnum',         'int', '', '', '', '',
2010       ],
2011       'primary_key' => 'groupagentnum',
2012       'unique' => [ [ 'groupnum', 'agentnum' ] ],
2013       'index'  => [ [ 'groupnum' ] ],
2014     },
2015
2016     'access_right' => {
2017       'columns' => [
2018         'rightnum',   'serial', '',      '', '', '',
2019         'righttype', 'varchar', '', $char_d, '', '',
2020         'rightobjnum',   'int', '',      '', '', '',
2021         'rightname', 'varchar', '', $char_d, '', '',
2022       ],
2023       'primary_key' => 'rightnum',
2024       'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
2025       'index'  => [],
2026     },
2027
2028     'svc_phone' => {
2029       'columns' => [
2030         'svcnum',      'int',         '',      '', '', '', 
2031         'countrycode', 'varchar',     '',       3, '', '', 
2032         'phonenum',    'varchar',     '',      15, '', '',  #12 ?
2033         'pin',         'varchar', 'NULL', $char_d, '', '',
2034       ],
2035       'primary_key' => 'svcnum',
2036       'unique' => [],
2037       'index'  => [ [ 'countrycode', 'phonenum' ] ],
2038     },
2039
2040     'reason_type' => {
2041       'columns' => [
2042         'typenum',   'serial',  '', '', '', '', 
2043         'class',     'char', '', 1, '', '', 
2044         'type',     'varchar', '', $char_d, '', '', 
2045       ],
2046       'primary_key' => 'typenum',
2047       'unique' => [],
2048       'index' => [],
2049     },
2050
2051     'reason' => {
2052       'columns' => [
2053         'reasonnum',     'serial',  '', '', '', '', 
2054         'reason_type',   'int',  '', '', '', '', 
2055         'reason',        'text', '', '', '', '', 
2056         'disabled',      'char',    'NULL', 1, '', '', 
2057       ],
2058       'primary_key' => 'reasonnum',
2059       'unique' => [],
2060       'index' => [],
2061     },
2062
2063     'conf' => {
2064       'columns' => [
2065         'confnum',  'serial',  '', '', '', '', 
2066         'agentnum', 'int',  'NULL', '', '', '', 
2067         'name',     'varchar', '', $char_d, '', '', 
2068         'value',    'text', 'NULL', '', '', '',
2069       ],
2070       'primary_key' => 'confnum',
2071       'unique' => [ [ 'agentnum', 'name' ]],
2072       'index' => [],
2073     },
2074
2075     'pkg_referral' => {
2076       'columns' => [
2077         'pkgrefnum',     'serial', '', '', '', '',
2078         'pkgnum',        'int',    '', '', '', '',
2079         'refnum',        'int',    '', '', '', '',
2080       ],
2081       'primary_key' => 'pkgrefnum',
2082       'unique'      => [ [ 'pkgnum', 'refnum' ] ],
2083       'index'       => [ [ 'pkgnum' ], [ 'refnum' ] ],
2084     },
2085     # name type nullability length default local
2086
2087     #'new_table' => {
2088     #  'columns' => [
2089     #    'num', 'serial',       '', '', '', '',
2090     #  ],
2091     #  'primary_key' => 'num',
2092     #  'unique' => [],
2093     #  'index'  => [],
2094     #},
2095
2096   };
2097
2098 }
2099
2100 =back
2101
2102 =head1 BUGS
2103
2104 =head1 SEE ALSO
2105
2106 L<DBIx::DBSchema>
2107
2108 =cut
2109
2110 1;
2111