How beone-capston/beone-mvp works
BeONE simulates choosing the held card with the greatest expected monthly benefit just before a simulated payment; it does not process real payments. The main workflow spans order creation, recommendation from card and monthly-state inputs, simulated approval, and ledger recording. Other major capabilities include member sessions, card management, CODEF connection/synchronization, and Android biometric activation. The excerpts show several service-level calls; unsampled controller wiring and frontend API calls are not inferred.
Main entry points: RecommendationService.java Recommendation service · UserCardService.java Held cards · SimulatedPaymentService.java Simulated payment · CodefSyncService.java CODEF sync
Components 16
Client apps
- Web app
frontend/src/App.tsx - Android shell
android/app/src/main/java/com/beone/app/MainActivity.kt - Device authentication
android/app/src/main/java/com/beone/app/auth/DeviceAuthenticator.kt
Identity and cards
- Member sessions
backend/src/main/java/com/beone/api/auth/application/AuthSessionService.java - Held cards
backend/src/main/java/com/beone/api/card/application/UserCardService.java
Recommendation
- Monthly state
backend/src/main/java/com/beone/api/monthlystate/application/MonthlyStateService.java - Recommendation service
backend/src/main/java/com/beone/api/recommendation/application/RecommendationService.java - Benefit engine
backend/src/main/java/com/beone/api/benefit/engine/HeldCardInput.java - Benefit rules
backend/src/main/java/com/beone/api/benefit/rule/RuleCatalog.java
Transactions and data
- Backend API
backend/src/main/java/com/beone/api - Virtual orders
backend/src/main/java/com/beone/api/order/application/OrderService.java - Transaction ledger
backend/src/main/java/com/beone/api/ledger/application/LedgerQueryService.java - Simulated payment
backend/src/main/java/com/beone/api/payment/application/SimulatedPaymentService.java
External integration
- CODEF sync
backend/src/main/java/com/beone/api/codef/application/CodefSyncService.java - CODEF service
Other components
- User
Connections 12
- User → Web app: uses
README.md - User → Android shell: uses
README.md - Android shell → Device authentication: authenticates
- Recommendation service → Virtual orders: reads order
backend/src/main/java/com/beone/api/recommendation/application/RecommendationService.java - Recommendation service → Held cards: lists cards
backend/src/main/java/com/beone/api/recommendation/application/RecommendationService.java - Recommendation service → Monthly state: loads state
backend/src/main/java/com/beone/api/recommendation/application/RecommendationService.java - Recommendation service → Transaction ledger: reads activity
backend/src/main/java/com/beone/api/recommendation/application/RecommendationService.java - Transaction ledger → Held cards: lists held cards
backend/src/main/java/com/beone/api/ledger/application/LedgerQueryService.java - Simulated payment → Recommendation service: recalculates
backend/src/main/java/com/beone/api/payment/application/SimulatedPaymentService.java - Simulated payment → Virtual orders: reads order
backend/src/main/java/com/beone/api/payment/application/SimulatedPaymentService.java - CODEF sync → Held cards: registers cards
backend/src/main/java/com/beone/api/codef/application/CodefSyncService.java - CODEF sync → CODEF service: fetches data