Skip to content

Architecture

Sources and verifications

Consultation date: 2026-11-03. Preference for primary documentation. URLs support technical capabilities; this project's architecture choices are our own proposals.

Consultation date: 2026-11-03. Preference for primary documentation. URLs support technical capabilities; this project's architecture choices are our own proposals.

SourceUse
Vukem — introductionExisting framework
Vukem — social loginGoogle, OIDC, PKCE, state, scaffold and variables
Vukem — InertiaReact pages and props from the backend
shadcn/ui — VitePlanned integration with the current frontend
shadcn/ui — SidebarRequired component
Google — OpenID ConnectIdentity and login validation
Railway — pre-deployMigrations before serving the version
Railway — healthchecksVerification at publication
Railway — scalingReplicas and infrastructure
Railway — serverlessVerification of the hibernation policy
Alpaca — paper tradingCandidate environment and simulation limits
Alpaca — ordersClient order ID and order query

Alpaca paper uses its own endpoint/credentials; paper does not replace validation in the real market. Paper-only accounts have feed limitations; validate the chosen plan. The documentation describes querying by client_order_id, but this alone does not guarantee exactly-once execution. Do not assume B3 support.

Local code consulted: bootstrap/app.go, routes/web.go, go.mod, package.json, Dockerfile, CI and the upstream Vukem scaffold at /tmp/vukem. The upstream copy serves for investigation; when implementing, verify the same APIs in the 0.37.0 module pinned in go.mod, since main may evolve.

The context text contains cost values, deadlines and regulatory claims. They were not adopted as verified quotes or opinions. For SaaS/live, record specific research and review of jurisdiction and service before the offer.

Additional verification confirmed social login and middleware also in the Vukem 0.37.0 module installed in GOPATH/pkg/mod, not only in upstream main. Railway pre-deploy uses a separate container, with network/env available and no mounted volumes; a Docker start command replaces ENTRYPOINT. Additional references: Start command and Services.

The detailed web research, carried out on 2026-11-03, records findings by topic, open sources, access limitations and next tests.