X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=blobdiff_plain;f=httemplate%2Fdocs%2Fschema.html;h=b38031777be97df9eeb76a9a8655297a447e1f2d;hp=f68b9d257046de99c4945847bdd286e042ce6257;hb=4594b30617c2759dc38a51a1ea23a336abbeb24a;hpb=51984ac3d3da3006809c6866fdecd4ad83610731 diff --git a/httemplate/docs/schema.html b/httemplate/docs/schema.html index f68b9d257..b38031777 100644 --- a/httemplate/docs/schema.html +++ b/httemplate/docs/schema.html @@ -3,29 +3,56 @@

Schema reference

+ Schema diagram: as a giant .png or dia source (dia homepage).

agent - Agents are resellers of your service. Agents may be limited to a subset of your full offerings (via their agent type). +
agent - Agents are resellers of your service. Agents may be limited to a subset of your full offerings (via their agent type).
- agentnum - primary key
- agent - name of this agent
- typenum - agent type
- prog - (unimplemented)
- freq - (unimplemented) +
- disabled - Disabled flag, empty or 'Y' +
- username - Username for the Agent interface +
- _password - Password for the Agent interface
-
agent_type - Agent types define groups of packages that you can then assign to particular agents. +
agent_type - Agent types define groups of packages that you can then assign to particular agents.
- typenum - primary key
- atype - name of this agent type
-
cust_bill - Invoices. Declarations that a customer owes you money. The specific charges are itemized in cust_bill_pkg. +
cust_bill - Invoices. Declarations that a customer owes you money. The specific charges are itemized in cust_bill_pkg.
- invnum - primary key
- custnum - customer
- _date
- charged - amount of this invoice
- printed - how many times this invoice has been printed automatically +
- closed - books closed flag, empty or `Y'
-
cust_bill_pkg - Invoice line items +
cust_bill_event - Invoice event history +
- eventnum - primary key +
- invnum - invoice +
- eventpart - event definition +
- _date +
- status +
- statustext +
+
part_bill_event - Invoice event definitions +
- eventpart - primary key +
- payby - CARD, DCRD, CHEK, DCHK, LECB, BILL, or COMP +
- event - event name +
- eventcode - event action +
- seconds - how long after the invoice date (cust_bill._date) events of this type are triggered +
- weight - ordering for events with identical seconds +
- plan - eventcode plan +
- plandata - additional plan data +
- disabled - Disabled flag, empty or `Y' +
- taxclass - Texas tax class flag, empty or "none", "access", or "hosting" +
+
cust_bill_pkg - Invoice line items
- invnum - (multiple) key
- pkgnum - package or 0 for the special virtual sales tax package @@ -33,8 +60,16 @@
- recur - recurring fee
- sdate - starting date
- edate - ending date +
- itemdesc - Line item description (currently used only when pkgnum is 0) +
+
cust_bill_pkg_detail - Invoice line items detail +
- detailnum - primary key +
- pkgnum - +
- invnum - +
- detail - Detail description
-
cust_credit - Credits. The equivalent of a negative cust_bill record. +
cust_credit - Credits. The equivalent of a negative cust_bill record.
- crednum - primary key
- custnum - customer @@ -42,13 +77,21 @@
- _date
- otaker - order taker
- reason +
- closed - books closed flag, empty or `Y' +
+
cust_credit_bill - Credit invoice application. Links a credit to an invoice. +
- creditbillnum - primary key +
- crednum - credit being applied +
- invnum - invoice to which credit is applied +
- amount - amount applied +
- _date
-
cust_main - Customers +
cust_main - Customers
- custnum - primary key
- agentnum - agent
- refnum - referral -
- titlenum - title
- first - name
- last - name
- ss - social security number @@ -76,41 +119,66 @@
- ship_daytime
- ship_night
- ship_fax -
- payby - CARD, BILL, or COMP +
- payby - CARD, DCHK, CHEK, DCHK, LECB, BILL, or COMP
- payinfo - card number, P.O.#, or comp issuer +
- paycvv - Card Verification Value, "CVV2" (also known as CVC2 or CID), the 3 or 4 digit number on the back (or front, for American Express) of the credit card
- paydate - expiration date
- payname - billing name (name on card)
- tax - tax exempt, Y or null
- otaker - order taker +
- referral_custnum +
- comments
(columns in italics are optional) -
cust_main_invoice - Invoice destinations for email invoices. Note that a customer can have many email destinations for their invoice (either literal or via svcnum), but only one postal destination. +
cust_main_invoice - Invoice destinations for email invoices. Note that a customer can have many email destinations for their invoice (either literal or via svcnum), but only one postal destination.
- destnum - primary key
- custnum - customer
- dest - Invoice destination. Freeside supports three types of invoice delivery: send directly to a service defined in Freeside, send to an arbitrary email address, or print the invoice to a printer and have someone send it out via snail mail. Freeside determines which method to use based on the contents of the dest field. If the contents are numeric, a svcnum pointing to a valid service is expected in the field. If the contents are a string, a literal email address is expected to be in the field. If the special keyword `POST' is present, the snail mail method is used (which is the default if no cust_main_invoice records exist). Snail mail invoices get their address information from cust_main and are printed with the printer defined in the configuration files.
-
cust_main_county - Tax rates +
cust_main_county - Tax rates
- taxnum - primary key
- state
- county
- country
- tax - % rate +
- taxclass +
- exempt_amount +
- taxname - if defined, printed on invoices instead of "Tax" +
- setuptax - if 'Y', this tax does not apply to setup fees +
- recurtax - if 'Y', this tax does not apply to recurring fees +
+
cust_tax_exempt - Tax exemption record +
- exemptnum - primary key +
- taxnum - tax rate +
- year +
- month +
- amount
-
cust_pay - Payments. Money being transferred from a customer. +
cust_pay - Payments. Money being transferred from a customer.
- paynum - primary key -
- invnum - invoice +
- custnum - customer
- paid - amount
- _date -
- payby - CARD, BILL, or COMP +
- payby - CARD, CHEK, LECB, BILL, or COMP
- payinfo - card number, P.O.#, or comp issuer
- paybatch - text field for tracking card processor batches +
- closed - books closed flag, empty or `Y' +
+
cust_bill_pay - Applicaton of a payment to a specific invoice. +
- billpaynum +
- invnum - invoice +
- paynum - payment +
- amount +
- _date
-
cust_pay_batch - Pending batch +
cust_pay_batch - Pending batch
- trancode - 77 for charges +
- paybatchnum
- cardnum
- exp - card expiration
- amount @@ -126,35 +194,46 @@
- zip
- country
-
cust_pkg - Customer billing items +
cust_pkg - Customer billing items
- pkgnum - primary key
- custnum - customer
- pkgpart - Package definition
- setup - date
- bill - next bill date +
- last_bill - last bill date
- susp - (past) suspension date
- expire - (future) cancellation date
- cancel - (past) cancellation date
- otaker - order taker +
- manual_flag - If this field is set to 1, disables the automatic unsuspensiond of this package when using the unsuspendauto config file.
-
cust_refund - Refunds. The transfer of money to a customer; equivalent to a negative cust_pay record. +
cust_refund - Refunds. The transfer of money to a customer; equivalent to a negative cust_pay record.
- refundnum - primary key -
- crednum - credit +
- custnum - customer
- refund - amount
- _date -
- payby - CARD, BILL or COMP +
- payby - CARD, CHEK, LECB, BILL or COMP
- payinfo - card number, P.O.#, or comp issuer
- otaker - order taker +
- closed - books closed flag, empty or `Y' +
+
cust_credit_refund - Applicaton of a refund to a specific credit. +
- creditrefundnum - primary key +
- crednum - credit +
- refundnum - refund +
- amount +
- _date
-
cust_svc - Customer services +
cust_svc - Customer services
- svcnum - primary key
- pkgnum - package
- svcpart - Service definition
-
nas - Network Access Server (terminal server) +
nas - Network Access Server (terminal server)
- nasnum - primary key
- nas - NAS name @@ -162,53 +241,84 @@
- nasfqdn - NAS fully-qualified domain name
- last - timestamp indicating the last instant the NAS was in a known state (used by the session monitoring).
-
part_pkg - Package definitions +
part_pkg - Package definitions
- pkgpart - primary key
- pkg - package name
- comment - non-customer visable package comment -
- setup - setup fee +
- setup - setup fee expression
- freq - recurring frequency (months) -
- recur - recurring fee +
- recur - recurring fee expression +
- setuptax - Setup fee tax exempt flag, empty or `Y' +
- recurtax - Recurring fee tax exempt flag, empty or `Y' +
- plan - price plan +
- plandata - additional price plan data +
- disabled - Disabled flag, empty or `Y'
-
part_referral - Referral listing +
part_referral - Referral listing
- refnum - primary key
- referral - referral
-
part_svc - Service definitions +
part_svc - Service definitions
- svcpart - primary key
- svc - name of this service -
- svcdb - table used for this service: svc_acct, svc_acct_sm, svc_domain, svc_charge or svc_wo -
- table__field - Default or fixed value for field in table +
- svcdb - table used for this service: svc_acct, svc_forward, svc_domain, svc_charge or svc_wo +
- disabled - Disabled flag, empty or `Y' +
-
part_title - Personal titles +
part_svc_column
- titlenum - primary key -
- title - personal title (`Dr.' or `Mr.') +
- columnnum - primary key +
- svcpart - Service definition +
- columnname - column name in part_svc.svcdb table +
- columnvalue - default or fixed value for the column +
- columnflag - null, D or F
-
pkg_svc +
pkg_svc
- pkgpart - Package definition
- svcpart - Service definition
- quantity - quantity of this service that this package includes +
- primary_svc - blank or Y: primary service +
+
export_svc +
- exportsvcnum - primary key +
- svcpart - Service definition +
- exportnum - Export +
+
part_export - Export to external provisioning +
- exportnum - primary key +
- machine - Machine name +
- exporttype - Export type +
- nodomain - blank or Y: usernames are exported to this service with no domain
-
port - individual port on a nas +
part_export_option - provisioning options +
- optionnum - primary key +
- exportnum - Export +
- optionname - option name +
- optionvalue - option value +
+
port - individual port on a nas
- portnum - primary key
- ip - IP address of this port
- nasport - port number on the NAS
- nasnum - NAS
-
prepay_credit +
prepay_credit
- prepaynum - primary key
- identifier - text or numeric string used to receive this credit
- amount - amount of credit
-
session +
session
- sessionnum - primary key
- portnum - Port @@ -217,11 +327,12 @@
- logout - timestamp indicating the end of this user session. May be null, which indicates a currently open session.
-
svc_acct - Accounts +
svc_acct - Accounts
- svcnum - primary key
- username
- _password +
- sec_phrase - security phrase
- popnum - Point of Presence
- uid
- gid @@ -230,9 +341,12 @@
- shell
- quota - (unimplementd)
- slipip - IP address -
- radius_Radius_Attribute - Radius-Attribute +
- seconds +
- domsvc +
- radius_Radius_Reply_Attribute - Radius-Reply-Attribute +
- rc_Radius_Check_Attribute - Radius-Check-Attribute
-
svc_acct_pop - Points of Presence +
svc_acct_pop - Points of Presence
- popnum - primary key
- city @@ -241,19 +355,29 @@
- exch - exchange
- loc - rest of number
-
svc_acct_sm - Domain mail aliases +
part_pop_local - Local calling areas
- svcnum - primary key -
- domsvc - Domain (by svcnum) -
- domuid - Account (by uid) -
- domuser - domuser @ Domain forwards to Account +
- localnum - primary key +
- popnum - primary key +
- city +
- state +
- npa - area code +
- nxx - exchange
-
svc_domain - Domains +
svc_domain - Domains
- svcnum - primary key
- domain
-
domain_record - Domain zone detail +
svc_forward - Mail forwarding aliases +
- svcnum - primary key +
- srcsvc - svcnum of the source of this forward +
- src - literal source (username or full email address) +
- dstsvc - svcnum of the destination of this forward +
- dst - literal destination (username or full email address) +
+
domain_record - Domain zone detail
- recnum - primary key
- svcnum - Domain (by svcnum) @@ -262,16 +386,50 @@
- rectype - type for this record (A, MX, etc.)
- recdata - data for this record
-
svc_www +
svc_www
- svcnum - primary key
- recnum - host
- usersvc - account
-
type_pkgs +
type_pkgs
- typenum - agent type
- pkgpart - Package definition
+
queue - job queue +
- jobnum - primary key +
- job +
- _date +
- status +
- statustext +
- svcnum +
+
queue_arg - job arguments +
- argnum - primary key +
- jobnum - job +
- arg - argument +
+
queue_depend - job dependancies +
- dependnum - primary key +
- jobnum - source jobnum +
- depend_jobnum - dependancy jobnum +
+
radius_usergroup - Link users to RADIUS groups. +
- usergroupnum - primary key +
- svcnum - account +
- groupname +
+
msgcat - i18n message catalog +
- msgnum - primary key +
- msgcode - message code +
- locale - locale +
- msg - Message text +