# ruchicodesofficial-code/tripsync architecture

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

- Interactive diagram: https://gitdiagram.com/ruchicodesofficial-code/tripsync
- Repository: https://github.com/ruchicodesofficial-code/tripsync

## Overview

TripSync is a collaborative trip-planning application. Its principal workflow is creating a trip and managing membership, then coordinating itineraries, shared expenses, and settlements; invitations, notifications, and documents support collaboration. The graph includes these documented-by-source capabilities, plus account and authentication layers. Service excerpts and the SOURCE INDEX support several service-to-service and repository relationships; controllers and some services were not sampled, so their runtime links are left unverified rather than inferred.

Main entry points: [`src/main/java/com/tripsync/user/repository/UserRepository.java`](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/user/repository/UserRepository.java) (User repository), [`src/main/java/com/tripsync/settlement/service/SettlementService.java`](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/settlement/service/SettlementService.java) (Settlements), [`src/main/java/com/tripsync/trip/repository/TripRepository.java`](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/repository/TripRepository.java) (Trip repositories), [`src/main/java/com/tripsync/trip/service/TripService.java`](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/service/TripService.java) (Trip management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Accounts and auth"]
  node_auth_api["Auth API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_user_service["User accounts<br/>[UserService.java]"]
  node_user_store[("User repository")]
end

subgraph group_trips["Trip management"]
  node_trip_api["Trip API"]
  node_trip_service["Trip management<br/>[TripService.java]"]
  node_trip_store[("Trip repositories")]
end

subgraph group_planning["Planning and documents"]
  node_itinerary_service["Itineraries"]
  node_itinerary_api["Itinerary API"]
  node_document_service["Trip documents"]
  node_document_storage["Document storage"]
end

subgraph group_finance["Shared finances"]
  node_expense_service["Expense tracking"]
  node_balance_service["Balance calculation"]
  node_settlement_service["Settlements"]
  node_settlement_store[("Settlement repository")]
end

subgraph group_collaboration["Collaboration"]
  node_invitation_service["Invitations"]
  node_email_service["Invitation email"]
  node_notification_service["Notifications"]
end

node_traveler(("Traveler"))

node_traveler -.->|"submits credentials"| node_auth_api
node_auth_api -.->|"dispatches auth"| node_auth_service
node_auth_service -->|"uses tokens"| node_jwt
node_traveler -.->|"manages account"| node_user_service
node_user_service -->|"reads and writes"| node_user_store
node_traveler -.->|"manages trips"| node_trip_api
node_trip_api -.->|"dispatches requests"| node_trip_service
node_trip_service -->|"reads and writes"| node_trip_store
node_trip_service -->|"looks up users"| node_user_store
node_invitation_service -->|"sends invitation"| node_email_service
node_invitation_service -->|"creates alerts"| node_notification_service
node_traveler -.->|"plans activities"| node_itinerary_api
node_itinerary_api -.->|"dispatches requests"| node_itinerary_service
node_itinerary_service -->|"checks trip access"| node_trip_store
node_itinerary_service -->|"looks up users"| node_user_store
node_traveler -.->|"manages documents"| node_document_service
node_document_service -->|"stores files"| node_document_storage
node_traveler -.->|"records expenses"| node_expense_service
node_expense_service -->|"checks membership"| node_trip_store
node_expense_service -->|"looks up members"| node_user_store
node_balance_service -->|"reads settlements"| node_settlement_store
node_traveler -.->|"records payments"| node_settlement_service
node_settlement_service -->|"saves settlement"| node_settlement_store
node_settlement_service -->|"checks membership"| node_trip_store
node_settlement_service -->|"looks up parties"| node_user_store

click node_auth_api "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/controller/AuthController.java"
click node_auth_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/service/AuthService.java"
click node_jwt "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/security/JwtService.java"
click node_user_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/user/service/UserService.java"
click node_user_store "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/user/repository/UserRepository.java"
click node_trip_api "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/controller/TripController.java"
click node_trip_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/service/TripService.java"
click node_trip_store "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/repository/TripRepository.java"
click node_invitation_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/invitation/service/TripInvitationService.java"
click node_email_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/invitation/service/InvitationEmailService.java"
click node_notification_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/notification/service/TripNotificationService.java"
click node_itinerary_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/itinerary/service/ItineraryService.java"
click node_itinerary_api "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/itinerary/controller/ItineraryController.java"
click node_document_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/document/service/TripDocumentService.java"
click node_document_storage "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/document/service/DocumentStorageService.java"
click node_expense_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/expense/service/ExpenseService.java"
click node_balance_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/expense/service/BalanceService.java"
click node_settlement_service "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/settlement/service/SettlementService.java"
click node_settlement_store "https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/settlement/repository/SettlementRepository.java"

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_auth_api,node_auth_service,node_jwt,node_user_service,node_user_store toneBlue
class node_trip_api,node_trip_service,node_trip_store toneAmber
class node_itinerary_service,node_itinerary_api,node_document_service,node_document_storage toneMint
class node_expense_service,node_balance_service,node_settlement_service,node_settlement_store toneRose
class node_invitation_service,node_email_service,node_notification_service,node_traveler toneIndigo
```

## Components

### Accounts and auth

- [Auth API](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/controller/AuthController.java): `src/main/java/com/tripsync/auth/controller/AuthController.java`
- [Authentication](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/service/AuthService.java): `src/main/java/com/tripsync/auth/service/AuthService.java`
- [JWT service](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/auth/security/JwtService.java): `src/main/java/com/tripsync/auth/security/JwtService.java`
- [User accounts](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/user/service/UserService.java): `src/main/java/com/tripsync/user/service/UserService.java`
- [User repository](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/user/repository/UserRepository.java): `src/main/java/com/tripsync/user/repository/UserRepository.java`

### Trip management

- [Trip API](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/controller/TripController.java): `src/main/java/com/tripsync/trip/controller/TripController.java`
- [Trip management](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/service/TripService.java): `src/main/java/com/tripsync/trip/service/TripService.java`
- [Trip repositories](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/trip/repository/TripRepository.java): `src/main/java/com/tripsync/trip/repository/TripRepository.java`

### Planning and documents

- [Itineraries](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/itinerary/service/ItineraryService.java): `src/main/java/com/tripsync/itinerary/service/ItineraryService.java`
- [Itinerary API](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/itinerary/controller/ItineraryController.java): `src/main/java/com/tripsync/itinerary/controller/ItineraryController.java`
- [Trip documents](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/document/service/TripDocumentService.java): `src/main/java/com/tripsync/document/service/TripDocumentService.java`
- [Document storage](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/document/service/DocumentStorageService.java): `src/main/java/com/tripsync/document/service/DocumentStorageService.java`

### Shared finances

- [Expense tracking](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/expense/service/ExpenseService.java): `src/main/java/com/tripsync/expense/service/ExpenseService.java`
- [Balance calculation](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/expense/service/BalanceService.java): `src/main/java/com/tripsync/expense/service/BalanceService.java`
- [Settlements](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/settlement/service/SettlementService.java): `src/main/java/com/tripsync/settlement/service/SettlementService.java`
- [Settlement repository](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/settlement/repository/SettlementRepository.java): `src/main/java/com/tripsync/settlement/repository/SettlementRepository.java`

### Collaboration

- [Invitations](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/invitation/service/TripInvitationService.java): `src/main/java/com/tripsync/invitation/service/TripInvitationService.java`
- [Invitation email](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/invitation/service/InvitationEmailService.java): `src/main/java/com/tripsync/invitation/service/InvitationEmailService.java`
- [Notifications](https://github.com/ruchicodesofficial-code/tripsync/blob/main/src/main/java/com/tripsync/notification/service/TripNotificationService.java): `src/main/java/com/tripsync/notification/service/TripNotificationService.java`

### Other components

- **Traveler**

## Connections

- Traveler → Auth API: submits credentials
- Auth API → Authentication: dispatches auth (evidence: `src/main/java/com/tripsync/auth/controller/AuthController.java`)
- Authentication → JWT service: uses tokens (evidence: `src/main/java/com/tripsync/auth/service/AuthService.java`)
- Traveler → User accounts: manages account
- User accounts → User repository: reads and writes (evidence: `src/main/java/com/tripsync/user/service/UserService.java`)
- Traveler → Trip API: manages trips
- Trip API → Trip management: dispatches requests (evidence: `src/main/java/com/tripsync/trip/controller/TripController.java`)
- Trip management → Trip repositories: reads and writes (evidence: `src/main/java/com/tripsync/trip/service/TripService.java`)
- Trip management → User repository: looks up users (evidence: `src/main/java/com/tripsync/trip/service/TripService.java`)
- Invitations → Invitation email: sends invitation (evidence: `src/main/java/com/tripsync/invitation/service/TripInvitationService.java`)
- Invitations → Notifications: creates alerts (evidence: `src/main/java/com/tripsync/invitation/service/TripInvitationService.java`)
- Traveler → Itinerary API: plans activities
- Itinerary API → Itineraries: dispatches requests (evidence: `src/main/java/com/tripsync/itinerary/controller/ItineraryController.java`)
- Itineraries → Trip repositories: checks trip access (evidence: `src/main/java/com/tripsync/itinerary/service/ItineraryService.java`)
- Itineraries → User repository: looks up users (evidence: `src/main/java/com/tripsync/itinerary/service/ItineraryService.java`)
- Traveler → Trip documents: manages documents
- Trip documents → Document storage: stores files (evidence: `src/main/java/com/tripsync/document/service/TripDocumentService.java`)
- Traveler → Expense tracking: records expenses
- Expense tracking → Trip repositories: checks membership (evidence: `src/main/java/com/tripsync/expense/service/ExpenseService.java`)
- Expense tracking → User repository: looks up members (evidence: `src/main/java/com/tripsync/expense/service/ExpenseService.java`)
- Balance calculation → Settlement repository: reads settlements (evidence: `src/main/java/com/tripsync/expense/service/BalanceService.java`)
- Traveler → Settlements: records payments
- Settlements → Settlement repository: saves settlement (evidence: `src/main/java/com/tripsync/settlement/service/SettlementService.java`)
- Settlements → Trip repositories: checks membership (evidence: `src/main/java/com/tripsync/settlement/service/SettlementService.java`)
- Settlements → User repository: looks up parties (evidence: `src/main/java/com/tripsync/settlement/service/SettlementService.java`)
