How shinh09/ntropy_server works
Ntropy is a financial-management backend for multi-job workers. Users enter through the BFF for authentication and product features; the domain services combine work and settlement data with linked-account transactions to support income planning, financial diagnosis, and crisis planning, alongside subscriptions, reports, and notifications. The README describes a modular monolith with common client contracts. Sampled code verifies selected orchestration and service calls; unsampled service links below are included only where the README documents them.
Main entry points: controller REST BFF · MonthlyAiReportOrchestrationService.java AI reports · service Work and calendar · DailyFinancialSyncOrchestrationService.java Account sync
Components 19
API and identity
- REST BFF
services/bff-service/src/main/java/com/ntropy/bff/controller - OAuth and JWT
services/user-service/src/main/java/com/ntropy/user/service/UserService.java - Shared contracts
common/src/main/java/com/ntropy/common/client
Work and finance
- Account sync
services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java - Bank connection
services/account-service/src/main/java/com/ntropy/account/client/codef - Account data
services/account-service/src/main/java/com/ntropy/account/client/LocalAccountQueryClient.java - Work and calendar
services/work-service/src/main/java/com/ntropy/work/service - Income settlement
services/work-service/src/main/java/com/ntropy/work/service/SettlementService.java
Financial insights
- Financial diagnosis
services/diagnosis-service/src/main/java/com/ntropy/diagnosis/service/DiagnosisResultService.java - Diagnosis analysis
services/diagnosis-service/src/main/java/com/ntropy/diagnosis/client/LocalDiagnosisAnalysisQueryClient.java - Defense mode
services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java - AI reports
services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java - PDF and email
services/ai-service/src/main/java/com/ntropy/ai/service/AiReportEmailDeliveryService.java - Product recommendations
services/ai-service/src/main/java/com/ntropy/ai/service
Product services
- Subscriptions
services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java - PortOne payments
services/payment-service/src/main/java/com/ntropy/payment/client/portone/PortOnePaymentClientV2.java - Notifications
services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java - Web Push
services/notification-service/src/main/java/com/ntropy/notification/push/WebPushServiceClient.java
Other components
- User
Connections 22
- User → REST BFF: requests
README.md - REST BFF → OAuth and JWT: authenticates
README.md - REST BFF → Account sync: requests
README.md - REST BFF → Work and calendar: requests
README.md - REST BFF → Financial diagnosis: requests
README.md - REST BFF → Defense mode: requests
README.md - REST BFF → AI reports: requests
README.md - REST BFF → Subscriptions: requests
README.md - REST BFF → Notifications: requests
README.md - REST BFF → Shared contracts: uses contracts
README.md - Account sync → Bank connection: syncs accounts
README.md - Account sync → Account data: provides data
- Work and calendar → Income settlement: tracks income
README.md - Diagnosis analysis → Financial diagnosis: reads results
services/diagnosis-service/src/main/java/com/ntropy/diagnosis/client/LocalDiagnosisAnalysisQueryClient.java - Diagnosis analysis → Account data: reads expenses
- Defense mode → Work and calendar: estimates income loss
services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java - AI reports → Work and calendar: reads income
services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java - AI reports → Account data: reads expenses
services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java - AI reports → PDF and email: delivers reports
services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java - AI reports → Product recommendations: requests recommendations
services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java - Subscriptions → PortOne payments: charges payments
services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java - Notifications → Web Push: sends pushes
services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java