Onboarding Portal

Use this page to get productive in under 30 minutes.

What this repo is

GitiNext backend is a Go monorepo with:

• services/*: deployable services (Docker images, Swarm services)
• packages/*: shared libraries (logger, vault, rpc, metrics, etc.)
• shared-schema/*: protobuf + generated code shared across services
• docker-compose.swarm.yml: production-ish Swarm deployment definition

Quickstart (read-first)

1. Intro + product context: docs/README.md
2. Setup + first run: docs/overview/getting-started.md
3. Architecture map: docs/architecture/microservices.md

Where to look first (by role)

Backend engineers

• Commands: docs/guides/quick-reference.md
• Wallet flows: docs/guides/wallet-service.md
• Signers (TON/TRON/EVM/TWC): docs/guides/signer-implementation.md

DevOps / SRE

• Production deploy patterns: docs/guides/DEPLOYMENT-GUIDE.md
• Swarm stack definition (source of truth): docker-compose.swarm.yml
• Monitoring config: monitoring/ and monitoring/GRAFANA_ALERTS_SETUP.md

Frontend (TMA) integrators

• Swagger / OpenAPI: https://api.nextgiti.cloud/swagger/
• Current API readiness snapshot: docs/CURRENT_STATUS_SUMMARY.md

How docs are served

docs.nextgiti.cloud is served by the services/docs Go service that bakes this repo’s docs/ folder into the docs image at build time.