# bujin2502/honnomachi architecture

> Architecture diagram of the GitHub repository bujin2502/honnomachi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bujin2502/honnomachi
- Repository: https://github.com/bujin2502/honnomachi

## Overview

HonNoMachi is an Android marketplace for used books: users authenticate, discover listings, and buy or sell books; the app also provides profiles, wallets, and admin moderation. The main user path runs through Compose navigation and feature ViewModels into Firebase-backed repositories, with Cloud Functions and Stripe supporting transaction processing. The image-uploader module handles camera/gallery selection and Firebase image storage. The README documents additional capabilities, but many feature implementations were not sampled, so only documented or indexed relationships are drawn.

Main entry points: [`app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt`](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt) (Checkout), [`functions/src/index.ts`](https://github.com/bujin2502/honnomachi/blob/master/functions/src/index.ts) (Cloud Functions), [`image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt`](https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt) (Image picker view), [`app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt`](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt) (Shopping cart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_entry["Activity and navigation<br/>[MainActivity.kt]"]
end

subgraph group_commerce["Books and commerce"]
  node_books["Book browsing<br/>[HomePage.kt]"]
  node_bookrepo["Book listings<br/>[BookRepository.kt]"]
  node_bookdetail["Book details"]
  node_addbook["Create listing<br/>[AddPage.kt]"]
  node_cart["Shopping cart<br/>[CartPage.kt]"]
  node_cartrepo["Cart operations<br/>[CartRepository.kt]"]
  node_checkout["Checkout"]
  node_orders["Orders<br/>[OrderRepository.kt]"]
  node_wallet["Wallet"]
end

subgraph group_identity["Identity and moderation"]
  node_authui["Authentication UI<br/>[AuthScreen.kt]"]
  node_authvm["Auth ViewModel<br/>[AuthViewModel.kt]"]
  node_authrepo["Authentication<br/>[AuthRepository.kt]"]
  node_userdata["User data source"]
  node_profile["User profile<br/>[ProfileScreen.kt]"]
  node_admin["Admin moderation<br/>[AdminRepository.kt]"]
end

subgraph group_media["Image upload"]
  node_uploader["Image picker view"]
  node_camera["Camera source"]
  node_gallery["Gallery source"]
  node_imageupload["Firebase image storage"]
end

subgraph group_backend["Firebase backend"]
  node_functions["Cloud Functions<br/>[index.ts]"]
  node_email["Email service<br/>[emailService.ts]"]
  node_firebase[("Firebase services")]
end

node_user(("Reader / seller"))
node_stripe["Stripe"]

node_user -->|"uses"| node_entry
node_entry -.->|"navigates"| node_authui
node_authui -->|"uses"| node_authvm
node_authvm -->|"invokes"| node_authrepo
node_authrepo -->|"reads and writes"| node_userdata
node_authrepo -->|"authenticates"| node_firebase
node_userdata -->|"stores user data"| node_firebase
node_user -->|"browses"| node_books
node_books -.->|"loads listings"| node_bookrepo
node_user -->|"views"| node_bookdetail
node_user -->|"creates listing"| node_addbook
node_user -->|"shops"| node_cart
node_cart -.->|"manages cart"| node_cartrepo
node_cart -.->|"starts checkout"| node_checkout
node_checkout -->|"simulates payment"| node_stripe
node_checkout -->|"requests payment"| node_functions
node_checkout -.->|"records purchase"| node_orders
node_user -->|"manages funds"| node_wallet
node_wallet -->|"requests top-up"| node_functions
node_user -->|"manages profile"| node_profile
node_user -->|"moderated by"| node_admin
node_uploader -->|"launches"| node_camera
node_uploader -->|"launches"| node_gallery
node_uploader -.->|"uploads images"| node_imageupload
node_functions -->|"sends email"| node_email
node_functions -->|"uses backend"| node_firebase

click node_entry "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/MainActivity.kt"
click node_authui "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt"
click node_authvm "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt"
click node_authrepo "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/AuthRepository.kt"
click node_userdata "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/FirestoreUserDataSource.kt"
click node_books "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/home/HomePage.kt"
click node_bookrepo "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/BookRepository.kt"
click node_bookdetail "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/book/BookDetailScreen.kt"
click node_addbook "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/add/AddPage.kt"
click node_cart "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt"
click node_cartrepo "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/CartRepository.kt"
click node_checkout "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt"
click node_orders "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/OrderRepository.kt"
click node_wallet "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/WalletRepository.kt"
click node_profile "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/profile/ProfileScreen.kt"
click node_admin "https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/AdminRepository.kt"
click node_uploader "https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt"
click node_camera "https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/sources/CameraImageSource.kt"
click node_gallery "https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/sources/GalleryImageSource.kt"
click node_imageupload "https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/FirebaseImageUploader.kt"
click node_functions "https://github.com/bujin2502/honnomachi/blob/master/functions/src/index.ts"
click node_email "https://github.com/bujin2502/honnomachi/blob/master/functions/src/emailService.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry toneBlue
class node_books,node_bookrepo,node_bookdetail,node_addbook,node_cart,node_cartrepo,node_checkout,node_orders,node_wallet toneAmber
class node_authui,node_authvm,node_authrepo,node_userdata,node_profile,node_admin toneMint
class node_uploader,node_camera,node_gallery,node_imageupload toneRose
class node_functions,node_email,node_firebase,node_user,node_stripe toneIndigo
```

## Components

### Android app

- [Activity and navigation](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/MainActivity.kt): `app/src/main/java/hr/foi/air/honnomachi/MainActivity.kt`

### Books and commerce

- [Book browsing](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/home/HomePage.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/home/HomePage.kt`
- [Book listings](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/BookRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/BookRepository.kt`
- [Book details](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/book/BookDetailScreen.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/book/BookDetailScreen.kt`
- [Create listing](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/add/AddPage.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/add/AddPage.kt`
- [Shopping cart](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt`
- [Cart operations](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/CartRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/CartRepository.kt`
- [Checkout](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt`
- [Orders](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/OrderRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/OrderRepository.kt`
- [Wallet](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/WalletRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/WalletRepository.kt`

### Identity and moderation

- [Authentication UI](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt`
- [Auth ViewModel](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt`
- [Authentication](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/AuthRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/AuthRepository.kt`
- [User data source](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/FirestoreUserDataSource.kt): `app/src/main/java/hr/foi/air/honnomachi/data/FirestoreUserDataSource.kt`
- [User profile](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/ui/profile/ProfileScreen.kt): `app/src/main/java/hr/foi/air/honnomachi/ui/profile/ProfileScreen.kt`
- [Admin moderation](https://github.com/bujin2502/honnomachi/blob/master/app/src/main/java/hr/foi/air/honnomachi/data/AdminRepository.kt): `app/src/main/java/hr/foi/air/honnomachi/data/AdminRepository.kt`

### Image upload

- [Image picker view](https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt): `image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt`
- [Camera source](https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/sources/CameraImageSource.kt): `image_uploader/src/main/java/hr/foi/air/image_uploader/sources/CameraImageSource.kt`
- [Gallery source](https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/sources/GalleryImageSource.kt): `image_uploader/src/main/java/hr/foi/air/image_uploader/sources/GalleryImageSource.kt`
- [Firebase image storage](https://github.com/bujin2502/honnomachi/blob/master/image_uploader/src/main/java/hr/foi/air/image_uploader/FirebaseImageUploader.kt): `image_uploader/src/main/java/hr/foi/air/image_uploader/FirebaseImageUploader.kt`

### Firebase backend

- [Cloud Functions](https://github.com/bujin2502/honnomachi/blob/master/functions/src/index.ts): `functions/src/index.ts`
- [Email service](https://github.com/bujin2502/honnomachi/blob/master/functions/src/emailService.ts): `functions/src/emailService.ts`
- **Firebase services**

### Other components

- **Reader / seller**
- **Stripe**

## Connections

- Reader / seller → Activity and navigation: uses
- Activity and navigation → Authentication UI: navigates
- Authentication UI → Auth ViewModel: uses (evidence: `app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt`)
- Auth ViewModel → Authentication: invokes (evidence: `app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt`)
- Authentication → User data source: reads and writes (evidence: `app/src/main/java/hr/foi/air/honnomachi/data/AuthRepository.kt`)
- Authentication → Firebase services: authenticates
- User data source → Firebase services: stores user data
- Reader / seller → Book browsing: browses
- Book browsing → Book listings: loads listings
- Reader / seller → Book details: views
- Reader / seller → Create listing: creates listing
- Reader / seller → Shopping cart: shops
- Shopping cart → Cart operations: manages cart
- Shopping cart → Checkout: starts checkout
- Checkout → Stripe: simulates payment
- Checkout → Cloud Functions: requests payment
- Checkout → Orders: records purchase
- Reader / seller → Wallet: manages funds
- Wallet → Cloud Functions: requests top-up
- Reader / seller → User profile: manages profile
- Reader / seller → Admin moderation: moderated by
- Image picker view → Camera source: launches (evidence: `image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt`)
- Image picker view → Gallery source: launches (evidence: `image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt`)
- Image picker view → Firebase image storage: uploads images
- Cloud Functions → Email service: sends email (evidence: `functions/src/index.ts`)
- Cloud Functions → Firebase services: uses backend
