kamerok/zebadge

Droidcon 2023: The time a new badge saw the light of the day, full with delight and android programming capabillities.

ZeBadge

Droidcon 2023: The time a new badge saw the light of the day, full with delight and android programming capabilities.

This is the badge:

And this is the Android app:

TBD

Together they make magic happen. 🪄🦄

Droidcon contribution guide:

1. Fork the repo & make write your code
2. Use "droidcon/${name}" format for the branch name so we can find it.
3. When done, open a PR and come to the booth to get you badge.

Getting Started

The following sections are describing the badge in detail, but if you just want to get started, please feel free to follow our Getting Started guide.

Scenario

The following lines are the thought experiment on how we imagine a visit to the GDG Berlin Android Droidcon 2023 Berlin booth will look like. Alice is an atenndee and Olivia is an organizer.

Actor	Dialog
Alice	Hey, I saw that thing everyone is running around, that with their name on it? They said I can find it here, is that true?
Olivia	Yes, you came to the right place, this is ZeBadge, a digital badge that displays your name and can be programmed and changed!
Alice	Oh that is amazing, how does this work? How can I get one?
Olivia	You need to do what we all love to do: Write some code and create a PR on our open source repository, controlling the badge and the android app. You can get started with using one of our loaner badges, and read one of our getting started guides. Once you have done "something code" with it, you can get your own badge.
Alice	Oh, neat, that is this qr code to get started points to one of the printed out sheets?
Olivia	Indeed, take loaner number four and happy hacking! Feel free to reach out when we can do something for you.
	Alice went over to the loaners, played for 20 minutes with the badge, and was able to follow the getting started guide and create a new page system, showing the weather on page 2. She pushed a PR.

Graph

The following diagram shows which parts are involved in this badge:

sequenceDiagram
Alice -->> App: Start
App --> App: Load last configuration
App -->> Alice: Show Bitmaps for A, B, C, U(p), D(down)
App -->> Badge: Connected?
Badge -->> App: Yes!
Alice -->> App: Tab on `update name on badge` button
App -->> Alice: What is your `name` and your contact info?
Alice --> App: `Alice Alicia` and `[email protected]`
App --> App: Layout view with provided info
App --> App: Save view to bitmap
App --> App: Convert bitmap to black and white format understood by badge
App -->> Badge: New `name` page set
Badge --> Badge: Save page
Badge --> Badge: Show page `a` (name)
Alice -->> Badge: Button 'b'
Badge --> Badge: Show sponsor 1 page 
Alice -->> Badge: Button 'c'
Badge --> Badge: Show sponsor 2 page
Alice -->> Badge: Button 'up'
Badge --> Badge: Show user page `u`
Alice -->> Badge: Button 'down'
Badge --> Badge: Show user page `d`