How bujin2502/honnomachi works
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: CheckoutRepository.kt Checkout · index.ts Cloud Functions · ImageUploaderView.kt Image picker view · CartPage.kt Shopping cart
Components 25
Android app
- Activity and navigation
app/src/main/java/hr/foi/air/honnomachi/MainActivity.kt
Books and commerce
- Book browsing
app/src/main/java/hr/foi/air/honnomachi/ui/home/HomePage.kt - Book listings
app/src/main/java/hr/foi/air/honnomachi/data/BookRepository.kt - Book details
app/src/main/java/hr/foi/air/honnomachi/ui/book/BookDetailScreen.kt - Create listing
app/src/main/java/hr/foi/air/honnomachi/ui/add/AddPage.kt - Shopping cart
app/src/main/java/hr/foi/air/honnomachi/ui/cart/CartPage.kt - Cart operations
app/src/main/java/hr/foi/air/honnomachi/data/CartRepository.kt - Checkout
app/src/main/java/hr/foi/air/honnomachi/data/CheckoutRepository.kt - Orders
app/src/main/java/hr/foi/air/honnomachi/data/OrderRepository.kt - Wallet
app/src/main/java/hr/foi/air/honnomachi/data/WalletRepository.kt
Identity and moderation
- Authentication UI
app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt - Auth ViewModel
app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt - Authentication
app/src/main/java/hr/foi/air/honnomachi/data/AuthRepository.kt - User data source
app/src/main/java/hr/foi/air/honnomachi/data/FirestoreUserDataSource.kt - User profile
app/src/main/java/hr/foi/air/honnomachi/ui/profile/ProfileScreen.kt - Admin moderation
app/src/main/java/hr/foi/air/honnomachi/data/AdminRepository.kt
Image upload
- Image picker view
image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt - Camera source
image_uploader/src/main/java/hr/foi/air/image_uploader/sources/CameraImageSource.kt - Gallery source
image_uploader/src/main/java/hr/foi/air/image_uploader/sources/GalleryImageSource.kt - Firebase image storage
image_uploader/src/main/java/hr/foi/air/image_uploader/FirebaseImageUploader.kt
Firebase backend
- Cloud Functions
functions/src/index.ts - Email service
functions/src/emailService.ts - Firebase services
Other components
- Reader / seller
- Stripe
Connections 26
- Reader / seller → Activity and navigation: uses
- Activity and navigation → Authentication UI: navigates
- Authentication UI → Auth ViewModel: uses
app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthScreen.kt - Auth ViewModel → Authentication: invokes
app/src/main/java/hr/foi/air/honnomachi/ui/auth/AuthViewModel.kt - Authentication → User data source: reads and writes
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
image_uploader/src/main/java/hr/foi/air/image_uploader/ui/ImageUploaderView.kt - Image picker view → Gallery source: launches
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
functions/src/index.ts - Cloud Functions → Firebase services: uses backend