How mohamednasr18/rasd works
RASD is a website SEO auditing application: a visitor submits a site for scanning, reviews scan and page-level findings, can generate a report, and can ask a scan-specific SEO assistant questions. The backend also supports guest or account ownership and bilingual interactions. The graph includes documented scan, report, chat, and authentication stages plus their principal internal services. The README is empty; frontend-to-backend wiring and queue-worker handoffs are not established by the excerpts, so those links are omitted or marked unverified.
Main entry points: prisma.service.ts Application database · chat.service.ts Chat orchestration · seo.controller.ts Scan API · viewer.service.ts Viewer access
Components 24
Web interface
- Audit interface
rasd-frontend/src/app/[lang]/page.tsx - Scan details
rasd-frontend/src/app/[lang]/scans/[id]/page.tsx - Page details
rasd-frontend/src/app/[lang]/scans/[id]/pages/[pageId]/page.tsx - Report display
rasd-frontend/src/components/ReportSection.tsx - Sign-in dialog
rasd-frontend/src/components/auth/AuthDialog.tsx
Identity and access
- Authentication API
rasd-backend/src/auth/auth.controller.ts - Authentication
rasd-backend/src/auth/auth.service.ts - Viewer access
rasd-backend/src/auth/viewer.service.ts
SEO scanning
- Scan API
rasd-backend/src/seo/seo.controller.ts - Scan orchestration
rasd-backend/src/seo/seo.service.ts - Site crawler
rasd-backend/src/seo/site-crawler.service.ts - SEO analyzer
rasd-backend/src/seo/seo-analyzer.service.ts - Sitemap parsing
rasd-backend/src/seo/sitemap.utils.ts
Reports
- Report API
rasd-backend/src/report/report.controller.ts - Report orchestration
rasd-backend/src/report/report.service.ts - Scan aggregation
rasd-backend/src/report/report-aggregator.service.ts - Report generation
rasd-backend/src/report/report-generator.service.ts
SEO assistant
- Chat API
rasd-backend/src/chat/chat.controller.ts - Chat orchestration
rasd-backend/src/chat/chat.service.ts - Chat agent
rasd-backend/src/chat/chat-agent.service.ts - Knowledge retrieval
rasd-backend/src/chat/knowledge-base.service.ts
Persistence and jobs
- Application database
rasd-backend/src/prisma/prisma.service.ts - Redis connection
rasd-backend/src/redis-connection.ts
Other components
- Site owner
Connections 28
- Site owner → Audit interface: uses
- Site owner → Sign-in dialog: signs in
- Scan API → Scan orchestration: enqueues scans
rasd-backend/src/seo/seo.controller.ts - Scan API → Viewer access: resolves access
rasd-backend/src/seo/seo.controller.ts - Scan orchestration → Site crawler: crawls sites
rasd-backend/src/seo/seo.service.ts - Scan orchestration → Application database: stores scan data
rasd-backend/src/seo/seo.service.ts - Scan orchestration → Redis connection: uses connection
rasd-backend/src/seo/seo.service.ts - SEO analyzer → Sitemap parsing: parses sitemaps
rasd-backend/src/seo/seo-analyzer.service.ts - Report API → Report orchestration: requests reports
rasd-backend/src/report/report.controller.ts - Report API → Viewer access: checks access
rasd-backend/src/report/report.controller.ts - Report orchestration → Application database: reads scan data
rasd-backend/src/report/report.service.ts - Scan aggregation → Application database: reads scan data
rasd-backend/src/report/report-aggregator.service.ts - Report generation → Scan aggregation: uses aggregation
rasd-backend/src/report/report-generator.service.ts - Chat API → Chat orchestration: sends messages
rasd-backend/src/chat/chat.controller.ts - Chat API → Viewer access: checks access
rasd-backend/src/chat/chat.controller.ts - Chat orchestration → Chat agent: invokes agent
rasd-backend/src/chat/chat.service.ts - Chat orchestration → Knowledge retrieval: retrieves guidance
rasd-backend/src/chat/chat.service.ts - Chat orchestration → Scan aggregation: builds context
rasd-backend/src/chat/chat.service.ts - Chat orchestration → Application database: reads conversations
rasd-backend/src/chat/chat.service.ts - Authentication API → Authentication: handles auth
rasd-backend/src/auth/auth.controller.ts - Authentication → Viewer access: uses viewer
rasd-backend/src/auth/auth.service.ts - Authentication → Application database: stores credentials
rasd-backend/src/auth/auth.service.ts - Viewer access → Application database: checks sessions
rasd-backend/src/auth/viewer.service.ts - Audit interface → Scan API: submits scans
- Scan details → Scan API: loads scan
- Page details → Scan API: loads page
- Report display → Report API: requests report
- Sign-in dialog → Authentication API: authenticates