# rpc1418/stockportfolio-fullstack architecture

> Architecture diagram of the GitHub repository rpc1418/stockportfolio-fullstack, 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/rpc1418/stockportfolio-fullstack
- Repository: https://github.com/rpc1418/stockportfolio-fullstack

## Overview

Stockify is a simulated stock-trading and portfolio platform. Users register or log in, browse stock data, place buy/sell orders, and review portfolio performance; administrators manage stocks and users. The React application calls Spring Boot APIs, with portfolio operations backed by AWS data services and user identity handled through a JPA repository. The README also documents automated price updates and a news feed. Some backend and frontend excerpts are partial, so uncertain implementation links are omitted; AWS automation and database roles are represented as documented capabilities.

Main entry points: [`Frontend/stockportfolio-main/src/App.js`](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/App.js) (App routing), [`Frontend/stockportfolio-main/src/context/AuthContext.js`](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/AuthContext.js) (Auth context), [`Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java) (Portfolio API), [`Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java) (Portfolio service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React experience"]
  node_app["App routing<br/>[App.js]"]
  node_registration["Registration flow"]
  node_login["Login UI<br/>[Login.js]"]
  node_newsui["News feed UI<br/>[News.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Auth context<br/>[AuthContext.js]"]
  node_protected["Role guards<br/>[ProtectedRoutes.js]"]
  node_userdetails["User details service"]
  node_jwtfilter["JWT filter<br/>[JwtAuthFilter.java]"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
end

subgraph group_trading["Trading and portfolio"]
  node_stockstate["Stock context<br/>[StockCon.js]"]
  node_dashboard["Portfolio dashboard"]
  node_summary["Portfolio summary"]
  node_calculator["Portfolio calculator"]
  node_orders["Order interface<br/>[OrderStock.js]"]
  node_stockdetails["Stock details<br/>[StockDetails.js]"]
  node_historychart["Price history chart"]
  node_adminui["Admin controls"]
end

subgraph group_backend["Spring API"]
  node_controller["Portfolio API"]
  node_service["Portfolio service"]
  node_models["Domain models"]
end

subgraph group_data["Persistence and feeds"]
  node_repository[("User repository")]
  node_dynamodb[("DynamoDB")]
  node_rds[("RDS")]
  node_newsapi["News API"]
  node_scheduler["EventBridge schedule"]
  node_lambda["Price updater"]
end

node_investor(("Investor"))
node_admin(("Administrator"))

node_investor -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"provides context"| node_registration
node_app -->|"guards routes"| node_protected
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_orders
node_app -->|"routes to"| node_stockdetails
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_newsui
node_login -->|"authenticates via"| node_auth
node_protected -->|"checks identity"| node_auth
node_registration -->|"submits registration"| node_controller
node_auth -->|"calls login API"| node_controller
node_auth -->|"submits portfolio update"| node_controller
node_auth -->|"loads portfolio data"| node_stockstate
node_userdetails -->|"looks up user"| node_repository
node_jwtfilter -->|"validates token"| node_jwt
node_controller -->|"delegates operations"| node_service
node_controller -->|"accepts and returns"| node_models
node_service -->|"uses user repository"| node_repository
node_service -->|"processes records"| node_models
node_service -->|"reads and writes"| node_dynamodb
node_repository -.->|"persists users"| node_rds
node_dynamodb -.->|"stock data via API"| node_stockstate
node_orders -->|"uses auth context"| node_auth
node_dashboard -->|"renders"| node_summary
node_summary -->|"calculates metrics"| node_calculator
node_summary -->|"reads portfolio state"| node_stockstate
node_stockdetails -->|"reads stock state"| node_stockstate
node_stockdetails -->|"renders history"| node_historychart
node_controller -.->|"fetches articles"| node_newsapi
node_newsui -.->|"loads market news"| node_newsapi
node_scheduler -->|"triggers hourly cycle"| node_lambda
node_lambda -->|"writes price updates"| node_dynamodb

click node_app "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/App.js"
click node_registration "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/RegisterUserContext.js"
click node_login "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/auth/Login.js"
click node_auth "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/AuthContext.js"
click node_protected "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/utils/ProtectedRoutes.js"
click node_userdetails "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java"
click node_jwtfilter "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java"
click node_jwt "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java"
click node_stockstate "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/StockCon.js"
click node_dashboard "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/PortfolioTracker.js"
click node_summary "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/PortfolioSummary.js"
click node_calculator "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/services/PortfolioCalculator.js"
click node_orders "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/OrderStock.js"
click node_stockdetails "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/stock/StockDetails.js"
click node_historychart "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/StockHistoryChart.js"
click node_adminui "https://github.com/rpc1418/stockportfolio-fullstack/tree/main/Frontend/stockportfolio-main/src/components/adminComponents"
click node_newsui "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/News.js"
click node_controller "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java"
click node_service "https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java"
click node_models "https://github.com/rpc1418/stockportfolio-fullstack/tree/main/Backend/Capstone/src/main/java/com/myapp/model"
click node_repository "https://github.com/rpc1418/stockportfolio-fullstack/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_app,node_registration,node_login,node_newsui toneBlue
class node_auth,node_protected,node_userdetails,node_jwtfilter,node_jwt toneAmber
class node_stockstate,node_dashboard,node_summary,node_calculator,node_orders,node_stockdetails,node_historychart,node_adminui toneMint
class node_controller,node_service,node_models toneRose
class node_repository,node_dynamodb,node_rds,node_newsapi,node_scheduler,node_lambda,node_investor,node_admin toneIndigo
```

## Components

### React experience

- [App routing](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/App.js): `Frontend/stockportfolio-main/src/App.js`
- [Registration flow](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/RegisterUserContext.js): `Frontend/stockportfolio-main/src/context/RegisterUserContext.js`
- [Login UI](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/auth/Login.js): `Frontend/stockportfolio-main/src/components/auth/Login.js`
- [News feed UI](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/News.js): `Frontend/stockportfolio-main/src/News.js`

### Identity and access

- [Auth context](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/AuthContext.js): `Frontend/stockportfolio-main/src/context/AuthContext.js`
- [Role guards](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/utils/ProtectedRoutes.js): `Frontend/stockportfolio-main/src/utils/ProtectedRoutes.js`
- [User details service](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java): `Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java`
- [JWT filter](https://github.com/rpc1418/stockportfolio-fullstack/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/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java): `Backend/Capstone/src/main/java/com/myapp/config/JwtUtil.java`

### Trading and portfolio

- [Stock context](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/context/StockCon.js): `Frontend/stockportfolio-main/src/context/StockCon.js`
- [Portfolio dashboard](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/PortfolioTracker.js): `Frontend/stockportfolio-main/src/components/PortfolioTracker.js`
- [Portfolio summary](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/PortfolioSummary.js): `Frontend/stockportfolio-main/src/components/dashboard/PortfolioSummary.js`
- [Portfolio calculator](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/services/PortfolioCalculator.js): `Frontend/stockportfolio-main/src/services/PortfolioCalculator.js`
- [Order interface](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/OrderStock.js): `Frontend/stockportfolio-main/src/components/dashboard/OrderStock.js`
- [Stock details](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/stock/StockDetails.js): `Frontend/stockportfolio-main/src/components/stock/StockDetails.js`
- [Price history chart](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Frontend/stockportfolio-main/src/components/dashboard/StockHistoryChart.js): `Frontend/stockportfolio-main/src/components/dashboard/StockHistoryChart.js`
- [Admin controls](https://github.com/rpc1418/stockportfolio-fullstack/tree/main/Frontend/stockportfolio-main/src/components/adminComponents): `Frontend/stockportfolio-main/src/components/adminComponents`

### Spring API

- [Portfolio API](https://github.com/rpc1418/stockportfolio-fullstack/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/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java): `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`
- [Domain models](https://github.com/rpc1418/stockportfolio-fullstack/tree/main/Backend/Capstone/src/main/java/com/myapp/model): `Backend/Capstone/src/main/java/com/myapp/model`

### Persistence and feeds

- [User repository](https://github.com/rpc1418/stockportfolio-fullstack/blob/main/Backend/Capstone/src/main/java/com/myapp/repository/portfolioRepository.java): `Backend/Capstone/src/main/java/com/myapp/repository/portfolioRepository.java`
- **DynamoDB**
- **RDS**
- **News API**
- **EventBridge schedule**
- **Price updater**

### Other components

- **Investor**
- **Administrator**

## Connections

- Investor → App routing: uses
- Administrator → App routing: uses
- App routing → Login UI: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Registration flow: provides context (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Role guards: guards routes (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Portfolio dashboard: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Order interface: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Stock details: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → Admin controls: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- App routing → News feed UI: routes to (evidence: `Frontend/stockportfolio-main/src/App.js`)
- Login UI → Auth context: authenticates via (evidence: `Frontend/stockportfolio-main/src/components/auth/Login.js`)
- Role guards → Auth context: checks identity (evidence: `Frontend/stockportfolio-main/src/utils/ProtectedRoutes.js`)
- Registration flow → Portfolio API: submits registration (evidence: `Frontend/stockportfolio-main/src/context/RegisterUserContext.js`)
- Auth context → Portfolio API: calls login API (evidence: `Frontend/stockportfolio-main/src/context/AuthContext.js`)
- Auth context → Portfolio API: submits portfolio update (evidence: `Frontend/stockportfolio-main/src/context/AuthContext.js`)
- Auth context → Stock context: loads portfolio data (evidence: `Frontend/stockportfolio-main/src/context/AuthContext.js`)
- User details service → User repository: looks up user (evidence: `Backend/Capstone/src/main/java/com/myapp/config/MyUserDetailsService.java`)
- JWT filter → JWT utilities: validates token (evidence: `Backend/Capstone/src/main/java/com/myapp/config/JwtAuthFilter.java`)
- Portfolio API → Portfolio service: delegates operations (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio API → Domain models: accepts and returns (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- Portfolio service → User repository: uses user repository (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- Portfolio service → Domain models: processes records (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- Portfolio service → DynamoDB: reads and writes (evidence: `Backend/Capstone/src/main/java/com/myapp/service/portfolioService.java`)
- User repository → RDS: persists users
- DynamoDB → Stock context: stock data via API
- Order interface → Auth context: uses auth context (evidence: `Frontend/stockportfolio-main/src/components/dashboard/OrderStock.js`)
- Portfolio dashboard → Portfolio summary: renders (evidence: `Frontend/stockportfolio-main/src/components/PortfolioTracker.js`)
- Portfolio summary → Portfolio calculator: calculates metrics (evidence: `Frontend/stockportfolio-main/src/components/dashboard/PortfolioSummary.js`)
- Portfolio summary → Stock context: reads portfolio state (evidence: `Frontend/stockportfolio-main/src/components/dashboard/PortfolioSummary.js`)
- Stock details → Stock context: reads stock state (evidence: `Frontend/stockportfolio-main/src/components/stock/StockDetails.js`)
- Stock details → Price history chart: renders history (evidence: `Frontend/stockportfolio-main/src/components/stock/StockDetails.js`)
- Portfolio API → News API: fetches articles (evidence: `Backend/Capstone/src/main/java/com/myapp/controller/portfolioController.java`)
- News feed UI → News API: loads market news
- EventBridge schedule → Price updater: triggers hourly cycle
- Price updater → DynamoDB: writes price updates
