https://github.com/katmore/clientcal
Scheduling, job, crew, and customer management web application for construction companies.
https://github.com/katmore/clientcal
calendar construction-company crew mysql php scheduling
Last synced: 2 months ago
JSON representation
Scheduling, job, crew, and customer management web application for construction companies.
- Host: GitHub
- URL: https://github.com/katmore/clientcal
- Owner: katmore
- License: mit
- Created: 2016-11-12T03:07:11.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-09-15T20:19:53.000Z (over 1 year ago)
- Last Synced: 2025-03-27T09:46:11.271Z (3 months ago)
- Topics: calendar, construction-company, crew, mysql, php, scheduling
- Language: PHP
- Homepage:
- Size: 512 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ClientCal
Scheduling, job, crew, and customer management web application for construction companies.
* Homepage: https://katmore.github.io/clientcal
* Download: [.zip file](https://github.com/katmore/clientcal/zipball/latest-release), [.tar.gz](https://github.com/katmore/clientcal/tarball/latest-release)
## Description
ClientCal is a PHP+MySQL based project initially released in 2006 to facilitate the management of customer info, job scheduling, job site info, and work crew scheduling for small to medium sized construction operations (SMBs). As a traditional HTML form based application it has proved to be very stable over the years. I have released this project in preparation for improvements to the UI (to make it mobile friendly) and implementing a RESTful API backend.
## Documentation
* [Installation](https://github.com/katmore/clientcal/wiki/Installation)
* [Utilities](https://github.com/katmore/clientcal/wiki/Utilities)
* [Updating](https://github.com/katmore/clientcal/wiki/Updating)
* [Docker](https://github.com/katmore/clientcal/wiki/Docker)
## Quick Start using Docker
Consult the [Docker](https://github.com/katmore/clientcal/wiki/Docker) page of the [ClientCal wiki](https://github.com/katmore/clientcal/wiki) for more information regarding usage with Docker.
* Prerequisites:
* a copy of the ClientCal source (i.e...)
```sh
git clone [email protected]:katmore/clientcal.git
```
* a recent version of [*docker*](https://www.docker.com/community-edition)
* a recent version of [*docker-compose*](https://docs.docker.com/compose/)
* Start containers and configure ClientCal
```sh
$ cd docker/compose/clientcal
$ docker-compose build
$ docker-compose start
$ docker-compose exec php-fpm /var/www/clientcal/bin/web-user.php add
```
* That's it! Ready to view in browser at: http://localhost:8080
## Quick Start without Docker
Consult the [Installation](https://github.com/katmore/clientcal/wiki/Installation) page of the [ClientCal wiki](https://github.com/katmore/clientcal/wiki) for more detailed instructions.
* Prerequisites:
* a copy of the ClientCal source (i.e...)
```sh
git clone [email protected]:katmore/clientcal.git
```
* PHP 7.2
* a recent version of [*composer*](https://getcomposer.org/)
* a web server provisioned with a "Document Root" pointing to the ClientCal web root ([clientcal/web](/web))
* a recent version of MySQL provisioned an empty database and a user with access to that database
* Configure ClientCal
```sh
composer update
```
```sh
php bin/config-update.php
```
```sh
php bin/db-update.php
```
```sh
php bin/web-user.php add my_user
```
* All done! Ready to view in a browser using your web server's URL.
## Screenshots
See the [Screenshots](https://katmore.github.io/clientcal/#screenshots) section of the [ClientCal homepage](https://katmore.github.io/clientcal/#screenshots).
## Related Resources
* Github: https://github.com/katmore/clientcal
* Packagist: https://packagist.org/packages/katmore/clientcal
* Latest release: https://github.com/katmore/clientcal/releases/latest
* Documentation: https://github.com/katmore/clientcal/wiki
* Support/Bugs: https://github.com/katmore/clientcal/issues
## Legal
ClientCal is distributed under the terms and conditions of the MIT license (see [LICENSE](/LICENSE)), or the terms and conditions of the GPLv3 license (see [GPLv3](/GPLv3)).
Copyright (c) 2006-2023, Paul Douglas Bird II.
All rights reserved.