GitiNext Wallet Backend Documentation
Version: 1.0.0
Last Updated: October 6, 2025
Status: Migration in Progress (Phase 0)
🚀 Quick Navigation
👋 New to the Project?
- Start with Introduction
- Follow Getting Started
- Understand Architecture
🔨 Ready to Code?
- Check Migration Overview
- Pick a task from Task Breakdown
- Follow the Development Guide
📚 Looking for Specific Info?
- API Endpoints: API Reference
- Database Schema: Database Documentation
- External APIs: Integration Guide
- Testing: Testing Guide
📖 Documentation Sections
Overview
Get familiar with the project, architecture, and technology stack.
- Introduction - What is GitiNext?
- Getting Started - Setup development environment
- Architecture Overview - High-level system design
- Technology Stack - Technologies and libraries used
Architecture
Deep dive into system architecture and design decisions.
- Microservices - Service breakdown
- Database Schema - Complete database design
- Security - Security architecture
- External Integrations - Third-party APIs
- Current System Analysis - What’s implemented
Migration Guide
Complete guide for migrating from Node.js to Go.
- Overview - Migration strategy and progress
- Task Breakdown - Detailed task list (24 tasks)
- Progress Tracking - Daily progress updates
- Planning Summary - Planning phase summary
- Phase 0: Foundation - Critical infrastructure
- Phase 1: Core Services - Market & Transaction services
- Phase 2: Financial - Payment, Voucher, Blockchain
- Phase 3: User Services - Support, KYC, Account
- Phase 4: Integration - End-to-end flows
- Phase 5: Production - Containerization & deployment
- Phase 6: Testing - Frontend integration & testing
Guides
Step-by-step guides for common tasks.
- Quick Reference - Commands and workflows
- Wallet Service - Wallet operations guide
- Watcher Service - Blockchain monitoring guide
- Signer Implementation - Implementing signers
- Database Integration - Database setup and usage
- Testing Guide - How to test services
- Deployment Guide - Production deployment
- Development Guide - Daily development workflow
API Reference
Complete API documentation for all services.
- Gateway REST API - HTTP/REST endpoints
- Wallet gRPC - Wallet service gRPC methods
- Account gRPC - Account service gRPC methods
- Market gRPC - Market service gRPC methods
- Transaction gRPC - Transaction service gRPC methods
Tutorials
Hands-on tutorials for learning by doing.
- Creating Your First Service - Build a microservice
- Implementing a Signer - TON/TRON signing
- Setting up Watchers - Blockchain monitoring
- Testing Locally - Development testing workflow
🎯 Current Focus: Phase 0 - Foundation
We’re currently in Phase 0 of the migration, focusing on critical infrastructure:
Active Tasks:
- Task 0.1: Fix TON Signer (IN PROGRESS) 🔵
- Task 0.2: Fix TRON Signer (PENDING)
- Task 0.3: Complete TON Watcher (PENDING)
- Task 0.4: Complete TRON Watcher (PENDING)
- Task 0.5: Create Balance Service (PENDING)
Progress: 0/5 tasks completed
See Migration Progress for real-time updates.
📊 Project Statistics
- Total Services: 11 microservices (3 exist, 7 to create, 1 to extend)
- Migration Tasks: 24 major tasks across 6 phases
- Estimated Duration: 8 weeks
- External APIs: 7 integrations
- Supported Blockchains: 4+ (TON, TRON, ETH, BSC)
🔗 Important Links
Internal Resources:
- Migration Plan - Complete task list
- Progress Tracker - Daily updates
- Architecture Diagrams - System design
External Resources:
- TON: https://docs.ton.org
- TRON: https://developers.tron.network
- Ethereum: https://ethereum.org/en/developers/docs/
- Protocol Buffers: https://protobuf.dev
Code Repositories:
- Backend (Go):
/opt/cryptotel/enterprise/stacks/gitinext/gitinext-golang - Frontend (TMA):
/opt/cryptotel/enterprise/stacks/gitinext/gitinext-telegram - Legacy (Node.js):
/opt/cryptotel/enterprise/stacks/gitinext/gitinext-golang/gitibot-back-main
💬 Support & Communication
Getting Help:
- Documentation Issues: Create GitHub issue with
docslabel - Technical Questions: Ask in #gitinext-backend Slack channel
- Bug Reports: Create GitHub issue with reproduction steps
- Feature Requests: Discuss in team meetings first
Contributing:
- Code: Submit PRs with tests and documentation updates
- Documentation: Submit PRs for docs improvements
- Testing: Help with integration testing
- Review: Participate in code reviews
🎓 Learning Path
For Backend Developers:
- Read Introduction (5 min)
- Set up Development Environment (30 min)
- Understand Microservices Architecture (20 min)
- Review Database Schema (15 min)
- Pick a Migration Task (start coding!)
For Frontend Developers:
- Read API Reference
- Check TMA Integration Guide
- Follow frontend development workflow
For DevOps:
- Review Architecture
- Read Deployment Guide
- Set up Monitoring
📝 Documentation Standards
Writing Documentation:
- Use clear, concise language
- Include code examples
- Add diagrams where helpful
- Keep up-to-date with code changes
- Use markdown formatting consistently
Code Comments:
- Explain WHY, not just WHAT
- Document all exported functions
- Include usage examples
- Note any gotchas or edge cases
Updating Docs:
- Update docs in the same PR as code changes
- Add migration notes for breaking changes
- Update API reference when endpoints change
- Keep progress tracker current
🔄 Recent Updates
2025-10-06:
- 📝 Created complete documentation structure
- 📋 Documented all 24 migration tasks
- 🏗️ Documented microservices architecture
- 🔐 Documented security architecture
- 🗄️ Documented database schema
- 📊 Created progress tracking system
📞 Contact
- Project Lead: [Name]
- Backend Team: #gitinext-backend (Slack)
- Documentation: docs@nextgiti.cloud
- Support: support@nextgiti.cloud
Happy Coding! 🚀
For the latest updates, see Migration Progress