# AltoForge — AI-Friendly Project Summary

> AltoForge is a collaborative cloud infrastructure visualization and monitoring platform for AWS.

## What AltoForge Does

AltoForge helps teams monitor, visualize, and respond to AWS infrastructure issues. Users connect their AWS accounts, discover resources automatically, build visual architecture diagrams on an infinite canvas, monitor CloudWatch metrics in real-time, and respond to incidents through auto-created war rooms.

## Core Features

### Infrastructure Dashboards
- Infinite-canvas editor for building AWS architecture diagrams
- Drag discovered AWS resources (EC2, RDS, Lambda, S3, ALB, ECS, SQS, ElastiCache) from a sidebar onto the canvas
- Smart line routing connects resources with orthogonal paths
- Design elements: boxes, labels, lines, markers, freehand annotations
- Multi-layer support for organizing complex architectures
- Real-time collaboration via WebSockets (shared cursors, locks, concurrent editing)

### AWS Integration
- Connect AWS accounts via a read-only CloudFormation stack (IAM role with ExternalId)
- Automatic resource discovery across 8 resource types
- Multi-account support — view all accounts in one place
- No agents, no credentials stored — uses STS AssumeRole

### Control Tower (Monitoring Wall)
- Personalized monitoring dashboard with pinned resource+metric graphs
- Real-time CloudWatch metrics polling
- Drag-to-reorder, fullscreen kiosk mode
- Available globally (cross-project) or per-project
- Serves as the project landing page

### Incident War Rooms
- Auto-created when CloudWatch alarms fire
- Blast radius topology visualization on a dedicated canvas
- Upstream probable cause chain with timestamps and lead times
- Past incident matching — automatically finds similar resolved incidents by resource and metric overlap, surfaces resolution steps that worked before
- AI-generated post-mortem reports (Claude) with executive summary, timeline, root cause, impact, and recommendations — downloadable as PDF
- AI dashboard health analysis with right-sizing recommendations, cost optimization, alarm coverage gaps, and architecture observations
- Predictive pre-incident warnings with confidence scores
- Auto-resolve after 6-hour stabilization period

### Projects
- Group dashboards, incidents, and Control Tower graphs
- Role-based access: admin, editor, viewer
- Per-project notification channels (Slack, PagerDuty, OpsGenie, webhooks, email)
- Project-scoped Control Tower as landing page

### Collaboration
- Real-time multi-user editing with presence indicators
- Cursor tracking across connected users
- Lock-based editing to prevent concurrent conflicts
- Room-based WebSocket architecture

### AI Features (Claude-Powered, Credit-Based)
- Dashboard health analysis: resource utilization, cost optimization, alarm coverage, architecture review
- Incident war room analysis: root cause identification, timeline reconstruction, impact assessment
- Post-mortem report generation with PDF export
- Credit system: monthly allowance per subscription tier (Starter: 2, Pro: 10, Business: 50 credits), cost estimation before each call, 15% guardrail + 20% profit margin, reconciliation after completion

### Community Forum
- Q&A threads with voting
- Polls
- Gamification with reputation and medal tiers

## Tech Stack

- **Frontend:** React 18, Vite, Tailwind CSS 4, Shadcn/ui, Socket.IO client, uplot (charts), @dnd-kit (drag-and-drop)
- **Backend:** Express, PostgreSQL (raw SQL, no ORM), AWS SDK v3, Anthropic Claude SDK
- **Collaboration:** Socket.IO server (separate process)
- **Infrastructure:** EC2, PM2, Nginx, Let's Encrypt SSL
- **Auth:** AWS Cognito (OpenID Connect)
- **Payments:** Stripe
- **Email:** Resend
- **Queues:** SQS (4 queues: metrics, notifications, emails, incident events)

## Pricing Tiers

- **Starter** (Free) — 1 AWS account, core monitoring features
- **Pro** — Multiple AWS accounts, advanced features, 10 AI credits/month
- **Business** — Unlimited accounts, priority support, 50 AI credits/month

## Public Pages

- https://altoforge.io/ — Landing page
- https://altoforge.io/pricing — Pricing and plan comparison
- https://altoforge.io/docs — Documentation
- https://altoforge.io/getting-started — Setup walkthrough
- https://altoforge.io/contact — Contact information
- https://altoforge.io/community — Community forum
- https://altoforge.io/privacy — Privacy policy
- https://altoforge.io/terms — Terms of service

## API

RESTful API at https://altoforge.io/api/ with the following prefixes:
- /auth — Cognito OAuth login/callback/logout
- /api/projects — Project CRUD, members, settings
- /api/dashboards — Dashboard CRUD, sharing, AI analysis
- /api/resources — AWS resource management, metrics, alarms
- /api/incidents — Incident CRUD, war rooms, reports, predictions
- /api/control-tower — Pinned graph CRUD, reorder
- /api/organizations — Organization management, teams, AWS accounts
- /api/billing — Stripe billing
- /api/forum — Community forum

## Contact

- Support: support@altoforge.io
- Sales: sales@altoforge.io