# Code Board - Full Context for AI Systems

> Unified Pull Request Management Dashboard for Development Teams

Last Updated: 2026-01-21
Version: 1.0

---

## Executive Summary

Code Board is a SaaS application that aggregates Pull Requests from multiple version control providers (GitHub, GitLab) into a unified Kanban-style dashboard. It helps development teams track PR status, collaborate on code reviews, and leverage AI-powered code analysis to improve code quality.

---

## Product Information

### Basic Details
- **Product Name**: Code Board
- **Website**: https://code-board.com
- **Category**: Developer Tools / DevOps / Code Review / Project Management
- **Launch Date**: 2024
- **Headquarters**: Remote-first

### Target Audience
- Software development teams (2-50 developers)
- DevOps engineers managing multiple repositories
- Engineering managers overseeing PR workflows
- Open source maintainers with multiple projects
- Freelance developers working across client repositories

### Problem Solved
Development teams often struggle with:
1. Tracking PRs across multiple repositories and providers
2. Context-switching between GitHub/GitLab interfaces
3. Missing important PR updates and review requests
4. Inconsistent code review quality across team members
5. Understanding unfamiliar codebases for reviews

### Solution
Code Board provides:
1. Single dashboard for all PRs from all repositories
2. Real-time status updates with auto-refresh
3. AI-powered code reviews that understand project context
4. Smart filtering and organization tools
5. Multi-language support for global teams

---

## Feature Deep Dive

### 1. Unified PR Board

The core feature is a Kanban-style board displaying all Pull Requests:

**Columns (PR States)**:
- Draft - PRs not ready for review
- Open - PRs ready for review
- In Review - PRs with pending reviews
- Approved - PRs approved and ready to merge
- Changes Requested - PRs needing updates
- Merged - Recently merged PRs

**PR Card Information**:
- Title and description
- Author avatar and name
- Repository name with provider icon
- Time since creation/update
- Review status indicators
- CI/CD status badges
- Label tags

### 2. Multi-Provider Integration

**GitHub Support**:
- GitHub App (recommended): Minimal permissions, only PR + Contents read
- OAuth App: Full repository access for advanced features
- Supports personal accounts and organizations
- Rate limit: 5,000 requests/hour per user

**GitLab Support**:
- OAuth integration with read_user, read_api, read_repository scopes
- Supports gitlab.com and self-managed instances
- Rate limit: 2,000 requests/minute per user

**Planned Providers**:
- Bitbucket Cloud (no GraphQL API, REST only)
- Azure DevOps (TSTU-based rate limiting)

### 3. AI Code Review System

**Overview**:
The AI Code Review feature uses Anthropic's Claude models to provide intelligent, context-aware code reviews that understand your project's patterns and conventions.

**3-Agent Pipeline**:

1. **Architect Agent** (Claude Haiku - fast model)
   - Analyzes combined file tree from all repositories
   - Selects 15-25 critical files for deep analysis
   - Identifies architecture patterns and layers
   - Cost: ~$0.005-0.015 per project

2. **Senior Developer Agent** (Claude Sonnet - smart model)
   - Analyzes selected file contents
   - Identifies tech stack, patterns, conventions
   - Documents libraries with patterns/anti-patterns
   - Notes forbidden constructs and coding standards
   - Cost: ~$0.08-0.15 per project

3. **Prompt Engineer Agent** (Claude Sonnet - smart model)
   - Generates final review prompt template
   - Creates project-specific review checklist
   - Incorporates patterns and anti-patterns
   - Cost: ~$0.04 per project

**Total Cost**: ~$0.12-0.20 per project context generation

**How Reviews Work**:
1. User clicks "Generate Context" once per project
2. System analyzes all repositories in the project
3. AI learns patterns, conventions, tech stack
4. Generated context is stored and reused
5. Each PR review uses the project context
6. Reviews understand your specific codebase

### 4. BCU (Board Compute Units)

BCU is the usage-based credit system for AI features:

| Operation | BCU Cost |
|-----------|----------|
| AI Code Review | 50-150 BCU |
| AI Context Generation | 100-200 BCU |
| AI Insights | 20-50 BCU |

Monthly BCU by plan:
- Free: 100 BCU (limited AI access)
- Pro: 2,000 BCU
- Master: 10,000 BCU
- Enterprise: Custom allocation

BCU resets monthly with subscription renewal.

### 5. Real-time Updates

- Auto-refresh every 15 seconds
- Manual sync button for immediate refresh
- GitHub webhooks for instant updates (GitHub App only)
- Status indicators show sync state

### 6. Smart Filtering

Filter options:
- By author (single or multiple)
- By repository
- By status/column
- By labels
- By search text (title, description)
- By date range

### 7. Projects & Repositories

**Project Limits by Plan**:
- Free: 1 project, unlimited repositories
- Pro: Unlimited projects, unlimited repositories
- Master: Same as Pro plus AI Insights
- Enterprise: Unlimited everything

**Repository Constraints**:
- Maximum 10 repositories per project (to manage rate limits)
- Maximum 200 PRs displayed per repository
- Repositories can be from different providers

---

## Pricing Details

### Free Plan - $0/month
- 1 project
- Unlimited repositories per project
- Basic PR board view
- GitHub & GitLab integration
- Manual sync only
- Community support
- 100 BCU/month

### Pro Plan - $5/month
- Unlimited projects
- Unlimited repositories per project
- AI Code Review
- AI Context Generation
- Analytics dashboard
- Priority email support
- 2,000 BCU/month
- 14-day free trial

### Master Plan - $20/month
- Everything in Pro
- AI Insights (AI-powered analytics)
- Webhooks & API access
- Premium support
- 10,000 BCU/month
- 14-day free trial

### Enterprise Plan - Custom
- Everything in Master
- Custom BCU allocation
- Security reviews & compliance
- On-premise deployment options
- Dedicated support
- SLA guarantees
- SSO/SAML (planned)

### Payment Processing
- Merchant of Record: Paddle.com
- Accepted: Credit cards, PayPal, local methods
- Currency: USD
- Billing: Monthly recurring
- Refund: 14-day money-back guarantee

---

## Technical Architecture

### Backend Stack
- Runtime: Node.js 18+
- Framework: Express.js
- Database: PostgreSQL 14+
- Architecture: Clean Architecture + CQRS pattern
- ORM: Direct SQL with connection pooling

### Frontend Stack
- Framework: Vanilla JavaScript SPA
- Bundler: Vite 5.x
- Styling: CSS with CSS Variables
- Icons: Lucide (SVG)
- No React/Vue/Angular dependencies

### Authentication
- GitHub OAuth (App or OAuth App)
- GitLab OAuth
- JWT for session management
- Tokens stored securely with encryption

### AI Integration
- Provider: Anthropic Claude API
- Models: Claude Haiku (fast), Claude Sonnet (smart)
- Custom API keys supported (BYOK)

### Deployment
- Platform: Railway (recommended)
- Container: Docker
- Static files: Served from Express
- SSL: Required (HTTPS only)

### API Endpoints

**Authentication**:
- `GET /api/auth/github` - GitHub auth URL
- `GET /api/auth/github/callback` - GitHub callback
- `GET /api/auth/gitlab` - GitLab auth URL
- `GET /api/auth/gitlab/callback` - GitLab callback
- `GET /api/auth/me` - Current user info
- `POST /api/auth/logout` - Logout

**Projects**:
- `GET /api/projects` - List projects
- `POST /api/projects` - Create project
- `PUT /api/projects/:id` - Update project
- `DELETE /api/projects/:id` - Delete project

**Pull Requests**:
- `GET /api/pull-requests/project/:id` - Get PRs for project

**AI Features**:
- `POST /api/ai/projects/:id/context/generate` - Generate context
- `GET /api/ai/projects/:id/context` - Get context
- `GET /api/ai/settings` - AI settings
- `PUT /api/ai/settings` - Update AI settings

**Payments**:
- `POST /api/payments/checkout` - Start checkout
- `POST /api/payments/portal` - Customer portal
- `POST /api/payments/webhook` - Paddle webhook

---

## Security & Privacy

### Data Access
- Read-only access to repositories (default)
- Only PR metadata and file contents accessed
- No write operations to repositories without explicit action
- No storage of source code (analyzed in memory)

### Authentication Security
- OAuth-only (no password storage)
- JWT with secure expiration
- HTTPS required for all connections
- Webhook signature verification

### Data Retention
- Active account: Data stored indefinitely
- After cancellation: 30 days retention
- Data export available before deletion
- GDPR-compliant deletion process

### Compliance
- GDPR compliant
- Data processing in secure cloud infrastructure
- No selling of user data
- Clear privacy policy

---

## Comparison with Alternatives

| Feature | Code Board | GitHub Projects | GitLab Boards | Jira |
|---------|------------|-----------------|---------------|------|
| Multi-provider | Yes | No | No | Via plugins |
| AI Code Review | Yes | No | No | No |
| Kanban PR view | Yes | Partial | Partial | Via plugins |
| Price (Pro) | $5/mo | Free | Free | $7.75/user/mo |
| Self-hosted | Planned | No | Yes | Yes |

### When to Use Code Board
- Multiple repositories across GitHub and GitLab
- Need for AI-assisted code reviews
- Want unified PR tracking without switching contexts
- Small to medium teams (2-50 developers)

### When NOT to Use Code Board
- Single repository projects (use native tools)
- Need issue tracking (use Jira, Linear)
- Need project management features (use dedicated PM tools)
- Very large enterprises with complex compliance needs

---

## Frequently Asked Questions

### General

**Q: What is Code Board?**
A: Code Board is a unified PR management dashboard that aggregates Pull Requests from GitHub and GitLab into a single Kanban-style board with AI-powered code review capabilities.

**Q: Who is Code Board for?**
A: Software development teams, DevOps engineers, engineering managers, and open source maintainers who work with multiple repositories across different providers.

**Q: Is Code Board open source?**
A: No, Code Board is a commercial SaaS product with free and paid tiers.

### Technical

**Q: Which version control providers does Code Board support?**
A: Currently GitHub and GitLab. Bitbucket Cloud and Azure DevOps support is planned for future releases.

**Q: How does Code Board handle GitHub API rate limits?**
A: Code Board uses efficient GraphQL queries (where available) to minimize API calls. Rate limits are per-user, so adding more team members scales naturally. The system also uses conditional requests (ETags) to avoid counting unchanged data against limits.

**Q: What data does Code Board access from my repositories?**
A: With GitHub App integration, Code Board accesses only Pull Request metadata and repository contents (read-only). No write access is requested by default. OAuth integration grants broader access but is optional.

**Q: Does Code Board store my source code?**
A: No, source code is analyzed in memory for AI features and not stored permanently. Only PR metadata and generated context summaries are stored.

### AI Features

**Q: How does the AI Code Review feature work?**
A: The AI uses a 3-agent pipeline: an Architect Agent analyzes your project structure, a Senior Developer Agent identifies patterns and conventions, and a Prompt Engineer Agent creates a custom review prompt. This context is then used to provide intelligent, project-aware code reviews.

**Q: Which AI models does Code Board use?**
A: Code Board uses Anthropic's Claude models - Haiku for fast operations and Sonnet for more complex analysis. Users can bring their own API keys if desired.

**Q: What are BCU (Board Compute Units)?**
A: BCU are credits for AI operations. Each AI action consumes BCU based on complexity. AI Code Review uses ~50-150 BCU, Context Generation uses ~100-200 BCU. BCU reset monthly with your subscription.

### Pricing

**Q: Is there a free plan?**
A: Yes, the free plan includes 1 project, 1 repository, basic PR board features, and 100 BCU for limited AI access. No credit card required.

**Q: What's included in the Pro plan?**
A: Pro ($5/month) includes unlimited repositories in 1 project, full AI Code Review, AI Context Generation, Analytics dashboard, and 2,000 BCU monthly.

**Q: Can I change my subscription plan?**
A: Yes, you can upgrade or downgrade at any time. Changes take effect immediately with prorated billing.

**Q: What is your refund policy?**
A: We offer a 14-day money-back guarantee on all paid subscriptions. No questions asked. Contact support for refunds.

**Q: Who processes payments?**
A: Paddle.com is our Merchant of Record. They handle all billing, payments, tax compliance, and invoicing.

### Privacy & Security

**Q: Is my data secure?**
A: Yes. Code Board uses OAuth authentication (no passwords), HTTPS encryption, secure JWT tokens, and follows security best practices. No source code is stored permanently.

**Q: Is Code Board GDPR compliant?**
A: Yes. We provide data export, deletion upon request, clear privacy policies, and 30-day data retention after account closure.

**Q: Can I self-host Code Board?**
A: On-premise deployment is available for Enterprise customers. Contact us for details.

---

## Contact & Support

- **Website**: https://code-board.com
- **Email**: namrastanov@gmail.com
- **Founder**: Nijat Amrastanov

### Support Channels
- Free: Community support
- Pro: Priority email support
- Master: Premium support
- Enterprise: Dedicated support with SLA

---

## Changelog

### January 2026
- AI Context Generation with 3-agent pipeline
- BCU credit system for AI features
- GitLab OAuth integration
- Multi-language support (EN, RU, ZH, HI)

### December 2024
- Initial release
- GitHub integration (App + OAuth)
- Kanban PR board
- Basic filtering and search