A comprehensive Quality Assurance Management Platform for Blackboard Learn/Ultra, built with React and Material-UI. QA Commander empowers teams to manage risk-based testing, automate test planning, and leverage AI for documentation, content creation, and more—all in a modern, serverless-ready UI.
- 🤖 AI Chatbot: Get instant, context-aware answers, step-by-step procedures, and test plans for Blackboard Learn/Ultra. Connects to OpenAI, AWS Bedrock, or Ollama via secure chatbot-middleware.
- ✍️ Content Creator: Generate and organize course content, test cases, and documentation with AI assistance.
- 🎯 Dashboard: Visualize QA metrics, recent activity, and quick links to common tasks.
- 🔍 Risk Analysis: Score workflows by likelihood and impact (1–4 scale), auto-calculate risk, and get automation recommendations (1–6 = Automate).
- 📋 Test Plans: Manage detailed test plans, categorize by type, track status, and assign team members.
- 🧪 Automated/Manual Test Guidance: Built-in logic recommends automation based on risk score.
- 🚧 Jenkins Analysis: (Coming Soon) Analyze build logs, failures, and performance trends.
- 🖥️ Modern UI/UX: Responsive, Material-UI v7 design with dark mode toggle. (can be switched over to bb-ui for Blackboard look and feel)
- 🔒 Secure & Serverless Ready: Deploy easily to AWS S3/CloudFront, connect to serverless backends, and keep API keys safe with middleware.
- Node.js 20+
- npm 10+
- Clone the repository:
git clone https://github.com/ShannonH/qa-commander-poc.git cd qa-commander-poc - Install dependencies:
npm install
- Start the development server:
The application will open at
npm start
http://localhost:3000.
npm startornpm run dev– Runs the development server using Nxnpm test– Runs the test suite via Nxnpm run build– Creates a production build with Nx
This project uses Nx as a powerful build system and task runner for modern monorepos. Nx provides fast, reliable builds, advanced caching, and enhanced developer experience.
nx serve– Start the development servernx build– Build the app for productionnx test– Run testsnx graph– Visualize the project dependency graph
You can also use npx nx <command> if Nx is not installed globally.
- Frontend: React 19 + TypeScript
- UI Framework: Material-UI v7 (with dark mode)
- Routing: React Router v6
- Styling: Emotion (CSS-in-JS)
- Data Storage: LocalStorage (expandable to real database)
- Build Tool: Nx (replaces Create React App)
src/
├── components/ # Reusable UI components (Layout, etc.)
├── views/ # Page components (Dashboard, RiskAnalysis, TestPlans, etc.)
├── types/ # TypeScript type definitions
├── utils/ # Utility functions and services (dataService, chatbotService, etc.)
└── App.tsx # Main application component
- Production build creates optimized static files for S3/CloudFront.
- Environment-agnostic configuration for easy deployment.
- Scalable architecture ready for serverless backend/API integration.
To connect the QA Commander chatbot to a real AI service (OpenAI, AWS Bedrock, Ollama, etc.):
- Create a
.envfile in the project root:REACT_APP_CHATBOT_API_URL=https://your-middleware-domain.com/chatbot- Replace with your deployed chatbot-middleware endpoint.
- Never expose your AI provider's API key in the frontend.
- Use the chatbot-middleware Proxy:
- Handles authentication and securely forwards requests to the AI service.
- Can be run locally or deployed to any cloud provider.
- Restart the app:
Your chatbot will now use the configured AI service for dynamic, realistic responses.
npm start
- Jenkins log analysis and build metrics (Q2 2024)
- Database integration (PostgreSQL/MongoDB)
- User authentication and authorization
- Real-time collaboration features
- API integration with testing tools
- Advanced reporting and analytics
- Export capabilities (PDF, Excel)
Built with ❤️ for Quality Assurance teams working with Blackboard Learn/Ultra