Senior Full-Stack Developer

# Senior Full Stack Developer - Elevate CRM

## About the Role
We're seeking a **Senior Full Stack Developer** to take a leadership role in building and scaling Elevate CRM, a mission-critical sales management platform for the solar industry. You'll architect complex features, mentor junior developers, make key technical decisions, and drive best practices across our codebase. This role requires deep expertise in modern web technologies and a proven track record of delivering high-quality, scalable solutions.

## Tech Stack
- **Frontend**: React (advanced patterns), Tailwind CSS, React Hook Form, Zod validation, React Query
- **Backend**: Firebase (Firestore, Cloud Functions, Storage, Authentication, Security Rules)
- **APIs**: RESTful integrations, Webhook systems (Enerflo, Spotio, DocuSeal, Everee, Mayer)
- **State Management**: Redux, Context API, custom hooks
- **Testing**: Vitest, Jest, React Testing Library (TDD approach)
- **Deployment**: Vercel, CI/CD pipelines
- **Tools**: Git/GitHub, npm, ESLint, performance monitoring

## Key Responsibilities

### Technical Leadership
- **Architect complex features** from requirements to production (e.g., multi-tier commission systems with dynamic splits, overrides, and deductions)
- **Design scalable data models** and Firestore collection structures for performance
- **Lead code reviews** and establish coding standards across the team
- **Make technical decisions** on libraries, patterns, and architecture
- **Mentor junior/mid-level developers** through pair programming and knowledge sharing
- **Drive TDD adoption** with comprehensive test coverage strategies

### Development
- Build sophisticated financial calculation engines with edge case handling
- Design real-time notification systems with multi-channel delivery (push, email, SMS, in-app)
- Implement complex Firebase Cloud Functions with error handling and retry logic
- Create advanced admin dashboards with data visualization and filtering
- Develop webhook integrations with third-party CRM and payment systems
- Optimize application performance (bundle size, render performance, query optimization)
- Write comprehensive tests following Red-Green-Refactor methodology

### System Design
- Design database schemas for complex business logic (commissions, deals, deductions, audit trails)
- Architect state management patterns for large-scale forms and wizards
- Build reusable component libraries with consistent styling and accessibility
- Design secure authentication flows and role-based access control
- Create monitoring and logging strategies for production debugging

## Required Skills

### Technical Expertise (5-7+ years)
- **Expert-level React** (custom hooks, context patterns, performance optimization, render behavior)
- **Advanced Firebase** (complex queries, compound indexes, security rules, Cloud Functions v2)
- **Deep JavaScript/TypeScript knowledge** (async patterns, functional programming, type systems)
- **Production experience** with financial/commission calculation systems
- **API design and integration** (RESTful, webhooks, error handling, idempotency)
- **Database design** (NoSQL patterns, denormalization strategies, query optimization)
- **Testing mastery** (unit, integration, e2e, TDD practices, test design patterns)
- **Git workflows** (branching strategies, PR reviews, conflict resolution)

### Soft Skills
- **Problem decomposition**: Break complex requirements into manageable tasks
- **Technical communication**: Explain architectural decisions clearly to stakeholders
- **Code review excellence**: Provide constructive, educational feedback
- **Debugging prowess**: Quickly identify root causes in production issues
- **Documentation**: Write clear technical specs, ADRs, and code comments
- **Ownership mindset**: Take full responsibility for feature delivery and quality

## Preferred Skills
- Experience with **schema validation libraries** (Zod, Yup, Joi) and advanced validation patterns
- Knowledge of **performance profiling** and optimization techniques
- Familiarity with **accessibility standards** (WCAG, ARIA, keyboard navigation)
- Experience with **analytics and monitoring** (error tracking, performance metrics)
- Understanding of **security best practices** (encryption, OWASP, data protection)
- **Solar industry or CRM platform** experience
- **Mobile-responsive design** patterns and cross-browser compatibility
- Experience with **legacy codebase modernization**

## Complex Features You'll Own

### Commission Calculation Engine
- Multi-tier commission splits (self-gen vs. setter/closer splits)
- Dynamic override system with audit trails
- Per-deal deductions with rep-specific assignment (closer/setter/both)
- Conditional logic for office rates, rep adders, and bonuses
- Real-time calculation preview with breakdown transparency
- **Challenge**: Handle edge cases like 0?aler fees, split overrides, and conditional rebates

### Advanced Notification System
- Multi-channel delivery (push, email, SMS, in-app)
- User preference management and notification deduplication
- Firestore triggers vs. manual calls (preventing duplicate sends)
- Recipient resolution logic (submitter, setter, closer, managers, admins)
- Error handling and retry mechanisms
- **Challenge**: Ensure single notification per event across distributed systems

### Deal Management Pipeline
- Complex stage transitions with validation rules
- Drag-and-drop deal boards with optimistic updates
- Deal assignment and reassignment workflows
- Document upload system with storage integration
- Stage history tracking with audit trails
- **Challenge**: Real-time updates across multiple user sessions

### Financial Document Cross-Reference
- Integrate uploaded documents (Enerflo breakdown, loan portal, install contracts)
- Display in commission modals for accounting verification
- Empty state handling and validation
- **Challenge**: Maintain data consistency across deals and commissions collections

## Example Projects You'll Lead

**Project 1: Per-Deal Deductions System**
- Design deduction schema with rep-specific assignment (closer/setter/both)
- Build DeductionsManager component with CRUD operations
- Implement calculation logic that correctly applies deductions to appropriate reps
- Create audit trail (createdBy, createdAt, notes)
- Display in rep-facing commission breakdown
- Write comprehensive test suite covering split scenarios

**Project 2: Commission Transparency Initiative**
- Add rep adder notes with 500-char validation
- Display financial documents in commission modal
- Show complete breakdown in rep-facing view
- Ensure data persists across deals, commissions, and rep_commissions collections
- **Complexity**: Multi-collection updates with transaction safety

## What Makes This Role Senior

- **Autonomy**: You'll own features end-to-end with minimal supervision
- **Decision-making**: Choose technical approaches and justify trade-offs
- **Impact**: Your work directly affects commission accuracy for the entire sales org
- **Mentorship**: Guide less experienced developers through complex implementations
- **Quality bar**: Set the standard for code quality, testing, and documentation
- **Production responsibility**: Debug critical issues and make architectural improvements

## Our Development Culture

### TDD-First Approach
- Write failing tests before implementation
- Red ? Green ? Refactor methodology
- Aim for 85%+ line coverage, 90%+ branch coverage on core modules
- Property-based testing for calculation logic

### Code Quality Standards
- Explicit undefined checks (no falsy value bugs)
- Comprehensive error handling with user feedback
- Loading states for all async operations
- Input validation at boundaries (forms, APIs)
- No silent failures or debug logs in production

### Collaboration
- Thorough PR reviews with educational feedback
- Detailed commit messages explaining "why" not just "what"
- Pair programming for complex features
- Documentation for architectural decisions

## What We Offer
- **Remote work** with flexible hours
- **Technical leadership opportunity** - shape the architecture of a growing platform
- **Real business impact** - your code directly affects commission accuracy and sales operations
- **Modern tech stack** - work with cutting-edge tools and best practices
- **Learning budget** - conferences, courses, books
- **Collaborative environment** - work with a team that values quality and craftsmanship
- **Ownership** - lead major initiatives and drive technical direction

## Ideal Candidate

You're a **senior developer who**:
- Has built complex financial systems with calculation accuracy requirements
- Takes pride in writing clean, well-tested code
- Enjoys mentoring and sharing knowledge
- Thinks deeply about edge cases and system design
- Values transparency and clear communication
- Loves solving hard problems with elegant solutions
- Understands the "why" behind best practices, not just the "what"

---

**To Apply**:

Send to ----------
1. **Resume** highlighting relevant experience
2. **GitHub profile** or code samples
3. **Case study** (1-2 paragraphs): Describe the most complex system you've architected, including:
- The problem you solved
- Technical decisions you made and why
- Challenges you overcame
- Impact on the business

**Bonus**: Link to a production app with complex financial calculations or commission systems you've built.