How bkstar123/kstock-v2 works
KStock is an admin-facing Vietnamese stock analysis platform. Admins add symbols, request quarterly or annual statements, and receive queued pulls; saved statements can be analyzed into company-type-specific ratios and viewed over rolling periods. Separate product areas cover company profiles and valuation, side-by-side comparisons, watchlists, freshness settings, and role-based administration. The graph combines sampled controller behavior with major README-documented capabilities; several feature implementations were not sampled, so their internal wiring is intentionally not expanded.
Main entry points: AnalyzeFinancialStatement.php Analysis job · CompanyController.php Company directory · FinancialStatement.php Financial statements · SymbolController.php Statement controller
Components 25
Statement ingestion
- Statement controller
app/Http/Controllers/SymbolController.php - Statement pull job
app/Jobs/PullFinancialStatement.php - Statement library
app/Services/StatementLibrary.php - Financial statements
app/Models/FinancialStatement.php - Statement models
app/Models/BaseStatement.php
Financial analysis
- Analysis job
app/Jobs/AnalyzeFinancialStatement.php - Ratio calculators
app/Jobs/Financials/Calculators - Report writers
app/Jobs/Financials/Writers - Analysis reports
app/Models/AnalysisReport.php - Completion events
app/Events/AnalyzeFinancialStatementCompleted.php
Market insights
- Company directory
app/Http/Controllers/CompanyController.php - Symbol services
app/Services/Symbols.php - Stock comparison
app/Http/Controllers/ComparisonController.php - Watchlist
app/Http/Controllers/WatchlistController.php - Watchlist records
app/Models/Watchlist.php - Symbol directory
app/Models/DirectoryEntry.php
Admin operations
- Freshness settings
app/Http/Controllers/SettingController.php - Admin and RBAC
packages/bkscms-admin-panel/src/routes/routes.php - Access policies
app/Providers/AuthServiceProvider.php
User interface
- Statement screens
resources/views/cms/symbols/statements/index.blade.php - Company hub views
resources/views/cms/companies/show.blade.php - Comparison view
resources/views/cms/compare/index.blade.php
Other components
- Admin user
- Market-data API
- Realtime notifications
Connections 28
- Admin user → Statement screens: requests statements
- Statement screens → Statement controller: submits pull
- Statement controller → Statement library: attaches ownership
- Statement controller → Statement pull job: dispatches pull
- Statement pull job → Market-data API: fetches statements
- Statement pull job → Financial statements: updates statement
- Statement library → Financial statements: tracks ownership
- Financial statements → Statement models: stores periods
- Financial statements → Analysis job: provides saved data
- Analysis job → Ratio calculators: computes ratios
- Analysis job → Report writers: writes report data
- Report writers → Analysis reports: persists reports
- Analysis job → Completion events: emits completion
- Completion events → Realtime notifications: broadcasts update
- Admin user → Company directory: browses companies
- Company directory → Symbol services: requests market data
- Symbol services → Market-data API: fetches quotes and fundamentals
- Company directory → Symbol directory: manages directory
- Company directory → Company hub views: renders hub
- Admin user → Stock comparison: compares tickers
- Stock comparison → Symbol services: requests indicators
- Stock comparison → Comparison view: renders comparison
- Admin user → Watchlist: manages watchlist
- Watchlist → Watchlist records: reads and writes
- Admin user → Freshness settings: configures freshness
- Freshness settings → Market-data API: configures credentials
- Admin user → Admin and RBAC: administers accounts
- Admin and RBAC → Access policies: checks permissions