{"id":18607318,"url":"https://github.com/addono/lisa","last_synced_at":"2025-04-10T20:32:16.845Z","repository":{"id":18222563,"uuid":"81029595","full_name":"Addono/LISA","owner":"Addono","description":"Lisa Is Super Awesome (LISA) - \"An informal thing tracker\"","archived":false,"fork":false,"pushed_at":"2023-03-04T02:26:19.000Z","size":64083,"stargazers_count":4,"open_issues_count":10,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-04-14T19:20:43.143Z","etag":null,"topics":["codeigniter","docker","docker-compose","html","javascript","jquery","js","manager","php","till","users","web-application"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Addono.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-02-05T23:22:07.000Z","updated_at":"2022-04-30T14:56:34.000Z","dependencies_parsed_at":"2023-01-11T20:28:23.625Z","dependency_job_id":"2d381d96-0598-4a45-8c63-af75864bb308","html_url":"https://github.com/Addono/LISA","commit_stats":null,"previous_names":[],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Addono%2FLISA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Addono%2FLISA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Addono%2FLISA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Addono%2FLISA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Addono","download_url":"https://codeload.github.com/Addono/LISA/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290041,"owners_count":21078923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["codeigniter","docker","docker-compose","html","javascript","jquery","js","manager","php","till","users","web-application"],"created_at":"2024-11-07T02:28:58.174Z","updated_at":"2025-04-10T20:32:16.833Z","avatar_url":"https://github.com/Addono.png","language":"PHP","readme":"# LISA\n[![Continuous Integration](https://github.com/Addono/LISA/actions/workflows/continuous-integration.yaml/badge.svg)](https://github.com/Addono/LISA/actions/workflows/continuous-integration.yaml)\n[![All Contributors](https://img.shields.io/badge/all_contributors-3-orange.svg)](#contributors)\n[![Project Status: Inactive – The project has reached a stable, usable state but is no longer being actively developed; support/maintenance will be provided as time allows.](https://www.repostatus.org/badges/latest/inactive.svg)](https://www.repostatus.org/#inactive)\n\n![Screenshot of the application](https://i.imgur.com/Yc03EAW.png)\n\nLisa Is Super Awesome (LISA) is an application made to track \"things\" between friends/a group of people who trust each other. It offers a simple, informal and trust-based system to let users tally on each other. Although the system is designed with a non-exploitative user base in mind are all actions related to a user still completely transparent, as each user can see on whom they tallied and who tallied on their tap.\n\nMany use-cases can be imagined, in general LISA gives each user an integer sized balance which each user can subtract from on a one-by-one basis. Imagined use cases include collectively buying goods and keeping track of whom used what.\n\n## Installation\n\n### Docker Compose (Recommended)\n\n```bash\n# Clone the repository\ngit clone https://github.com/Addono/lisa \u0026\u0026 cd lisa\n\n# Install dependencies\nnpm install\n\n# (Optional) Configure the database, the defaults are for a docker compose instance\nvim application/config/database.php\n\n# (Optional) Configure general settings, setting the hostname is mandatory\n# by default it is set to http://localhost:8080, if your Docker instance\n# is not at localhost, then you need to set $config['base_url'] manually \n# in application/config/config.php\nvim application/config/config.php\n\n# (Optional) Although you will get nasty errors in your logs whenever it\n# tries to send email.\nvim application/config/email.php\n\n# Configuration is finished, let's deploy the application and all required services\ndocker compose up -d\n```\nOne small last thing we need to do is to run all database migrations, either point your browser at [http://localhost:8080/install](http://localhost:8080/install) or run`curl http://localhost:8080/install`.\n\n:rocket: And we are live at [http://localhost:8080](http://localhost:8080) :rocket:\n\nHint: The default admin credentials are `admin:admin312` :wink:\n\n_Note: Depending on how you installed Docker it might be that Docker is not accessible at localhost, in that case replace localhost with the IP address of your Docker installation. E.g. for docker-machine users run `$(docker-machine ip)`._\n\n### Manual\nRequirements:\n * PHP 7* with the mysqli extension enabled.\n * MySQL database\n\n 1. Download a copy/make a clone/make a fork of the project and move it to a folder in your web server.\n 1. Rename or copy  `config.php-setup`, `database.php-setup` and `email.php-config` to `config.php`, `database.php` and `email.php` respectively, these files can be found in `application/config/`.\n 1. Edit these config files to match your system.\n    * Add your hostname in `config.php`.\n    * Enter the settings of your database in `database.php`.\n    * (Optional, but recommended) Configure an SMTP server in `email.php`.\n 1. Navigate to __YOUR_HOSTNAME__/index.php/Install to initialize the database.\n\n*The Docker Compose deploy method and the CI are using 7.4. The version used there is leading and the only one supported.\n\n## Development Environment\n\nFor development purposes, an extended Docker Compose configuration is available in `docker-compose.dev.yml`. This configuration adds additional services useful for development:\n\n### Additional Services\n- **phpMyAdmin**: Web interface for database management\n  - Available at: http://localhost:8081\n\n### Starting Development Environment\n\nTo start all services including development tools:\n\n```bash\ndocker compose -f docker-compose.dev.yml up -d\n```\n\nThis will start all base services plus the development services.\n\n## Usage\n\nBy default, the database is populated with one admin user with username `admin`and password `admin312`. Login as this user and change the password as soon as possible.\n\nAfterwards, use the admin user to create new users, which can be done in the backend. When creating new users, make sure that the `user`role is enabled*, otherwise they won't be able to use the application.\n\n*The admin user doesn't have the user role by default, hence the \"Insufficient rights\" message when you first logged in. Obviously you can add the admin user to the `user`group, however it is recommended to keep the admin user merely as an admin.\n\n## Customisation\n\n### Language\nCurrently, the language used by the application is hard-coded into `Handler.php`, for future releases it is planned to move configurations like these into the database. For now, one should edit hard-coded language or substitute all language files in the `nederlands` language folder with your language of preference. During development I tried to add translations for both English and Dutch, so the English translation files should be complete.\n\n## Contributors✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://aknapen.nl\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/15435678?v=4?s=100\" width=\"100px;\" alt=\"Adriaan Knapen\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAdriaan Knapen\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#maintenance-Addono\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e \u003ca href=\"#design-Addono\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"https://github.com/Addono/LISA/issues?q=author%3AAddono\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"https://github.com/Addono/LISA/commits?author=Addono\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#content-Addono\" title=\"Content\"\u003e🖋\u003c/a\u003e \u003ca href=\"#translation-Addono\" title=\"Translation\"\u003e🌍\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.sdhd.nl/\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/4325936?v=4?s=100\" width=\"100px;\" alt=\"Djamon Staal\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eDjamon Staal\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#security-SjamonDaal\" title=\"Security\"\u003e🛡️\u003c/a\u003e \u003ca href=\"#infra-SjamonDaal\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://koenvw.nl\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/1337450?v=4?s=100\" width=\"100px;\" alt=\"Koen\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eKoen\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#infra-koen860\" title=\"Infrastructure (Hosting, Build-Tools, etc)\"\u003e🚇\u003c/a\u003e \u003ca href=\"#ideas-koen860\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"#userTesting-koen860\" title=\"User Testing\"\u003e📓\u003c/a\u003e \u003ca href=\"https://github.com/Addono/LISA/issues?q=author%3Akoen860\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/omit01\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/62880858?v=4?s=100\" width=\"100px;\" alt=\"Timo\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTimo\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Addono/LISA/commits?author=omit01\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Synthetica9\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7075751?v=4?s=100\" width=\"100px;\" alt=\"Patrick Hilhorst\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePatrick Hilhorst\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/Addono/LISA/commits?author=Synthetica9\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddono%2Flisa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faddono%2Flisa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faddono%2Flisa/lists"}