// Understand onepixel runtime architecture, host-based app dispatch, and redirect analytics flow before changing behavior across routes/controllers/db.
| name | architecture |
| description | Understand onepixel runtime architecture, host-based app dispatch, and redirect analytics flow before changing behavior across routes/controllers/db. |
Use this skill when implementing features that cross app startup, routing, controller behavior, or data boundaries.
src/main.go.db.GetAppDB)db.GetEventsDB)db.GetGeoIPDB)Host header:
ADMIN_SITE_HOST -> server.CreateAdminAppMAIN_SITE_HOST -> server.CreateMainAppsrc/db/init.go.src/routes/redirect/redirect.go.EventsController.LogRedirectAsync.src/utils/posthog/posthog_client.go).src/server/parsers) -> validator (src/server/validators) -> controller -> DTO responseReference for all onepixel API endpoints, their HTTP methods, paths, auth requirements, and behavior.
Understand onepixel database topology by environment, data ownership across app/events stores, and initialization/migration behavior.
Build and run onepixel binaries, generate Swagger docs when needed, and produce cross-platform release artifacts.
Apply onepixel repository conventions for env loading, DB backend selection, auth locals, error payloads, and shortcode semantics.
Run onepixel unit and e2e tests with correct env setup, coverage artifacts, and troubleshooting guidance for GeoIP/network-related failures.