Professional networking and fundraising platform for startups, investors, and talent.

Real Deal is a comprehensive platform that connects startups with investors, companies with talent, and facilitates professional networking. It features multi-provider OAuth authentication, company verification, job management, VC/YC fundraising workflows, AI-powered recommendations, and tiered billing.

• Multi-provider OAuth/OIDC (WeChat, Apple, Google, GitHub, LinkedIn)
• Account merging and binding
• Secure session management
• Role-based access control

• Job posting and management
• Company profiles and verification
• Job compliance and moderation
• AI-powered job matching

• Investor profiles with availability
• Pitch pages for founders
• Deal rooms with access controls
• AI-powered investor-founder matching
• Dual-consent introductions

• Project and product showcases
• Blog posts and updates
• Media asset management (MinIO)
• Content moderation

• Tiered storage limits
• Capacity packs
• Job slot quotas
• Usage metering and tracking
• Charge history

• Intelligent recommendations
• AI customer service
• Natural language query understanding
• Content personalization

• Custom themes and skins
• Style token system
• Theme validation and review
• Creator revenue sharing

• Language: Go 1.23.0
• Framework: Gin v1.10.1
• Database: MongoDB (primary), Redis (cache/sessions)
• Object Storage: MinIO v7.0.60
• Message Queue: NATS 2.10
• Config: godotenv

• Framework: Next.js 14.2.4 (App Router)
• UI Library: React 18.2.0
• Language: TypeScript 5.3.3
• Styling: Tailwind CSS 3.4.3 + CSS Variables

• Containerization: Docker & Docker Compose
• CI/CD: GitHub Actions
• Deployment: Ready for cloud hosting

• Docker & Docker Compose
• Go 1.23+
• Node.js 18+
• Git

# Clone repository
git clone <repo-url>
cd real_deal

# Start infrastructure services
docker-compose up -d mongodb redis minio nats

# Wait for services to be ready (10-20 seconds)
sleep 15

# Seed database with initial data
docker-compose --profile seed up seed

# Start backend server (terminal 1)
go run cmd/server/main.go

# Start frontend development server (terminal 2)
cd web
npm install
npm run dev

• Frontend: http://localhost:3000
• Backend API: http://localhost:8080
• MinIO Console: http://localhost:9001 (miniouser/miniopass123)
• MongoDB: mongodb://localhost:27017
• Redis: localhost:6379

real_deal/
├── .skills/              # Development skills (guides)
├── .agents/              # Automation agents (tools)
├── cmd/                  # Application entry points
│   ├── server/           # Backend server (Gin)
│   └── seed/            # Database seeding
├── internal/            # Internal packages
│   ├── config/          # Configuration management
│   ├── db/              # Database connections
│   ├── handlers/        # API route handlers
│   └── storage/         # MinIO storage interface
├── web/                 # Next.js frontend
│   ├── app/            # App Router pages
│   ├── components/      # React components
│   └── lib/            # Utilities (API client)
├── seeds/               # Seed data JSON files
├── scripts/             # Utility scripts
├── docker-compose.yml    # Docker services
├── go.mod              # Go module definition
├── go.sum              # Go dependencies
└── README.md           # This file

This project includes specialized skills and agents for efficient development:

• Skills - Domain-specific development guides
• Agents - Automated workflows and tools

# Run backend server
go run cmd/server/main.go

# Run tests
go test ./...

# Run tests with coverage
go test -cover ./...

# Format code
gofmt -w .

# Lint code
golangci-lint run

cd web

# Start development server
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Type checking
npx tsc --noEmit

Skills provide context-specific guidance:

• Working on Go backend → backend-skill activates
• Creating React components → frontend-skill activates
• Implementing login → auth-skill activates
• Setting up billing → billing-skill activates
• Designing UI/UX → product-design-skill activates

Agents automate common tasks:

# Code review
bash .agents/code-review-agent/scripts/review-all.sh

# Run all tests
bash .agents/testing-agent/scripts/run-all-tests.sh

# Generate documentation
bash .agents/documentation-agent/scripts/generate-all.sh

See API Endpoints Reference for complete API documentation.

# Login
curl -X POST http://localhost:8080/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com"}' \
  -c cookies.txt

# Get current user
curl http://localhost:8080/api/me -b cookies.txt

# Get explore feed
curl http://localhost:8080/api/explore

# Get jobs
curl http://localhost:8080/api/jobs

# Get company details
curl http://localhost:8080/api/companies/company_001

See MongoDB Collections Reference for complete schema documentation.

• users - User accounts and profiles
• projects - Project listings
• products - Product listings
• posts - Blog posts
• jobs - Job listings
• companies - Company profiles
• pitch_pages - Pitch pages
• deal_rooms - Deal rooms
• investors - Investor profiles
• company_verifications - Verification records
• job_compliance - Job compliance records
• content_moderation - Content moderation records

# Run all tests
go test ./... -v

# Run with coverage
go test -cover ./...

# Run specific package
go test ./internal/handlers -v

cd web

# Run tests
npm test

# Run tests with coverage
npm test -- --coverage

# Run E2E tests (Playwright)
npx playwright test

# Run all tests (backend + frontend)
bash .agents/testing-agent/scripts/run-all-tests.sh

# Generate coverage reports
bash .agents/testing-agent/scripts/generate-coverage.sh

# Build and start all services
docker-compose up -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

# Stop and remove volumes
docker-compose down -v

1. Configure environment variables
2. Build Docker images
3. Run security scans
4. Deploy to staging
5. Run integration tests
6. Deploy to production

See deployment-agent for detailed deployment guides.

• Never commit secrets or credentials
• Use environment variables for configuration
• Implement proper authentication and authorization
• Validate and sanitize all inputs
• Use HTTPS in production
• Regular security audits

Run security audits using the security-audit-agent:

# Go vulnerability scan
govulncheck ./...

# Node.js audit
cd web
npm audit

# Run security agent
# (See security-audit-agent documentation)

• Skills Documentation - Complete skills guide
• Agent Documentation - Automation tools
• Backend Skill - Go backend development
• Frontend Skill - React/Next.js development
• API Reference

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests: bash .agents/testing-agent/scripts/run-all-tests.sh
5. Run code review: bash .agents/code-review-agent/scripts/review-all.sh
6. Submit a pull request

• Follow existing code conventions
• Add tests for new features
• Update documentation
• Run security audits
• Ensure all tests pass

# Check if MongoDB is running
docker-compose ps

# Check backend logs
docker-compose logs app

# Restart backend
docker-compose restart app

cd web
rm -rf node_modules package-lock.json
npm install
npm run build

# Restart MongoDB
docker-compose restart mongodb

# Check MongoDB logs
docker-compose logs mongodb

# Verify connection
mongosh mongodb://localhost:27017

[Add license information here]

For support and questions:

• GitHub Issues: [Create an issue]
• Email: support@realdeal.com
• Documentation: [Link to docs]

Version: 1.0.0 Last Updated: January 18, 2026