# rishabhkumar2201/stockify architecture

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

- Interactive diagram: https://gitdiagram.com/rishabhkumar2201/stockify
- Repository: https://github.com/rishabhkumar2201/stockify

## Overview

Stockify is documented as a stock-trading simulation and portfolio-management platform. Its main user flow is React clients requesting stock and portfolio APIs; the Spring controller delegates operations to a service, which reads or updates DynamoDB, while authentication uses JWT and user records use a relational database. The README also describes scheduled price updates, admin operations, and a news feed. Frontend and cloud-updater source are not present in the supplied tree, so those components and links are based on README documentation.

Main entry points: [`Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java) (Portfolio controller), [`Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java) (Portfolio service), [`Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java`](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java) (JWT filter), [`Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java`](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java) (User details service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_frontend["React frontend"]
end

subgraph group_api["Backend API"]
  node_controller["Portfolio controller"]
  node_service["Portfolio service"]
  node_portfolio_models["Portfolio and stock models"]
end

subgraph group_identity["Identity and users"]
  node_jwt_filter["JWT filter<br/>[JwtAuthFilter.java]"]
  node_jwt_util["JWT utilities<br/>[JwtUtil.java]"]
  node_security["Security configuration"]
  node_user_details["User details service"]
  node_user_repository["User repository"]
  node_rds[("User database")]
end

subgraph group_market["Market data and storage"]
  node_dynamodb[("DynamoDB tables")]
  node_updater["Price updater"]
  node_scheduler["EventBridge schedule"]
  node_news_api["Finance news API"]
end

node_user(("Investor or admin"))

node_user -->|"uses"| node_frontend
node_frontend -->|"requests APIs"| node_controller
node_controller -->|"delegates operations"| node_service
node_service -->|"uses models"| node_portfolio_models
node_controller -->|"accepts and returns"| node_portfolio_models
node_service -->|"reads and writes"| node_dynamodb
node_controller -->|"serves stock and portfolio APIs"| node_dynamodb
node_controller -->|"fetches headlines"| node_news_api
node_scheduler -->|"triggers each minute"| node_updater
node_updater -->|"updates prices"| node_dynamodb
node_security -->|"registers filter"| node_jwt_filter
node_jwt_filter -->|"validates tokens"| node_jwt_util
node_jwt_filter -->|"loads identity"| node_user_details
node_controller -->|"issues tokens"| node_jwt_util
node_controller -->|"loads login identity"| node_user_details
node_user_details -->|"looks up user"| node_user_repository
node_service -->|"manages user records"| node_user_repository
node_user_repository -->|"persists users"| node_rds

click node_frontend "https://github.com/rishabhkumar2201/stockify/tree/main/Frontend/stockportfolio"
click node_controller "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java"
click node_service "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java"
click node_portfolio_models "https://github.com/rishabhkumar2201/stockify/tree/main/Backend/Capstone/src/main/java/com/myapp/model"
click node_jwt_filter "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java"
click node_jwt_util "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java"
click node_security "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/SecurityConfig.java"
click node_user_details "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java"
click node_user_repository "https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/repository/portfolioRepository.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_frontend toneBlue
class node_controller,node_service,node_portfolio_models toneAmber
class node_jwt_filter,node_jwt_util,node_security,node_user_details,node_user_repository,node_rds toneMint
class node_dynamodb,node_updater,node_scheduler,node_news_api toneRose
class node_user toneIndigo
```

## Components

### Client experience

- [React frontend](https://github.com/rishabhkumar2201/stockify/tree/main/Frontend/stockportfolio): `Frontend/stockportfolio`

### Backend API

- [Portfolio controller](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java): `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`
- [Portfolio service](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java): `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`
- [Portfolio and stock models](https://github.com/rishabhkumar2201/stockify/tree/main/Backend/Capstone/src/main/java/com/myapp/model): `Backend/Capstone/src/main/java/com/myapp/model`

### Identity and users

- [JWT filter](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java): `Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java`
- [JWT utilities](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java): `Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java`
- [Security configuration](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/SecurityConfig.java): `Backend/Capstone/src/main/java/com/myapp/config/SecurityConfig.java`
- [User details service](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java): `Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java`
- [User repository](https://github.com/rishabhkumar2201/stockify/blob/main/Backend/Capstone/src/main/java/com/myapp/repository/portfolioRepository.java): `Backend/Capstone/src/main/java/com/myapp/repository/portfolioRepository.java`
- **User database**

### Market data and storage

- **DynamoDB tables**
- **Price updater**
- **EventBridge schedule**
- **Finance news API**

### Other components

- **Investor or admin**

## Connections

- Investor or admin → React frontend: uses (evidence: `readme.md`)
- React frontend → Portfolio controller: requests APIs (evidence: `readme.md`)
- Portfolio controller → Portfolio service: delegates operations (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio service → Portfolio and stock models: uses models (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- Portfolio controller → Portfolio and stock models: accepts and returns (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio service → DynamoDB tables: reads and writes (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- Portfolio controller → DynamoDB tables: serves stock and portfolio APIs (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio controller → Finance news API: fetches headlines (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- EventBridge schedule → Price updater: triggers each minute (evidence: `readme.md`)
- Price updater → DynamoDB tables: updates prices (evidence: `readme.md`)
- Security configuration → JWT filter: registers filter (evidence: `Backend/Capstone/src/main/java/com/myapp/config/SecurityConfig.java`)
- JWT filter → JWT utilities: validates tokens (evidence: `Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java`)
- JWT filter → User details service: loads identity (evidence: `Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java`)
- Portfolio controller → JWT utilities: issues tokens (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio controller → User details service: loads login identity (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- User details service → User repository: looks up user (evidence: `Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java`)
- Portfolio service → User repository: manages user records (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- User repository → User database: persists users (evidence: `readme.md`)
