forgotten files
[freeside.git] / TODO
1 $Id: TODO,v 1.66 2001-07-30 07:13:34 ivan Exp $
2
3 If you are interested in helping with any of these, please join the
4 *development* mailing list (send a blank message to
5 ivan-freeside-devel-subscribe@sisd.com) to avoid duplication of effort.
6
7 ---
8
9 > Does Freeside currently support notification to the customer that their
10 > credit card on file is about to expire?
11 > What about notification that their
12 > credit card was declined after they sign up, say like in 5 months when it
13 > fails?
14
15
16 random templating thoughts:
17 for starters, read the "Template Syntax" section of Text::Template
18 that sums up the starting philosophy pretty well
19 > Text::Template is unsuitable because it's backwards, but don't worry about
20 +that quite yet.  everything in that section applies
21 ..
22 then ttp://forum.swarthmore.edu/epigone/modperl/frahthonbror/19990525144012.8806.qmail@plover.com
23 ..
24 then: given that as background, freside will use a simple template syntax designed
25 +to interact well with the webmonkey html editors, and will export to Mason
26 +and Apache::ASP for starters, and eventually any "right-side-out" "eval"
27 +templating system
28
29
30 make svc_acct.import complain if you try to use a local file
31
32 make the invoices configurable such that:
33 > Also, Can you change FreeSide so that it says "GST" instead of TAX?
34
35 "Andrew Wafula" <awafula2000@yahoo.co.uk>:
36 > Following my recent questions on money_char, i would like to suggest that
37 > money_char be used as well in cust_bill.cgi and cust_main.cgi so that the
38 > charges are seen in whatever money_char is used in a particular country
39 > instead of the default dollar currecny. This would make it such that the
40 > system has one monetary unit in its entirety rather than only for the
41 > invoicing part. I guess this would be something others would appreciate as
42 > well.
43
44 Things that would be nice but probably won't happen: testing with 
45 MySQL+Sleepycat, a fix for the long-RADIUS-attributes-with Pg problem,    
46 passive session monitoring with RADIUS (tailing a log file or monitoring a
47 database, as opposed to using a RADIUS with proper callbacks).
48
49 anything doing transactions in the web interface should likely move into *.pm.
50 (transactions are here woo!)
51
52 write some sample billing expressions with libcflow-perl :)
53
54 (future templating)
55 .
56 (at least) These questions need to be answered for Mason, Apache::ASP and
57 eperl.  If eperl becomes too much of a pain, I'm okay with forgetting 
58 about it - it's not well-maintained.
59 .
60 How do you interpolate a value?
61 mason: <% $value %>
62 apache-asp(don't think there is a "with-escaping-HTML" way?): <%= $value %>
63 .
64 How do you interpolate a value without escaping HTML?
65 mason: <% $value |n %>
66 apache-asp??: <%= $value %> 
67 .
68 How do you interpolate a (possibly non-stand-alone, non-interpolated) 
69 control structure?  With an inital % - for example:
70 .     
71 mason:
72         % foreach $value ( @values ) {
73         <OPTION><% $value %></OPTION>
74         % }
75 apache-asp:
76         <% foreach $value ( @values ) { %>
77         <OPTION><%= $value %></OPTION>
78         <% } %>
79 .     
80 This is one of the things I worry that the webmonkey HTML editors will not
81 like about Mason.  That and the <%INIT> and <%PERL> tags.
82
83
84 in the context of a state machine (& MySQL and Pg locking) for LDAP export:
85 .
86 Also note that Pg locks are for the duration of the transaction, so 
87 Freeside needs to start using transactions for this to happen.  
88 FS::UID::adminsuidsetup should explicitly set AutoCommit false and export
89 some functions to begin and end transactions on $FS::UID::dbh.  (Well,
90 eventually FS::UID should be an overloaded subclass of a DBI handle, but
91 we don't have to worry about that until perl threads + mod_perl + threaded
92 Apache 2.0 is stable, i.e. quite some time).
93
94 Postfix
95 also supports virtual domains in a way that's somewhat similar (but not
96 compatible with) the way sendmail does.  In the postfix world, all virtual
97 domain info is contained in one file (similar to the virtusertable), but
98 is formatted as such:
99 bar.com         virtual
100 foo@bar.com             some@other.net
101 quux@bar.com    localuser1
102 ...
103 and so on.  After the file is generated, it gets compiled into a hash db
104 using, "postmap /etc/postfix/virtual".
105
106
107 steal all the play-nice-with-cache stuff back from RT
108
109 Use this for email checking:
110 libemail-valid-perl - Check validity of Internet email addresses
111 .                                                                
112 This module determines whether an email address is well-formed, and 
113 optionally, whether a mail host exists for the domain.
114
115
116 wishlist from drenalin@ultimanet.com:
117 * delete button for customers
118 - 15th of the month billing
119 - field for customer referrals (naming who it is) and automatically crediting
120 +that account
121 - ability to edit referrals
122 - catch expired credit cards and notify via email when they are expiring
123 * show passwords
124 - set default shell to /bin/false when adding ppp account
125 - import list of POPs from Megapop (see www.ultimanet.com and click on locations
126 +from text in index page)
127
128
129 wishlist wrt projects/consulting from jivko@ijs.com:
130 >The other thing, which is the serious part, is the following: We do not
131 >offer dial-up services and that part of the system does not have to work,
132 >but we have many customer, for which we do both hosting and consulting work.
133 .
134 >The hosting can be handled by freeside fine, but in the little time I spent 
135 >on it I could not see how exactly to solve the consulting problem. What I
136 >would love to see there is a way to create 'projects' for each customer and
137 >ability to follow up on those (I mean to be able to add new comments,
138 >descriptions, progress updates etc.). You already have the feature, which
139 >allows multiple people to access the system with different access rights so
140 >it should be possible to make it keep track of who and when updated given
141 >'project' so we could have the developers access the database and update
142 >the projects they are working on.
143 .
144 Hmm.  Is this accurate:  Each project is related to a single customer, and
145 zero or more packages (billing items).  Each project has a name, due date,    
146 and zero or more log entries consisting of date, user, and a text field
147 (for "new comments, descriptions, progress updates etc." - would you like
148 anything more specific?)
149
150 In conjunction with that it looks like you need the ability to create
151 "one-off" packages on the fly for arbitrary charges.
152
153 > Additionally it would be nice to have a page, where all open projects can
154 > be listed and not only that but be able list them by date too. (Say I want
155 > to find out which projects are due today or two days from today, or which
156 > projects are running late)
157 .
158 Browse/search project by date and customer.
159 .
160 > Finally it would be real nice if the billing script could add the cost for
161 > all completed projects (or work done by the hour) to the monthly bill along   
162 > with the hosting information and using the description of the work from the
163 > 'project' table. 
164 .
165 Can you be more specific about your needs here?
166 .
167 > This is a lot of work, unless you disagree :-), and I would not expect you
168 > to do all of it - we can work on it too - but I would hope for you to lead 
169 > the effort.
170 .
171 I'm trying to get a handle on specifically what you need.
172 .
173 > Oh, and there is one more thing, but that should be simple to do. I would
174 > like to be able to give the customers access to selected information from
175 > their account. I want them to be able to monitor the progress of their
176 > projects and the status of their accounts. 
177 .
178 Ok.
179 .
180 > Does all this make sense? It must be close to what you need at your office
181 > though or at least I think so.
182 .
183 Yes, but we're small and have been tracking projects manually.
184 .
185 .
186 >You may have this already .. what I have in mind is the following. Say you
187 >have a customer for which you do hosting and some consulting (CGI, JAVA
188 >etc) At the end of the month you need to bill the customer for the hosting,
189 >35hours of Java programming and 10 hours of HTML authoring. The last two
190 >are not because the project is over but because the work was done during
191 >that month.
192 >
193 >So the way I see it, and it could be wrong, is that during the month the
194 >people who work on particular project enter their comments and time spent
195 >on the project. At the end of the month the billing script generates
196 >invoices in which besides the hosting charges there are also charges for
197 >work done during the period.
198 >
199 >Currently we do this in a very stupid way by maintaining a customer file,
200 >in which a script saves things to be invoiced. At the end of the month a
201 >script goes through these files and generates invoices with all items from
202 >the files, which have not been flagged as 'paid'. The convenience of this
203 >is that no one needs to worry about the invoices containing the items they
204 >need to contain.
205
206
207
208 first package select field in edit/cust_main.cgi isn't sticky on errors, yuck
209 (also referral isn't sticky either?  yuck)
210
211 > 1. A Web Form to the user get his account added automatically . The
212 > /etc/raddb/users and /etc/passwd would be updated automatically (these
213 > file are on the same machine Freeside is). I guess the the Add
214 > Customer
215 > page with some customization could be the work.
216 > 2. A Canceling Account Web Form available to user cancel his account   
217 > at
218 > any time he wants.
219 > 3. A Password Changing Web Form where the user could change your
220 > password by sending your username, old and new password.
221 > 4. Additional POP Accounts Creation where the user supply only his
222 > main
223 > username/password (probably provided from a PPP Account already
224 > created)
225 > and his POP username/password for this specific account.
226 (actually need something more general i guess - probably need some way to say
227 which accounts (svc_acct) can log in and make changes per customer (cust_main) )
228
229 this is awfully vauge, perhaps email for more info?  don't want to alientate
230 someone with accounting experience, but i just don't have time right now.
231 .
232 Hi Ivan,
233 .
234 Thanks for the information. It took me a little while to figure it out, but I
235 +was
236 able to create an invoice. As a lamer and an accountant, may I make a few
237 suggestions?
238 .
239 On the Customer view page:
240 1) Layout the information in the manner the invoicing process is conducted.
241     a) Customer information                                                
242     b) Package Ordering    
243     c)  Add a "Create & Edit Invoice" section - this allows auditing of  the
244 invoice     before it is processed.
245     d) then put the billing section to actually process the invoice
246     e) then put payment history information                        
247 .
248 Thanks,
249 Mark Roberts <mroberts@iopenenterprises.com>
250
251
252 new overdue code might be overzealous.  test carefully.
253
254 Port Freeside to use the modules that were abstracted from it:
255 Net::SSH, Net::SCP, DBIx::DataSource and DBIx::DBSchema, at least.
256
257 "first package" and email invoice (?) not sticky on errors in new/edit customer
258 screen.
259
260 http://www.ipmeter.com/ integration would be useful
261
262 http://tangram.sourceforge.net/
263 Tie::DBI
264
265 mmm, http://pootpoot.com/~dlowe/DBIx-Table/
266
267 The cybercash links in htdocs/docs/config.html are b0rken.
268
269 Yes.  Which is what I've been trying to tell you.  (destination user,
270 destination domainname) would be represented by the svcnum of a record in
271 svc_acct.  (In retrospect, using the uid instead of the svcnum was a bad
272 choice).  (domuser, domain name) would be part of the svc_acct_sm record,
273 as domuser and domsvc.
274
275 Upon further consideration, I'll probably eliminate the svc_acct_sm table
276 completely, and just add a field for the svcnum of a domain and the svcnum
277 of a destination mailbox to svc_acct (or perhaps a one-to-many
278 relationship - multiple svcnum(s) for multiple destination mailboxes.
279 hmm.)
280
281 > > > > Longer-term, I need to do something about the length of the             
282 > > > > column names -                                                          
283 > > > > The SQL1992 standard defines 18 character column names,                 
284 > > > > which would be a                                                        
285 > > > > reasonable goal.                                                        
286 > > >                                                                           
287 > > > Maybe the thing to do would be to separate these out to separate          
288 > > > tables.                                                                   
289 > > > then we could simply use something like id, attrib_name,                  
290 > > attrib_value                                                                
291 > > > to                                                                        
292 > > > store all of the radius values.                                           
293 > >                                                                             
294 > > Hmm, no, that's not quite right.  You don't want to store the actual        
295 > > strings in the records for each account.  Probably need a table that        
296 > > corresponds to the RADIUS dictionary file, with a list of                   
297 > > attributes and                                                              
298 > > attribute id's, then reference the attribute by id and not name.            
299 > >                                                                             
300 > > The more difficult bit is handling the service definitions                  
301 > > correctly -                                                                 
302 > > part_svc and it's effects.                                                  
303 >                                                                               
304 > Yes that could be a bit tricky. Perhaps just one "radius" field in            
305 > part_svc that held a list of id's from the radius table that applied          
306 > that particular service?                                                      
307
308 No, that wouldn't let you set defaults or fixed values for each attribute,
309 like part_svc currently does.
310  
311
312
313 hmm - if you delete an account in svc_acct somehow that a mail alias points to,
314 svc_acct_sm.export will fail.  make sure this can't be done using
315 the web interface.
316
317 Bug: during the linking process apparantly you can link too many services to 
318 a package.  *sigh*
319
320 zip code i18n is not very good :( but at least US, CA, HU, ?
321
322 ut_phonen doesn't check data length.  several
323 orthogonal cleanup projects here.  *sigh*
324
325 update the cybercash links in config.html and in the homepage.  add more explicit support for other payment types.  etc.
326
327 From "Tim Jung" <tjung@igateway.net>
328 .
329 Automatic CC Decline Notices via email
330 Block Time billing for prepaid internet cards (400 hours or whatever block
331 time of hours)
332 Trouble Ticket System with simple search function for Knowledge Base feature
333 Employee Timecards
334 Credit Card System support for Red Hat's CCVS, and other Linux credit card
335 programs
336 Contact Manager/Lead Tracking
337 Pre-Sale Quotes
338 Cisco NetFlow Account for IP traffic billing
339 VoIP and FoIP billing
340 Roaming per minute billing based on Radius Proxy support or number they
341 dialed into from Radius logs (800# etc)
342 Support for OpenSRS Domain Registration
343 Support for TUCOWS signup CDs
344
345
346 dbdef-create for postgres
347
348 pro-rating, fiddling dates
349
350 It looks like svc_acct.import doesn't deal well with comments and
351 multi-attribute lines.
352
353 ivan@rootwood:~/freeside_current$ rgrep -r domuid * | cut -d: -f1 | sort |
354 uniq
355 CVS/Base/TODO
356 TODO
357 bin/fs-setup
358 bin/svc_acct_sm.export
359 bin/svc_acct_sm.import
360 htdocs/docs/man/svc_acct_sm.txt
361 htdocs/docs/schema.html
362 htdocs/edit/CVS/Base/part_svc.cgi
363 htdocs/edit/part_svc.cgi
364 htdocs/edit/process/svc_acct_sm.cgi
365 htdocs/edit/svc_acct_sm.cgi
366 htdocs/search/svc_acct_sm.cgi
367 htdocs/view/svc_acct_sm.cgi
368 site_perl/svc_acct_sm.pm
369
370 rootwood:COMPLETEHOST/TODO
371
372 Currently, you set a value in the %FS::UID::callback hash with a coderef  
373 of the code you want to execute, but this was bad design and will shortly
374 be changed to a subroutine to which you pass your coderef to register it.
375
376 This is not a bug, it is how the system is currently designed.  After 
377 defining a new package, you need to specifically allow agent types to
378 purchase packages.  You can do this from the edit screen of the new agent
379 type.
380 .
381 It wouldn't be a bad idea to add a configuration value that makes new
382 packages available for all currently existing agent types automatically.
383 .
384 On Fri, Apr 07, 2000 at 10:50:35AM -0500, David Morton wrote:
385 > For some reason, the type_pkgs table didn't get updated when I tried to
386 > create a domain service and package...  insert into type_pkgs values   
387 > (4,1);  fixed it up so that I could actually order the package.
388
389
390 From: Chuck Cochems <zaphod@tdl.com>
391 .
392 1) automated generating of late notices.  So far the only way I know to
393 generate one is to re-invoice manually.
394
395 2) smart credit card rejection handling.  It should e-mail a note at
396 least, explainig that it did't go through, and why.
397
398 3)coment field in the main customer record.
399 .
400 4) streamlined payment entry feature. the current scheme has it fairly
401 buried.
402
403 5) queries to show al customers who owe money,and such stuff as that.
404
405
406 credits aren't counted against past invoices?  hmm.  something needs to be
407 done to "apply payment" genericly. and zero out invoices etc.
408
409 more email which should make it into a more organized TODO list:
410 .
411 I would also love to see Freeside support bandwidth billing by reading the
412 Cisco NetFlow Accounting data so we and other ISP's could automatically bill
413 co-located servers and even potentially other virtually hosted sites like
414 MUD, Palace Chat, IRC Chat, etc based on the bandwidth they use or average
415 sustained rates or whatever. I'm not much of a programmer so I don't know
416 what all this entails but I did download a NetFlow client agent/whatever for
417 Linux though.
418  .
419 It would also be nice to see Freeside be able to read Apache log files and
420 bill customers for web traffic that way as an option also. Plus an option to
421 bill for excessive disk usage without having to use quotas if you didn't
422 want to, would be a nice feature as well. So you could monitor with a script
423 or something to see how much disk space a user was using then get some
424 average and charge a certain amount for anything above some preset limit for
425 that account type. I might be able to hack something like this up, but I'm
426 not 100% sure where to start or if there is something out there that could
427 be modified or not.
428 .
429 Do you think that you will ever support the HKS CCVS (Hell's Kitchen
430 Software Credit Card Verification Software) since Red Hat bought them out
431 and is going to be including that for credit card processing when you buy
432 the professional version? What about possibly supporting the OpenCCVS which
433 is a GNU/GPL version of a credit card program? I haven't had time to comb
434 through the Freeside code to see how hard it would be to add support for
435 these as externally called programs.
436 .
437 Also any thoughts on help desk, and knowledge base stuff? Any thoughts on
438 this stuff, and how possible and what kinds of work or time frame would be
439 involved?
440 .
441 Tim Jung
442 System Admin
443 Internet Gateway Inc.
444 tjung@igateway.net
445
446
447
448            CVS via SSH (Score:1)
449            by platinum (jedgar at fxp dot org) on Thursday September 30, @07:13PM EDT (#4)
450            (User Info) http://www.fxp.org/~jedgar
451            The links above are your best bet for basic cvs server configuration. Once you have a pserver set up, you
452            may consider using cvs via ssh. All you need to do is the following: 
453
454            1) Have ssh and sshd set up on the client and server machines 
455            2) Set CVSROOT="joe@example.com:/home/ncvs" 
456            3) Set CVS_RSH="/usr/local/bin/ssh" 
457            4) Use cvs normally 
458            (Obviously, insert the proper host/paths above) 
459
460            You can also set up cvs/ssh to not need a password every time (similiar to an initial 'cvs login'): 
461
462            1) run ssh-keygen on client machine using no passphrase. 
463            2) copy/add ~/.ssh/identity.pub on the client to ~/.ssh/authorized_keys on the server 
464            (man ssh for more details) 
465
466            The main reason I mentio
467            CVS via SSH (Score:1)
468            by platinum (jedgar at fxp dot org) on Thursday September 30, @07:13PM EDT (#4)
469            (User Info) http://www.fxp.org/~jedgar
470
471
472 There's no way to do this currently, though it would be pretty
473 straightforward to modify the source - specifically, the _collect_
474 subroutine in FS::cust_main.
475 >
476 On Mon, Dec 13, 1999 at 04:05:32PM -0700, Jeff Garner wrote:
477 > Freeside will e-mail my users when they are billed if they are setup as
478 > billing.
479 >
480 > When setup by credit card it does not e-mail them.  Is there a way to
481 > turn on e-mail invoices for those who are billed via credit card?  Kind
482 > of like a recipt of billing....
483
484
485 doc: http://www.softagency.co.jp/mysql/qmail.en.html
486
487 sql1992.txt standard is 18 character column names.  shoot for that, not just
488 32 (postgresql default)
489
490 Also note that (AFAIK) Freeside won't display any package that has more
491 than one service on the "Add Customer" page.  The reason for this is
492 because there's no way to dynamically alter the displayed html form
493 based on which package is selected. One possible solution would be to
494 make an additional page that's used in the signup process that would
495 display the form for each package, like a MS-style "Wizard".  The first
496 page lets you select the package, then the second page has the custom
497 form with fields for each service in that package and a save button. Of
498 course, that would require a little perl work.
499 .
500 Later,
501 Scott Cruzen <sic@boernenet.com>
502
503
504 Your suggested script with back up /usr/local/etc/freeside, but will miss
505 any database not named `freeside'.  Both of our scripts are specific to
506 MySQL.  If you're interested in contributing to Freeside, maybe you could
507 work on a script which: reads the mapsecrets configuration file and then
508 each secrets file to find out what specific database engine(s) (MySQL,
509 PostgreSQL, etc.) and database(s) need to be backed up, then does so,
510 serializing backups of the same engine, i.e. stop mysql, do all the mysql
511 backups, start mysql, stop postgresql, do all the postgresql backups,
512 start postgresql, etc.
513 > #!/bin/sh                                                                     
514 > apachectl stop                                                                
515 > mysqldump -t freeside > fs-backup.sql                                         
516 > apachectl start                                                               
517 > tar -Pzcvf fs-backup-`date +%y%m%d%H%M%S`.tgz fs-backup.sql /usr/local/etc/freeside/                                                       
518 > rm fs-backup.sql                                                              
519
520 I chose to use counters in the filesystem because there is no standard way
521 to get the value of an auto-incrementing keyfield which is common across  
522 all databases (as seen through DBI/DBD).
523 .
524 It certainly wouldn't be a bad idea to use the database-specific methods,
525 when available.
526
527 htdocs/edit/svc_acct.cgi:
528 (Does the `*HIDDEN*' show up when you are adding a new account, and 
529 specify the password, then receive an error and are returned to the form?)
530
531 more DOC:
532 Thought some of you might be interested in this:
533   
534 <ftp://ftp.minivend.com/pub> has CyberCash compatibility modules for 
535 Paymentnet <http://www.paymentnet.com> and Authorizenet 
536 <http://www.authorizenet.com> which should allow you process transactions
537 using those services as well as CyberCash.
538
539 The files are named CCLib.pm.paymentnet and CCLib.pm_authorizenet,
540 respectively, and are installed by renaming to CCLib.pm and moving to your
541 site_perl directory.  Otherwise, follow the directions for Cybercash v2 in
542 htdocs/docs/config.html
543
544 DOC:
545 fs_passwd/ is a client-server replacement for the `passwd', `chfn' and    
546 `chsh' commands that updates the Freeside database.  (so for that to be   
547 useful, you'd have to be exporting that data periodically)
548   
549 fs_radlog/ is a client-server RADIUS log parser that stuffs the data into
550 SQL.  It isn't finished, and probably won't be unless someone who I can't
551 convince to use one of the RADIUS daemons that logs to SQL directly pays  
552 me money or something.
553   
554 fs_signup/ is a client-server signup server.  i'm just finishing it up    
555 now; probably isn't on your machine yet.
556
557
558 http://www.sisd.com/freeside/list-archive/msg00812.html
559
560 package definitions should be implicit allow wrt agent types, not implicit deny
561 (with the old behavior possible via a config file)
562
563 > So is there anyway it could be setup to allow you to select a "primary
564 > service" from each package?  This service would be the one you were prompted
565 > for.  Could the signup server then be expanded to allow users to go into
566 > their package and "turn-on" the remaining non-primary services(using the
567 > primary account.)
568
569 take the GPL'ed whois proxy stuff at www.geektools.com and turn it into
570 intelligence for Net::Whois.
571
572 A web version of the fs_passwd stuff would be nifty.   
573
574 If you have Cistron authenticating directly from MySQL, you can replicate
575 in real-time instead of exporting periodically.  See 
576 <http://www.mysql.com/Manual_chapter/manual_Common_problems.html#Replication>.
577
578 these go in docs:
579 <http://www.sisd.com/freeside/list-archive/msg00541.html> (was 546), and
580
581 and http://www.sisd.com/freeside/list-archive/msg00421.html (was 423)
582
583 > > 5: Is there anyway to get freeside to send a sysadmin a warning when a
584 > > credit card has expired?
585 No, but there should be.
586
587 Put this in the doc (quoting Mark Wells <mark@pc-intouch.com>):
588 >Of course, thanks to the sheer coolness of SQL and MyODBC, you can do
589 >whatever reports you want in basically whatever application you want.
590 >There's no need for Freeside itself to do any reports at all.
591
592 middle names and titles
593
594 On Wed, Jul 07, 1999 at 01:11:40PM -0400, Frank Nazario wrote:
595 > Playing and entering information to Freeside i encountered the following
596 > missing reports:
597
598 > View Customers by Agent
599
600 > View Pending Invoices
601
602
603 grep 'uncomment this to encrypt password immediately' site_perl/svc_acct.pm
604 Not to say that it shouldn't be a configurable option.
605
606 in site_perl/cust_main_invoice.pm (elsewhere?), error out if mydomain config file is gone
607 (at least until the idea of a default domain goes away)
608
609 FS::Record::qsearch does an eval every loop iteration (which is itself not
610 guaranteed to work across all DBD's and should be fixed).  This has got to be
611 slow.  Fix it.  (I think recent Perls might have a way to accept a variable
612 there, no eval needed?)
613
614 Could you have added /bin/sync, /sbin/shutdown, and /bin/halt to the
615 `shells' configuration file before importing, and removed them afterwords?
616 (even better if svc_acct.import did that automatically - it could just    
617 munge and restore @FS::svc_acct::shells... hmm.)
618
619 > BTW, Ivan, I am trying to verify in an additional database table that a
620 > particular user doesn't exist. This database is used to store email aliases a$
621 > additional POP boxes for our customers (kinda like AOL allows). I have toyed  
622 > with the idea of just writing the aliases to an email only svc_acct that
623 > doesn't write to the password file, but that isn't really how I want to do it.
624
625 Actually, I think that's a pretty good way to do it.  Cerkit contributed
626 support a little while back for svc_acct.pm and svc_acct.export for
627 multiple export targets.  It needs to be cleaned up and documented, which
628 I'll try to get to soon.  For this to work correctly, the svc_acct_sm
629 table should go away, along with the concept of a "default" domain.  
630
631 default setting for new packages should allow all agents to purchase them...
632 with a config file for the old behaviour
633
634 fix or replace Term::Query (Quiz::Question doesn't do what i need)
635
636 Check config file reading stuff from CPAN
637  
638 Authorizenet module from CPAN!
639
640 <http://www.math.fu-berlin.de/~leitner/mutt/faq.html> has a good y2k complience
641 statement!
642
643     I'm hoping Freeside can support arbitrailly complex pricing plans
644     because of a simple concept: all prices are perl expressions.  So if
645     you use `19.95' for example, perl evalates that to be `19.95'.  But if
646     you need to do a complex pricing scheme, you just need to write an
647     appropriate perl expression, which will most likely pull data from the
648     database to return pricing.  Some things will already log to SQL; for
649     example most RADIUS servers can or have a patch available.  Getting
650     Freeside to bill based on any sort of data then becomes a matter of
651     importing the data into the database.
652  
653     There are some issues involved with pro-rating, partial month charges,
654     that sort of thing.  Expressions will need a standard way to have the
655     applicable time/data ranges passed to them.  Also the expressions are
656     currently running under the Safe perl module, and the opmask might not
657     be right in all situations.  I'll try to spend some time working on
658     this if you are using it.
659
660 > 2. can customers view their bills on-line.                                    
661  
662 Not yet; it needs to be proxied from Freeside to a customer web server in
663 a secure way using something not completely unlike the fs_passwd,
664 fs_passwdd, fs_passwd_server trio.
665
666
667 > Lastly, if someone over pays on an invoice, the credit part does not flow
668 > over to other invoices..
669
670 The total balance flows over correctly, but individual payments don't.
671 The code you're looking for is in FS::cust_pay::insert
672
673 The question of what to do with overpayments that don't have another 
674 invoice to flow into (yet.. or possibly not) is still an open one.    The
675 legacy system Freeside replaced long ago had a separate place for this
676 (payments waiting for an invoice) for each customer, and it gave our
677 bookeeper fits.
678
679
680 option to relax username uniqueness in favor of username+domain or mail/shell
681 vs. radius to ease import for isp's with namespace problems or who buy others.
682
683 do i have to store anything for radius realms besides regular radius attributes
684 (which are handled fine now)?
685
686 warn or complain or something when invoice_from is empty (and we use it)
687
688 Right now Freeside uses the `freq' field of a package definition as a 
689 number of months.  The specific section of code you're looking for is in  
690 FS::cust_main::bill:
691         
692         #change this bit to use Date::Manip?
693         #$sdate=$cust_pkg->bill || time;
694         #$sdate=$cust_pkg->bill || $time;
695         $sdate = $cust_pkg->bill || $cust_pkg->setup || $time;
696         my ($sec,$min,$hour,$mday,$mon,$year) =
697           (localtime($sdate) )[0,1,2,3,4,5];
698         $mon += $part_pkg->getfield('freq');
699         until ( $mon < 12 ) { $mon -= 12; $year++; }
700         $cust_pkg->setfield('bill',
701           timelocal($sec,$min,$hour,$mday,$mon,$year));
702         $cust_pkg_mod_flag = 1;
703   
704 ..and when I went poking for this, looks like it tells us just what needs   
705 to be done!  Hehehe...
706
707 Date::Manip can handle cool things like "+ 1 month" (actually the current
708 case of /^(\d+)$/ would have to be added as a special case of "+ $1 
709 month") and "+ 30 days" (what you need) and even "+ 5 business days" !
710
711
712 On Wed, Apr 28, 1999 at 08:38:16PM +0000, Kristian Hoffmann wrote:
713 > I can't quite seem to figure out how this exporting works.  From what I
714 > understand, when you run svc_acct.export, it rewrites the /etc/passwd,
715 > /etc/shadow, etc. files.  Is this only for initial setups with the
716 > export hooks being in the pm's?
717  
718 You can use both, or just one method.  The configuration files control    
719 this.  One of the things in the TODO is to take out the last few things   
720 that aren't customizable wrt this and put them in config files.
721
722 http://www.daemonnews.org/199905/user-mgmt.html
723
724 Term::Query doesn't install out of the box from CPAN.  Fix it (and get it 
725 submitted upstream!), or remove requirement from bin/svc_acct.import and
726 bin/svc_acct_sm.import and take it out of the install instructions.
727
728 use this cool link to explain the Freeside API
729 ftp://cpan.nas.nasa.gov/pub/perl/CPAN/doc/FMTEYEWTK/easy_objects.html
730
731 Multiple tax rates by geographic region (county, state, and county) are   
732 supported; just choose View/Edit tax rates from the main menu.
733
734 Multiple tax rates by package are not (yet) supported.
735
736 On Wed, Jul 07, 1999 at 12:13:36PM -0400, Shaun Batterton wrote:
737 > How would you handle something like multiple tax rates and multiple   
738 > states?  For example in Connecticut, they just changed computer and/or
739 > data processing services to 3% (whatever that is), and everything else
740 > is 6%.
741
742
743 > Second, when trying to add a new user I get two types of errors; first one
744 > is when I place an e-mail address and select the "submit," Freeside
745 > complains with "Error: Unknown local account (specified literally)"
746 .  
747 You probably put a (local) email address in for email invoices.  Freeside
748 stores these as references to the database records, so (for example) they
749 follow username changes.
750 .
751 I'm guessing you put in the email address that you were creating, and got
752 that error because it didn't exist yet.  Sounds like a buglet to me.  I'll
753 try to fix that soon; in the meantime you can add the invoicing email 
754 address afterwords.
755
756 (workaround for postgres before 6.5) (unlikely to ever be implemented)
757 In the mean-time, this could probably be fixed with the reverse of        
758 the kludge in FS::Record::new.  This removes `$' and `,' from money fields
759 coming out of the database.  Something which fixed up the data so Postgres
760 was happy with it could go in FS::Record::_quote, for data going into the
761 database.
762
763 our data display problem might be a Freeside problem wrt not using 
764 Oracle-compatible DBI syntax (fixed using the return value from $sth->execute
765 as a number of rows - something else?).
766
767 hooks for arbitrary commands out of configuration files
768 svc_acct.pm svc_acct_sm.pm etc.
769
770 Add this to a FAQ, along with doing it for middle names:
771
772
773 >  What I'm finding difficult is how to easily 
774 > customize fields.  For example, I am trying to add a "middle name" field
775 > to the Customer Edit, view, etc.  If I'm going about it right, it appears
776 > I have to edit the cust_main.cgi under edit and edit/process and the
777 > site_perl/cust_main.pm, as well as other things.  Perhaps you could shed
778 > some light on the best way of doing this.
779
780 You have the basic idea.  To implement that completely, I would:
781 - Add the new field to bin/fs-setup for new users
782 - Document the field in htdocs/docs/schema.html
783 - Document the change in a new file, htdocs/docs/upgrade4.html
784 * Run bin/dbdef-create
785 * Add the new field to edit/cust_main.cgi and edit/process/cust_main.cgi
786
787 For bonus points, I'd grep around for the various bits which use "$first 
788 $last" or "$last, $first" and replace them with a method call in cust_main.pm,
789  , like search/cust_main.cgi
790
791 document security model:
792 Don't forget about Apache usernames - since, via the mapsecrets file, each
793 user can login to the SQL database with a different username and
794 password, you can utitilize the security model of the SQL database as
795 well.  Also, each username here can point to a different configuration
796 directory where you could store user-specific configuration info.  Then   
797 you could link each username to one-to-many agents. 
798 (The web demo works using a trivial version of this.)
799
800 Yes, queue processing or the equivalent via checkpoint fields on various  
801 talbes (which you pick up via a pretty simple SELECT) would be really 
802 nice too.
803
804 default (and ordering) state/county/country config file
805 expand the
806 cust_main_county table to provide a preferred ordering, so the most common
807 entries would be at the top of the selection box.  automatically, based on
808 recent selections?
809
810 hmm... maybe svc_acct__shell should check off the legal shells list if
811 applicable?  yeah... cool.
812
813 payinfo field should me much larger than 16
814
815
816 [Mon Apr 12 20:31:21 1999] [error] [Mon Apr 12 20:31:21 1999] null: Error closing true: Broken pipe at /usr/local/lib/site_perl/FS/cust_main.pm line 615.
817
818 javascript (yuck!) "are you sure?" confirmation on cancelations, etc.
819 (view/cust_pkg and view/svc_*)
820
821 get rid of time2str("%D") which formats dates in a non-y2k-safe looking fashion
822 (all the actual date handling uses UNIX timestamps and is fine)
823
824 uncomment expire in view/cust_pkg.cgi and find the expire cron from fsold
825
826 (Test this)
827 one-time/per-customer/? changes in rates and descriptions ('remembered
828 invoices'): implement by creating a new package on the fly... but it isn't 
829 associated with any agent types so it won't show up for other customers to buy.
830 (but also... make sure they go away when the customer does! - need this? :
831  one-off package edits! : need a cust_pkgs or cust_part_pkgs or something table,
832  with custnum and partpkg (like type_pkgs)
833 (what happens if you hit "custom pricing" but the pricing is already custom?)
834
835 Lay out any remaining ugly forms better.
836
837 remove "records identical" warning?  gets in the way of more important stuff.
838 or fix logic which tries to update identical records??
839 1.2 should be quiet enough that the error log is useful, hopefully.
840
841 Postgres has a maximum column length of 31 characters (but see NAMEDATALEN in
842 postgres_ext.h).  part_svc has columns like: svc_acct__radius_Attribute_flag
843 (22 characters!)  It seems that stuff over the limit is silently ignored,
844 so we get 4 characters back.  So, Radius_Attributes are max 13 characters with
845 stock Postgres.  see rfc2138 for what's affected
846 What's a good fix?  (besides recompiling postgres with NAMEDATALEN 64)
847 (mysql has a 64 character max column length.  others?)
848
849 [Mon Mar 29 06:57:56 1999] -e: Use of uninitialized value at /usr/lib/perl5/Date/Format.pm line 333.
850 (when sending mail in cust_main.pm::bill or svc_domain.pm)
851
852 look at DBIx::Recordset!  (and Tie::DBI, and...)
853
854 undefined conf/lpr gives this uninfomative error:
855 [Fri Feb 26 16:42:36 1999] bill.cgi: Can't do bidirectional pipe at
856 /usr/lib/per
857 l5/site_perl/FS/cust_main.pm line 629.
858 [Fri Feb 26 16:42:38 1999] bill.cgi: Error closing : Broken pipe at
859 /usr/lib/per
860 l5/site_perl/FS/cust_main.pm line 631.
861 So give a meaningful error!
862
863 password and slipip stuff in svc_acct.pm store need to be split into two fields or something, so the silliness in svc_acct.pm and svc_acct.export with looking at the data to decide what to do with it can be fixed
864
865 i10n: Apache::Language
866
867 Apache::Session?  Other useful Apache::* ?
868
869 email invoices are only sent for the BILL payby.  If setup, should statements
870 (since they're not invoices) be sent for COMP and CARD as well?
871
872 $cgi->keywords is causing the (hard to trace) error:
873         Use of uninitialized value at (eval 5) line 5
874
875 edit/cust_main.cgi gives an uninformative error message:
876 > Can't call method "agentnum" without a package or object reference at   
877 > /usr/local/apache-ssl/htdocs/freeside/edit/cust_main.cgi line 116.
878 if there are no agents.
879
880 (is this missing on any web screens?  (easy with $cust_svc->label)
881 Add the ability for services to filter information up to the package level
882 for web screens, so you can select a particlar package based
883 on username or domain name, etc.
884
885 Allow a cancelled/suspended/active status from packages to bubble up to
886 the customer lists.  Put active, then suspended, then cancelled accounts.
887 Similar ordering on the package listing inside a single customer.
888
889 false laziness: edit/cust_main.cgi got some parts copied from edit/svc_acct.cgi
890 the web interface in general needs to be redone in a more abstract way.
891
892 false laziness: some of search/svc_acct_sm.cgi was copied to search/svc_domain.cgi.  but web interface in general needs to be rewritten in a mucho cleaner way.
893
894 subroutine the where clause (eventually all SQL) as OO perhaps (has anyone done this?)
895
896 add a select method to FS::Record?
897
898 one-time/per-customer/? changes in rates and descriptions ('remembered
899 invoices'): implement by creating a new package on the fly... but it isn't 
900 associated with any agent types so it won't show up for other customers to buy.
901 (but also... make sure they go away when the customer does! - need this? :
902  one-off package edits! : need a cust_pkgs or cust_part_pkgs or something table,
903  with custnum and partpkg (like type_pkgs)
904 (what happens if you hit "custom pricing" but the pricing is already custom?)
905
906 You can't delete the stuff under administration yet.  Add this,
907 _including_ making sure the thing you are deleting is not in use!
908
909 add links on view/cust_main.cgi to setup services, like view/cust_pkg.cgi
910
911 FS::cust_pkg _require_'s FS::$svc, but this won't work with %FS::UID::callback
912 loading of configuration.  (pry need same idea, but will run immediately if
913 context allows).  Looks like error is masked by 'use FS::cust_svc' which in
914 turn 'use's FS::{svc_acct, svc_acct_sm, svc_domain}' which is now explicit
915 w/comments in source
916
917 Allow a cancelled/suspended/active status from packages to bubble up to
918 the customer lists.  Put active, then suspended, then cancelled accounts.
919 Similar ordering on the package listing inside a single customer.
920
921 svc_domain.pm mail sending uses Date::Format which doesn't seem to pick up 
922 correct timezone.
923
924 view/svc_domain.cgi needs to know the domain might be unaudited (cosmetic)
925
926 remove whois_hack set to 1 for svc_domain.pm?  add all known registries and
927 whois accordingly.
928 .us domains and others!
929 site_perl/svc_domain.cgi (hmm... or maybe should have a button?  or maybe svc_domain.pm should handle this) should set $whois_hack for non-internic domains, so you can add them...
930
931 turn on the depriciation warnings for [e]idiot in FS::CGI. Stop using [e]idiot
932 the last places it is (htdocs/search/ htdocs/misc/ htdocs/misc/process)
933
934 (test cust_main.pm with cybercash v2 and v3, especially with the callback
935  stuff AND with mod_perl w/cybercash v2 kludge in package main)
936 (callback stuff should be eliminated by now)
937
938 bah, table/itable/*table in FS::CGI is silly.
939
940 doc Apache::AuthDBI as well
941 ..
942 Provide sample httpd.conf files.
943
944 hey look: Tie::DBI!  Check that out.  Override its commit with something that
945 does perl-side caching for ? a performance improvement and as an emulation
946 layer to plug in f.ex mysql's atomic transactions
947 ..
948 Record.pm uses does some non-portable DBI things.  MySQL and Pg seem fine.
949 Fix it anyway unless we migrate to Tie::DBI.
950
951 faq
952
953 cust_bill.pm uses '==' comparison on dates because they're currently ints
954
955 config file for allowed card types
956
957 write instructions for adding new services w/svc_Common.pm.  Get rid of all
958 places where svc_* tables are hardcoded (rename svc_acct_pop to part_pop so
959 we can do that)
960
961 test and document libapache-dbi-logger (woo!)
962
963 radius logfile parsing and perl expression check.
964
965 Fix in cust_bill BUGS: 
966 There is an off-by-one error in print_text which causes a visual error (Page 1
967 of 2 printed on some single-page invoices).
968
969 fields should be a method against a FS::Record or derived object, as well as
970 being something you can call as FS::Record::fields('tablename').  Might
971 even be able to handle both in the same routine (that would be neato).
972
973 Immediate removal of incorrectly entered check payments (can't take too
974 long to do this, or accounting is fubared).
975
976 Add code to move from one service to another (POP to SLIP/PPP, etc.).
977 This _should_ be possible by working off the rules in part_svc rather than
978 hardcoding anything in.  The rules in part_svc may need some elaboration,
979 perhaps.
980
981 Use ut_ FS::Record methods in all derived classes (possibly some from dbdef?... eventually all from dbdef??? - but then `dbdef-create' would be impossible as there would be metadata we couldn't ask the backend for.  hmm.)
982
983 (bring back from fsold, ) Generalize config-sending stuff and make more configurable.
984 Expand the HylaFAX interface (also possibly generalize for other fax
985 softwar ie .comfaxe); allow things like arbitrary faxes of sales
986 literature, specific troubleshooting documents and so on.  Maybe even
987 allow users to do this (though that might not belong in Freeside).
988 misc/sendconfig.cgi
989 misc/process/sendconfig.cgi
990 Configure fax recipients via a separate box rather than using the finger
991 name or first+last from cust_main.
992
993 move all phone number logic out of Freeside - let HylaFAX or whatever
994 handle it.
995
996 soundex searches for customer name and company?  where are free soundex tools? (standard Text::Soundex duh) - I could have sworn I saw Text::Soundex on CPAN?!
997
998 should be able to link on some field in email alias (right now you can link
999 on username or domain with a fallback to svcnum)
1000
1001 generalize and make configurable new invoice printing scheme in FS::cust_main::collect (past due)
1002
1003 deleting an svc_domain should delete all associated svc_acct_sm records.
1004 same with a svc_acct.
1005
1006 periodic password encrypter
1007
1008 Automated, configurable notification, suspension and cancellation of
1009 defunct accounts.
1010 ...
1011 expire cron job
1012 ...
1013 Allow for a future setup date on accounts.
1014
1015 sub AUTOLOAD in FS::Record should warn? die? if used with a non-existant column
1016 name?
1017
1018 edit (not just import, export and allow default/fixed) arbitrary radius stuff
1019 in svc_acct
1020 edit/svc_acct.cgi and edit/process/svc_acct.cgi should deal with arbitrary radius stuff
1021
1022 radius import should take DEFAULT entry and put it in /var/spool/freeside/conf/radius-default ; svc_acct.export should use it (and doc)
1023
1024 in UI, s/State/State\/Provence/go and s/County/County\/Locality/go
1025
1026 what else (besides l10n) for i18n? (money!)
1027
1028 audit htdocs/* for things that should be libraried and things that should be
1029 new methods on the objects (need to do this before implementing a new UI)
1030 all the big things are done
1031
1032 some places we die() where we should &FS::CGI::idiot (and perhaps vice-versa).
1033 Decide based on whether or not the "error" should show up in logs.
1034
1035 all .cgi's should use standard header/footer and idiot() subroutines.  maybe HTML:: perl modules
1036 for HTML creation.  Maybe Embperl or something along those lines.  ?
1037
1038 When running bin/bill, Fix this (Annoying but harmless):
1039 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 99, <ADDRESS> chunk 4.
1040 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 102, <ADDRESS> chunk 4.
1041 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 105, <ADDRESS> chunk 4.
1042
1043 all cgi (but internal to the isp) places where package names are listed should also have
1044 comment (like agent_type)
1045
1046 clean up $recref and other silliness and use -> calls where possible, or
1047 one other alternative.  clean up everything else.
1048 should FS::Record use Tie::Hash?  That would be very clean, but where do we
1049 store the other information?  Maybe you could ask any FS::Record object for a
1050 tied hash?
1051
1052 change all file access from regular open(FILE,) stuff to OO, because of 
1053 problems scoping and passing filehandles like that.
1054
1055 the web interface should create a new object and use it instead of a blank
1056 form for new records.  the create method of svc_ objects should set defaults
1057 (from part_svc).
1058
1059 sub check in man FS::table_name should be rewriteen.  Get rid of $recref
1060 stuff.  Make sure all fields that refer to other database are checked.
1061
1062 Integration with signup disks (are there any free ones?  Netscape?).
1063
1064 One-button cancel (+refund) for lusers who can't get online.
1065
1066 Keep information on virtual web servers (hostname, IP, host machine,
1067 directory, etc.) and export this information for importation into the ISPs
1068 web farm. 
1069
1070 Remove requirement that the first mail alias be the catchall?  Still make
1071 sure only one catchall per domain is defined in any case, of course. 
1072
1073 Ability to move cust_pkg records from one customer to another? (proably
1074 will need to cancel the old and create a new like when we move services
1075 between packages). 
1076
1077 Auto-increment expired cards one year, and try again?
1078
1079 More non-US stuff - zip codes, country codes, foreign currencies, etc.
1080
1081 cust_refund.{cgi.pm} need to do cards xaxtions.  (now we only have cust_credit)
1082
1083 Nicer set of integrated reporting possibilities, like weekly sales totals
1084 by customer, package, agent, referral, etc., aging reports sorted by lots
1085 of different things, and so on.
1086
1087 Client/server setup for users to modify their own passwords, shells, etc,
1088 via passwd or secure web interface (prelminary passwd/chfn/chsh
1089 replacement done).  Complicated by the fact that we don't want to allow
1090 incoming connections to the machine running Freeside, so we probably need
1091 to have a daemon on each external shell or web machine that is contacted
1092 by the Freeside machine.  Be very very careful for both traditional
1093 security issues and DoS problems. 
1094
1095 An extension of the above to allow users to modify selected parts of their
1096 own information, order and cancel services.  A web interface for new
1097 customers.
1098
1099 Expand domain name stuff to house all domain information.  Export
1100 named.boot/named.conf (primary and secondary) and named.{domain} files.
1101 Add more registries (not just InterNIC's com org net edu)
1102
1103 Nice postscript paper invoices, rather than current ASCII invoices.
1104
1105 think about race-condititions in FS::Record and derived ->check ->insert
1106 and so on, uid and username checks in svc_acct, etc.
1107
1108 Move to rsync over ssh file exportation rather than scp.
1109
1110 check 'n fix the proactive password checker. (cracklib?)
1111
1112 refunds of "BILL" payments: generate pseudo-check.
1113
1114 write batch senders and batch parsers for the different credit card processors
1115 people use/
1116 More CC processors/methods.
1117
1118 you should be able to fiddle the setup date in cust_pkg. (at least initially)
1119
1120 delete options in administration section
1121
1122 write a generic batch senders and batch parsers.
1123
1124 need a way to override svc_acct export on a per-machine basis; just use config files based on machine name i suppose; document that. (no, import desync_hosts
1125 type stuff from cerkit)
1126 ...
1127 add a table with column of export services (passwd, shadow, master.passwd, .qmail file update, dns update, etc.) and rows machine groups and whether or not to export that (and any necessary parameters).  wasn't matt (vunderkid, not matt@michweb) working on this?  find him?  each machine goes in a group of its own as well as a group based on function.  add a table with only svcpart and machine group.  now, when you import from each machine, it can get its own accounts with one svcpart and universal accounts with another svcpart.  (though that does make the username duplicate checking more interesting)
1128
1129 you should be able to get column types as a method against an FS::Record object
1130 as well as dbdef->table($table)->column($column)->type
1131
1132 move to perl module for fuzzy and soundex searching.
1133
1134 package view needs to list extraneous services; we need to prevent the
1135 creation of them so this never happens (and mark it as such in the source)
1136 (the creation problem should be fixed - though they will still happen if people
1137 fsck around in the data manually, so list them anyway)
1138
1139 add attribute dictionary to fs-setup as a menu, plus analyze users file to
1140 decide automatically
1141
1142 Check for and report on duplicate billing accounts (cust_main, though many
1143 will have a need for these so probably don't disable them outright.)
1144
1145 create a ->warn as well as a ->check method for all FS::table classes?
1146 (see above)
1147
1148 something to automate making a release and updating the web demo
1149
1150 export a debian-style (also redhat and?) /etc/group file aswell!
1151
1152 svc_acct_sm.import qmail import should pull in recipientmap people too.
1153
1154 .pm's like svc_acct.pm which need to do time-consuming things like ssh remotely
1155 should fork and do them in a child.
1156
1157 i18n/l10n: take ALL messages and catalog them in english.txt or in database or something, so we can eventually go int'l.  int'l currency support would be a help aswell.
1158
1159 get some of { city, county, state, zip } from the missing bits if
1160 possible (where can i get the data to do this?  usps.gov?)
1161
1162 additional interfaces (perltk?  java?)
1163
1164 Put the GPL notice in all files.
1165
1166 integrate w/IDEA's signup server
1167
1168 $cust_bill->owed database field to be eliminated, replaced by a method call
1169 that calculates on the fly.  make sure to grep for ->(get|set)field('owed') 
1170 same for cust_credit->credited
1171
1172 Export quota information.
1173
1174 move all configuration to a central place.  maybe in blob's in the
1175 database.  maybe even things like the code to execute when a username is
1176 changed can be in there, so less of the distributed scripts change between
1177 different sites.
1178
1179 Implement setup and recurring fees as Safe perl expressions rather than
1180 numbers, to allow for variable-rate services.  Backwards compatibility is
1181 obtained because { 43 } in perl is still 43.  :)  Define API to pass
1182 starting and ending dates and any other necessary data to expression
1183 (fees are currently evaluated as Safe expressions but more work needs to
1184 be done to define an opmask for various needs, write examples
1185 (usage-based billing, etc.) and so on).
1186 ...
1187 Add the ability to modify the next billing date in cust_pkg, and take
1188 appropriate action.  This will allow the implementation of pro-rate/1st of
1189 the month billing as well as the ability to manually fiddle with
1190 anniversary dates in cust_pkg, so you can sync a customer's anniversary
1191 date even if you're using anniversary billing (manually or automatically).
1192 (now with above, we need to have a way to automatically pro-rate /^(\d+)$/
1193 charges - anything more complicated should figure it out itself given
1194 starting and ending dates [document that!])
1195 ...
1196 Daily Radius log parsing into database; other logfile formats?
1197 ...
1198 Callbacks to enforce hourly limits on accounts (suspend until the end of
1199 the billing period?), for those who limit customers rather than tack on
1200 extra charges.
1201
1202 Flag packages (part_pkg) as taxable or non/taxable as some ISPs (for
1203 example) need to charge tax on equipment but not service (separate flags
1204 for setup and recurring fee... or perhaps a setup_tax, setup_notax,
1205 recur_tax and recur_notax fees, and possibly something more flexible if
1206 there is need).
1207
1208 Allow for a variable number of invoices for customers who need multiple
1209 copies.
1210
1211 Add a mail alias service with table svc_acct (not domain mail aliasing
1212 which is domain with svc_acct_sm)
1213
1214 (bring back from fsold) Change customer comment field from its current kludge to something more
1215 workable.
1216
1217 Better work orders with more information.  Should eventually open a ticket
1218 when we have such a thing.
1219 edit/svc_wo.cgi
1220 edit/process/svc_wo.cgi
1221 Call tracking and trouble tickets.
1222
1223 More accoutability for complimentary accounts: approval, expiration, term
1224 (no more than x months in advance) and notification.
1225 Flag particular users (or all users, for that matter) as having their
1226 passwords hidden and/or locked from users of Freeside (maybe need Freeside
1227 security levels first?). 
1228 ...
1229 Better Freeside-level configurable access, for those ISP's who have
1230 employees they can't trust.  Right now you're "stuck" with setting up
1231 .htaccess stuff yourself.  This should really just be integrated. 
1232
1233 configuration/setup should get web interface
1234 ...
1235 /usr/local/etc/freeside should be configurable
1236 ...
1237 (probably as part of some automated installation process?)
1238
1239 This requires some serious magic in FS::Record:
1240 ok, if date_type in fs-setup is to be something besides int,
1241 now we need to create wrappers
1242 for them so they behave identically across RDBMS's, ie date pops out as as
1243 UNIX timestamp (or an object of some sort? maybe even a blessed $obj which
1244 is a string not a hashref for backwards compatibility?) and so on. (remember
1245 to treat '0' as Not a Date instead of 1/1/70.
1246
1247 Add Freeside-level transactions for RDBMS's which don't support
1248 transcations?  (Currently we assume a minimal RDBMS which has no rollback,
1249 transactions or atomic updates).  Or just require a RDBMS that supports
1250 rollback and/or atomic updates and get rid of the work-arounds?  The /rdb
1251 interface had this kludge on top of it but is a technical dead-end in most
1252 other ways, unless it can gain an SQL parser and DBD interface.
1253 ...
1254 if i'm really bored, find the /rdb interface in fsold and port it to NoSQL,
1255 and while I'm add it add interfaces for AnyDBM_File tied hash.. hmm.  Shouldn't
1256 an FS::Record have something to do with a tied hash?  But we don't want
1257 performance to go gaga... maybe something with commit to help out here?
1258 ...
1259 Ok: FS::Record gives you a tied hash, and you get methods for commit, etc.
1260
1261 Better automated comparison of our CC records with processors (CyberCash,
1262 at least, has not always had 100% accuracy, though recent versions are
1263 much better) 
1264
1265 Expect or other pty based login check, where we actually connect to a
1266 terminal server or shell machine and test logging in as the user (if we
1267 are keeping a cleartext password for that user)  (This is something tech
1268 support often needs for new customers)
1269
1270 Use cust_main table for pre-sales tracking as well?
1271
1272 Automatic commision report and check generation via freq and prog (to
1273 become a Safe perl expression) fields in agent table, and possibly others.
1274
1275 Database and add a mailed-out date and method for disk/CD mailing, so a
1276 customer can call and you can say, "sent on xx/xx/xx via {US Mail, Fedex,
1277 UPS, etc}" 
1278
1279 Inventory tracking for physical items such as routers (for sale or
1280 lease... probably doesn't make a difference in the ordering... but if you
1281 cancel a router lease the inventory should come back.  hmm.)
1282
1283 -- Matt's wishlist ---
1284
1285 From matt@michweb.net Fri Feb 20 16:39:53 1998
1286 Date: Thu, 19 Feb 1998 23:20:11 -0500
1287 From: Matt Simerson <matt@michweb.net>
1288 Reply-To: quadran-developer@netgoth.com
1289 To: quadran-developer@netgoth.com
1290 Subject: Re: Welcome to quadran-developer
1291
1292 >Whats it based on and what is it supposed to do?  I'm interested, but
1293 >unfortunatly, I don't have that much time to help on the project (I'm busily
1294 >working on one of my own based around MySQL and Qt right now -- don't know
1295 >if it will be GPL'ed or not yet -- we'll probably just use it in house since
1296 >it is designed around our system)...
1297
1298 That's what I set out to find, but didn't find anything on the web site.
1299 I'm looking for something that will do the following:
1300
1301 Single point of entry for users on a secure system:
1302         Creates account on user (public) systems
1303                 update /etc/passwd/master.passwd file
1304                 update radius database (if necessary)
1305         Set up up disk quotas (although I hacked adduser to do this)
1306         Option for adding user to a mailing list(s)
1307         Export of new user info to customizable report (for automated entry
1308 into
1309                 accounting software, etc...)
1310
1311 Automated billing:
1312         Export credit card info for batch processing and have hooks built
1313                 in for other forms of electronic processing.
1314         Batch-Payment (apply payments from formatted text file).
1315         Customizable reports for manual entry/importing into Accounting
1316 software
1317         Email or laser print invoices
1318         Sanity checks credit card numbers before processing (code available)
1319
1320 Simple method for disabling an account.
1321         Arbitrary Expiration Dates (on a given day, in x days)
1322         Remove from radius.
1323         Changing password to '*'
1324         Virtual customers disabling dns, http server, log processing, etc..
1325
1326 Billing for different account types:
1327         Dialup monthly flat rate. Prorates for partial months.
1328         Dialup monthly flat rate for x hours + hourly usage.
1329         Dialup email only
1330         Email only accounts
1331         Virtual Web accounts - w/multiple mailboxes
1332         Leased line accounts
1333         Disk space used over quota.
1334         Tech support minimum + hourly charges
1335         Other for misc stuff (modem, RAM, etc...)
1336
1337 Per user definable RADIUS attributes (ties in with above)
1338         Fixed IP
1339         Simultaneous Use
1340         IP filters (for dialup email only)
1341
1342 Keep logs of modem usage generated daily from radius accounting logs stored
1343 on multiple radius servers.
1344
1345 Keep logs of disk usage generated from quota.
1346
1347 Method of adding virtual domains to your system:
1348         Automatically grabs an IP address from a preassigned pool.
1349         Creates a domain.com database file from database fields
1350         Updates /etc/named.conf or /etc/named.boot and reloads named.
1351         Add's virtual.com to /etc/sendmail.cw or qmail control files.
1352         Edits your web servers httpd.conf file and restarts http server.
1353         An optional section for adding vif's can be added if the users OS
1354                 supports adding them on the fly. Otherwise it's up to the end
1355                 user. Make a hook that can run a custom script that the user
1356                 tweaks for his system.
1357         Update or create the config file your web stats analyzer needs. I've
1358                 done this for analog (free) and http-analyze. Probably
1359                 should only officially support analog and let users hack
1360                 it to their hearts desire.
1361 I've already written scripts that do most of the virtual web stuff on my
1362 system...in bash. Shouldn't be hard for a perlmeister to convert. In fact,
1363 as long as all the info was stored in the database (username, domain name,
1364 and ip pool) this could easily just be run as an external script that the
1365 user tweaks to match his system.
1366
1367 We use a great accounting software (M.Y.O.B) that does all the AP, AR,
1368 Payroll, Tax stuff, and most everything else we could need. It's already
1369 set up for the type of checks we have, etc, etc... I just need something to
1370 do the billing part. I can import/export sales and payments directly once
1371 the billing part is done. You can't write accounting software as good as
1372 M.Y.O.B. for $120.
1373
1374