GnuCash Project Goals

GnuCash (previously known as X-Accountant) is a personal finance accounting application. The project goals are to create a world-class GPL'ed Open Source personal financial application for GNU/Linux and other Unix's. The project is the result of a merger of the GnoMoney project with X-Accountant development. There are currently two versions: xacc-1.0.18, and gnucash-1.1.x. Version xacc-1.0.18 is written in Motif, and is considered to be stable/production quality. You can read more about X-Accountant at its home page http://www.cs.hmc.edu/~rclark/xacc/index.html. Versions numbered as gnucash-1.1.x are the current development versions, and are unstable. GnuCash is in active development; this page is an effort to summarize the project goals and status.

The GnuCash pages provide overview & introductory material about GnuCash, and in general present a glossier, more accessilbe format. This page is aimed at developers, not users.

We believe that a GNU GPL project should provide goals and motivations at both the large and the small scales, in order to focus and motivate the developers. Over-arching and grand goals are difficult to grasp and carry out; yet their lack serves only to dissuade the grand thinkers. A list of detailed goals may be mind-numbing to the casual reader; yet, without them, the roll-up-your-sleeves-and-do-it coder cannot know where to begin. Detailed goals lend a concreteness to the discussion: they can be architected, designed and coded at any time by coders of any ability. Thus, we present a list of goals, large and small, with the hope that the small goals will fall quickly, and the large ones shall turn into a multitude of small ones.

News

September 1998
Version 1.1.18 is begining to get stable; most things work the way they're supposed to. New features include variety of ways of viewing an account, a simple query engine, and support for multiple currencies.

April 1998
The domain "gnucash.org" has been registered; web site is up.

10 April 1998
Work on OFX support, and user-prefrences, has begun in earnest.

10 March 1998
Source is available with CVS. See instructions at bottom.

4 March 1998
The folks involved with WaterMark, GnoMoney, and X-Accountant have tentatively agreed to join forces to work on a unified personal-finance project. Subscribe to the xacc mailing list for more info.

Meta-Architecture Goals

Concrete Architectural and Development Goals

The following is a list of the larger, more abstract, and more difficult architectural goals.
Graphs, Reports
Add the whole host of reports, including Net Worth statements, Balance Sheets, and Profit & Loss statements. These should be printable: it might be best to create them as ordinary HTML pages, and use the printing abilities of the browser. In an ideal situation, the user should be able to create custom reports.

Other output format possibilities include SGML and XML. In the long run, these are preferable to HTML, since DSSSL and Jade (James DSSSL Engine can be used to convert to RTF, Postscript, etc. XML is the wave of the future.

The Report Generator should be a "dockable" subsystem of the whole. Thus, it should be possible to run the report generator in a stand-alone, read-only fashion without having to start up the main application.

Graphs, charts, etc. too ...

One hard part of reporting is designing a configurable interface, so that people can build custom reports.

Status:

Web Site Maintenance & Marketing
Put together an active, relevent web site. Mailing list archives. Screen shots. Announces on c.o.l.a, freshmeat. Put minor news items, etc. on web site news. Bug tracker. Maintain repository of co-requisite tools & packages.

Status:

OFX support
Provide the SGML DTD parsers to handle the OFX reports that many banking institutions are providing, or will soon be providing, to retail customers. See below for OFX references. OFX is an open spec from Microsoft, Intuit, & Checkfree, and will be supported by Integrion. The OFX DTD's are included in the 1.1 distributions. See OFX HomePage for details.

Status:

Budgeting
Ability to handle budgeted future transactions.

Status:

Incremental Development Goals

The following is a list of goals and "bug fixes" that should be solved immediately, independent of the major goals.
User Interface Ports
Port the package as a whole to gtk/gnome, Qt, Emacs.

Status:

Internationalization
All menus, markup and help-text should be internationalized, so that GnuCash could be usable in any country. This would include the printing of currency values in the local country conventions.

Current status:

Icons, Glitz, Icons, Glitz
A set of pretty icons and button pixmaps should be created for minimized windows, and for the various buttons. A user-configurable button-bar would be nice too. This should probably be coupled with the creation of an X resource file, which does not currently exist.

User Preferences
Create menu system & file format for manipulating user preferences. Preferences include things like showing/not showing categories, forcing double-entry, etc.

Current status:

Categories
Provide a default list of "Categories" (Income/Expense Accounts). These are categories such as "Automobile Expense", "Bank Interest Income", and "Employment Income". The user should be able to select a default set of accounts, and have those be created. To actually implement this, it might be best to simple create a file with these in them, and load that file. A mechanism should be provided to allow the user to weed-out the unwanted accounts without hampering their ability to use them at a later date, if desired.

Current status:

Recurring Transactions
Add support for automatic, recurring transactions, e.g. mortgage payments, fixed-interest bonds, bank accounts, etc. Note that the design for this could be very different, depending on whether the multi-user functions are available or not. Note also, maybe the engine needs to support two dates per transaction: expected, and actual ?? Current status:

Navigation
Menu navigation using the keyboard should be possible. Although menu mnomenics exist, they seem to be broken. Similarly, tab-key navigation should be possible. Currently, it is possible to use the tab key to navigate from field to field in the register window, to user arrow keys to navigate menus, and quick-fill to automatically complete fields. However, it is not possible to tab over to the "Commit" button. It should be.

Folder Tabs
Currently, Income/Expense accounts can be shown or hidden by selecting from a menu. It would be nice to be able to examine different account types (Asset, Liability, Income, Expense, Payables, Receivables, Inventory) by selecting a tab folder.

Fly-Over Help
When the user pauses the mouse over a button, "fly-over" pop-up help windows should appear.

Simplified Stock Ledger
Stocks and Mutual funds are handled by placing them each in their own account. Each account can be viewed individually. If all of the stock accounts are children of a master trading account, then the trading account can be viewed and modified in a General Ledger window. The current stock general ledger window is a bit obtuse, and difficult to understand and use. A simplified but still powerful ledger window is desperately needed.

Forced Double-Entry
The system supports double-entry: every transaction indicates a pair of accounts: one is debited, and one is credited. Double-entry is a powerful way of ensuring the integrity of of the financial data. Currently, while double-entry is supported, its use is not forced: the user can create dangling transactions, where only one account is indicated. Although this is acceptable for home use (even desirable, since it allows the casual user the simplicity they desire), it is not acceptable for business use. It must be possible to enable forced-double entry, so that a transaction cannot be completed until two accounts have been specified.

Current status:

emacs, vi, motif, kde, gnome Key Bindings for Text Fields
Make sure that text fields can handle the vi & emacs key bindings, so that e.g. emacs-style ctrl-a, ctrl-k does the right thing.

Bonds & Interest Bearing Instruments
Support should be added for Mortgages, Bonds, CD's and other instruments (e.g. savings accounts) that pay interest on a regular basis. It should be possible to specify the interest rate, the payment schedule, and other regularly recurring transactions.

Household Assets
Add an example showing how regular household assets (house, car, jewelry, etc.) should be treated. In particular, show how appreciation and depreciation should be treated.

Inventory, Job Costing
Add the business features needed to maintain a stock of items for sale, estimating jobs.

Payables & Receivables
Add features to track sales receipts and other pending sources of income, as well as owed sums.

Check Printing
Create a check-printing ability.

Locks
When splits are implemented, and the parent transaction has been marked as cleared, the record should be locked, so that further modifications to the amount can't be performed (or at least, a warning is generated. This prevents accidental garbaging up of old transactions.)

Grayed-out Form Help
Create grayed out entries in the ledger, titled "Memo", "Description", etc, helping users understand what should be typed into each field.

Accounting Periods
Ability to permanently lock records as non-editable. This should be straight-forward by using the "reconciled" field to hold "locked", and not allowing the GUI to edit locked records.

Quicken(TM) Export
Ability to export Quicken QIF files. Quicken import is implemented and mostly works. (Note: Quicken import worked in v 1.0, but got slightly broken in v 1.1 It no longer merges duplicate transactions when importing two or more QIF files. This should be easy to fix, as the "merge" routine is there in the code somewhere; its just not called because it was never restructured for the vv 1.1 engine.)

Transaction Window Fixes
The transaction window should allow the user to specify a share price (when purchasing/selling shares) as well as the load and/or fees associated with the purchase. Fees, of course, are handled as separate transactions: however, it should still be possible to specify the fees, the transfer, and other details from a single window.

Status: Some basic reorganization of register was done to support mixed multi-line split display. However, the actual display of such things remaions unimplemented.

Tab-delimited ASCII file format
People *like* to be able to read file contents in ASCII. There are many Unix tools for manipulating ASCII. An ASCII equivalent of the current file format should be easy to develop ... just substitute the writes with printf's. The tab-delimited format should be compatible with that of /rdb. The /rdb format is like so:
    field-name  tab  fieldname  tab fieldname   \n
    ------------------------------------------  \n
    value       tab   value     tab value       \n
    value       tab   value     tab value       \n
    etc ...
Its a very simple, very basic flat table format. It should match the SQL schemas in order to minimize I/O complexity and incompatibility.

Status

Well, just to show that we are getting things done.
Getting Source with CVS
A read-only version of the cvs tree is available on the net. To access it, first, login, as so:
     cvs -d :pserver:cvs@linas.org:/home/cvs/cvsroot login
     
The password is "guest". To get a copy of the source, do a
     cvs -d :pserver:cvs@linas.org:/home/cvs/cvsroot checkout xacc
     
Note that various versions can be accessed with tags. For example, the tag xacc-10b17 will get you version 1.0.17 and the tag xacc-11b6 will get you version 1.1.6 In particular, the latest code in the 1.0.x series (the stable series) is available on the branch xacc-10-patch. For historical record, you can view Robin Clark's original source from October 1997 at xacc-09a. Things have changed a *lot* since then.

(March 1988)

Version 1.1 Alpha
The Alpha development version 1.1 is out. Features include: (January 1998)

New Improved Web Site
We now have a spiffy web site, with good graphics and exciting text, a mailing list, mailing list archives, and a read-only CVS tree. (December 1997)

Splits
When performing a transfer, it is well-useful to allow the transfer to be "split" between several accounts. To implement a split, the best direction might be to have each transaction be a pointer to a set of splits, with each split having it's own distinct credited account, memo field and currency value. Suggestion is to leave the debited account pointer in the main transaction, and have one credited account pointer in each of the splits. Also, suggest leaving a "cleared" flag in the main transaction, *and* putting a separate cleared flag in each split as well. This allows the cleared flag to be independently set for both the debited & credited accounts.

Status: Essentially more-or-less done (July/August 1998)

Misc Bugs

Volunteers

Your name here as project contributor! This list only mentions some of the recently active developers; many, many others have contributed fixes and patches both large and small. I've tried to credit them in the README.

References


Draft version 0.25 -- October 1998
Linas Vepstas linas@linas.org