How teddysmithdev/finshark works
This is a stock research and portfolio web application: users register or log in, search companies, inspect company and financial-statement views, and manage portfolios and stock comments. The React frontend routes these experiences and calls an ASP.NET API; the API handles identity, stocks, portfolios, and comments, with SQL-backed persistence and a Financial Modeling Prep integration. The README is empty, and several frontend and API modules were not excerpted, so uncertain cross-system links are omitted or marked unverified.
Main entry points: api.tsx API client · Program.cs API service wiring · StockRepository.cs Stock repository · ApplicationDBContext.cs Application data context
Components 24
Web application
- Page routing
frontend/src/Routes/Routes.tsx - Login and register
frontend/src/Pages/LoginPage/LoginPage.tsx - Search page
frontend/src/Pages/SearchPage/SearchPage.tsx - Company page
frontend/src/Pages/CompanyPage/CompanyPage.tsx - Financial statements
frontend/src/Components/IncomeStatement/IncomeStatement.tsx - Auth context
frontend/src/Context/useAuth.tsx - Auth service
frontend/src/Services/AuthService.tsx - Portfolio service
frontend/src/Services/PortfolioService.tsx - Comment service
frontend/src/Services/CommentService.tsx - API client
frontend/src/api.tsx
API domain
- Account endpoints
api/Controllers/AccountController.cs - Stock endpoints
api/Controllers/StockController.cs - Portfolio endpoints
api/Controllers/PortfolioController.cs - Comment endpoints
api/Controllers/CommentController.cs - FMP service
api/Service/FMPService.cs - JWT token service
api/Service/TokenService.cs - API service wiring
api/Program.cs
Persistence
- Stock repository
api/Repository/StockRepository.cs - Portfolio repository
api/Repository/PortfolioRepository.cs - Comment repository
api/Repository/CommentRepository.cs - Application data context
api/Data/ApplicationDBContext.cs
External systems
- SQL database
- Financial Modeling Prep
Other components
- User
Connections 34
- User → Page routing: opens pages
frontend/src/Routes/Routes.tsx - Page routing → Login and register: routes to
frontend/src/Routes/Routes.tsx - Page routing → Search page: protects and routes
frontend/src/Routes/Routes.tsx - Page routing → Company page: protects and routes
frontend/src/Routes/Routes.tsx - Company page → Financial statements: hosts views
frontend/src/Routes/Routes.tsx - Login and register → Auth context: uses
- Auth context → Auth service: calls
frontend/src/Context/useAuth.tsx - Search page → Portfolio service: uses
frontend/src/Pages/SearchPage/SearchPage.tsx - Search page → API client: uses
frontend/src/Pages/SearchPage/SearchPage.tsx - Auth service → API client: requests
- Portfolio service → API client: requests
- Comment service → API client: requests
- API client → Account endpoints: calls API
- API client → Stock endpoints: calls API
- API client → Portfolio endpoints: calls API
- API client → Comment endpoints: calls API
- Account endpoints → JWT token service: issues tokens
api/Controllers/AccountController.cs - Stock endpoints → Stock repository: uses
api/Controllers/StockController.cs - Portfolio endpoints → Portfolio repository: uses
api/Controllers/PortfolioController.cs - Portfolio endpoints → Stock repository: looks up stocks
api/Controllers/PortfolioController.cs - Comment endpoints → Comment repository: uses
api/Controllers/CommentController.cs - Comment endpoints → Stock repository: looks up stocks
api/Controllers/CommentController.cs - Comment endpoints → FMP service: finds missing stocks
api/Controllers/CommentController.cs - Stock repository → Application data context: queries and saves
api/Repository/StockRepository.cs - Portfolio repository → Application data context: queries and saves
api/Repository/PortfolioRepository.cs - Comment repository → Application data context: queries and saves
api/Repository/CommentRepository.cs - Application data context → SQL database: persists data
- FMP service → Financial Modeling Prep: fetches stock data
- API service wiring → Application data context: configures
api/Program.cs - API service wiring → Stock repository: registers
api/Program.cs - API service wiring → Portfolio repository: registers
api/Program.cs - API service wiring → Comment repository: registers
api/Program.cs - API service wiring → FMP service: registers
api/Program.cs - API service wiring → JWT token service: registers
api/Program.cs