Chapter 3. QUICKSTART

A quick start is what everyone wants don't they. I know when I install a new piece of open source software, I quickly jump to this section, skim through the steps, and wing it. If I can't get it to work I go back to that section, and only if I absolutely have to do I touch the real docs. So, here goes.

The first thing you probably want to do when you test out this system is to generate a PDF invoice, right? Ok, here's what you do. After installation, you'll have an "admin" account, so login with that.

  1. Create a client - the recipient of your invoice

    1. click on the "Companies" link (MAIN section)

    2. click the "add company" link

    3. fill in all the information and click "submit"

    4. follow these steps a-c to create your parent company as that is disassociated from the user you login as

  2. Create a project

    1. click on the "Projects" link (MAIN section)

    2. click "Add Project" link in the "Selected projects" section

    3. fill in the information, be sure to select the "Customer" who is the recipient, and "Billing Company" who is the owner of the project

  3. Create a person

    1. click on the "Persons" link (MAIN section)

    2. click on the "Add Person" link in the "Persons" section

    3. fill in the info and select a company

    4. default hourly rate can be changed for each project this person works on

    5. Don't jump to the project resource section yet, this person won't show up. First you have to create a user.

  4. Create a user

    1. click on the "Users" link (ADMINISTRATION section)

    2. click "Add user" under the Users section

    3. enter the login, and select the "Person" you created in step 3

  5. Add project members and tasks

    1. click "Projects" link (MAIN section)

    2. under "Selected projects" click your project name

    3. click the "Add Project Member" link

    4. select a Person from the popup and their default job category and default hourly wage will be filled in automatically! Of course if they are different for this project, you may change them.

    5. click "submit" when you're done

    6. when the popup window for "Add Project Member" closes click "Add Task" on the "Project: your-project-name" page.

    7. select the "Project member"

    8. enter the start/end date or use the popup calendar to select them. The first + last day of the month make a lot of sense here.

    9. Fill in the duration as total hours worked.

    10. enter a description of what that resource did this month

  6. Review project page

    1. click the project name under "Project information" section

    2. you'll see some changes there, and the graphs and details will include that new task you've added

  7. Create your invoice

    1. click on the "Invoices" link (FINANCE section)

    2. click "Add invoice with tasks" under "Invoices" section

    3. if these are your first invoices and tasks it won't be obvious, but at this point it's worth noting that only *unassigned* tasks which don't appear on another invoice will show up.

    4. click the "Create Invoice" link

    5. select or deselect tasks as appropriate, or add custom line items

    6. click recalculate if you've removed items

    7. when you're done, click "Create line items for associated tasks" button

    8. finally if all is ok click "Create Invoice" button

    9. note a *Notice* box may be displayed at the top if you don't select a recipient company

    10. enter a custom invoice number if necessary

    11. the resulting window will be your invoice in HTML format

    12. click "Export PDF" + select options

    13. select save-as or print from your Acrobat client