{"id":22157485,"url":"https://github.com/yuriytkach/fundraiser-tracker","last_synced_at":"2025-07-26T08:31:57.651Z","repository":{"id":36984589,"uuid":"496389977","full_name":"yuriytkach/fundraiser-tracker","owner":"yuriytkach","description":"Fundraiser Tracker implemented as AWS Lambda with ability to manage through Slack and autosync with Monobank and Privatbank","archived":false,"fork":false,"pushed_at":"2024-11-18T01:55:23.000Z","size":622,"stargazers_count":10,"open_issues_count":12,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-11-18T02:42:56.195Z","etag":null,"topics":["aws","aws-lambda","aws-secrets-manager","dynamodb","java","monobank-api","privatbank-api","quarkus","slack-bot"],"latest_commit_sha":null,"homepage":"","language":"Java","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/yuriytkach.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-25T21:05:45.000Z","updated_at":"2024-11-18T01:55:26.000Z","dependencies_parsed_at":"2023-12-25T21:26:50.743Z","dependency_job_id":"4ef94a09-e4b3-4883-b54d-35237590e8d2","html_url":"https://github.com/yuriytkach/fundraiser-tracker","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriytkach%2Ffundraiser-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriytkach%2Ffundraiser-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriytkach%2Ffundraiser-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuriytkach%2Ffundraiser-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuriytkach","download_url":"https://codeload.github.com/yuriytkach/fundraiser-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227663036,"owners_count":17800711,"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":["aws","aws-lambda","aws-secrets-manager","dynamodb","java","monobank-api","privatbank-api","quarkus","slack-bot"],"created_at":"2024-12-02T03:09:24.369Z","updated_at":"2024-12-02T03:09:24.931Z","avatar_url":"https://github.com/yuriytkach.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fundraiser Tracker\n\nAn AWS Lambda application written in Quarkus uses DynamoDB as storage, exposes REST interface to get data \nand Slack command REST interface to manipulate data. Application supports currency conversion with rates obtained \nfrom Monobank API.\n\nAdditionally, application supports automatic synchronization of donations using Monobank and Privatbank sync \nby reacting to REST calls.\n\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/224eb30e7e5c4f38934ee9601e15237e)](https://app.codacy.com/gh/yuriytkach/fundraiser-tracker/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Codacy Badge](https://app.codacy.com/project/badge/Coverage/224eb30e7e5c4f38934ee9601e15237e)](https://app.codacy.com/gh/yuriytkach/fundraiser-tracker/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_coverage)\n\n## Supported Slack commands\n\nIf you add a [slash command](https://api.slack.com/interactivity/slash-commands) to Slack (for example `/fund`) then the following commands are supported \nby the application.\n\n**Create new fund:**\n```text\n/fund create car eur 5000 /Banderomobil/ blue\n```\nCreates new fund with short name `car` (will be used to track donations) with goal of €5000, with full \ndescription `Banderomobil` and color `blue` (used in UI tracker)\n\n```text\n/fund create dron usd 7000\n```\nCreates a new fund with short name and description `dron` with goal of $7000 and default color `green` on UI\n\n**Supported currencies:**\n`UAH, USD, EUR, PLN, GBP, CHF`\n\n**Update fund:**\n```text\n/fund update car open|close curr:eur goal:5000 desc:/Banderomobil/ color:blue bank:account\n```\nUpdates the attributes of fund with name `car` by specifying their names, colon and new values (see example above). \nAll attributes are optional so that you can update only needed, but provider then in the above order.\n\n- `open` or `close` perform either enabling or disabling of fund.\n- `bank` can specify several accounts coma-separated.\n\n**Updatable attributes:** currency(`curr`), goal(`goal`), description(`desc`), color(`color`), bank accounts(`bank`)\n\n**List all funds:**\n```text\n/fund list\n```\nDisplays all created funds with status (how much raised)\n\n**Track donation:**\n```text\n/fund track car eur 500 Ivan 2022-05-12 14:15\n/fund track car uah 500 Ivan 14:15             - track for today's date\n/fund track car usd 500 Ivan                   - track for today's date and time\n/fund track car usd 500                        - track for noname person\n```\nThis will track donation for fund with short name `car`. \n- Any supported currency is allowed. Currency conversion takes place.\n- Date and time is optional.\n- Person name is optional. If not supplied, then `noname` is used.\n\n**Delete fund:**\n`Warning! This action cannot be undone! Use with caution!`\n```text\n/fund delete car\n```\nThis will delete fund `car` with all recorded donations. _**Warning! - Cannot be undone!**_\n\n## Running the application in dev mode\n\nYou can run your application in dev mode that enables live coding using:\n```shell script\n./gradlew quarkusDev\n```\n\n\u003e **_NOTE:_**  Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.\n\n## Packaging and running the application\n\nThe application can be packaged using:\n```shell script\n./gradlew build\n```\nIt produces the `quarkus-run.jar` file in the `target/quarkus-app/` directory.\nBe aware that it’s not an _über-jar_ as the dependencies are copied into the `build/quarkus-app/lib/` directory.\n\nThe application is now runnable using `java -jar build/quarkus-app/quarkus-run.jar`.\n\nIf you want to build an _über-jar_, execute the following command:\n```shell script\n./gradlew build -Dquarkus.package.type=uber-jar\n```\n\nThe application, packaged as an _über-jar_, is now runnable using `java -jar build/*-runner.jar`.\n\n## Creating a native executable\n\nYou can create a native executable using: \n```shell script\n./gradlew build -Dquarkus.package.type=native\n```\n\nOr, if you don't have GraalVM installed, you can run the native executable build in a container using: \n```shell script\n./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true\n```\n\nYou can then execute your native executable with: `./build/code-with-quarkus-1.0.0-SNAPSHOT-runner`\n\n## Running in AWS\nYou can manually create Lambda function in AWS from generated `function.zip`. \nAdd the API Gateway for function's REST API.\n\nYou should also create DynamoDB `funds` table with indexes.\n\nAdditionally, you should create secret for Slack token and Privatbank token in AWS Systems Manager.\n\nIf you want to sync Privatbank on a regular basis then you can create Event in the AWS EventBridge \nthat will call Lambda.\n\n## Related Guides\n\n- REST Client Classic ([guide](https://quarkus.io/guides/rest-client)): Call REST services\n- YAML Configuration ([guide](https://quarkus.io/guides/config-yaml)): Use YAML to configure your Quarkus application\n- AWS Lambda Gateway REST API ([guide](https://quarkus.io/guides/amazon-lambda-http)): Build an API Gateway REST API with Lambda integration\n- Amazon DynamoDB ([guide](https://quarkiverse.github.io/quarkiverse-docs/quarkus-amazon-services/dev/amazon-dynamodb.html)): Connect to Amazon DynamoDB datastore\n- RESTEasy Classic ([guide](https://quarkus.io/guides/resteasy)): REST endpoint framework implementing Jakarta REST and more\n- Amazon Secrets Manager ([guide](https://quarkiverse.github.io/quarkiverse-docs/quarkus-amazon-services/dev/amazon-secretsmanager.html)): Connect to Amazon Secrets Manager\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriytkach%2Ffundraiser-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuriytkach%2Ffundraiser-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriytkach%2Ffundraiser-tracker/lists"}