3 use vars qw(@ISA @EXPORT_OK $DEBUG $setup_hack %dbdef_cache);
4 use subs qw(reload_dbdef);
6 use DBIx::DBSchema 0.30;
7 use DBIx::DBSchema::Table;
8 use DBIx::DBSchema::Column 0.06;
9 use DBIx::DBSchema::ColGroup::Unique;
10 use DBIx::DBSchema::ColGroup::Index;
11 use FS::UID qw(datasrc);
14 @EXPORT_OK = qw( dbdef dbdef_dist reload_dbdef );
20 ##ask FS::UID to run this stuff for us later
21 #FS::UID->install_callback( sub {
22 # #$conf = new FS::Conf;
23 # &reload_dbdef("/usr/local/etc/freeside/dbdef.". datasrc)
24 # unless $setup_hack; #$setup_hack needed now?
29 FS::Schema - Freeside database schema
33 use FS::Schema qw(dbdef dbdef_dist reload_dbdef);
35 $dbdef = reload_dbdef;
36 $dbdef = reload_dbdef "/non/standard/filename";
38 $dbdef_dist = dbdef_dist;
42 This class represents the database schema.
48 =item reload_dbdef([FILENAME])
50 Load a database definition (see L<DBIx::DBSchema>), optionally from a
51 non-default filename. This command is executed at startup unless
52 I<$FS::Schema::setup_hack> is true. Returns a DBIx::DBSchema object.
59 unless ( exists $dbdef_cache{$file} ) {
60 warn "[debug]$me loading dbdef for $file\n" if $DEBUG;
61 $dbdef_cache{$file} = DBIx::DBSchema->load( $file )
62 or die "can't load database schema from $file";
64 warn "[debug]$me re-using cached dbdef for $file\n" if $DEBUG;
66 $dbdef = $dbdef_cache{$file};
71 Returns the current database definition (represents the current database,
72 assuming it is up-to-date). See L<DBIx::DBSchema>.
78 =item dbdef_dist [ OPTION => VALUE ... ]
80 Returns the current canoical database definition as defined in this file.
87 # create a dbdef object from the old data structure
90 my $tables_hashref = tables_hashref();
93 my $dbdef = new DBIx::DBSchema map {
95 while (@{$tables_hashref->{$_}{'columns'}}) {
96 #my($name, $type, $null, $length, $default, $local) =
98 splice @{$tables_hashref->{$_}{'columns'}}, 0, 6;
99 my %hash = map { $_ => shift @coldef }
100 qw( name type null length default local );
102 unless ( defined $hash{'default'} ) {
104 join('', map "$_ => $hash{$_}\n", keys %hash) ;# $stop = <STDIN>;
107 push @columns, new DBIx::DBSchema::Column ( \%hash );
109 DBIx::DBSchema::Table->new(
111 $tables_hashref->{$_}{'primary_key'},
112 DBIx::DBSchema::ColGroup::Unique->new($tables_hashref->{$_}{'unique'}),
113 DBIx::DBSchema::ColGroup::Index->new($tables_hashref->{$_}{'index'}),
116 } keys %$tables_hashref;
119 warn "[debug]$me initial dbdef_dist created ($dbdef) with tables:\n";
120 warn "[debug]$me $_\n" foreach $dbdef->tables;
123 my $cust_main = $dbdef->table('cust_main');
124 #unless ($ship) { #remove ship_ from cust_main
125 # $cust_main->delcolumn($_) foreach ( grep /^ship_/, $cust_main->columns );
126 #} else { #add indices
127 push @{$cust_main->index->lol_ref},
128 map { [ "ship_$_" ] } qw( last company daytime night fax );
131 #add radius attributes to svc_acct
133 #my($svc_acct)=$dbdef->table('svc_acct');
136 #foreach $attribute (@attributes) {
137 # $svc_acct->addcolumn ( new DBIx::DBSchema::Column (
138 # 'radius_'. $attribute,
145 #foreach $attribute (@check_attributes) {
146 # $svc_acct->addcolumn( new DBIx::DBSchema::Column (
154 #create history tables (false laziness w/create-history-tables)
156 grep { ! /^clientapi_session/ }
160 my $tableobj = $dbdef->table($table)
161 or die "unknown table $table";
163 die "unique->lol_ref undefined for $table"
164 unless defined $tableobj->unique->lol_ref;
165 die "index->lol_ref undefined for $table"
166 unless defined $tableobj->index->lol_ref;
168 my $h_tableobj = DBIx::DBSchema::Table->new( {
170 primary_key => 'historynum',
171 unique => DBIx::DBSchema::ColGroup::Unique->new( [] ),
172 'index' => DBIx::DBSchema::ColGroup::Index->new( [
173 @{$tableobj->unique->lol_ref},
174 @{$tableobj->index->lol_ref}
177 DBIx::DBSchema::Column->new( {
178 'name' => 'historynum',
180 'null' => 'NOT NULL',
185 DBIx::DBSchema::Column->new( {
186 'name' => 'history_date',
193 DBIx::DBSchema::Column->new( {
194 'name' => 'history_user',
196 'null' => 'NOT NULL',
201 DBIx::DBSchema::Column->new( {
202 'name' => 'history_action',
204 'null' => 'NOT NULL',
210 my $column = $tableobj->column($_);
212 #clone so as to not disturb the original
213 $column = DBIx::DBSchema::Column->new( {
214 map { $_ => $column->$_() }
215 qw( name type null length default local )
218 if ( $column->type eq 'serial' ) {
219 $column->type('int');
220 $column->null('NULL');
222 #$column->default('')
223 # if $column->default =~ /^nextval\(/i;
224 #( my $local = $column->local ) =~ s/AUTO_INCREMENT//i;
225 #$column->local($local);
230 $dbdef->addtable($h_tableobj);
239 my $char_d = 80; #default maxlength for text fields
241 #my(@date_type) = ( 'timestamp', '', '' );
242 my @date_type = ( 'int', 'NULL', '' );
243 my @perl_type = ( 'text', 'NULL', '' );
244 my @money_type = ( 'decimal', '', '10,2' );
246 my $username_len = 32; #usernamemax config file
248 # name type nullability length default local
254 'agentnum', 'serial', '', '', '', '',
255 'agent', 'varchar', '', $char_d, '', '',
256 'typenum', 'int', '', '', '', '',
257 'freq', 'int', 'NULL', '', '', '',
258 'prog', @perl_type, '', '',
259 'disabled', 'char', 'NULL', 1, '', '',
260 'username', 'varchar', 'NULL', $char_d, '', '',
261 '_password','varchar', 'NULL', $char_d, '', '',
262 'ticketing_queueid', 'int', 'NULL', '', '', '',
264 'primary_key' => 'agentnum',
266 'index' => [ ['typenum'], ['disabled'] ],
271 'typenum', 'serial', '', '', '', '',
272 'atype', 'varchar', '', $char_d, '', '',
274 'primary_key' => 'typenum',
281 'typepkgnum', 'serial', '', '', '', '',
282 'typenum', 'int', '', '', '', '',
283 'pkgpart', 'int', '', '', '', '',
285 'primary_key' => 'typepkgnum',
286 'unique' => [ ['typenum', 'pkgpart'] ],
287 'index' => [ ['typenum'] ],
292 'invnum', 'serial', '', '', '', '',
293 'custnum', 'int', '', '', '', '',
294 '_date', @date_type, '', '',
295 'charged', @money_type, '', '',
296 'printed', 'int', '', '', '', '',
297 'closed', 'char', 'NULL', 1, '', '',
299 'primary_key' => 'invnum',
301 'index' => [ ['custnum'], ['_date'] ],
304 'cust_bill_event' => {
306 'eventnum', 'serial', '', '', '', '',
307 'invnum', 'int', '', '', '', '',
308 'eventpart', 'int', '', '', '', '',
309 '_date', @date_type, '', '',
310 'status', 'varchar', '', $char_d, '', '',
311 'statustext', 'text', 'NULL', '', '', '',
313 'primary_key' => 'eventnum',
314 #no... there are retries now #'unique' => [ [ 'eventpart', 'invnum' ] ],
316 'index' => [ ['invnum'], ['status'] ],
319 'part_bill_event' => {
321 'eventpart', 'serial', '', '', '', '',
322 'freq', 'varchar', 'NULL', $char_d, '', '',
323 'payby', 'char', '', 4, '', '',
324 'event', 'varchar', '', $char_d, '', '',
325 'eventcode', @perl_type, '', '',
326 'seconds', 'int', 'NULL', '', '', '',
327 'weight', 'int', '', '', '', '',
328 'plan', 'varchar', 'NULL', $char_d, '', '',
329 'plandata', 'text', 'NULL', '', '', '',
330 'disabled', 'char', 'NULL', 1, '', '',
332 'primary_key' => 'eventpart',
334 'index' => [ ['payby'], ['disabled'], ],
339 'billpkgnum', 'serial', '', '', '', '',
340 'pkgnum', 'int', '', '', '', '',
341 'invnum', 'int', '', '', '', '',
342 'setup', @money_type, '', '',
343 'recur', @money_type, '', '',
344 'sdate', @date_type, '', '',
345 'edate', @date_type, '', '',
346 'itemdesc', 'varchar', 'NULL', $char_d, '', '',
348 'primary_key' => 'billpkgnum',
350 'index' => [ ['invnum'], [ 'pkgnum' ] ],
353 'cust_bill_pkg_detail' => {
355 'detailnum', 'serial', '', '', '', '',
356 'pkgnum', 'int', '', '', '', '',
357 'invnum', 'int', '', '', '', '',
358 'detail', 'varchar', '', $char_d, '', '',
360 'primary_key' => 'detailnum',
362 'index' => [ [ 'pkgnum', 'invnum' ] ],
367 'crednum', 'serial', '', '', '', '',
368 'custnum', 'int', '', '', '', '',
369 '_date', @date_type, '', '',
370 'amount', @money_type, '', '',
371 'otaker', 'varchar', '', 32, '', '',
372 'reason', 'text', 'NULL', '', '', '',
373 'closed', 'char', 'NULL', 1, '', '',
375 'primary_key' => 'crednum',
377 'index' => [ ['custnum'] ],
380 'cust_credit_bill' => {
382 'creditbillnum', 'serial', '', '', '', '',
383 'crednum', 'int', '', '', '', '',
384 'invnum', 'int', '', '', '', '',
385 '_date', @date_type, '', '',
386 'amount', @money_type, '', '',
388 'primary_key' => 'creditbillnum',
390 'index' => [ ['crednum'], ['invnum'] ],
395 'custnum', 'serial', '', '', '', '',
396 'agentnum', 'int', '', '', '', '',
397 'agent_custid', 'varchar', 'NULL', $char_d, '', '',
398 # 'titlenum', 'int', 'NULL', '', '', '',
399 'last', 'varchar', '', $char_d, '', '',
400 # 'middle', 'varchar', 'NULL', $char_d, '', '',
401 'first', 'varchar', '', $char_d, '', '',
402 'ss', 'varchar', 'NULL', 11, '', '',
403 'company', 'varchar', 'NULL', $char_d, '', '',
404 'address1', 'varchar', '', $char_d, '', '',
405 'address2', 'varchar', 'NULL', $char_d, '', '',
406 'city', 'varchar', '', $char_d, '', '',
407 'county', 'varchar', 'NULL', $char_d, '', '',
408 'state', 'varchar', 'NULL', $char_d, '', '',
409 'zip', 'varchar', 'NULL', 10, '', '',
410 'country', 'char', '', 2, '', '',
411 'daytime', 'varchar', 'NULL', 20, '', '',
412 'night', 'varchar', 'NULL', 20, '', '',
413 'fax', 'varchar', 'NULL', 12, '', '',
414 'ship_last', 'varchar', 'NULL', $char_d, '', '',
415 # 'ship_middle', 'varchar', 'NULL', $char_d, '', '',
416 'ship_first', 'varchar', 'NULL', $char_d, '', '',
417 'ship_company', 'varchar', 'NULL', $char_d, '', '',
418 'ship_address1', 'varchar', 'NULL', $char_d, '', '',
419 'ship_address2', 'varchar', 'NULL', $char_d, '', '',
420 'ship_city', 'varchar', 'NULL', $char_d, '', '',
421 'ship_county', 'varchar', 'NULL', $char_d, '', '',
422 'ship_state', 'varchar', 'NULL', $char_d, '', '',
423 'ship_zip', 'varchar', 'NULL', 10, '', '',
424 'ship_country', 'char', 'NULL', 2, '', '',
425 'ship_daytime', 'varchar', 'NULL', 20, '', '',
426 'ship_night', 'varchar', 'NULL', 20, '', '',
427 'ship_fax', 'varchar', 'NULL', 12, '', '',
428 'payby', 'char', '', 4, '', '',
429 'payinfo', 'varchar', 'NULL', 512, '', '',
430 'paycvv', 'varchar', 'NULL', 512, '', '',
431 'paymask', 'varchar', 'NULL', $char_d, '', '',
432 #'paydate', @date_type, '', '',
433 'paydate', 'varchar', 'NULL', 10, '', '',
434 'paystart_month', 'int', 'NULL', '', '', '',
435 'paystart_year', 'int', 'NULL', '', '', '',
436 'payissue', 'varchar', 'NULL', 2, '', '',
437 'payname', 'varchar', 'NULL', $char_d, '', '',
438 'payip', 'varchar', 'NULL', 15, '', '',
439 'tax', 'char', 'NULL', 1, '', '',
440 'otaker', 'varchar', '', 32, '', '',
441 'refnum', 'int', '', '', '', '',
442 'referral_custnum', 'int', 'NULL', '', '', '',
443 'comments', 'text', 'NULL', '', '', '',
444 'spool_cdr','char', 'NULL', 1, '', '',
446 'primary_key' => 'custnum',
447 'unique' => [ [ 'agentnum', 'agent_custid' ] ],
448 #'index' => [ ['last'], ['company'] ],
449 'index' => [ ['last'], [ 'company' ], [ 'referral_custnum' ],
450 [ 'daytime' ], [ 'night' ], [ 'fax' ], [ 'refnum' ],
451 [ 'county' ], [ 'state' ], [ 'country' ], [ 'zip' ],
452 [ 'ship_last' ], [ 'ship_company' ],
453 [ 'payby' ], [ 'paydate' ],
458 'cust_main_invoice' => {
460 'destnum', 'serial', '', '', '', '',
461 'custnum', 'int', '', '', '', '',
462 'dest', 'varchar', '', $char_d, '', '',
464 'primary_key' => 'destnum',
466 'index' => [ ['custnum'], ],
469 'cust_main_county' => { #county+state+country are checked off the
470 #cust_main_county for validation and to provide
473 'taxnum', 'serial', '', '', '', '',
474 'state', 'varchar', 'NULL', $char_d, '', '',
475 'county', 'varchar', 'NULL', $char_d, '', '',
476 'country', 'char', '', 2, '', '',
477 'taxclass', 'varchar', 'NULL', $char_d, '', '',
478 'exempt_amount', @money_type, '', '',
479 'tax', 'real', '', '', '', '', #tax %
480 'taxname', 'varchar', 'NULL', $char_d, '', '',
481 'setuptax', 'char', 'NULL', 1, '', '', # Y = setup tax exempt
482 'recurtax', 'char', 'NULL', 1, '', '', # Y = recur tax exempt
484 'primary_key' => 'taxnum',
486 # 'unique' => [ ['taxnum'], ['state', 'county'] ],
487 'index' => [ [ 'county' ], [ 'state' ], [ 'country' ] ],
492 'paynum', 'serial', '', '', '', '',
493 #now cust_bill_pay #'invnum', 'int', '', '', '', '',
494 'custnum', 'int', '', '', '', '',
495 'paid', @money_type, '', '',
496 '_date', @date_type, '', '',
497 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
498 # index into payby table
500 'payinfo', 'varchar', 'NULL', $char_d, '', '', #see cust_main above
501 'paybatch', 'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
502 'closed', 'char', 'NULL', 1, '', '',
504 'primary_key' => 'paynum',
506 'index' => [ [ 'custnum' ], [ 'paybatch' ], [ 'payby' ], [ '_date' ] ],
511 'paynum', 'int', '', '', '', '',
512 'custnum', 'int', '', '', '', '',
513 'paid', @money_type, '', '',
514 '_date', @date_type, '', '',
515 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
516 # index into payby table
518 'payinfo', 'varchar', 'NULL', $char_d, '', '', #see cust_main above
519 'paybatch', 'varchar', 'NULL', $char_d, '', '', #for auditing purposes.
520 'closed', 'char', 'NULL', 1, '', '',
521 'void_date', @date_type, '', '',
522 'reason', 'varchar', 'NULL', $char_d, '', '',
523 'otaker', 'varchar', '', 32, '', '',
525 'primary_key' => 'paynum',
527 'index' => [ [ 'custnum' ] ],
532 'billpaynum', 'serial', '', '', '', '',
533 'invnum', 'int', '', '', '', '',
534 'paynum', 'int', '', '', '', '',
535 'amount', @money_type, '', '',
536 '_date', @date_type, '', '',
538 'primary_key' => 'billpaynum',
540 'index' => [ [ 'paynum' ], [ 'invnum' ] ],
543 'pay_batch' => { #batches of payments to an external processor
545 'batchnum', 'serial', '', '', '', '',
546 'status', 'char', 'NULL', 1, '', '',
547 'download', @date_type, '', '',
548 'upload', @date_type, '', '',
550 'primary_key' => 'batchnum',
555 'cust_pay_batch' => { #what's this used for again? list of customers
556 #in current CARD batch? (necessarily CARD?)
558 'paybatchnum', 'serial', '', '', '', '',
559 'batchnum', 'int', '', '', '', '',
560 'invnum', 'int', '', '', '', '',
561 'custnum', 'int', '', '', '', '',
562 'last', 'varchar', '', $char_d, '', '',
563 'first', 'varchar', '', $char_d, '', '',
564 'address1', 'varchar', '', $char_d, '', '',
565 'address2', 'varchar', 'NULL', $char_d, '', '',
566 'city', 'varchar', '', $char_d, '', '',
567 'state', 'varchar', 'NULL', $char_d, '', '',
568 'zip', 'varchar', 'NULL', 10, '', '',
569 'country', 'char', '', 2, '', '',
570 # 'trancode', 'int', '', '', '', ''
571 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should be
572 'payinfo', 'varchar', '', 512, '', '',
573 #'exp', @date_type, '', ''
574 'exp', 'varchar', 'NULL', 11, '', '',
575 'payname', 'varchar', 'NULL', $char_d, '', '',
576 'amount', @money_type, '', '',
577 'status', 'varchar', 'NULL', $char_d, '', '',
579 'primary_key' => 'paybatchnum',
581 'index' => [ ['batchnum'], ['invnum'], ['custnum'] ],
586 'pkgnum', 'serial', '', '', '', '',
587 'custnum', 'int', '', '', '', '',
588 'pkgpart', 'int', '', '', '', '',
589 'otaker', 'varchar', '', 32, '', '',
590 'setup', @date_type, '', '',
591 'bill', @date_type, '', '',
592 'last_bill', @date_type, '', '',
593 'susp', @date_type, '', '',
594 'cancel', @date_type, '', '',
595 'expire', @date_type, '', '',
596 'manual_flag', 'char', 'NULL', 1, '', '',
598 'primary_key' => 'pkgnum',
600 'index' => [ ['custnum'], ['pkgpart'] ],
605 'refundnum', 'serial', '', '', '', '',
606 #now cust_credit_refund #'crednum', 'int', '', '', '', '',
607 'custnum', 'int', '', '', '', '',
608 '_date', @date_type, '', '',
609 'refund', @money_type, '', '',
610 'otaker', 'varchar', '', 32, '', '',
611 'reason', 'varchar', '', $char_d, '', '',
612 'payby', 'char', '', 4, '', '', # CARD/BILL/COMP, should
613 # be index into payby
615 'payinfo', 'varchar', 'NULL', $char_d, '', '', #see cust_main above
616 'paybatch', 'varchar', 'NULL', $char_d, '', '',
617 'closed', 'char', 'NULL', 1, '', '',
619 'primary_key' => 'refundnum',
624 'cust_credit_refund' => {
626 'creditrefundnum', 'serial', '', '', '', '',
627 'crednum', 'int', '', '', '', '',
628 'refundnum', 'int', '', '', '', '',
629 'amount', @money_type, '', '',
630 '_date', @date_type, '', '',
632 'primary_key' => 'creditrefundnum',
634 'index' => [ [ 'crednum', 'refundnum' ] ],
640 'svcnum', 'serial', '', '', '', '',
641 'pkgnum', 'int', 'NULL', '', '', '',
642 'svcpart', 'int', '', '', '', '',
644 'primary_key' => 'svcnum',
646 'index' => [ ['svcnum'], ['pkgnum'], ['svcpart'] ],
651 'pkgpart', 'serial', '', '', '', '',
652 'pkg', 'varchar', '', $char_d, '', '',
653 'comment', 'varchar', '', $char_d, '', '',
654 'promo_code', 'varchar', 'NULL', $char_d, '', '',
655 'setup', @perl_type, '', '',
656 'freq', 'varchar', '', $char_d, '', '', #billing frequency
657 'recur', @perl_type, '', '',
658 'setuptax', 'char', 'NULL', 1, '', '',
659 'recurtax', 'char', 'NULL', 1, '', '',
660 'plan', 'varchar', 'NULL', $char_d, '', '',
661 'plandata', 'text', 'NULL', '', '', '',
662 'disabled', 'char', 'NULL', 1, '', '',
663 'taxclass', 'varchar', 'NULL', $char_d, '', '',
664 'classnum', 'int', 'NULL', '', '', '',
666 'primary_key' => 'pkgpart',
668 'index' => [ [ 'promo_code' ], [ 'disabled' ] ],
673 # 'titlenum', 'int', '', '',
674 # 'title', 'varchar', '', $char_d,
676 # 'primary_key' => 'titlenum',
677 # 'unique' => [ [] ],
683 'pkgsvcnum', 'serial', '', '', '', '',
684 'pkgpart', 'int', '', '', '', '',
685 'svcpart', 'int', '', '', '', '',
686 'quantity', 'int', '', '', '', '',
687 'primary_svc','char', 'NULL', 1, '', '',
689 'primary_key' => 'pkgsvcnum',
690 'unique' => [ ['pkgpart', 'svcpart'] ],
691 'index' => [ ['pkgpart'] ],
696 'refnum', 'serial', '', '', '', '',
697 'referral', 'varchar', '', $char_d, '', '',
698 'disabled', 'char', 'NULL', 1, '', '',
699 'agentnum', 'int', 'NULL', '', '', '',
701 'primary_key' => 'refnum',
703 'index' => [ ['disabled'] ],
708 'svcpart', 'serial', '', '', '', '',
709 'svc', 'varchar', '', $char_d, '', '',
710 'svcdb', 'varchar', '', $char_d, '', '',
711 'disabled', 'char', 'NULL', 1, '', '',
713 'primary_key' => 'svcpart',
715 'index' => [ [ 'disabled' ] ],
718 'part_svc_column' => {
720 'columnnum', 'serial', '', '', '', '',
721 'svcpart', 'int', '', '', '', '',
722 'columnname', 'varchar', '', 64, '', '',
723 'columnvalue', 'varchar', 'NULL', $char_d, '', '',
724 'columnflag', 'char', 'NULL', 1, '', '',
726 'primary_key' => 'columnnum',
727 'unique' => [ [ 'svcpart', 'columnname' ] ],
728 'index' => [ [ 'svcpart' ] ],
731 #(this should be renamed to part_pop)
734 'popnum', 'serial', '', '', '', '',
735 'city', 'varchar', '', $char_d, '', '',
736 'state', 'varchar', '', $char_d, '', '',
737 'ac', 'char', '', 3, '', '',
738 'exch', 'char', '', 3, '', '',
739 'loc', 'char', 'NULL', 4, '', '', #NULL for legacy purposes
741 'primary_key' => 'popnum',
743 'index' => [ [ 'state' ] ],
746 'part_pop_local' => {
748 'localnum', 'serial', '', '', '', '',
749 'popnum', 'int', '', '', '', '',
750 'city', 'varchar', 'NULL', $char_d, '', '',
751 'state', 'char', 'NULL', 2, '', '',
752 'npa', 'char', '', 3, '', '',
753 'nxx', 'char', '', 3, '', '',
755 'primary_key' => 'localnum',
757 'index' => [ [ 'npa', 'nxx' ], [ 'popnum' ] ],
762 'svcnum', 'int', '', '', '', '',
763 'username', 'varchar', '', $username_len, '', '', #unique (& remove dup code)
764 '_password', 'varchar', '', 72, '', '', #13 for encryped pw's plus ' *SUSPENDED* (md5 passwords can be 34, blowfish 60)
765 'sec_phrase', 'varchar', 'NULL', $char_d, '', '',
766 'popnum', 'int', 'NULL', '', '', '',
767 'uid', 'int', 'NULL', '', '', '',
768 'gid', 'int', 'NULL', '', '', '',
769 'finger', 'varchar', 'NULL', $char_d, '', '',
770 'dir', 'varchar', 'NULL', $char_d, '', '',
771 'shell', 'varchar', 'NULL', $char_d, '', '',
772 'quota', 'varchar', 'NULL', $char_d, '', '',
773 'slipip', 'varchar', 'NULL', 15, '', '', #four TINYINTs, bah.
774 'seconds', 'int', 'NULL', '', '', '', #uhhhh
775 'domsvc', 'int', '', '', '', '',
777 'primary_key' => 'svcnum',
778 #'unique' => [ [ 'username', 'domsvc' ] ],
780 'index' => [ ['username'], ['domsvc'] ],
785 # 'svcnum', 'int', '', '',
786 # 'amount', @money_type,
788 # 'primary_key' => 'svcnum',
789 # 'unique' => [ [] ],
795 'svcnum', 'int', '', '', '', '',
796 'domain', 'varchar', '', $char_d, '', '',
797 'catchall', 'int', 'NULL', '', '', '',
799 'primary_key' => 'svcnum',
800 'unique' => [ ['domain'] ],
806 'recnum', 'serial', '', '', '', '',
807 'svcnum', 'int', '', '', '', '',
808 'reczone', 'varchar', '', 255, '', '',
809 'recaf', 'char', '', 2, '', '',
810 'rectype', 'varchar', '', 5, '', '',
811 'recdata', 'varchar', '', 255, '', '',
813 'primary_key' => 'recnum',
815 'index' => [ ['svcnum'] ],
820 'svcnum', 'int', '', '', '', '',
821 'srcsvc', 'int', 'NULL', '', '', '',
822 'src', 'varchar', 'NULL', 255, '', '',
823 'dstsvc', 'int', 'NULL', '', '', '',
824 'dst', 'varchar', 'NULL', 255, '', '',
826 'primary_key' => 'svcnum',
828 'index' => [ ['srcsvc'], ['dstsvc'] ],
833 'svcnum', 'int', '', '', '', '',
834 'recnum', 'int', '', '', '', '',
835 'usersvc', 'int', '', '', '', '',
837 'primary_key' => 'svcnum',
844 # 'svcnum', 'int', '', '',
845 # 'svcnum', 'int', '', '',
846 # 'svcnum', 'int', '', '',
847 # 'worker', 'varchar', '', $char_d,
848 # '_date', @date_type,
850 # 'primary_key' => 'svcnum',
851 # 'unique' => [ [] ],
857 'prepaynum', 'serial', '', '', '', '',
858 'identifier', 'varchar', '', $char_d, '', '',
859 'amount', @money_type, '', '',
860 'seconds', 'int', 'NULL', '', '', '',
861 'agentnum', 'int', 'NULL', '', '', '',
863 'primary_key' => 'prepaynum',
864 'unique' => [ ['identifier'] ],
870 'portnum', 'serial', '', '', '', '',
871 'ip', 'varchar', 'NULL', 15, '', '',
872 'nasport', 'int', 'NULL', '', '', '',
873 'nasnum', 'int', '', '', '', '',
875 'primary_key' => 'portnum',
882 'nasnum', 'serial', '', '', '', '',
883 'nas', 'varchar', '', $char_d, '', '',
884 'nasip', 'varchar', '', 15, '', '',
885 'nasfqdn', 'varchar', '', $char_d, '', '',
886 'last', 'int', '', '', '', '',
888 'primary_key' => 'nasnum',
889 'unique' => [ [ 'nas' ], [ 'nasip' ] ],
890 'index' => [ [ 'last' ] ],
895 'sessionnum', 'serial', '', '', '', '',
896 'portnum', 'int', '', '', '', '',
897 'svcnum', 'int', '', '', '', '',
898 'login', @date_type, '', '',
899 'logout', @date_type, '', '',
901 'primary_key' => 'sessionnum',
903 'index' => [ [ 'portnum' ] ],
908 'jobnum', 'serial', '', '', '', '',
909 'job', 'text', '', '', '', '',
910 '_date', 'int', '', '', '', '',
911 'status', 'varchar', '', $char_d, '', '',
912 'statustext', 'text', 'NULL', '', '', '',
913 'svcnum', 'int', 'NULL', '', '', '',
915 'primary_key' => 'jobnum',
917 'index' => [ [ 'svcnum' ], [ 'status' ] ],
922 'argnum', 'serial', '', '', '', '',
923 'jobnum', 'int', '', '', '', '',
924 'arg', 'text', 'NULL', '', '', '',
926 'primary_key' => 'argnum',
928 'index' => [ [ 'jobnum' ] ],
933 'dependnum', 'serial', '', '', '', '',
934 'jobnum', 'int', '', '', '', '',
935 'depend_jobnum', 'int', '', '', '', '',
937 'primary_key' => 'dependnum',
939 'index' => [ [ 'jobnum' ], [ 'depend_jobnum' ] ],
944 'exportsvcnum' => 'serial', '', '', '', '',
945 'exportnum' => 'int', '', '', '', '',
946 'svcpart' => 'int', '', '', '', '',
948 'primary_key' => 'exportsvcnum',
949 'unique' => [ [ 'exportnum', 'svcpart' ] ],
950 'index' => [ [ 'exportnum' ], [ 'svcpart' ] ],
955 'exportnum', 'serial', '', '', '', '',
956 'machine', 'varchar', '', $char_d, '', '',
957 'exporttype', 'varchar', '', $char_d, '', '',
958 'nodomain', 'char', 'NULL', 1, '', '',
960 'primary_key' => 'exportnum',
962 'index' => [ [ 'machine' ], [ 'exporttype' ] ],
965 'part_export_option' => {
967 'optionnum', 'serial', '', '', '', '',
968 'exportnum', 'int', '', '', '', '',
969 'optionname', 'varchar', '', $char_d, '', '',
970 'optionvalue', 'text', 'NULL', '', '', '',
972 'primary_key' => 'optionnum',
974 'index' => [ [ 'exportnum' ], [ 'optionname' ] ],
977 'radius_usergroup' => {
979 'usergroupnum', 'serial', '', '', '', '',
980 'svcnum', 'int', '', '', '', '',
981 'groupname', 'varchar', '', $char_d, '', '',
983 'primary_key' => 'usergroupnum',
985 'index' => [ [ 'svcnum' ], [ 'groupname' ] ],
990 'msgnum', 'serial', '', '', '', '',
991 'msgcode', 'varchar', '', $char_d, '', '',
992 'locale', 'varchar', '', 16, '', '',
993 'msg', 'text', '', '', '', '',
995 'primary_key' => 'msgnum',
996 'unique' => [ [ 'msgcode', 'locale' ] ],
1000 'cust_tax_exempt' => {
1002 'exemptnum', 'serial', '', '', '', '',
1003 'custnum', 'int', '', '', '', '',
1004 'taxnum', 'int', '', '', '', '',
1005 'year', 'int', '', '', '', '',
1006 'month', 'int', '', '', '', '',
1007 'amount', @money_type, '', '',
1009 'primary_key' => 'exemptnum',
1010 'unique' => [ [ 'custnum', 'taxnum', 'year', 'month' ] ],
1014 'cust_tax_exempt_pkg' => {
1016 'exemptpkgnum', 'serial', '', '', '', '',
1017 #'custnum', 'int', '', '', '', ''
1018 'billpkgnum', 'int', '', '', '', '',
1019 'taxnum', 'int', '', '', '', '',
1020 'year', 'int', '', '', '', '',
1021 'month', 'int', '', '', '', '',
1022 'amount', @money_type, '', '',
1024 'primary_key' => 'exemptpkgnum',
1026 'index' => [ [ 'taxnum', 'year', 'month' ],
1034 'routernum', 'serial', '', '', '', '',
1035 'routername', 'varchar', '', $char_d, '', '',
1036 'svcnum', 'int', 'NULL', '', '', '',
1038 'primary_key' => 'routernum',
1043 'part_svc_router' => {
1045 'svcrouternum', 'serial', '', '', '', '',
1046 'svcpart', 'int', '', '', '', '',
1047 'routernum', 'int', '', '', '', '',
1049 'primary_key' => 'svcrouternum',
1056 'blocknum', 'serial', '', '', '', '',
1057 'routernum', 'int', '', '', '', '',
1058 'ip_gateway', 'varchar', '', 15, '', '',
1059 'ip_netmask', 'int', '', '', '', '',
1061 'primary_key' => 'blocknum',
1062 'unique' => [ [ 'blocknum', 'routernum' ] ],
1066 'svc_broadband' => {
1068 'svcnum', 'int', '', '', '', '',
1069 'blocknum', 'int', '', '', '', '',
1070 'speed_up', 'int', '', '', '', '',
1071 'speed_down', 'int', '', '', '', '',
1072 'ip_addr', 'varchar', '', 15, '', '',
1074 'primary_key' => 'svcnum',
1079 'part_virtual_field' => {
1081 'vfieldpart', 'int', '', '', '', '',
1082 'dbtable', 'varchar', '', 32, '', '',
1083 'name', 'varchar', '', 32, '', '',
1084 'check_block', 'text', 'NULL', '', '', '',
1085 'length', 'int', 'NULL', '', '', '',
1086 'list_source', 'text', 'NULL', '', '', '',
1087 'label', 'varchar', 'NULL', 80, '', '',
1089 'primary_key' => 'vfieldpart',
1094 'virtual_field' => {
1096 'vfieldnum', 'serial', '', '', '', '',
1097 'recnum', 'int', '', '', '', '',
1098 'vfieldpart', 'int', '', '', '', '',
1099 'value', 'varchar', '', 128, '', '',
1101 'primary_key' => 'vfieldnum',
1102 'unique' => [ [ 'vfieldpart', 'recnum' ] ],
1108 'snarfnum', 'int', '', '', '', '',
1109 'svcnum', 'int', '', '', '', '',
1110 'machine', 'varchar', '', 255, '', '',
1111 'protocol', 'varchar', '', $char_d, '', '',
1112 'username', 'varchar', '', $char_d, '', '',
1113 '_password', 'varchar', '', $char_d, '', '',
1115 'primary_key' => 'snarfnum',
1117 'index' => [ [ 'svcnum' ] ],
1122 'svcnum', 'int', '', '', '', '',
1123 'id', 'int', 'NULL', '', '', '',
1124 'title', 'varchar', 'NULL', $char_d, '', '',
1126 'primary_key' => 'svcnum',
1131 'cust_pay_refund' => {
1133 'payrefundnum', 'serial', '', '', '', '',
1134 'paynum', 'int', '', '', '', '',
1135 'refundnum', 'int', '', '', '', '',
1136 '_date', @date_type, '', '',
1137 'amount', @money_type, '', '',
1139 'primary_key' => 'payrefundnum',
1141 'index' => [ ['paynum'], ['refundnum'] ],
1144 'part_pkg_option' => {
1146 'optionnum', 'serial', '', '', '', '',
1147 'pkgpart', 'int', '', '', '', '',
1148 'optionname', 'varchar', '', $char_d, '', '',
1149 'optionvalue', 'text', 'NULL', '', '', '',
1151 'primary_key' => 'optionnum',
1153 'index' => [ [ 'pkgpart' ], [ 'optionname' ] ],
1158 'ratenum', 'serial', '', '', '', '',
1159 'ratename', 'varchar', '', $char_d, '', '',
1161 'primary_key' => 'ratenum',
1168 'ratedetailnum', 'serial', '', '', '', '',
1169 'ratenum', 'int', '', '', '', '',
1170 'orig_regionnum', 'int', 'NULL', '', '', '',
1171 'dest_regionnum', 'int', '', '', '', '',
1172 'min_included', 'int', '', '', '', '',
1173 #'min_charge', @money_type, '', '',
1174 'min_charge', 'decimal', '', '10,5', '', '',
1175 'sec_granularity', 'int', '', '', '', '',
1176 #time period (link to table of periods)?
1178 'primary_key' => 'ratedetailnum',
1179 'unique' => [ [ 'ratenum', 'orig_regionnum', 'dest_regionnum' ] ],
1180 'index' => [ [ 'ratenum', 'dest_regionnum' ] ],
1185 'regionnum', 'serial', '', '', '', '',
1186 'regionname', 'varchar', '', $char_d, '', '',
1188 'primary_key' => 'regionnum',
1195 'prefixnum', 'serial', '', '', '', '',
1196 'regionnum', 'int', '', '',, '', '',
1197 'countrycode', 'varchar', '', 3, '', '',
1198 'npa', 'varchar', 'NULL', 6, '', '',
1199 'nxx', 'varchar', 'NULL', 3, '', '',
1201 'primary_key' => 'prefixnum',
1203 'index' => [ [ 'countrycode' ], [ 'regionnum' ] ],
1208 'codenum', 'serial', '', '', '', '',
1209 'code', 'varchar', '', $char_d, '', '',
1210 'agentnum', 'int', '', '', '', '',
1212 'primary_key' => 'codenum',
1213 'unique' => [ [ 'agentnum', 'code' ] ],
1214 'index' => [ [ 'agentnum' ] ],
1219 'codepkgnum', 'serial', '', '', '', '',
1220 'codenum', 'int', '', '', '', '',
1221 'pkgpart', 'int', '', '', '', '',
1223 'primary_key' => 'codepkgnum',
1224 'unique' => [ [ 'codenum', 'pkgpart' ] ],
1225 'index' => [ [ 'codenum' ] ],
1228 'clientapi_session' => {
1230 'sessionnum', 'serial', '', '', '', '',
1231 'sessionid', 'varchar', '', $char_d, '', '',
1232 'namespace', 'varchar', '', $char_d, '', '',
1234 'primary_key' => 'sessionnum',
1235 'unique' => [ [ 'sessionid', 'namespace' ] ],
1239 'clientapi_session_field' => {
1241 'fieldnum', 'serial', '', '', '', '',
1242 'sessionnum', 'int', '', '', '', '',
1243 'fieldname', 'varchar', '', $char_d, '', '',
1244 'fieldvalue', 'text', 'NULL', '', '', '',
1246 'primary_key' => 'fieldnum',
1247 'unique' => [ [ 'sessionnum', 'fieldname' ] ],
1251 'payment_gateway' => {
1253 'gatewaynum', 'serial', '', '', '', '',
1254 'gateway_module', 'varchar', '', $char_d, '', '',
1255 'gateway_username', 'varchar', 'NULL', $char_d, '', '',
1256 'gateway_password', 'varchar', 'NULL', $char_d, '', '',
1257 'gateway_action', 'varchar', 'NULL', $char_d, '', '',
1258 'disabled', 'char', 'NULL', 1, '', '',
1260 'primary_key' => 'gatewaynum',
1262 'index' => [ [ 'disabled' ] ],
1265 'payment_gateway_option' => {
1267 'optionnum', 'serial', '', '', '', '',
1268 'gatewaynum', 'int', '', '', '', '',
1269 'optionname', 'varchar', '', $char_d, '', '',
1270 'optionvalue', 'text', 'NULL', '', '', '',
1272 'primary_key' => 'optionnum',
1274 'index' => [ [ 'gatewaynum' ], [ 'optionname' ] ],
1277 'agent_payment_gateway' => {
1279 'agentgatewaynum', 'serial', '', '', '', '',
1280 'agentnum', 'int', '', '', '', '',
1281 'gatewaynum', 'int', '', '', '', '',
1282 'cardtype', 'varchar', 'NULL', $char_d, '', '',
1283 'taxclass', 'varchar', 'NULL', $char_d, '', '',
1285 'primary_key' => 'agentgatewaynum',
1287 'index' => [ [ 'agentnum', 'cardtype' ], ],
1292 'bannum', 'serial', '', '', '', '',
1293 'payby', 'char', '', 4, '', '',
1294 'payinfo', 'varchar', '', 128, '', '', #say, a 512-big digest _hex encoded
1295 #'paymask', 'varchar', 'NULL', $char_d, '', ''
1296 '_date', @date_type, '', '',
1297 'otaker', 'varchar', '', 32, '', '',
1298 'reason', 'varchar', 'NULL', $char_d, '', '',
1300 'primary_key' => 'bannum',
1301 'unique' => [ [ 'payby', 'payinfo' ] ],
1305 'cancel_reason' => {
1307 'reasonnum', 'serial', '', '', '', '',
1308 'reason', 'varchar', '', $char_d, '', '',
1309 'disabled', 'char', 'NULL', 1, '', '',
1311 'primary_key' => 'reasonnum',
1313 'index' => [ [ 'disabled' ] ],
1318 'classnum', 'serial', '', '', '', '',
1319 'classname', 'varchar', '', $char_d, '', '',
1321 'primary_key' => 'classnum',
1328 # qw( name type null length default local );
1334 'acctid', 'bigserial', '', '', '', '',
1335 'calldate', 'TIMESTAMP with time zone', '', '', \'now()', '',
1336 'clid', 'varchar', '', $char_d, \"''", '',
1337 'src', 'varchar', '', $char_d, \"''", '',
1338 'dst', 'varchar', '', $char_d, \"''", '',
1339 'dcontext', 'varchar', '', $char_d, \"''", '',
1340 'channel', 'varchar', '', $char_d, \"''", '',
1341 'dstchannel', 'varchar', '', $char_d, \"''", '',
1342 'lastapp', 'varchar', '', $char_d, \"''", '',
1343 'lastdata', 'varchar', '', $char_d, \"''", '',
1345 #these don't seem to be logged by most of the SQL cdr_* modules
1346 #except tds under sql-illegal names, so;
1347 # ... don't rely on them for rating?
1348 # and, what they hey, i went ahead and changed the names and data types
1349 # to freeside-style dates...
1350 #'start', 'timestamp', 'NULL', '', '', '',
1351 #'answer', 'timestamp', 'NULL', '', '', '',
1352 #'end', 'timestamp', 'NULL', '', '', '',
1353 'startdate', @date_type, '', '',
1354 'answerdate', @date_type, '', '',
1355 'enddate', @date_type, '', '',
1358 'duration', 'int', '', '', 0, '',
1359 'billsec', 'int', '', '', 0, '',
1360 'disposition', 'varchar', '', 45, \"''", '',
1361 'amaflags', 'int', '', '', 0, '',
1362 'accountcode', 'varchar', '', 20, \"''", '',
1363 'uniqueid', 'varchar', '', 32, \"''", '',
1364 'userfield', 'varchar', '', 255, \"''", '',
1367 # fields for unitel/RSLCOM/convergent that don't map well to asterisk
1371 #cdr_type: Usage = 1, S&E = 7, OC&C = 8
1372 'cdrtypenum', 'int', 'NULL', '', '', '',
1374 'charged_party', 'varchar', 'NULL', $char_d, '', '',
1376 'upstream_currency', 'char', 'NULL', 3, '', '',
1377 'upstream_price', 'decimal', 'NULL', '10,2', '', '',
1378 'upstream_rateplanid', 'int', 'NULL', '', '', '', #?
1380 # how it was rated internally...
1381 'ratedetailnum', 'int', 'NULL', '', '', '',
1382 'rated_price', 'decimal', 'NULL', '10,2', '', '',
1384 'distance', 'decimal', 'NULL', '', '', '',
1385 'islocal', 'int', 'NULL', '', '', '', # '', '', 0, '' instead?
1387 #cdr_calltype: the big list in appendix 2
1388 'calltypenum', 'int', 'NULL', '', '', '',
1390 'description', 'varchar', 'NULL', $char_d, '', '',
1391 'quantity', 'int', 'NULL', '', '', '',
1393 #cdr_carrier: Telstra =1, Optus = 2, RSL COM = 3
1394 'carrierid', 'int', 'NULL', '', '', '',
1396 'upstream_rateid', 'int', 'NULL', '', '', '',
1399 #and now for our own fields
1402 # a svcnum... right..?
1403 'svcnum', 'int', 'NULL', '', '', '',
1405 #NULL, done (or something)
1406 'freesidestatus', 'varchar', 'NULL', 32, '', '',
1409 'primary_key' => 'acctid',
1411 'index' => [ [ 'calldate' ], [ 'dst' ], [ 'accountcode' ], [ 'freesidestatus' ] ],
1416 'calltypenum', 'serial', '', '', '', '',
1417 'calltypename', 'varchar', '', $char_d, '', '',
1419 'primary_key' => 'calltypenum',
1426 'cdrtypenum' => 'serial', '', '', '', '',
1427 'cdrtypename' => 'varchar', '', '', '', '',
1429 'primary_key' => 'cdrtypenum',
1436 'carrierid' => 'serial', '', '', '', '',
1437 'carriername' => 'varchar', '', '', '', '',
1439 'primary_key' => 'carrierid',
1444 #map upstream rateid to ours...
1445 'cdr_upstream_rate' => {
1447 'upstreamratenum', 'serial', '', '', '', '',
1448 'upstream_rateid', 'varchar', '', $char_d, '', '',
1449 'ratedetailnum', 'int', 'NULL', '', '', '',
1451 'primary_key' => 'upstreamratenum', #XXX need a primary key
1452 'unique' => [ [ 'upstream_rateid' ] ], #unless we add another field, yeah
1456 'inventory_item' => {
1458 'itemnum', 'serial', '', '', '', '',
1459 'classnum', 'int', '', '', '', '',
1460 'item', 'varchar', '', $char_d, '', '',
1461 'svcnum', 'int', 'NULL', '', '', '',
1463 'primary_key' => 'itemnum',
1464 'unique' => [ [ 'classnum', 'item' ] ],
1465 'index' => [ [ 'classnum' ], [ 'svcnum' ] ],
1468 'inventory_class' => {
1470 'classnum', 'serial', '', '', '', '',
1471 'classname', 'varchar', '', $char_d, '', '',
1473 'primary_key' => 'classnum',
1480 'usernum', 'serial', '', '', '', '',
1481 'username', 'varchar', '', $char_d, '', '',
1482 '_password', 'varchar', '', $char_d, '', '',
1483 'last', 'varchar', '', $char_d, '', '',
1484 'first', 'varchar', '', $char_d, '', '',
1485 'disabled', 'char', 'NULL', 1, '', '',
1487 'primary_key' => 'usernum',
1488 'unique' => [ [ 'username' ] ],
1492 'access_user_pref' => {
1494 'prefnum', 'serial', '', '', '', '',
1495 'usernum', 'int', '', '', '', '',
1496 'prefname', 'varchar', '', $char_d, '', '',
1497 'prefvalue', 'text', 'NULL', '', '', '',
1499 'primary_key' => 'prefnum',
1501 'index' => [ [ 'usernum' ] ],
1506 'groupnum', 'serial', '', '', '', '',
1507 'groupname', 'varchar', '', $char_d, '', '',
1509 'primary_key' => 'groupnum',
1510 'unique' => [ [ 'groupname' ] ],
1514 'access_usergroup' => {
1516 'usergroupnum', 'serial', '', '', '', '',
1517 'usernum', 'int', '', '', '', '',
1518 'groupnum', 'int', '', '', '', '',
1520 'primary_key' => 'usergroupnum',
1521 'unique' => [ [ 'usernum', 'groupnum' ] ],
1522 'index' => [ [ 'usernum' ] ],
1525 'access_groupagent' => {
1527 'groupagentnum', 'serial', '', '', '', '',
1528 'groupnum', 'int', '', '', '', '',
1529 'agentnum', 'int', '', '', '', '',
1531 'primary_key' => 'groupagentnum',
1532 'unique' => [ [ 'groupnum', 'agentnum' ] ],
1533 'index' => [ [ 'groupnum' ] ],
1538 'rightnum', 'serial', '', '', '', '',
1539 'righttype', 'varchar', '', $char_d, '', '',
1540 'rightobjnum', 'int', '', '', '', '',
1541 'rightname', 'varchar', '', '', '', '',
1543 'primary_key' => 'rightnum',
1544 'unique' => [ [ 'righttype', 'rightobjnum', 'rightname' ] ],
1550 'svcnum', 'int', '', '', '', '',
1551 'countrycode', 'varchar', '', 3, '', '',
1552 'phonenum', 'varchar', '', 15, '', '', #12 ?
1553 'pin', 'varchar', 'NULL', $char_d, '', '',
1555 'primary_key' => 'svcnum',
1557 'index' => [ [ 'countrycode', 'phonenum' ] ],
1564 # 'num', 'serial', '', '', '', '',
1566 # 'primary_key' => 'num',