# shinh09/ntropy_server architecture

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

- Interactive diagram: https://gitdiagram.com/shinh09/ntropy_server
- Repository: https://github.com/shinh09/ntropy_server

## Overview

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: [`services/bff-service/src/main/java/com/ntropy/bff/controller`](https://github.com/shinh09/ntropy_server/tree/develop/services/bff-service/src/main/java/com/ntropy/bff/controller) (REST BFF), [`services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`](https://github.com/shinh09/ntropy_server/blob/develop/services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java) (AI reports), [`services/work-service/src/main/java/com/ntropy/work/service`](https://github.com/shinh09/ntropy_server/tree/develop/services/work-service/src/main/java/com/ntropy/work/service) (Work and calendar), [`services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java`](https://github.com/shinh09/ntropy_server/blob/develop/services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java) (Account sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and identity"]
  node_bff["REST BFF"]
  node_auth["OAuth and JWT<br/>[UserService.java]"]
  node_common["Shared contracts"]
end

subgraph group_finance["Work and finance"]
  node_account["Account sync"]
  node_codef["Bank connection"]
  node_accountdata[("Account data")]
  node_work["Work and calendar"]
  node_settlement["Income settlement"]
end

subgraph group_insights["Financial insights"]
  node_diagnosis[("Financial diagnosis")]
  node_diagnosisquery["Diagnosis analysis"]
  node_defense["Defense mode"]
  node_ai["AI reports"]
  node_aiemail["PDF and email"]
  node_recommendations["Product recommendations"]
end

subgraph group_engagement["Product services"]
  node_subscription["Subscriptions"]
  node_portone["PortOne payments"]
  node_notifications[("Notifications")]
  node_push["Web Push"]
end

node_user(("User"))

node_user -->|"requests"| node_bff
node_bff -->|"authenticates"| node_auth
node_bff -->|"requests"| node_account
node_bff -->|"requests"| node_work
node_bff -->|"requests"| node_diagnosis
node_bff -->|"requests"| node_defense
node_bff -->|"requests"| node_ai
node_bff -->|"requests"| node_subscription
node_bff -->|"requests"| node_notifications
node_bff -->|"uses contracts"| node_common
node_account -.->|"syncs accounts"| node_codef
node_account -.->|"provides data"| node_accountdata
node_work -.->|"tracks income"| node_settlement
node_diagnosisquery -->|"reads results"| node_diagnosis
node_diagnosisquery -.->|"reads expenses"| node_accountdata
node_defense -.->|"estimates income loss"| node_work
node_ai -->|"reads income"| node_work
node_ai -->|"reads expenses"| node_accountdata
node_ai -->|"delivers reports"| node_aiemail
node_ai -->|"requests recommendations"| node_recommendations
node_subscription -->|"charges payments"| node_portone
node_notifications -->|"sends pushes"| node_push

click node_bff "https://github.com/shinh09/ntropy_server/tree/develop/services/bff-service/src/main/java/com/ntropy/bff/controller"
click node_auth "https://github.com/shinh09/ntropy_server/blob/develop/services/user-service/src/main/java/com/ntropy/user/service/UserService.java"
click node_account "https://github.com/shinh09/ntropy_server/blob/develop/services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java"
click node_codef "https://github.com/shinh09/ntropy_server/tree/develop/services/account-service/src/main/java/com/ntropy/account/client/codef"
click node_accountdata "https://github.com/shinh09/ntropy_server/blob/develop/services/account-service/src/main/java/com/ntropy/account/client/LocalAccountQueryClient.java"
click node_work "https://github.com/shinh09/ntropy_server/tree/develop/services/work-service/src/main/java/com/ntropy/work/service"
click node_settlement "https://github.com/shinh09/ntropy_server/blob/develop/services/work-service/src/main/java/com/ntropy/work/service/SettlementService.java"
click node_diagnosis "https://github.com/shinh09/ntropy_server/blob/develop/services/diagnosis-service/src/main/java/com/ntropy/diagnosis/service/DiagnosisResultService.java"
click node_diagnosisquery "https://github.com/shinh09/ntropy_server/blob/develop/services/diagnosis-service/src/main/java/com/ntropy/diagnosis/client/LocalDiagnosisAnalysisQueryClient.java"
click node_defense "https://github.com/shinh09/ntropy_server/blob/develop/services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java"
click node_ai "https://github.com/shinh09/ntropy_server/blob/develop/services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java"
click node_aiemail "https://github.com/shinh09/ntropy_server/blob/develop/services/ai-service/src/main/java/com/ntropy/ai/service/AiReportEmailDeliveryService.java"
click node_recommendations "https://github.com/shinh09/ntropy_server/tree/develop/services/ai-service/src/main/java/com/ntropy/ai/service"
click node_subscription "https://github.com/shinh09/ntropy_server/blob/develop/services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java"
click node_portone "https://github.com/shinh09/ntropy_server/blob/develop/services/payment-service/src/main/java/com/ntropy/payment/client/portone/PortOnePaymentClientV2.java"
click node_notifications "https://github.com/shinh09/ntropy_server/blob/develop/services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java"
click node_push "https://github.com/shinh09/ntropy_server/blob/develop/services/notification-service/src/main/java/com/ntropy/notification/push/WebPushServiceClient.java"
click node_common "https://github.com/shinh09/ntropy_server/tree/develop/common/src/main/java/com/ntropy/common/client"

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_bff,node_auth,node_common,node_user toneBlue
class node_account,node_codef,node_accountdata,node_work,node_settlement toneAmber
class node_diagnosis,node_diagnosisquery,node_defense,node_ai,node_aiemail,node_recommendations toneMint
class node_subscription,node_portone,node_notifications,node_push toneRose
```

## Components

### API and identity

- [REST BFF](https://github.com/shinh09/ntropy_server/tree/develop/services/bff-service/src/main/java/com/ntropy/bff/controller): `services/bff-service/src/main/java/com/ntropy/bff/controller`
- [OAuth and JWT](https://github.com/shinh09/ntropy_server/blob/develop/services/user-service/src/main/java/com/ntropy/user/service/UserService.java): `services/user-service/src/main/java/com/ntropy/user/service/UserService.java`
- [Shared contracts](https://github.com/shinh09/ntropy_server/tree/develop/common/src/main/java/com/ntropy/common/client): `common/src/main/java/com/ntropy/common/client`

### Work and finance

- [Account sync](https://github.com/shinh09/ntropy_server/blob/develop/services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java): `services/account-service/src/main/java/com/ntropy/account/service/DailyFinancialSyncOrchestrationService.java`
- [Bank connection](https://github.com/shinh09/ntropy_server/tree/develop/services/account-service/src/main/java/com/ntropy/account/client/codef): `services/account-service/src/main/java/com/ntropy/account/client/codef`
- [Account data](https://github.com/shinh09/ntropy_server/blob/develop/services/account-service/src/main/java/com/ntropy/account/client/LocalAccountQueryClient.java): `services/account-service/src/main/java/com/ntropy/account/client/LocalAccountQueryClient.java`
- [Work and calendar](https://github.com/shinh09/ntropy_server/tree/develop/services/work-service/src/main/java/com/ntropy/work/service): `services/work-service/src/main/java/com/ntropy/work/service`
- [Income settlement](https://github.com/shinh09/ntropy_server/blob/develop/services/work-service/src/main/java/com/ntropy/work/service/SettlementService.java): `services/work-service/src/main/java/com/ntropy/work/service/SettlementService.java`

### Financial insights

- [Financial diagnosis](https://github.com/shinh09/ntropy_server/blob/develop/services/diagnosis-service/src/main/java/com/ntropy/diagnosis/service/DiagnosisResultService.java): `services/diagnosis-service/src/main/java/com/ntropy/diagnosis/service/DiagnosisResultService.java`
- [Diagnosis analysis](https://github.com/shinh09/ntropy_server/blob/develop/services/diagnosis-service/src/main/java/com/ntropy/diagnosis/client/LocalDiagnosisAnalysisQueryClient.java): `services/diagnosis-service/src/main/java/com/ntropy/diagnosis/client/LocalDiagnosisAnalysisQueryClient.java`
- [Defense mode](https://github.com/shinh09/ntropy_server/blob/develop/services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java): `services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java`
- [AI reports](https://github.com/shinh09/ntropy_server/blob/develop/services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java): `services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`
- [PDF and email](https://github.com/shinh09/ntropy_server/blob/develop/services/ai-service/src/main/java/com/ntropy/ai/service/AiReportEmailDeliveryService.java): `services/ai-service/src/main/java/com/ntropy/ai/service/AiReportEmailDeliveryService.java`
- [Product recommendations](https://github.com/shinh09/ntropy_server/tree/develop/services/ai-service/src/main/java/com/ntropy/ai/service): `services/ai-service/src/main/java/com/ntropy/ai/service`

### Product services

- [Subscriptions](https://github.com/shinh09/ntropy_server/blob/develop/services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java): `services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java`
- [PortOne payments](https://github.com/shinh09/ntropy_server/blob/develop/services/payment-service/src/main/java/com/ntropy/payment/client/portone/PortOnePaymentClientV2.java): `services/payment-service/src/main/java/com/ntropy/payment/client/portone/PortOnePaymentClientV2.java`
- [Notifications](https://github.com/shinh09/ntropy_server/blob/develop/services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java): `services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java`
- [Web Push](https://github.com/shinh09/ntropy_server/blob/develop/services/notification-service/src/main/java/com/ntropy/notification/push/WebPushServiceClient.java): `services/notification-service/src/main/java/com/ntropy/notification/push/WebPushServiceClient.java`

### Other components

- **User**

## Connections

- User → REST BFF: requests (evidence: `README.md`)
- REST BFF → OAuth and JWT: authenticates (evidence: `README.md`)
- REST BFF → Account sync: requests (evidence: `README.md`)
- REST BFF → Work and calendar: requests (evidence: `README.md`)
- REST BFF → Financial diagnosis: requests (evidence: `README.md`)
- REST BFF → Defense mode: requests (evidence: `README.md`)
- REST BFF → AI reports: requests (evidence: `README.md`)
- REST BFF → Subscriptions: requests (evidence: `README.md`)
- REST BFF → Notifications: requests (evidence: `README.md`)
- REST BFF → Shared contracts: uses contracts (evidence: `README.md`)
- Account sync → Bank connection: syncs accounts (evidence: `README.md`)
- Account sync → Account data: provides data
- Work and calendar → Income settlement: tracks income (evidence: `README.md`)
- Diagnosis analysis → Financial diagnosis: reads results (evidence: `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 (evidence: `services/defense-service/src/main/java/com/ntropy/defense/service/DefenseModeService.java`)
- AI reports → Work and calendar: reads income (evidence: `services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`)
- AI reports → Account data: reads expenses (evidence: `services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`)
- AI reports → PDF and email: delivers reports (evidence: `services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`)
- AI reports → Product recommendations: requests recommendations (evidence: `services/ai-service/src/main/java/com/ntropy/ai/service/MonthlyAiReportOrchestrationService.java`)
- Subscriptions → PortOne payments: charges payments (evidence: `services/payment-service/src/main/java/com/ntropy/payment/service/SubscriptionService.java`)
- Notifications → Web Push: sends pushes (evidence: `services/notification-service/src/main/java/com/ntropy/notification/service/NotificationService.java`)
