How stjudewashere/seonaut works
Project type and purpose
• SEOnaut is a full-stack, monolithic web application written in Go.
• Purpose: crawl and audit websites for SEO issues, store results in a MySQL database, and present an interactive dashboard (using custom CSS/vanilla JS + Apache ECharts) to end users.
File structure
• Top-level components:
• cmd/server: entrypoint (main.go) that wires up HTTP server, services, repository, migrations.
• internal/: Go packages organized by feature/layer (archiver, crawler, issues, models, repository, routes, services, urlutils).
• web/: static assets (CSS, fonts, robots.txt) and HTML templates for server-side rendering.
• migrations/: SQL migrations for schema evolution.
• docker-compose.yml / Dockerfile: container orchestration and packaging.
• Patterns:
• Layered architecture (HTTP → routes → services → repository → MySQL).
• Modular feature groups (crawler engine, issue detectors, archiver).
• Single Go binary + Docker-deployed MySQL container.
README for additional insights
• Confirms Go + MySQL stack, Docker-based deployment, port 9000 HTTP interface, recommendation for HTTPS via reverse proxy.
• Hosted version uses same architecture (Go app container + MySQL).
Detail
• Routes
• Services (crawler, archiver, parser, issue detector, renderer)
• Repository
• Config & utils
• Essential modules without over-aggregating.