update TODO
[freeside.git] / TODO
1 $Id: TODO,v 1.40 2000-01-27 00:27:50 ivan Exp $
2
3 If you are interested in helping with any of these, please join the mailing
4 list (send a blank message to ivan-freeside-subscribe@sisd.com) to avoid 
5 duplication of effort.
6
7 ---
8
9 There's no way to do this currently, though it would be pretty
10 straightforward to modify the source - specifically, the _collect_
11 subroutine in FS::cust_main.
12 >
13 On Mon, Dec 13, 1999 at 04:05:32PM -0700, Jeff Garner wrote:
14 > Freeside will e-mail my users when they are billed if they are setup as
15 > billing.
16 >
17 > When setup by credit card it does not e-mail them.  Is there a way to
18 > turn on e-mail invoices for those who are billed via credit card?  Kind
19 > of like a recipt of billing....
20
21
22 doc: http://www.softagency.co.jp/mysql/qmail.en.html
23
24 sql1992.txt standard is 18 character column names.  shoot for that, not just
25 32 (postgresql default)
26
27 Also note that (AFAIK) Freeside won't display any package that has more
28 than one service on the "Add Customer" page.  The reason for this is
29 because there's no way to dynamically alter the displayed html form
30 based on which package is selected. One possible solution would be to
31 make an additional page that's used in the signup process that would
32 display the form for each package, like a MS-style "Wizard".  The first
33 page lets you select the package, then the second page has the custom
34 form with fields for each service in that package and a save button. Of
35 course, that would require a little perl work.
36 .
37 Later,
38 Scott Cruzen <sic@boernenet.com>
39
40
41 Your suggested script with back up /usr/local/etc/freeside, but will miss
42 any database not named `freeside'.  Both of our scripts are specific to
43 MySQL.  If you're interested in contributing to Freeside, maybe you could
44 work on a script which: reads the mapsecrets configuration file and then
45 each secrets file to find out what specific database engine(s) (MySQL,
46 PostgreSQL, etc.) and database(s) need to be backed up, then does so,
47 serializing backups of the same engine, i.e. stop mysql, do all the mysql
48 backups, start mysql, stop postgresql, do all the postgresql backups,
49 start postgresql, etc.
50 > #!/bin/sh                                                                     
51 > apachectl stop                                                                
52 > mysqldump -t freeside > fs-backup.sql                                         
53 > apachectl start                                                               
54 > tar -Pzcvf fs-backup-`date +%y%m%d%H%M%S`.tgz fs-backup.sql /usr/local/etc/freeside/                                                       
55 > rm fs-backup.sql                                                              
56
57 I chose to use counters in the filesystem because there is no standard way
58 to get the value of an auto-incrementing keyfield which is common across  
59 all databases (as seen through DBI/DBD).
60 .
61 It certainly wouldn't be a bad idea to use the database-specific methods,
62 when available.
63
64 htdocs/edit/svc_acct.cgi:
65 (Does the `*HIDDEN*' show up when you are adding a new account, and 
66 specify the password, then receive an error and are returned to the form?)
67
68 more DOC:
69 Thought some of you might be interested in this:
70   
71 <ftp://ftp.minivend.com/pub> has CyberCash compatibility modules for 
72 Paymentnet <http://www.paymentnet.com> and Authorizenet 
73 <http://www.authorizenet.com> which should allow you process transactions
74 using those services as well as CyberCash.
75
76 The files are named CCLib.pm.paymentnet and CCLib.pm_authorizenet,
77 respectively, and are installed by renaming to CCLib.pm and moving to your
78 site_perl directory.  Otherwise, follow the directions for Cybercash v2 in
79 htdocs/docs/config.html
80
81 DOC:
82 fs_passwd/ is a client-server replacement for the `passwd', `chfn' and    
83 `chsh' commands that updates the Freeside database.  (so for that to be   
84 useful, you'd have to be exporting that data periodically)
85   
86 fs_radlog/ is a client-server RADIUS log parser that stuffs the data into
87 SQL.  It isn't finished, and probably won't be unless someone who I can't
88 convince to use one of the RADIUS daemons that logs to SQL directly pays  
89 me money or something.
90   
91 fs_signup/ is a client-server signup server.  i'm just finishing it up    
92 now; probably isn't on your machine yet.
93
94
95 http://www.sisd.com/freeside/list-archive/msg00812.html
96
97 package definitions should be implicit allow wrt agent types, not implicit deny
98 (with the old behavior possible via a config file)
99
100 > So is there anyway it could be setup to allow you to select a "primary
101 > service" from each package?  This service would be the one you were prompted
102 > for.  Could the signup server then be expanded to allow users to go into
103 > their package and "turn-on" the remaining non-primary services(using the
104 > primary account.)
105
106 take the GPL'ed whois proxy stuff at www.geektools.com and turn it into
107 intelligence for Net::Whois.
108
109 A web version of the fs_passwd stuff would be nifty.   
110
111 If you have Cistron authenticating directly from MySQL, you can replicate
112 in real-time instead of exporting periodically.  See 
113 <http://www.mysql.com/Manual_chapter/manual_Common_problems.html#Replication>.
114
115 these go in docs:
116 <http://www.sisd.com/freeside/list-archive/msg00546.html>, and
117 <http://www.sisd.com/freeside/list-archive/msg00554.html>
118
119 and http://www.sisd.com/freeside/list-archive/msg00423.html
120
121 > > 5: Is there anyway to get freeside to send a sysadmin a warning when a
122 > > credit card has expired?
123 No, but there should be.
124
125 Put this in the doc (quoting Mark Wells <mark@pc-intouch.com>):
126 >Of course, thanks to the sheer coolness of SQL and MyODBC, you can do
127 >whatever reports you want in basically whatever application you want.
128 >There's no need for Freeside itself to do any reports at all.
129
130 middle names and titles
131
132 On Wed, Jul 07, 1999 at 01:11:40PM -0400, Frank Nazario wrote:
133 > Playing and entering information to Freeside i encountered the following
134 > missing reports:
135
136 > View Customers by Agent
137
138 > View Pending Invoices
139
140
141 grep 'uncomment this to encrypt password immediately' site_perl/svc_acct.pm
142 Not to say that it shouldn't be a configurable option.
143
144 in site_perl/cust_main_invoice.pm (elsewhere?), error out if mydomain config file is gone
145 (at least until the idea of a default domain goes away)
146
147 FS::Record::qsearch does an eval every loop iteration (which is itself not
148 guaranteed to work across all DBD's and should be fixed).  This has got to be
149 slow.  Fix it.  (I think recent Perls might have a way to accept a variable
150 there, no eval needed?)
151
152 Could you have added /bin/sync, /sbin/shutdown, and /bin/halt to the
153 `shells' configuration file before importing, and removed them afterwords?
154 (even better if svc_acct.import did that automatically - it could just    
155 munge and restore @FS::svc_acct::shells... hmm.)
156
157 > BTW, Ivan, I am trying to verify in an additional database table that a
158 > particular user doesn't exist. This database is used to store email aliases a$
159 > additional POP boxes for our customers (kinda like AOL allows). I have toyed  
160 > with the idea of just writing the aliases to an email only svc_acct that
161 > doesn't write to the password file, but that isn't really how I want to do it.
162
163 Actually, I think that's a pretty good way to do it.  Cerkit contributed
164 support a little while back for svc_acct.pm and svc_acct.export for
165 multiple export targets.  It needs to be cleaned up and documented, which
166 I'll try to get to soon.  For this to work correctly, the svc_acct_sm
167 table should go away, along with the concept of a "default" domain.  
168
169 default setting for new packages should allow all agents to purchase them...
170 with a config file for the old behaviour
171
172 fix or replace Term::Query (Quiz::Question doesn't do what i need)
173
174 Check config file reading stuff from CPAN
175  
176 Authorizenet module from CPAN!
177
178 <http://www.math.fu-berlin.de/~leitner/mutt/faq.html> has a good y2k complience
179 statement!
180
181     I'm hoping Freeside can support arbitrailly complex pricing plans
182     because of a simple concept: all prices are perl expressions.  So if
183     you use `19.95' for example, perl evalates that to be `19.95'.  But if
184     you need to do a complex pricing scheme, you just need to write an
185     appropriate perl expression, which will most likely pull data from the
186     database to return pricing.  Some things will already log to SQL; for
187     example most RADIUS servers can or have a patch available.  Getting
188     Freeside to bill based on any sort of data then becomes a matter of
189     importing the data into the database.
190  
191     There are some issues involved with pro-rating, partial month charges,
192     that sort of thing.  Expressions will need a standard way to have the
193     applicable time/data ranges passed to them.  Also the expressions are
194     currently running under the Safe perl module, and the opmask might not
195     be right in all situations.  I'll try to spend some time working on
196     this if you are using it.
197
198 > 2. can customers view their bills on-line.                                    
199  
200 Not yet; it needs to be proxied from Freeside to a customer web server in
201 a secure way using something not completely unlike the fs_passwd,
202 fs_passwdd, fs_passwd_server trio.
203
204
205 > Lastly, if someone over pays on an invoice, the credit part does not flow
206 > over to other invoices..
207
208 The total balance flows over correctly, but individual payments don't.
209 The code you're looking for is in FS::cust_pay::insert
210
211 The question of what to do with overpayments that don't have another 
212 invoice to flow into (yet.. or possibly not) is still an open one.    The
213 legacy system Freeside replaced long ago had a separate place for this
214 (payments waiting for an invoice) for each customer, and it gave our
215 bookeeper fits.
216
217
218 option to relax username uniqueness in favor of username+domain or mail/shell
219 vs. radius to ease import for isp's with namespace problems or who buy others.
220
221 do i have to store anything for radius realms besides regular radius attributes
222 (which are handled fine now)?
223
224 warn or complain or something when invoice_from is empty (and we use it)
225
226 Right now Freeside uses the `freq' field of a package definition as a 
227 number of months.  The specific section of code you're looking for is in  
228 FS::cust_main::bill:
229         
230         #change this bit to use Date::Manip?
231         #$sdate=$cust_pkg->bill || time;
232         #$sdate=$cust_pkg->bill || $time;
233         $sdate = $cust_pkg->bill || $cust_pkg->setup || $time;
234         my ($sec,$min,$hour,$mday,$mon,$year) =
235           (localtime($sdate) )[0,1,2,3,4,5];
236         $mon += $part_pkg->getfield('freq');
237         until ( $mon < 12 ) { $mon -= 12; $year++; }
238         $cust_pkg->setfield('bill',
239           timelocal($sec,$min,$hour,$mday,$mon,$year));
240         $cust_pkg_mod_flag = 1;
241   
242 ..and when I went poking for this, looks like it tells us just what needs   
243 to be done!  Hehehe...
244
245 Date::Manip can handle cool things like "+ 1 month" (actually the current
246 case of /^(\d+)$/ would have to be added as a special case of "+ $1 
247 month") and "+ 30 days" (what you need) and even "+ 5 business days" !
248
249
250 On Wed, Apr 28, 1999 at 08:38:16PM +0000, Kristian Hoffmann wrote:
251 > I can't quite seem to figure out how this exporting works.  From what I
252 > understand, when you run svc_acct.export, it rewrites the /etc/passwd,
253 > /etc/shadow, etc. files.  Is this only for initial setups with the
254 > export hooks being in the pm's?
255  
256 You can use both, or just one method.  The configuration files control    
257 this.  One of the things in the TODO is to take out the last few things   
258 that aren't customizable wrt this and put them in config files.
259
260 http://www.daemonnews.org/199905/user-mgmt.html
261
262 Term::Query doesn't install out of the box from CPAN.  Fix it (and get it 
263 submitted upstream!), or remove requirement from bin/svc_acct.import and
264 bin/svc_acct_sm.import and take it out of the install instructions.
265
266 use this cool link to explain the Freeside API
267 ftp://cpan.nas.nasa.gov/pub/perl/CPAN/doc/FMTEYEWTK/easy_objects.html
268
269 Multiple tax rates by geographic region (county, state, and county) are   
270 supported; just choose View/Edit tax rates from the main menu.
271
272 Multiple tax rates by package are not (yet) supported.
273
274 On Wed, Jul 07, 1999 at 12:13:36PM -0400, Shaun Batterton wrote:
275 > How would you handle something like multiple tax rates and multiple   
276 > states?  For example in Connecticut, they just changed computer and/or
277 > data processing services to 3% (whatever that is), and everything else
278 > is 6%.
279
280
281 > Second, when trying to add a new user I get two types of errors; first one
282 > is when I place an e-mail address and select the "submit," Freeside
283 > complains with "Error: Unknown local account (specified literally)"
284 .  
285 You probably put a (local) email address in for email invoices.  Freeside
286 stores these as references to the database records, so (for example) they
287 follow username changes.
288 .
289 I'm guessing you put in the email address that you were creating, and got
290 that error because it didn't exist yet.  Sounds like a buglet to me.  I'll
291 try to fix that soon; in the meantime you can add the invoicing email 
292 address afterwords.
293
294 Postgres `money' time sucks rocks anyway.  I'll probably just require 6.5
295 and use the numeric types, which *finally* work right.
296 On Sat, Apr 24, 1999 at 12:52:00PM -0700, Mr. Poet wrote:
297 > Software error:
298 > Error creating cust_bill record: ERROR: parser:
299 > attribute 'charged' is of type 'money' but expression
300 > is of type 'float8' You will need to rewrite or cast 
301 > the expression ! Check updated but unbilled packages 
302 > for customer1
303 .
304 Postgres `money' time sucks rocks anyway.  I'll probably just require 6.5
305 and use the numeric types, which *finally* work right (well, according to 
306 the web site, anyway).
307 .
308 In the mean-time, this could probably be fixed with the reverse of        
309 the kludge in FS::Record::new.  This removes `$' and `,' from money fields
310 coming out of the database.  Something which fixed up the data so Postgres
311 was happy with it could go in FS::Record::_quote, for data going into the
312 database.
313
314 our data display problem might be a Freeside problem wrt not using 
315 Oracle-compatible DBI syntax (uses the return value from $sth->execute as
316 a number of rows).  Fixing this is on the TODO.
317
318 hooks for arbitrary commands out of configuration files
319 svc_acct.pm svc_acct_sm.pm etc.
320
321 Add this to a FAQ, along with doing it for middle names:
322
323
324 >  What I'm finding difficult is how to easily 
325 > customize fields.  For example, I am trying to add a "middle name" field
326 > to the Customer Edit, view, etc.  If I'm going about it right, it appears
327 > I have to edit the cust_main.cgi under edit and edit/process and the
328 > site_perl/cust_main.pm, as well as other things.  Perhaps you could shed
329 > some light on the best way of doing this.
330
331 You have the basic idea.  To implement that completely, I would:
332 - Add the new field to bin/fs-setup for new users
333 - Document the field in htdocs/docs/schema.html
334 - Document the change in a new file, htdocs/docs/upgrade4.html
335 * Run bin/dbdef-create
336 * Add the new field to edit/cust_main.cgi and edit/process/cust_main.cgi
337
338 For bonus points, I'd grep around for the various bits which use "$first 
339 $last" or "$last, $first" and replace them with a method call in cust_main.pm,
340  , like search/cust_main.cgi
341
342 document security model:
343 Don't forget about Apache usernames - since, via the mapsecrets file, each
344 user can login to the SQL database with a different username and
345 password, you can utitilize the security model of the SQL database as
346 well.  Also, each username here can point to a different configuration
347 directory where you could store user-specific configuration info.  Then   
348 you could link each username to one-to-many agents. 
349 (The web demo works using a trivial version of this.)
350
351 Yes, queue processing or the equivalent via checkpoint fields on various  
352 talbes (which you pick up via a pretty simple SELECT) would be really 
353 nice too.
354
355 default (and ordering) state/county/country config file
356 expand the
357 cust_main_county table to provide a preferred ordering, so the most common
358 entries would be at the top of the selection box.  automatically, based on
359 recent selections?
360
361 hmm... maybe svc_acct__shell should check off the legal shells list if
362 applicable?  yeah... cool.
363
364 payinfo field should me much larger than 16
365
366
367 [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.
368
369 javascript (yuck!) "are you sure?" confirmation on cancelations, etc.
370 (view/cust_pkg and view/svc_*)
371
372 get rid of time2str("%D") which formats dates in a non-y2k-safe looking fashion
373 (all the actual date handling uses UNIX timestamps and is fine)
374
375 uncomment expire in view/cust_pkg.cgi and find the expire cron from fsold
376
377 (Test this)
378 one-time/per-customer/? changes in rates and descriptions ('remembered
379 invoices'): implement by creating a new package on the fly... but it isn't 
380 associated with any agent types so it won't show up for other customers to buy.
381 (but also... make sure they go away when the customer does! - need this? :
382  one-off package edits! : need a cust_pkgs or cust_part_pkgs or something table,
383  with custnum and partpkg (like type_pkgs)
384 (what happens if you hit "custom pricing" but the pricing is already custom?)
385
386 Lay out any remaining ugly forms better.
387
388 remove "records identical" warning?  gets in the way of more important stuff.
389 or fix logic which tries to update identical records??
390 1.2 should be quiet enough that the error log is useful, hopefully.
391
392 Postgres has a maximum column length of 31 characters (but see NAMEDATALEN in
393 postgres_ext.h).  part_svc has columns like: svc_acct__radius_Attribute_flag
394 (22 characters!)  It seems that stuff over the limit is silently ignored,
395 so we get 4 characters back.  So, Radius_Attributes are max 13 characters with
396 stock Postgres.  see rfc2138 for what's affected
397 What's a good fix?  (besides recompiling postgres with NAMEDATALEN 64)
398 (mysql has a 64 character max column length.  others?)
399
400 [Mon Mar 29 06:57:56 1999] -e: Use of uninitialized value at /usr/lib/perl5/Date/Format.pm line 333.
401 (when sending mail in cust_main.pm::bill or svc_domain.pm)
402
403 look at DBIx::Recordset!  (and Tie::DBI, and...)
404
405 undefined conf/lpr gives this uninfomative error:
406 [Fri Feb 26 16:42:36 1999] bill.cgi: Can't do bidirectional pipe at
407 /usr/lib/per
408 l5/site_perl/FS/cust_main.pm line 629.
409 [Fri Feb 26 16:42:38 1999] bill.cgi: Error closing : Broken pipe at
410 /usr/lib/per
411 l5/site_perl/FS/cust_main.pm line 631.
412 So give a meaningful error!
413
414 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
415
416 i10n: Apache::Language
417
418 Apache::Session?  Other useful Apache::* ?
419
420 email invoices are only sent for the BILL payby.  If setup, should statements
421 (since they're not invoices) be sent for COMP and CARD as well?
422
423 $cgi->keywords is causing the (hard to trace) error:
424         Use of uninitialized value at (eval 5) line 5
425
426 edit/cust_main.cgi gives an uninformative error message:
427 > Can't call method "agentnum" without a package or object reference at   
428 > /usr/local/apache-ssl/htdocs/freeside/edit/cust_main.cgi line 116.
429 if there are no agents.
430
431 (is this missing on any web screens?  (easy with $cust_svc->label)
432 Add the ability for services to filter information up to the package level
433 for web screens, so you can select a particlar package based
434 on username or domain name, etc.
435
436 Allow a cancelled/suspended/active status from packages to bubble up to
437 the customer lists.  Put active, then suspended, then cancelled accounts.
438 Similar ordering on the package listing inside a single customer.
439
440 false laziness: edit/cust_main.cgi got some parts copied from edit/svc_acct.cgi
441 the web interface in general needs to be redone in a more abstract way.
442
443 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.
444
445 Portability: in FS::Record, $sth->execute does not return a number of rows for all DBD's.  see man DBI
446
447 subroutine the where clause (eventually all SQL) as OO perhaps (has anyone done this?)
448
449 add a select method to FS::Record?
450
451 one-time/per-customer/? changes in rates and descriptions ('remembered
452 invoices'): implement by creating a new package on the fly... but it isn't 
453 associated with any agent types so it won't show up for other customers to buy.
454 (but also... make sure they go away when the customer does! - need this? :
455  one-off package edits! : need a cust_pkgs or cust_part_pkgs or something table,
456  with custnum and partpkg (like type_pkgs)
457 (what happens if you hit "custom pricing" but the pricing is already custom?)
458
459 You can't delete the stuff under administration yet.  Add this,
460 _including_ making sure the thing you are deleting is not in use!
461
462 add links on view/cust_main.cgi to setup services, like view/cust_pkg.cgi
463
464 FS::cust_pkg _require_'s FS::$svc, but this won't work with %FS::UID::callback
465 loading of configuration.  (pry need same idea, but will run immediately if
466 context allows).  Looks like error is masked by 'use FS::cust_svc' which in
467 turn 'use's FS::{svc_acct, svc_acct_sm, svc_domain}' which is now explicit
468 w/comments in source
469
470 Allow a cancelled/suspended/active status from packages to bubble up to
471 the customer lists.  Put active, then suspended, then cancelled accounts.
472 Similar ordering on the package listing inside a single customer.
473
474 svc_domain.pm mail sending uses Date::Format which doesn't seem to pick up 
475 correct timezone.
476
477 view/svc_domain.cgi needs to know the domain might be unaudited (cosmetic)
478
479 remove whois_hack set to 1 for svc_domain.pm?  add all known registries and
480 whois accordingly.
481 .us domains and others!
482 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...
483
484 turn on the depriciation warnings for [e]idiot in FS::CGI. Stop using [e]idiot
485 the last places it is (htdocs/search/ htdocs/misc/ htdocs/misc/process)
486
487 (test cust_main.pm with cybercash v2 and v3, especially with the callback
488  stuff AND with mod_perl w/cybercash v2 kludge in package main)
489 (callback stuff should be eliminated by now)
490
491 bah, table/itable/*table in FS::CGI is silly.
492
493 doc Apache::AuthDBI as well
494 ..
495 Provide sample httpd.conf files.
496
497 hey look: Tie::DBI!  Check that out.  Override its commit with something that
498 does perl-side caching for ? a performance improvement and as an emulation
499 layer to plug in f.ex mysql's atomic transactions
500 ..
501 Record.pm uses does some non-portable DBI things.  MySQL and Pg seem fine.
502 Fix it anyway unless we migrate to Tie::DBI.
503
504 faq
505
506 cust_bill.pm uses '==' comparison on dates because they're currently ints
507
508 config file for allowed card types
509
510 write instructions for adding new services w/svc_Common.pm.  Get rid of all
511 places where svc_* tables are hardcoded (rename svc_acct_pop to part_pop so
512 we can do that)
513
514 test and document libapache-dbi-logger (woo!)
515
516 radius logfile parsing and perl expression check.
517
518 Fix in cust_bill BUGS: 
519 There is an off-by-one error in print_text which causes a visual error (Page 1
520 of 2 printed on some single-page invoices).
521
522 fields should be a method against a FS::Record or derived object, as well as
523 being something you can call as FS::Record::fields('tablename').  Might
524 even be able to handle both in the same routine (that would be neato).
525
526 Immediate removal of incorrectly entered check payments (can't take too
527 long to do this, or accounting is fubared).
528
529 Add code to move from one service to another (POP to SLIP/PPP, etc.).
530 This _should_ be possible by working off the rules in part_svc rather than
531 hardcoding anything in.  The rules in part_svc may need some elaboration,
532 perhaps.
533
534 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.)
535
536 (bring back from fsold, ) Generalize config-sending stuff and make more configurable.
537 Expand the HylaFAX interface (also possibly generalize for other fax
538 softwar ie .comfaxe); allow things like arbitrary faxes of sales
539 literature, specific troubleshooting documents and so on.  Maybe even
540 allow users to do this (though that might not belong in Freeside).
541 misc/sendconfig.cgi
542 misc/process/sendconfig.cgi
543 Configure fax recipients via a separate box rather than using the finger
544 name or first+last from cust_main.
545
546 move all phone number logic out of Freeside - let HylaFAX or whatever
547 handle it.
548
549 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?!
550
551 should be able to link on some field in email alias (right now you can link
552 on username or domain with a fallback to svcnum)
553
554 generalize and make configurable new invoice printing scheme in FS::cust_main::collect (past due)
555
556 deleting an svc_domain should delete all associated svc_acct_sm records.
557 same with a svc_acct.
558
559 periodic password encrypter
560
561 Automated, configurable notification, suspension and cancellation of
562 defunct accounts.
563 ...
564 expire cron job
565 ...
566 Allow for a future setup date on accounts.
567
568 sub AUTOLOAD in FS::Record should warn? die? if used with a non-existant column
569 name?
570
571 edit (not just import, export and allow default/fixed) arbitrary radius stuff
572 in svc_acct
573 edit/svc_acct.cgi and edit/process/svc_acct.cgi should deal with arbitrary radius stuff
574
575 radius import should take DEFAULT entry and put it in /var/spool/freeside/conf/radius-default ; svc_acct.export should use it (and doc)
576
577 in UI, s/State/State\/Provence/go and s/County/County\/Locality/go
578
579 what else (besides l10n) for i18n? (money!)
580
581 audit htdocs/* for things that should be libraried and things that should be
582 new methods on the objects (need to do this before implementing a new UI)
583 all the big things are done
584
585 some places we die() where we should &FS::CGI::idiot (and perhaps vice-versa).
586 Decide based on whether or not the "error" should show up in logs.
587
588 all .cgi's should use standard header/footer and idiot() subroutines.  maybe HTML:: perl modules
589 for HTML creation.  Maybe Embperl or something along those lines.  ?
590
591 When running bin/bill, Fix this (Annoying but harmless):
592 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 99, <ADDRESS> chunk 4.
593 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 102, <ADDRESS> chunk 4.
594 Use of uninitialized value at /usr/local/lib/site_perl/FS/cust_pkg.pm line 105, <ADDRESS> chunk 4.
595
596 all cgi (but internal to the isp) places where package names are listed should also have
597 comment (like agent_type)
598
599 clean up $recref and other silliness and use -> calls where possible, or
600 one other alternative.  clean up everything else.
601 should FS::Record use Tie::Hash?  That would be very clean, but where do we
602 store the other information?  Maybe you could ask any FS::Record object for a
603 tied hash?
604
605 change all file access from regular open(FILE,) stuff to OO, because of 
606 problems scoping and passing filehandles like that.
607
608 the web interface should create a new object and use it instead of a blank
609 form for new records.  the create method of svc_ objects should set defaults
610 (from part_svc).
611
612 sub check in man FS::table_name should be rewriteen.  Get rid of $recref
613 stuff.  Make sure all fields that refer to other database are checked.
614
615 Integration with signup disks (are there any free ones?  Netscape?).
616
617 One-button cancel (+refund) for lusers who can't get online.
618
619 Keep information on virtual web servers (hostname, IP, host machine,
620 directory, etc.) and export this information for importation into the ISPs
621 web farm. 
622
623 Remove requirement that the first mail alias be the catchall?  Still make
624 sure only one catchall per domain is defined in any case, of course. 
625
626 Ability to move cust_pkg records from one customer to another? (proably
627 will need to cancel the old and create a new like when we move services
628 between packages). 
629
630 Auto-increment expired cards one year, and try again?
631
632 More non-US stuff - zip codes, country codes, foreign currencies, etc.
633
634 cust_refund.{cgi.pm} need to do cards xaxtions.  (now we only have cust_credit)
635
636 Nicer set of integrated reporting possibilities, like weekly sales totals
637 by customer, package, agent, referral, etc., aging reports sorted by lots
638 of different things, and so on.
639
640 Client/server setup for users to modify their own passwords, shells, etc,
641 via passwd or secure web interface (prelminary passwd/chfn/chsh
642 replacement done).  Complicated by the fact that we don't want to allow
643 incoming connections to the machine running Freeside, so we probably need
644 to have a daemon on each external shell or web machine that is contacted
645 by the Freeside machine.  Be very very careful for both traditional
646 security issues and DoS problems. 
647
648 An extension of the above to allow users to modify selected parts of their
649 own information, order and cancel services.  A web interface for new
650 customers.
651
652 Expand domain name stuff to house all domain information.  Export
653 named.boot/named.conf (primary and secondary) and named.{domain} files.
654 Add more registries (not just InterNIC's com org net edu)
655
656 Nice postscript paper invoices, rather than current ASCII invoices.
657
658 think about race-condititions in FS::Record and derived ->check ->insert
659 and so on, uid and username checks in svc_acct, etc.
660
661 Move to rsync over ssh file exportation rather than scp.
662
663 check 'n fix the proactive password checker. (cracklib?)
664
665 refunds of "BILL" payments: generate pseudo-check.
666
667 write batch senders and batch parsers for the different credit card processors
668 people use/
669 More CC processors/methods.
670
671 you should be able to fiddle the setup date in cust_pkg. (at least initially)
672
673 delete options in administration section
674
675 write a generic batch senders and batch parsers.
676
677 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
678 type stuff from cerkit)
679 ...
680 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)
681
682 you should be able to get column types as a method against an FS::Record object
683 as well as dbdef->table($table)->column($column)->type
684
685 move to perl module for fuzzy and soundex searching.
686
687 package view needs to list extraneous services; we need to prevent the
688 creation of them so this never happens (and mark it as such in the source)
689 (the creation problem should be fixed - though they will still happen if people
690 fsck around in the data manually, so list them anyway)
691
692 add attribute dictionary to fs-setup as a menu, plus analyze users file to
693 decide automatically
694
695 Check for and report on duplicate billing accounts (cust_main, though many
696 will have a need for these so probably don't disable them outright.)
697
698 create a ->warn as well as a ->check method for all FS::table classes?
699 (see above)
700
701 something to automate making a release and updating the web demo
702
703 export a debian-style (also redhat and?) /etc/group file aswell!
704
705 svc_acct_sm.import qmail import should pull in recipientmap people too.
706
707 .pm's like svc_acct.pm which need to do time-consuming things like ssh remotely
708 should fork and do them in a child.
709
710 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.
711
712 get some of { city, county, state, zip } from the missing bits if
713 possible (where can i get the data to do this?  usps.gov?)
714
715 additional interfaces (perltk?  java?)
716
717 Put the GPL notice in all files.
718
719 integrate w/IDEA's signup server
720
721 $cust_bill->owed database field to be eliminated, replaced by a method call
722 that calculates on the fly.  make sure to grep for ->(get|set)field('owed') 
723 same for cust_credit->credited
724
725 Export quota information.
726
727 move all configuration to a central place.  maybe in blob's in the
728 database.  maybe even things like the code to execute when a username is
729 changed can be in there, so less of the distributed scripts change between
730 different sites.
731
732 Implement setup and recurring fees as Safe perl expressions rather than
733 numbers, to allow for variable-rate services.  Backwards compatibility is
734 obtained because { 43 } in perl is still 43.  :)  Define API to pass
735 starting and ending dates and any other necessary data to expression
736 (fees are currently evaluated as Safe expressions but more work needs to
737 be done to define an opmask for various needs, write examples
738 (usage-based billing, etc.) and so on).
739 ...
740 Add the ability to modify the next billing date in cust_pkg, and take
741 appropriate action.  This will allow the implementation of pro-rate/1st of
742 the month billing as well as the ability to manually fiddle with
743 anniversary dates in cust_pkg, so you can sync a customer's anniversary
744 date even if you're using anniversary billing (manually or automatically).
745 (now with above, we need to have a way to automatically pro-rate /^(\d+)$/
746 charges - anything more complicated should figure it out itself given
747 starting and ending dates [document that!])
748 ...
749 Daily Radius log parsing into database; other logfile formats?
750 ...
751 Callbacks to enforce hourly limits on accounts (suspend until the end of
752 the billing period?), for those who limit customers rather than tack on
753 extra charges.
754
755 Flag packages (part_pkg) as taxable or non/taxable as some ISPs (for
756 example) need to charge tax on equipment but not service (separate flags
757 for setup and recurring fee... or perhaps a setup_tax, setup_notax,
758 recur_tax and recur_notax fees, and possibly something more flexible if
759 there is need).
760
761 Allow for a variable number of invoices for customers who need multiple
762 copies.
763
764 Add a mail alias service with table svc_acct (not domain mail aliasing
765 which is domain with svc_acct_sm)
766
767 (bring back from fsold) Change customer comment field from its current kludge to something more
768 workable.
769
770 Better work orders with more information.  Should eventually open a ticket
771 when we have such a thing.
772 edit/svc_wo.cgi
773 edit/process/svc_wo.cgi
774 Call tracking and trouble tickets.
775
776 More accoutability for complimentary accounts: approval, expiration, term
777 (no more than x months in advance) and notification.
778 Flag particular users (or all users, for that matter) as having their
779 passwords hidden and/or locked from users of Freeside (maybe need Freeside
780 security levels first?). 
781 ...
782 Better Freeside-level configurable access, for those ISP's who have
783 employees they can't trust.  Right now you're "stuck" with setting up
784 .htaccess stuff yourself.  This should really just be integrated. 
785
786 configuration/setup should get web interface
787 ...
788 /usr/local/etc/freeside should be configurable
789 ...
790 (probably as part of some automated installation process?)
791
792 This requires some serious magic in FS::Record:
793 ok, if date_type in fs-setup is to be something besides int,
794 now we need to create wrappers
795 for them so they behave identically across RDBMS's, ie date pops out as as
796 UNIX timestamp (or an object of some sort? maybe even a blessed $obj which
797 is a string not a hashref for backwards compatibility?) and so on. (remember
798 to treat '0' as Not a Date instead of 1/1/70.
799
800 Add Freeside-level transactions for RDBMS's which don't support
801 transcations?  (Currently we assume a minimal RDBMS which has no rollback,
802 transactions or atomic updates).  Or just require a RDBMS that supports
803 rollback and/or atomic updates and get rid of the work-arounds?  The /rdb
804 interface had this kludge on top of it but is a technical dead-end in most
805 other ways, unless it can gain an SQL parser and DBD interface.
806 ...
807 if i'm really bored, find the /rdb interface in fsold and port it to NoSQL,
808 and while I'm add it add interfaces for AnyDBM_File tied hash.. hmm.  Shouldn't
809 an FS::Record have something to do with a tied hash?  But we don't want
810 performance to go gaga... maybe something with commit to help out here?
811 ...
812 Ok: FS::Record gives you a tied hash, and you get methods for commit, etc.
813
814 Better automated comparison of our CC records with processors (CyberCash,
815 at least, has not always had 100% accuracy, though recent versions are
816 much better) 
817
818 Expect or other pty based login check, where we actually connect to a
819 terminal server or shell machine and test logging in as the user (if we
820 are keeping a cleartext password for that user)  (This is something tech
821 support often needs for new customers)
822
823 Use cust_main table for pre-sales tracking as well?
824
825 Automatic commision report and check generation via freq and prog (to
826 become a Safe perl expression) fields in agent table, and possibly others.
827
828 Database and add a mailed-out date and method for disk/CD mailing, so a
829 customer can call and you can say, "sent on xx/xx/xx via {US Mail, Fedex,
830 UPS, etc}" 
831
832 Inventory tracking for physical items such as routers (for sale or
833 lease... probably doesn't make a difference in the ordering... but if you
834 cancel a router lease the inventory should come back.  hmm.)
835
836 -- Matt's wishlist ---
837
838 From matt@michweb.net Fri Feb 20 16:39:53 1998
839 Date: Thu, 19 Feb 1998 23:20:11 -0500
840 From: Matt Simerson <matt@michweb.net>
841 Reply-To: quadran-developer@netgoth.com
842 To: quadran-developer@netgoth.com
843 Subject: Re: Welcome to quadran-developer
844
845 >Whats it based on and what is it supposed to do?  I'm interested, but
846 >unfortunatly, I don't have that much time to help on the project (I'm busily
847 >working on one of my own based around MySQL and Qt right now -- don't know
848 >if it will be GPL'ed or not yet -- we'll probably just use it in house since
849 >it is designed around our system)...
850
851 That's what I set out to find, but didn't find anything on the web site.
852 I'm looking for something that will do the following:
853
854 Single point of entry for users on a secure system:
855         Creates account on user (public) systems
856                 update /etc/passwd/master.passwd file
857                 update radius database (if necessary)
858         Set up up disk quotas (although I hacked adduser to do this)
859         Option for adding user to a mailing list(s)
860         Export of new user info to customizable report (for automated entry
861 into
862                 accounting software, etc...)
863
864 Automated billing:
865         Export credit card info for batch processing and have hooks built
866                 in for other forms of electronic processing.
867         Batch-Payment (apply payments from formatted text file).
868         Customizable reports for manual entry/importing into Accounting
869 software
870         Email or laser print invoices
871         Sanity checks credit card numbers before processing (code available)
872
873 Simple method for disabling an account.
874         Arbitrary Expiration Dates (on a given day, in x days)
875         Remove from radius.
876         Changing password to '*'
877         Virtual customers disabling dns, http server, log processing, etc..
878
879 Billing for different account types:
880         Dialup monthly flat rate. Prorates for partial months.
881         Dialup monthly flat rate for x hours + hourly usage.
882         Dialup email only
883         Email only accounts
884         Virtual Web accounts - w/multiple mailboxes
885         Leased line accounts
886         Disk space used over quota.
887         Tech support minimum + hourly charges
888         Other for misc stuff (modem, RAM, etc...)
889
890 Per user definable RADIUS attributes (ties in with above)
891         Fixed IP
892         Simultaneous Use
893         IP filters (for dialup email only)
894
895 Keep logs of modem usage generated daily from radius accounting logs stored
896 on multiple radius servers.
897
898 Keep logs of disk usage generated from quota.
899
900 Method of adding virtual domains to your system:
901         Automatically grabs an IP address from a preassigned pool.
902         Creates a domain.com database file from database fields
903         Updates /etc/named.conf or /etc/named.boot and reloads named.
904         Add's virtual.com to /etc/sendmail.cw or qmail control files.
905         Edits your web servers httpd.conf file and restarts http server.
906         An optional section for adding vif's can be added if the users OS
907                 supports adding them on the fly. Otherwise it's up to the end
908                 user. Make a hook that can run a custom script that the user
909                 tweaks for his system.
910         Update or create the config file your web stats analyzer needs. I've
911                 done this for analog (free) and http-analyze. Probably
912                 should only officially support analog and let users hack
913                 it to their hearts desire.
914 I've already written scripts that do most of the virtual web stuff on my
915 system...in bash. Shouldn't be hard for a perlmeister to convert. In fact,
916 as long as all the info was stored in the database (username, domain name,
917 and ip pool) this could easily just be run as an external script that the
918 user tweaks to match his system.
919
920 We use a great accounting software (M.Y.O.B) that does all the AP, AR,
921 Payroll, Tax stuff, and most everything else we could need. It's already
922 set up for the type of checks we have, etc, etc... I just need something to
923 do the billing part. I can import/export sales and payments directly once
924 the billing part is done. You can't write accounting software as good as
925 M.Y.O.B. for $120.
926
927