https://github.com/cha87de/easycom
A web-based assistant for freelancers - for time recording and invoicing.
https://github.com/cha87de/easycom
assistant freelancer invoice invoice-pdf invoicing time-tracker
Last synced: about 2 months ago
JSON representation
A web-based assistant for freelancers - for time recording and invoicing.
- Host: GitHub
- URL: https://github.com/cha87de/easycom
- Owner: cha87de
- License: gpl-3.0
- Created: 2016-12-10T17:29:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-05-08T18:31:05.000Z (about 5 years ago)
- Last Synced: 2025-03-21T22:16:30.434Z (about 1 year ago)
- Topics: assistant, freelancer, invoice, invoice-pdf, invoicing, time-tracker
- Language: Shell
- Homepage: http://easycom.alb-tec.de
- Size: 436 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# easyCOM [](https://travis-ci.org/cha87de/easycom)
A web-based assistant for freelancers - for time recording and invoicing. The typical workflow could be:
1. create customer record
2. add working time records with hourly rate
3. one-click invoice creation on unaccounted time records
4. export invoice as pdf (via Latex template)
5. mark invoice as paid
*If this workflow fits your needs, easycom will save an incredible amount of your time.*
## Screenshots
## Technical details
easyCOM consists of a web based user interface (ui) and a server based backend,
with a REST based communication in between.
The web based ui is based on Sencha ExtJS. Currently a sim simple php backend exists testing.
The backend should be reimplemented in a more reliable and stable way.
## Setup Guide
### Use prebuild Docker image
Get easily started with docker:
```
docker pull cha87de/easycom:master
docker run -d -p 8080:80 --name easycom \
-v $(pwd)/easycom-data:/var/www/html/easycom-phpbackend/_data/ \
cha87de/easycom:master
```
### Use with any existing webserver
If you want to install easyCOM, please follow these steps:
1. Prerequisite: a php enabled Apache2 webserver with rewrite module, the texlive packages for latex compilation.
2. Download the `easycom.tgz` build archive from the releases at https://github.com/cha87de/easycom/releases
3. Extract the easycom.tgz folder into a valid document root of your webserver.
4. Open your browser and point to your webserver.
## Developers Guide
If you want to prepare and run a development environment, follow these steps:
1. Checkout this git repository, with all git submodules, via `git clone --recursive git@github.com:cha87de/easycom.git`
2. Prepare your workspace: install Sencha Command, download Sencha Ext JS, create a sencha workspace, and finally add easycom-webui to the sencha workspace. All that can be done at once by calling `./workspace-init`.
3. Write code, or do whatever you want with the source :-)
4. Run the development environment e.g. in a Docker container. If you have docker installed, simply call `./workspace-run-dev` to do this magic. Open your webbrowser and point it to http://localhost:8080/easycom/.
## Improve easyCOM!
Any help is absolutely welcome!
* Provide code input via merge request on github
* [Donate the easyCOM author to support further development](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Y4MESA6J72MDN)
Please report bugs and wishes via github issues.