https://github.com/cityssm/shiftlog
A work management system with work order recording, shift activity logging, and timesheet tracking.
https://github.com/cityssm/shiftlog
employee-management equipment-management it-helpdesk open-government public-works shift-management timesheet-management work-management work-orders
Last synced: about 1 month ago
JSON representation
A work management system with work order recording, shift activity logging, and timesheet tracking.
- Host: GitHub
- URL: https://github.com/cityssm/shiftlog
- Owner: cityssm
- License: mit
- Created: 2025-11-12T13:46:50.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-08T15:04:11.000Z (about 1 month ago)
- Last Synced: 2026-05-08T15:35:32.360Z (about 1 month ago)
- Topics: employee-management, equipment-management, it-helpdesk, open-government, public-works, shift-management, timesheet-management, work-management, work-orders
- Language: TypeScript
- Homepage: https://cityssm.github.io/shiftlog/
- Size: 7.79 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ShiftLog
[](https://app.deepsource.com/gh/cityssm/shiftlog/)
[](https://codecov.io/gh/cityssm/shiftlog)
[](https://cloud.cypress.io/projects/85uth8/runs)
[](https://github.com/cityssm/shiftlog/actions/workflows/coverage.yml)
🚧 **Under Development** 🚧
A lightweight and flexible work management system with:
- ✔️ Work order recording
- ✏️ Shift activity logging
- ✏️ Timesheet tracking.
Built with the following use cases in mind:
- Community Services and Public Works work order management
- Accessibility complaint management
- Freedom of information request tracking
- IT help desk
## Features
### Free Mapping
Thanks to the powerful [Leaflet](https://leafletjs.com/) plugin
and the community at [OpenStreetMap](https://www.openstreetmap.org/about),
mapping does not need to come with a huge cost.
### Notifications and Subscriptions
Includes basic high-level notification functionality for:
- E-mail (via SMTP).
- Microsoft Teams.
- [ntfy](https://ntfy.sh/)
(notifications for web browsers, and Android and iPhone devices).
Also includes work order creating, updating, and messaging via:
- Microsoft Graph API.
### Integration Friendly
Currently has data sync integrations with applications like:
- [Avanti](https://www.avanti.ca/)
- [CentralSquare](https://www.centralsquare.com/)'s Pearl
- [ArcGIS](https://www.esri.com/en-us/arcgis/products/arcgis-online/overview).
## Usage
### Running the Application
By default, ShiftLog looks for its configuration file at `data/config.js`.
To start the application in production mode:
```bash
npm start
```
To start the application in development mode with hot reloading:
```bash
npm run dev
```
## About this Project
- 📘 [Documentation](./docs/README.md) (Coming Soon)
- 🤗 [Code of Conduct](CODE_OF_CONDUCT.md)
- 🥰 [Contributing Guidelines](CONTRIBUTING.md)
- 🛡️ [Security Policy](SECURITY.md)
- 📃 [MIT Licence](LICENSE.md)
This system is a rewrite of an internal system used by the City's Public Works
department to track activity occurring during shifts that does not necessarily
fit well into a work order itself. The scope has then been expanded to cover
several other outstanding "work order"-like projects.
Although the system is quite niche, it's being released in an open source
environment in hopes to pool developer resources from other municipalities
looking to move away from older, legacy systems or complicated spreadsheets.
It is being shared to start the dialog among other municipalities and present
an option to those who may be outgrowing managing tasks in spreadsheets
and looking for a more robust alternative.