How maxim-coder-arch/personal-website works
This is a personal portfolio website with an administrative backend: visitors browse project and article content, while an administrator manages content and reviews audience analytics. The backend also collects and aggregates visit data, and the frontend provides the public pages, admin views, and analytics tracker. The README contains no product description, and most frontend wiring and the analytics ingestion controller were not sampled; those relationships are therefore omitted or marked unverified rather than asserted as confirmed calls.
Main entry points: ApplicationDBContext.cs Application database · (views) Portfolio pages · articles-page.tsx Articles pages · AdminAnalyticsController.cs Analytics endpoints
Components 21
Public Portfolio
- Portfolio pages
frontend/src/(views) - Projects page
frontend/src/(views)/projects-page/ui/layer/projects-page.tsx - Articles pages
frontend/src/(views)/articles-page/ui/layer/articles-page.tsx - Article reader
frontend/src/widgets/sections/article-page/article-reader/ui/layer/article-page-reader.tsx - Analytics tracker
frontend/src/features/analytics-tracker/lib/helpers/tracker.ts
Admin Experience
- Admin login
frontend/src/features/admin-auth/ui/layer/admin-login-form.tsx - Analytics dashboard
frontend/src/(views)/admin-page/ui/layer/admin-page.tsx - Audience view
frontend/src/(views)/admin-audience-page/ui/layer/admin-audience-page.tsx - Admin auth client
frontend/src/entities/api/admin-auth/admin-auth-api.ts - Analytics client
frontend/src/entities/api/analytics/analytics-api.ts
Backend API
- Content endpoints
backend/backend/Controllers/ArticlesController.cs - Project endpoints
backend/backend/Controllers/ProjectsController.cs - Admin auth endpoints
backend/backend/Controllers/Admin/AdminAuthController.cs - Analytics endpoints
backend/backend/Controllers/Admin/AdminAnalyticsController.cs
Persistence and Analytics
- Analytics collector
backend/backend/Services/Analytics/AnalyticsCollector.cs - Analytics reader
backend/backend/Services/Analytics/AnalyticsReader.cs - Geolocation lookup
backend/backend/Services/Analytics/GeoLocator.cs - Development data seeder
backend/backend/Dtos/Analytics/DevDataSeeder.cs - Application database
backend/backend/Data/ApplicationDBContext.cs
Other components
- Site visitor
- Administrator
Connections 23
- Site visitor → Portfolio pages: browses
- Portfolio pages → Projects page: shows projects
- Portfolio pages → Articles pages: shows articles
- Articles pages → Article reader: opens article
- Portfolio pages → Analytics tracker: tracks visits
- Analytics tracker → Analytics collector: sends events
- Projects page → Project endpoints: requests projects
- Articles pages → Content endpoints: requests articles
- Administrator → Admin login: signs in
- Admin login → Admin auth client: submits credentials
- Admin auth client → Admin auth endpoints: calls
- Administrator → Analytics dashboard: reviews metrics
- Administrator → Audience view: reviews audience
- Analytics dashboard → Analytics client: requests metrics
- Audience view → Analytics client: requests audience
- Analytics client → Analytics endpoints: calls
- Content endpoints → Application database: reads and writes
backend/backend/Controllers/ArticlesController.cs - Project endpoints → Application database: reads and writes
backend/backend/Controllers/ProjectsController.cs - Admin auth endpoints → Application database: reads and writes
backend/backend/Controllers/Admin/AdminAuthController.cs - Analytics endpoints → Analytics reader: queries
backend/backend/Controllers/Admin/AdminAnalyticsController.cs - Analytics endpoints → Development data seeder: seeds data
backend/backend/Controllers/Admin/AdminAnalyticsController.cs - Analytics reader → Application database: reads analytics
backend/backend/Services/Analytics/AnalyticsReader.cs - Development data seeder → Application database: writes sample data
backend/backend/Dtos/Analytics/DevDataSeeder.cs