https://github.com/literalplus/tingo
A web application based on Spring and Angular that provides a centralised service for managing bingo games targeting teachers
https://github.com/literalplus/tingo
bingo java spring teachers tingo
Last synced: 5 months ago
JSON representation
A web application based on Spring and Angular that provides a centralised service for managing bingo games targeting teachers
- Host: GitHub
- URL: https://github.com/literalplus/tingo
- Owner: literalplus
- License: apache-2.0
- Created: 2016-02-06T22:23:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-09-09T20:00:17.000Z (10 months ago)
- Last Synced: 2025-10-08T10:51:43.483Z (9 months ago)
- Topics: bingo, java, spring, teachers, tingo
- Language: Java
- Homepage: https://tingo.lit.plus/
- Size: 232 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tingo
__Tingo__ is a web application built to manage teacher bingos. It uses technologies like AngularJS, lesscss and
the Spring Framework. Also check out [sic](https://github.com/literalplus/sic), which is a citation management software.
## What is it?
Specifically, _Tingo_ allows anyone knowing a secret code to register, view and manage bingo fields.
Teachers do currently have to be created by an administrator, but this might change in the future.
It also provides a convenient print view which allows people to print Tingo fields for playing.
## How to play
Print a grid of Tingo fields for a teacher. Each filed represents something (dumb?) they often do.
Once they do that, you mark that field using a pencil. If you have five marked fields in a vertical,
horizontal or diagonal row, you win. If you prefer, you can stand up and tell the rest of the class
by shouting "Bingo!". Then erase the marks you made and start over again.
Obviously, the game is most fun when played with friends. You can cooperate on creating the fields and
also play together. The fields are printed in random order to prevent everyone winning at the same time.
Tingo can obviously be used for things different than teachers, such as TV shows, politicians, university
professors, anything. Use your imagination.
## Installation
To install _Tingo_, you first need to build it: (assuming you're on GNU/Linux, other platforms work similarly)
````bash
git clone https://github.com/literalplus/tingo.git
cd sic
./gradlew build
cp application.yml-default application.yml
````
Then, you need to edit the `application.yml` config file with your favourite editor and insert database credentials.
_Tingo_ was built for use with MySQL or MariaDB. You do not need to perform any database setup except for creating the
database you named in your config file. (`tingo` by default)
You can then run the application either using Gradle directly:
````bash
./gradlew bootRun
````
or by running the `.jar` file created in the `build/libs/` directory.
It will start on port 8080 by default.
## Deployment
```bash
docker build -t registry.lit.plus/tingo:latest .
docker push registry.lit.plus/tingo:latest
helm install tingo charts/tingo --namespace=tingo-sic
```
## License
This project is licensed under the Apache License, Version 2.0. You can find a copy in the `LICENSE` file.
## Support
Please, just open an issue at [GitHub](https://github.com/xxyy/tingo/issues). Pull Requests are obviously welcome.