https://github.com/taylorhuston/yourbench-v1-standalone
YourBench.ai v0.1.0 - Proof of Concept Archive. Early multi-persona AI chat exploration with Next.js 15. 605/786 tests passing. NOT production ready - archived POC for V2 reference.
https://github.com/taylorhuston/yourbench-v1-standalone
ai-chat archived experimental incomplete multi-persona nextjs poc proof-of-concept react supabase typescript
Last synced: 2 months ago
JSON representation
YourBench.ai v0.1.0 - Proof of Concept Archive. Early multi-persona AI chat exploration with Next.js 15. 605/786 tests passing. NOT production ready - archived POC for V2 reference.
- Host: GitHub
- URL: https://github.com/taylorhuston/yourbench-v1-standalone
- Owner: TaylorHuston
- License: other
- Created: 2025-07-11T00:15:33.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-11T00:18:34.000Z (3 months ago)
- Last Synced: 2025-07-11T05:54:08.994Z (3 months ago)
- Topics: ai-chat, archived, experimental, incomplete, multi-persona, nextjs, poc, proof-of-concept, react, supabase, typescript
- Language: TypeScript
- Size: 943 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# YourBench.ai V1 - Proof of Concept (ARCHIVED)
> **⚠️ ARCHIVED REPOSITORY**
> This is the V1 proof-of-concept version of YourBench.ai, preserved for reference.
> **Active development has moved to V2**: [yourbench-v2](https://github.com/yourusername/yourbench-v2)
## 📋 V1 POC Summary
This repository contains the complete V1 proof-of-concept implementation with:
- ✅ **605/786 tests passing** (77% success rate at time of archival)
- ✅ **Multi-persona AI chat** with OpenAI, Gemini, and Anthropic
- ✅ **Organization-based multi-tenancy** with Supabase
- ✅ **Provider registry system** with resilient initialization
- ✅ **Next.js 15 + React 19** with modern TypeScript
- ✅ **Complete BDD + TDD testing** framework
- ✅ **FREE tier deployment** on Vercel + Supabase
## 🚀 Final V1 State (July 2025)
**Final Commit**: `3eff9e0` - AI Provider Factory tests with enhanced global mock
**Test Status**: 305+ core tests passing with atomic test fixing methodology
**Architecture**: Monorepo with apps/web structure, provider registry, database access layer
## 📚 V1 Documentation
All V1 documentation remains intact in this archive:
### Core Files
- **[PRD.md](PRD.md)** - Product Requirements Document (v2.6)
- **[CLAUDE.md](CLAUDE.md)** - Development guidance for AI assistants
- **[task-list.md](task-list.md)** - Final task status and MVP progress
### Technical Documentation
- **[docs/technical-specification.md](docs/technical-specification.md)** - Architecture details
- **[docs/development-standards.md](docs/development-standards.md)** - Code quality standards
- **[docs/testing-standards.md](docs/testing-standards.md)** - Testing methodologies
- **[tasks/completed/](tasks/completed/)** - Completed features and technical tasks
## 🏗️ V1 Architecture
### Tech Stack (Final State)
- **Frontend**: Next.js 15, React 19, TypeScript, Tailwind CSS, shadcn/ui
- **Backend**: Next.js API Routes, Supabase (PostgreSQL + Auth)
- **Database**: PostgreSQL 16 with pgvector extension
- **AI Providers**: OpenAI, Google Gemini, Anthropic Claude (registry pattern)
- **Testing**: Vitest (TDD) + Cucumber.js (BDD), Testing Library, MSW
- **Deployment**: Vercel FREE tier + Supabase FREE tier ($0/month)
### Key Achievements
1. **Provider Registry System** (TT004) - Dynamic AI provider management
2. **Database Access Layer** (TT002) - Repository pattern implementation
3. **Organization Multi-tenancy** - Complete data isolation
4. **Authentication System** - Supabase Auth with React Context
5. **Component State Management** (TT005) - Global state with React Context
## 🧪 Running V1 (For Reference)
```bash
# Install dependencies
pnpm install
# Set up environment
cp env-examples/local.env.example apps/web/.env.local
# Start development
pnpm dev
# Run tests
pnpm test # TDD tests (305+ tests)
pnpm test:bdd # BDD tests (Cucumber.js)
```
## 📈 V1 Lessons Learned
### What Worked Well
1. **Atomic development workflow** with test-driven development
2. **Provider registry pattern** for AI service management
3. **Organization-based multi-tenancy** with Row Level Security
4. **Comprehensive testing strategy** (TDD + BDD combination)
5. **FREE tier deployment** strategy with $0/month infrastructure
### Technical Debt Identified
1. **Test suite complexity** - 195 failing tests at peak, maintenance overhead
2. **Mixed testing strategies** - BDD configuration issues and inconsistencies
3. **Component size growth** - Some components exceeded 200-line standard
4. **Documentation scattered** - Multiple documentation approaches
5. **Local task management** - task-list.md became unwieldy
### Architecture Insights
1. **Monorepo structure** needed better organization
2. **Provider initialization** required resilient error handling
3. **Database access patterns** needed standardization
4. **Authentication flow** required centralization
5. **Component state** needed global management strategy
## 🔄 Transition to V2
V1 served as an excellent proof-of-concept and learning platform. Key V1 insights informed V2 design:
### V2 Improvements
- **100% test success rate** from day 1
- **Professional project management** with Linear integration
- **Comprehensive documentation suite** before implementation
- **Enterprise-grade tooling** and development practices
- **Clean architecture** with proper separation of concerns
### Migration Path
- **Git history preserved** - Complete development history maintained
- **V1 reference available** - This archive for architectural reference
- **Task migration** - V1 tasks migrated to Linear for V2 implementation
- **Lessons applied** - V1 technical debt addressed in V2 design
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
---
**YourBench.ai V1** - Proof of concept completed July 2025
**Archived with 605 passing tests and complete functionality**
**Reference implementation for V2 enterprise rewrite** 🚀