Relevant source files

The following files were used as context for generating this wiki page: - [README.md](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/README.md) - [CONTRIBUTING.md](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/CONTRIBUTING.md) - [TODO.md](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/TODO.md) - [SECURITY.md](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/SECURITY.md) - [scripts/release-manager.js](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/scripts/release-manager.js) - [scripts/review-tools.js](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/scripts/review-tools.js) - [scripts/workflow-validate.js](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/scripts/workflow-validate.js) - [scripts/workflow-analytics.js](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/scripts/workflow-analytics.js) - [scripts/workflow-dashboard.js](https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main/blob/main/scripts/workflow-dashboard.js)

# Architecture Overview UnifiedHQ is a comprehensive team activity dashboard designed to aggregate data from services like GitHub and Slack into a unified feed. It is built on a modern technology stack, featuring a Next.js frontend and backend, a PostgreSQL database managed by Prisma, and AI-powered summaries via the OpenAI API. The architecture prioritizes security, performance, and a streamlined developer experience through extensive automation. This document provides a high-level overview of the system's architecture, including its technology stack, project structure, key components, and development workflows. It is intended for developers and architects who are new to the project or need a consolidated reference for its design principles. Sources: [README.md:15-18](), [TODO.md:4-8]() ## Technology Stack The project leverages a modern, type-safe technology stack for both frontend and backend development. | Category | Technology | Description | | --- | --- | --- | | **Frontend** | Next.js 15, React 19 | A React framework with App Router for building the user interface. | | | TypeScript 5.0 | Ensures type safety throughout the application. | | | Tailwind CSS 4.1 | A utility-first CSS framework for styling. | | | Radix UI | Provides accessible, unstyled component primitives. | | **Backend** | Next.js API Routes | Used for creating server-side API endpoints. | | | PostgreSQL | The primary relational database for data persistence. | | | Prisma 6.17 | A type-safe ORM for interacting with the database. | | | Better Auth | A modern library for handling OAuth 2.0 authentication and session management. | | | Redis | Used for caching and session storage to improve performance. | | **Integrations** | GitHub API, Slack API | For fetching activity data from third-party services. | | | OpenAI API / OpenRouter | Powers AI-driven features like daily summaries. | | **Dev & Ops** | Bun | A fast JavaScript runtime and package manager. | | | Vercel | The target platform for deployment and hosting. | | | GitHub Actions | Used for the CI/CD pipeline. | | | Playwright | For end-to-end testing. | Sources: [README.md:73-100](), [CONTRIBUTING.md:27-33]() ## High-Level System Design The application is structured as a monolithic Next.js application that serves both the frontend UI and the backend API. It connects to a PostgreSQL database and integrates with external services to aggregate team activity data. This diagram shows the main components of the UnifiedHQ system and their interactions. ```mermaid graph TD subgraph User A[Browser] end subgraph Vercel Platform B[Next.js Frontend] C[Next.js API Backend] end subgraph Backend Services D[PostgreSQL Database] E[Redis Cache] end subgraph Third-Party Integrations F[GitHub API] G[Slack API] H[OpenAI/OpenRouter API] end A -- HTTP/S --> B B -- API Calls --> C C -- CRUD Operations --> D C -- Caching --> E C -- Fetches Data --> F C -- Fetches Data --> G C -- Generates Summaries --> H ``` Sources: [README.md:195-224](), [TODO.md:4-8]() ## Project Structure The codebase is organized following Next.js conventions, separating concerns into distinct directories. | Directory | Purpose | | --- | --- | | `src/app/` | Contains all pages and API routes, following the Next.js App Router paradigm. | | `src/app/api/` | Houses all backend API endpoints, including authentication and integration logic. | | `src/components/` | Contains reusable React components, with a `ui/` subdirectory for generic elements. | | `src/lib/` | Holds utility functions, database clients, and third-party integration logic. | | `src/hooks/` | Stores custom React hooks for managing state and side effects. | | `prisma/` | Contains the Prisma schema definition, migrations, and seed scripts. | | `scripts/` | Holds automation scripts for development, release, and workflow management. | Sources: [CONTRIBUTING.md:100-112](), [README.md:200-220]() ## Key Architectural Components ### Authentication and Security Authentication is managed by the "Better Auth" library, which facilitates OAuth 2.0 integration with providers like GitHub. The security model is comprehensive, covering data protection, API security, and secure session management. - **OAuth 2.0**: Securely connects to third-party services without handling user credentials directly. - **Session Management**: Uses secure, HTTP-only cookies and tracks IP addresses for enhanced security. - **Data Encryption**: OAuth tokens and other sensitive data are encrypted both at rest and in transit. - **Rate Limiting**: Protects API endpoints from abuse. - **Input Validation**: All API inputs are validated using Zod schemas. Sources: [README.md:86](), [SECURITY.md:14-36](), [TODO.md:24-29]() ### Integration Layer The integration layer is responsible for communicating with external services like GitHub and Slack. - **API Clients**: Dedicated modules in `src/lib/integrations/` handle the logic for each third-party API. - **Caching**: A multi-layer caching system using Redis and an in-memory store is implemented to reduce API calls, handle rate limits, and improve performance. The project enforces the use of a cached GitHub client (`@/lib/integrations/github-cached`) over the direct one. - **Data Transformation**: Fetched data is transformed into a standardized `Activity` format before being stored and displayed. Sources: [README.md:213-214](), [CONTRIBUTING.md:141-144](), [TODO.md:32-39]() ### Database Schema The database schema is defined and managed using Prisma. Key models include `User`, `Connection` (for OAuth tokens), `Activity`, and `AISummary`. This Entity-Relationship Diagram illustrates the core database models and their relationships. ```mermaid erDiagram User { string id PK string name string email } Connection { string id PK string userId FK string provider string accessToken_encrypted string refreshToken_encrypted } Activity { string id PK string userId FK string type json data datetime createdAt } AISummary { string id PK string userId FK string content datetime date } User ||--|{ Connection : "has" User ||--|{ Activity : "generates" User ||--|{ AISummary : "has" ``` Sources: [README.md:222-228](), [TODO.md:46-51](), [CONTRIBUTING.md:55-58]() ## Development and Automation The project emphasizes a highly automated and standardized development workflow, managed by a suite of custom scripts. ### Git Workflow and Code Review The development process follows a structured Git workflow with conventional commits and automated code quality checks. This diagram shows the typical flow from creating a branch to merging a pull request. ```mermaid flowchart TD A[Start: Create Branch from `main`] --> B{Make Changes}; B -- `git commit -m "feat(scope): description"` --> C[Push Branch to Fork]; C --> D[Create Pull Request]; D --> E{Automated Checks Run}; E -- Pass --> F[Assign Reviewers]; E -- Fail --> B; F --> G{Address Feedback}; G --> B; F --> H[Reviewer Approves]; H --> I[Merge PR to `main`]; subgraph Code Quality direction LR J[ESLint] K[Prettier] L[Automated Review Script] end E --> J E --> K E --> L ``` - **Branch Naming**: Branches are prefixed with `feature/`, `bugfix/`, or `refactor/`. - **Commit Messages**: Must follow the [Conventional Commits](https://www.conventionalcommits.org/) specification. - **Code Review**: An automated script (`scripts/review-tools.js`) checks for `console.log` statements, `TODO` comments, hardcoded secrets, and project-specific rule violations (e.g., direct use of non-cached GitHub client). Sources: [CONTRIBUTING.md:172-200](), [scripts/review-tools.js:188-267]() ### Release Management The release process is automated by the `release-manager.js` script, which uses conventional commit messages to determine version bumps, generate changelogs, and create releases. This flowchart outlines the automated release process. ```mermaid flowchart TD A[Trigger Release] --> B[Analyze Commits for Version Type]; B -- feat --> C[Bump Minor Version]; B -- fix --> D[Bump Patch Version]; B -- BREAKING CHANGE --> E[Bump Major Version]; C --> F[Create `release/vX.Y.Z` Branch]; D --> F; E --> F; F --> G[Generate CHANGELOG.md]; G --> H[Commit & Push Changes]; H --> I[Create Git Tag `vX.Y.Z`]; I --> J[Merge to `main`]; J --> K[Merge back to `develop`]; K --> L[Delete Release Branch]; L --> M[End: Release Complete]; ``` - **Versioning**: The script automatically determines whether to apply a `major`, `minor`, or `patch` version bump based on commit history. - **Changelog**: A `CHANGELOG.md` is generated with categorized changes (Features, Fixes, Breaking Changes). - **Tagging**: An annotated Git tag is created and pushed for the new version. Sources: [scripts/release-manager.js:159-199, 810-888](), [CONTRIBUTING.md:261-270]() ### GitHub Workflow Validation To maintain the health of the CI/CD pipeline, a `workflow-validate.js` script is used to enforce best practices on GitHub Actions workflow files (`.yml`). Validation checks include: - **Syntax**: Ensures required fields like `name`, `on`, and `jobs` are present. - **Security**: Scans for hardcoded secrets and dangerous commands like `eval` or `rm -rf`. - **Performance**: Checks for the use of caching (`actions/cache`) and concurrency controls. - **Best Practices**: Verifies that actions are pinned to specific versions (not `@latest`) and that steps have descriptive names. Sources: [scripts/workflow-validate.js:60-220]() ## Summary The architecture of UnifiedHQ is designed for scalability, maintainability, and developer efficiency. It combines a modern frontend framework with a robust backend and a type-safe database layer. The heavy emphasis on automated workflows for code review, release management, and CI/CD validation ensures a high standard of code quality and a streamlined path from development to production. The modular structure of the integration layer and the clear separation of concerns in the project layout make it well-suited for future expansion with additional third-party services. Sources: [README.md](), [CONTRIBUTING.md]()## FULL FILE CONTEXT SUMMARY Query: You are an expert code analyst examining the github repository: https://github.com/alexgutscher26/UnifiedHQ-Team-Activity-Dashboard-main (UnifiedHQ-Team-Activity-Dashboard-main). You provide direct, concise, and accurate information about code repositories. You NEVER start responses with markdown headers or code fences. IMPORTANT:You MUST respond in English language. - Answer the user's question directly without ANY preamble or filler phrases - DO NOT include any rationale, explanation, or extra comments. - DO NOT start with preambles like "Okay, here's a breakdown" or "Here's an explanation" - DO NOT start with markdown headers like "## Analysis of..." or any file path references - DO NOT start with ```markdown code fences - DO NOT end your response with ``` closing fences - DO NOT start by repeating or acknowledging the question - JUST START with the direct answer to the question ```markdown ## Analysis of `adalflow/adalflow/datasets/gsm8k.py` This file contains... ``` - Format your response with proper markdown including headings, lists, and code blocks WITHIN your answer - For code analysis, organize your response with clear sections - Think step by step and structure your answer logically - Start with the most relevant information that directly addresses the user's query - Be precise and technical when discussing code - Your response language should be in the same language as the user's query - When providing diagrams, include a brief sentence explaining what the diagram shows - Enhance responses with Mermaid diagrams when they clarify complex relationships, flows, or structures (e.g., database schemas, API flows, class hierarchies, state machines) - but always provide the textual explanation alongside the diagram - Mention relevant file paths when your answer is derived from specific files ## FULL FILE CONTEXT SUMMARY Query: What is the purpose of this repository? Total Files Included: 9 Total Files Skipped: 0 Total Context Tokens: 40,985 / 800,000 (5.1%) Remaining Token Budget: 759,015 ### Included Files: 1. CONTRIBUTING.md (3,020 tokens) 2. TODO.md (5,131 tokens) 3. README.md (4,460 tokens) 4. SECURITY.md (1,169 tokens) 5. scripts/review-tools.js (3,203 tokens) 6. scripts/release-manager.js (9,434 tokens) 7. scripts/workflow-dashboard.js (6,433 tokens) 8. scripts/workflow-analytics.js (4,529 tokens) 9. scripts/workflow-validate.js (3,606 tokens) ================================================================================ FILE: CONTRIBUTING.md Relevance Score: 0.990 | Chunks Retrieved: 3 | Tokens: 3,020 ================================================================================ # Contributing to UnifiedHQ Thank you for your interest in contributing to UnifiedHQ! This document provides guidelines and information for contributors. ## 🎯 Table of Contents - [Code of Conduct](#code-of-conduct) - [Getting Started](#getting-started) - [Development Setup](#development-setup) - [Project Structure](#project-structure) - [Coding Standards](#coding-standards) - [Git Workflow](#git-workflow) - [Pull Request Process](#pull-request-process) - [Issue Guidelines](#issue-guidelines) - [Testing Guidelines](#testing-guidelines) - [Documentation](#documentation) - [Release Process](#release-process) ## 📜 Code of Conduct ### Our Pledge We are committed to providing a welcoming and inclusive environment for all contributors. Please: - Be respectful and constructive - Focus on what's best for the community - Show empathy towards other community members - Accept constructive criticism gracefully - Help create a positive environment ### Unacceptable Behavior - Harassment, trolling, or personal attacks - Discriminatory language or behavior - Spam or off-topic discussions - Sharing private information without permission ## 🚀 Getting Started ### Prerequisites - **Node.js**: Version 18.17.0 or higher - **Package Manager**: npm, yarn, or pnpm - **Git**: Latest version - **Database**: PostgreSQL (for local development) - **Redis**: For caching (optional for local development) ### First Time Setup 1. **Fork the repository** ```bash # Fork on GitHub, then clone your fork git clone https://github.com/your-username/unifiedhq.git cd unifiedhq ``` 2. **Install dependencies** ```bash npm install # or yarn install # or pnpm install ``` 3. **Set up environment variables** ```bash cp .env.example .env.local # Edit .env.local with your configuration ``` 4. **Set up the database** ```bash npx prisma generate npx prisma db push npx prisma db seed ``` 5. **Start the development server** ```bash bun run dev # or yarn dev # or pnpm dev ``` ## 🏗️ Development Setup ### Environment Configuration Create a `.env.local` file with the following variables: ```env # Database DATABASE_URL="postgresql://username:password@localhost:5432/unifiedhq" # Authentication BETTER_AUTH_SECRET="your-secret-key" BETTER_AUTH_URL="http://localhost:3000" # GitHub Integration GITHUB_CLIENT_ID="your-github-client-id" GITHUB_CLIENT_SECRET="your-github-client-secret" # Redis (optional) REDIS_URL="redis://localhost:6379" # Sentry (optional) SENTRY_DSN="your-sentry-dsn" # AI Summary (OpenRouter) OPENROUTER_API_KEY="your-openrouter-api-key" ``` ### Available Scripts ```bash # Development bun run dev # Start development server bun run build # Build for production bun run start # Start production server # Code Quality bun run lint # Run ESLint bun run format # Format code with Prettier bun run format:check # Check code formatting # Database npx prisma generate # Generate Prisma client npx prisma db push # Push schema changes npx prisma studio # Open Prisma Studio ``` ## 📁 Project Structure ``` src/ ├── app/ # Next.js app directory │ ├── api/ # API routes │ ├── auth/ # Authentication pages │ ├── dashboard/ # Dashboard pages │ └── globals.css # Global styles ├── components/ # React components │ ├── ui/ # Reusable UI components │ └── ... # Feature-specific components ├── lib/ # Utility libraries │ ├── integrations/ # Third-party integrations │ └── ... # Other utilities ├── hooks/ # Custom React hooks ├── contexts/ # React contexts └── styles/ # Additional styles ``` ### Key Directories - **`/src/app`**: Next.js 13+ app router pages and API routes - **`/src/components`**: Reusable React components - **`/src/lib`**: Utility functions and configurations - **`/src/hooks`**: Custom React hooks - **`/prisma`**: Database schema and migrations - **`/docs`**: Project documentation ## 📝 Coding Standards ### TypeScript Guidelines - **Strict mode**: Always use strict TypeScript - **Type definitions**: Define types for all functions and variables - **Interfaces**: Use interfaces for object shapes - **Enums**: Use enums for constants - **Generics**: Use generics for reusable components ```typescript // ✅ Good interface User { id: string; name: string; email: string; } function createUser(userData: Omit): User { return { id: generateId(), ...userData, }; } // ❌ Bad function createUser(userData: any): any { return userData; } ``` ### React Guidelines - **Functional components**: Use functional components with hooks - **Props interface**: Define interfaces for component props - **Custom hooks**: Extract reusable logic into custom hooks - **Error boundaries**: Use error boundaries for error handling ```typescript // ✅ Good interface ButtonProps { children: React.ReactNode; onClick: () => void; variant?: 'primary' | 'secondary'; } export function Button({ children, onClick, variant = 'primary' }: ButtonProps) { return ( ); } ``` ### Project-Specific Rules #### GitHub Integration - **Always use cached client**: Use `@/lib/integrations/github-cached` - **Never use direct Octokit**: Avoid `@/lib/integrations/github` directly - **Cache management**: Use `GitHubCacheManager` for cache operations ```typescript // ✅ Good import { fetchGithubActivity } from '@/lib/integrations/github-cached'; // ❌ Bad import { fetchGithubActivity } from '@/lib/integrations/github'; ``` #### Image Optimization - **Use OptimizedImage**: Always use `OptimizedImage` component - **Quality levels**: Use appropriate quality levels (hero, card, thumbnail, avatar) - **Responsive images**: Provide width, height, and sizes props ```typescript // ✅ Good // ❌ Bad

``` ### Code Style - **ESLint**: Follow ESLint configuration - **Prettier**: Use Prettier for code formatting - **Naming**: Use descriptive names for variables and functions - **Comments**: Add comments for complex logic - **Imports**: Organize imports (external, internal, relative) ```typescript // ✅ Good - Organized imports import React from 'react'; import { NextPage } from 'next'; import { Button } from '@/components/ui/button'; import { useAuth } from '@/hooks/use-auth'; import { User } from '@/types/user'; ``` ## 🔄 Git Workflow ### Branch Naming - **Feature**: `feature/description` (e.g., `feature/github-integration`) - **Bugfix**: `bugfix/description` (e.g., `bugfix/auth-redirect`) - **Hotfix**: `hotfix/description` (e.g., `hotfix/security-patch`) - **Refactor**: `refactor/description` (e.g., `refactor/api-structure`) ### Commit Messages Follow [Conventional Commits](https://www.conventionalcommits.org/): ``` type(scope): description [optional body] [optional footer] ``` **Types:** - `feat`: New feature - `fix`: Bug fix - `docs`: Documentation changes - `style`: Code style changes - `refactor`: Code refactoring - `perf`: Performance improvements - `test`: Adding or updating tests - `chore`: Maintenance tasks **Examples:** ``` feat(github): add repository caching fix(auth): resolve redirect loop issue docs(api): update integration guide refactor(ui): simplify component structure ``` ### Workflow Steps 1. **Create branch** from `main` 2. **Make changes** with descriptive commits 3. **Push branch** to your fork 4. **Create PR** using the template 5. **Address feedback** from reviewers 6. **Merge** after approval ## 🔍 Pull Request Process ### Before Creating a PR - [ ] Code compiles without errors - [ ] All tests pass - [ ] Linting passes - [ ] Formatting is correct - [ ] Self-review completed - [ ] Branch is up to date with main ### PR Requirements - **Template**: Use the PR template completely - **Description**: Clear description of changes - **Issues**: Link related issues - **Tests**: Include tests for new features - **Documentation**: Update docs if needed ### Review Process - **Reviewers**: Assign appropriate reviewers - **Labels**: Add relevant labels - **Milestone**: Set if part of larger initiative - **Timeline**: Respond to feedback within 24 hours ## 🐛 Issue Guidelines ### Bug Reports - **Template**: Use the bug report template - **Reproduction**: Provide clear steps to reproduce - **Environment**: Include environment details - **Screenshots**: Add screenshots if helpful - **Logs**: Include relevant error logs ### Feature Requests - **Template**: Use the feature request template - **Problem**: Clearly describe the problem - **Solution**: Propose a solution - **Impact**: Explain the impact - **Mockups**: Include mockups if applicable ### Questions - **Template**: Use the question template - **Context**: Provide sufficient context - **Research**: Show what you've already tried - **Specific**: Ask specific questions ## 🧪 Testing Guidelines ### Test Types - **Unit tests**: Test individual functions/components - **Integration tests**: Test API endpoints and database operations - **E2E tests**: Test critical user flows - **Manual testing**: Test UI changes and complex interactions ### Test Requirements - **New features**: Must include tests - **Bug fixes**: Must include regression tests - **Critical paths**: Always test authentication, data flow, and API endpoints - **Coverage**: Aim for high test coverage ### Running Tests ```bash # Run all tests npm test # Run tests in watch mode bun run test:watch # Run tests with coverage bun run test:coverage # Run specific test file npm test -- --testPathPattern=Button.test.tsx ``` ## 📚 Documentation ### Code Documentation - **JSDoc**: Use JSDoc for functions and classes - **Comments**: Add comments for complex logic - **README**: Update README for new features - **API docs**: Document API endpoints ```typescript /** * Fetches GitHub activity for a user with caching * @param userId - The user ID * @param options - Fetch options * @returns Promise */ export async function fetchGithubActivity( userId: string, options?: FetchOptions ): Promise { // Implementation } ``` ### Documentation Updates - **New features**: Update relevant documentation - **API changes**: Update API documentation - **Configuration**: Update configuration guides - **Deployment**: Update deployment instructions ## 🚀 Release Process ### Versioning We use [Semantic Versioning](https://semver.org/): - **Major**: Breaking changes - **Minor**: New features (backward compatible) - **Patch**: Bug fixes (backward compatible) ### Release Steps 1. **Update version** in `package.json` 2. **Update changelog** with new features/fixes 3. **Create release** on GitHub 4. **Deploy** to production 5. **Monitor** for issues ## 🤝 Getting Help ### Resources - **Documentation**: Check `/docs` folder - **Issues**: Search existing issues - **Discussions**: Use GitHub Discussions - **Code review**: Ask in PR comments ### Contact - **Maintainers**: Tag @maintainers for urgent issues - **Community**: Use GitHub Discussions for general questions - **Security**: Email security@unifiedhq.com for security issues ## 🎉 Recognition ### Contributors We recognize contributors in: - **README**: List of contributors - **Releases**: Mention in release notes - **Community**: Highlight in discussions ### Types of Contributions - **Code**: Bug fixes, features, refactoring - **Documentation**: Guides, tutorials, examples - **Testing**: Test cases, bug reports - **Community**: Help, discussions, feedback --- ## 📋 Quick Start Checklist ### For New Contributors - [ ] Read this contributing guide - [ ] Set up development environment - [ ] Find a good first issue - [ ] Create a branch - [ ] Make changes - [ ] Write tests - [ ] Create PR - [ ] Address feedback - [ ] Celebrate! 🎉 ### For Maintainers - [ ] Review PRs promptly - [ ] Provide constructive feedback - [ ] Help new contributors - [ ] Maintain code quality - [ ] Keep documentation updated **Thank you for contributing to UnifiedHQ! 🚀** ================================================================================ ================================================================================ FILE: TODO.md Relevance Score: 0.980 | Chunks Retrieved: 5 | Tokens: 5,131 ================================================================================ # TODO - Team Dashboard Project ## Project Overview A unified team dashboard that connects Slack, and GitHub to provide a centralized view of team activity with AI-powered summaries. Built with Next.js 15, TypeScript, Prisma, and modern web technologies. ## 🎯 Project Goals - **Primary**: Create a single dashboard for teams to track all activity across GitHub, and Slack - **Secondary**: Provide AI-powered insights and summaries of team productivity - **Tertiary**: Enable real-time collaboration and team awareness ## 📊 Current Status - **Overall Progress**: ~85% complete - **GitHub Integration**: 100% complete - **Slack Integration**: 100% complete (fully implemented with OAuth, API integration, and activity tracking) - **Coming Soon Integrations**: 7 integrations planned (Microsoft Teams, Google Workspace, Jira, Trello, Discord, Linear, Asana) - **AI Features**: 80% complete - **UI/UX**: 95% complete ## ✅ IMPLEMENTED FEATURES ### Authentication & User Management - [x] Better Auth integration with OAuth support - [x] GitHub OAuth authentication - [x] User session management - [x] User preferences storage (Prisma schema) - [x] Rate limiting implementation - [x] Sign in/Sign up pages ### GitHub Integration - [x] GitHub OAuth app setup and configuration - [x] Repository selection and management - [x] Real-time commit tracking (last 10 commits) - [x] Pull request monitoring (open, closed, merged) - [x] GitHub API integration with proper error handling - [x] Repository preferences persistence - [x] External links to GitHub commits and PRs - [x] Activity feed with GitHub data ### UI/UX Components - [x] Modern dashboard layout with sidebar navigation - [x] Responsive design with Tailwind CSS - [x] Comprehensive UI component library (Radix UI) - [x] Activity feed component with real-time updates - [x] Repository selector component - [x] GitHub connection status component - [x] Integration cards for different services - [x] Loading states and error handling - [x] Refresh functionality for data updates - [x] Slack integration UI components - [x] Activity type icons and styling - [x] Integration status indicators ### Database & Backend - [x] PostgreSQL database with Prisma ORM - [x] User management schema - [x] OAuth application and token management - [x] User preferences schema - [x] Rate limiting table - [x] Database migrations ### API Endpoints - [x] `/api/github` - GitHub data fetching - [x] `/api/github/status` - GitHub connection status - [x] `/api/github/repositories` - Repository listing - [x] `/api/github/session` - GitHub session management - [x] `/api/user-preferences` - User preferences CRUD - [x] `/api/auth/[...all]` - Authentication routes ### Data Management - [x] Prisma client generation and configuration - [x] Database connection pooling - [x] User preferences persistence - [x] GitHub repository selection storage - [x] OAuth token management - [x] Session management with Better Auth ### Frontend Architecture - [x] Next.js 15 App Router implementation - [x] TypeScript configuration and type safety - [x] Component-based architecture - [x] Custom hooks for data fetching - [x] State management with React hooks - [x] Responsive design system - [x] Accessibility considerations (basic) ### Development Tools - [x] Hot reloading and fast refresh - [x] TypeScript compilation - [x] Tailwind CSS with custom configuration - [x] Component library with Radix UI - [x] Icon system with Tabler Icons - [x] Form handling with React Hook Form ### Image Optimization & WebP Support - [x] Next.js image optimization configuration - [x] Sharp image processing library integration - [x] WebP and AVIF format support with fallbacks - [x] Responsive image sizing and breakpoints - [x] Lazy loading with Intersection Observer - [x] Image preloading for critical images - [x] Blur placeholder support - [x] Quality control system (hero, card, thumbnail, avatar) - [x] OptimizedImage component with WebP support - [x] AvatarImage component for profile pictures - [x] ImageGallery component with thumbnails and fullscreen - [xx] Custom image loader and utility functions - [x] Error handling and fallback support - [x] Performance optimizations and caching - [x] Demo page showcasing all features - [x] Comprehensive documentation ## 🚧 IN PROGRESS / PARTIALLY IMPLEMENTED ### Slack Integration - [x] Slack UI components and integration cards - [x] Mock Slack activity data in activity feed - [x] Slack icon and styling implementation - [x] Integration status display ("Coming Soon") - [x] Slack OAuth setup and authentication - [x] Slack API integration for messages and channels - [x] Real Slack activity tracking - [x] Slack data transformation for activity feed - [x] Slack workspace/team selection and management - [x] Slack channel monitoring and filtering - [x] Slack preferences storage (SelectedChannel model) - [x] Slack caching system (memory + database) - [x] Slack installation guide with step-by-step instructions - [x] Slack app distribution support with bot tokens - [x] Professional UI with dark mode support ### Coming Soon Integrations - [x] Microsoft Teams integration UI and planning - [x] Google Workspace integration UI and planning - [x] Jira integration UI and planning - [x] Trello integration UI and planning - [x] Discord integration UI and planning - [x] Linear integration UI and planning - [x] Asana integration UI and planning - [x] Coming Soon status indicators and badges - [x] Professional integration cards with proper branding - [x] Feature lists and descriptions for each integration - [x] Disabled state styling for coming soon integrations - [x] Alert notices for development status - [x] Proper icon integration with Tabler Icons - [x] Responsive design for all coming soon integrations ### AI Summary Feature - [x] AI-powered daily summary generation using OpenRouter - [x] Integration with OpenRouter API (OpenAI GPT-4o-mini model) - [x] Summary component UI matching the design specification - [x] Prompt engineering for team activity summaries - [x] Context-aware summarization based on team patterns - [x] Summary caching and optimization (30-minute cache) - [x] Automated summary generation with cron job scheduling - [x] Database schema for storing AI summaries - [x] API endpoints for manual and automated generation - [x] Dashboard integration with time range selection - [x] Error handling and fallback mechanisms - [x] Setup script and comprehensive documentation ### Theme System - [x] Dark/light theme implementation (theme provider exists) - [x] Theme persistence in user preferences - [x] System theme detection - [x] Custom theme variables - [x] Theme switching animations ### Error Handling - [x] Global error boundary implementation - [x] User-friendly error messages - [x] Retry mechanisms for failed requests ## ❌ MISSING FEATURES ### Slack Integration (Backend/API) - [x] Slack OAuth setup and authentication - [x] Slack API integration for messages and channels - [x] Slack workspace/team selection - [x] Real Slack activity tracking (messages, threads, reactions) - [x] Slack data transformation for activity feed - [x] Slack preferences storage - [x] Slack channel monitoring and filtering - [x] Slack user presence and status tracking - [x] Slack file sharing and attachment tracking - [x] Slack app mentions and bot interactions - [x] Slack thread and reply tracking - [x] Slack emoji reactions and responses - [x] Slack integration with external tools - [x] Slack notification preferences ### Enhanced Dashboard Features - [ ] Real-time updates with WebSockets or Server-Sent Events - [x] Advanced filtering and search capabilities - [x] Activity filtering by service (GitHub, Slack) - [x] Time range filtering (today, this week, this month) - [x] User-specific activity filtering - [ ] Activity export functionality - [ ] Activity bookmarking and favorites - [ ] Activity tagging and categorization system - [ ] Custom activity views and layouts - [ ] Activity timeline visualization - [ ] Activity heatmap and calendar view - [ ] Activity statistics and metrics dashboard - [ ] Activity search with full-text search - [ ] Activity filtering by keywords and tags - [x] Activity sorting options (time, relevance, user) - [x] Activity pagination and infinite scroll - [ ] Activity sharing and collaboration features ### AI & Analytics - [x] Complete AI summary implementation - [ ] Team productivity metrics - [ ] Activity trend analysis - [x] Custom AI prompts for summaries - [ ] Sentiment analysis of activities - [ ] Team collaboration insights - [ ] AI-powered activity recommendations - [ ] Predictive analytics for team patterns - [x] Automated report generation - [ ] Team performance benchmarking - [ ] Individual productivity insights - [ ] Cross-platform activity correlation - [ ] Anomaly detection in team activity - [ ] AI-generated action items and follow-ups - [ ] Natural language query interface - [ ] Custom dashboard widgets with AI insights - [ ] Machine learning for activity classification - [ ] AI-powered team communication analysis ### User Experience - [x] Dark/light theme toggle (theme provider exists and implemented) - [ ] Keyboard shortcuts - [ ] Activity notifications - [ ] Email digest functionality - [ ] Customizable dashboard widgets - [ ] Drag-and-drop dashboard customization - [x] Personal workspace preferences - [ ] Onboarding flow and tutorials - [ ] Help system and documentation - [x] Accessibility improvements (WCAG 2.1 AA) - [ ] Multi-language support - [ ] Customizable notification preferences - [ ] Activity digest scheduling - [ ] User onboarding analytics - [ ] Feature discovery and hints - [ ] Progressive web app features - [ ] Customizable activity feeds - [ ] User preference synchronization across devices ### Advanced Features - [ ] Team member management - [ ] Role-based access control - [ ] Activity tagging and categorization - [ ] Custom activity types - [ ] Integration with calendar apps - [ ] Activity scheduling and reminders - [ ] Team workspace management - [ ] Organization-level settings - [ ] Multi-tenant architecture - [ ] Team collaboration tools - [ ] Activity approval workflows - [ ] Custom integration marketplace - [ ] Third-party app integrations - [ ] Webhook system for external services - [ ] API for third-party developers - [ ] Plugin system for custom features - [ ] Team activity archiving - [ ] Data retention policies - [ ] Compliance and audit features - [ ] Team activity reports and exports - [ ] Integration with project management tools - [ ] Time tracking integration - [ ] Meeting integration and scheduling ## 🔧 TECHNICAL IMPROVEMENTS ### Performance - [x] Implement caching for GitHub API calls - [x] Multi-layer caching system (in-memory + database) - [x] Smart cache management with TTL support - [x] Rate limit handling and fallback mechanisms - [x] Cache statistics and monitoring - [x] Automated cache cleanup system - [x] Cache management API endpoints - [x] Add database query optimization - [x] Implement pagination for large activity feeds - [x] Add service worker for offline functionality - [x] Optimize bundle size and loading times - [x] Implement Redis caching layer - [x] Add CDN for static assets - [x] Implement lazy loading for components - [x] Add image optimization and WebP support - [x] Implement virtual scrolling for large lists - [x] Add database connection pooling - [x] Implement API response compression - [x] Add request deduplication - [x] Implement background sync for offline data - [x] Add performance monitoring and metrics ### Security - [x] Implement proper token encryption for stored OAuth tokens - [x] Add CSRF protection - [x] Implement proper rate limiting per user - [x] Add audit logging for sensitive operations - [x] Implement proper error handling and logging - [x] Add input validation and sanitization - [x] Implement SQL injection prevention - [x] Add XSS protection headers - [x] Implement secure session management - [x] Add API authentication and authorization - [ ] Implement data encryption at rest - [x] Add security headers (HSTS, CSP, etc.) - [x] Implement OWASP security guidelines - [ ] Add vulnerability scanning - [ ] Implement secure password policies - [ ] Add two-factor authentication - [ ] Implement data privacy compliance (GDPR, CCPA) - [ ] Add security monitoring and alerting ### Code Quality - [x] Add comprehensive unit tests - [x] Add integration tests for API endpoints - [x] Add E2E tests for critical user flows - [x] Implement proper TypeScript strict mode - [x] Add ESLint and Prettier configuration - [x] Add code coverage reporting - [x] Implement code review guidelines - [x] Add automated code quality checks - [x] Implement consistent coding standards - [x] Add dependency vulnerability scanning - [x] Implement automated dependency updates - [x] Add code complexity analysis - [x] Implement code duplication detection - [x] Add performance regression testing - [x] Implement API contract testing - [x] Add accessibility testing automation - [xx] Implement cross-browser testing ### DevOps & Deployment - [x] CI/CD pipeline setup - [x] Environment-specific configurations - [x] Database backup and recovery procedures - [x] Monitoring and alerting setup - [x] Performance monitoring - [ ] Infrastructure as Code (Terraform/CloudFormation) - [ ] Blue-green deployment strategy - [x] Automated rollback mechanisms - [x] Environment promotion pipeline - [x] Database migration automation - [x] Secrets management system - [x] Log aggregation and analysis - [x] Application performance monitoring (APM) - [x] Error tracking and reporting - [x] Health check endpoints - [ ] Load balancing configuration - [ ] Auto-scaling policies - [ ] Disaster recovery procedures ## 🏗️ ARCHITECTURE & DESIGN ### System Architecture - [ ] Microservices architecture planning - [ ] Event-driven architecture implementation - [ ] Message queue system (Redis/RabbitMQ) - [ ] API gateway implementation - [ ] Service mesh configuration - [ ] Database sharding strategy - [ ] Caching layer architecture - [ ] CDN configuration and optimization ### Data Architecture - [ ] Data modeling for all integrations - [ ] Data warehouse design - [ ] ETL pipeline implementation - [ ] Data lake architecture - [ ] Real-time data processing - [ ] Data versioning and migration - [ ] Data quality monitoring - [ ] Data lineage tracking ### Integration Architecture - [ ] Webhook management system - [ ] API rate limiting and throttling - [ ] Integration health monitoring - [ ] Circuit breaker pattern implementation - [ ] Retry and backoff strategies - [ ] Integration testing framework - [ ] Integration documentation generation ## 🔄 WORKFLOW & PROCESSES ### Development Workflow - [x] Git branching strategy (GitFlow/GitHub Flow) - [x] Pull request templates and guidelines - [x] Code review process automation - [ ] Feature flag management - [x] Release management process - [x] Hotfix procedures - [x] Rollback strategies ### Quality Assurance - [ ] Security testing integration - [ ] User acceptance testing process - [ ] Bug tracking and triage - [ ] Quality gates implementation - [ ] Test data management - [ ] Regression testing automation ### Operations - [ ] Incident response procedures - [ ] On-call rotation setup - [ ] Escalation procedures - [ ] Post-mortem process - [ ] Capacity planning - [ ] Disaster recovery testing - [ ] Security incident response - [ ] Change management process ## 📊 MONITORING & OBSERVABILITY ### Application Monitoring - [ ] Application performance monitoring (APM) - [ ] Real user monitoring (RUM) - [ ] Synthetic monitoring - [ ] Error tracking and alerting - [ ] Custom metrics and dashboards - [ ] Log aggregation and analysis - [ ] Distributed tracing - [ ] Service dependency mapping ### Business Metrics - [ ] User engagement tracking - [ ] Feature adoption metrics - [ ] Conversion funnel analysis - [ ] Retention analysis - [ ] Revenue metrics (if applicable) - [ ] Customer satisfaction tracking - [ ] Support ticket analysis - [ ] Usage pattern analysis ### Infrastructure Monitoring - [ ] Server resource monitoring - [ ] Database performance monitoring - [ ] Network monitoring - [ ] CDN performance tracking - [ ] Third-party service monitoring - [ ] Cost monitoring and optimization - [ ] Capacity utilization tracking - [ ] Security event monitoring ## 🐛 KNOWN ISSUES ### Critical Issues - [x] GitHub token storage in localStorage (should be encrypted) - RESOLVED: OAuth handles token storage in database - [x] Mock data still present in activity feed - [x] No proper error boundaries for React components - FIXED: Comprehensive error boundary system implemented - [x] Missing loading states for some components - FIXED: Comprehensive loading state system implemented - [x] No proper validation for user inputs - FIXED: Comprehensive input validation system implemented ### High Priority Issues - [x] Memory leaks in React components - FIXED: Comprehensive memory leak prevention system implemented - [x] Inconsistent error handling across API endpoints - FIXED: Standardized error handling system implemented - [x] Missing TypeScript types for some components - FIXED: Comprehensive TypeScript types implemented - [x] Performance issues with large activity feeds - FIXED: Virtual scrolling, memoization, and performance optimizations implemented - [x] Accessibility issues in UI components ### Medium Priority Issues - [x] Inconsistent styling across components - [ ] Limited mobile responsiveness - [ ] Incomplete API documentation ### Low Priority Issues - [ ] Code duplication in similar components - [ ] Inconsistent naming conventions - [ ] Missing JSDoc comments - [ ] Console.log statements in production code ## 📝 DOCUMENTATION NEEDED ### Technical Documentation - [ ] API documentation (OpenAPI/Swagger) - [ ] Setup guide for new developers - [ ] Deployment guide - [ ] Architecture decision records (ADRs) - [ ] Database schema documentation - [ ] Integration setup guides (Slack) - [ ] Troubleshooting guide - [ ] Performance optimization guide - [ ] Security best practices guide - [ ] Code style guide and conventions ### User Documentation - [ ] User manual and getting started guide - [ ] Feature documentation - [ ] Video tutorials and walkthroughs - [ ] FAQ and common issues - [ ] Keyboard shortcuts reference - [ ] Mobile app documentation - [ ] Integration setup for end users - [ ] Privacy policy and terms of service - [ ] Accessibility documentation ### Developer Documentation - [ ] Contributing guidelines - [ ] Development environment setup - [ ] Testing guidelines - [ ] Release process documentation - [ ] Code review guidelines - [ ] Git workflow documentation - [ ] CI/CD pipeline documentation - [ ] Monitoring and alerting setup ## 🎯 SUCCESS METRICS ### User Engagement - [ ] Daily/Monthly Active Users (DAU/MAU) - [ ] User retention rates (1-day, 7-day, 30-day) - [ ] Session duration and frequency - [ ] Feature adoption rates - [ ] User satisfaction scores (NPS, CSAT) - [ ] Support ticket volume and resolution time - [ ] User feedback and feature requests ### Technical Performance - [ ] Page load times and Core Web Vitals - [ ] API response times and throughput - [ ] Error rates and uptime (99.9% target) - [ ] Database query performance - [ ] Memory usage and optimization - [ ] Bundle size and loading performance - [ ] Mobile performance metrics ### Business Metrics - [ ] Integration adoption rates (GitHub, Slack) - [ ] Team collaboration metrics - [ ] Activity volume and patterns - [ ] User onboarding completion rates - [ ] Feature usage analytics - [ ] Revenue metrics (if applicable) - [ ] Cost per acquisition and retention ### Quality Metrics - [ ] Bug report frequency and severity - [ ] Code coverage percentage - [ ] Test automation coverage - [ ] Security vulnerability count - [ ] Performance regression incidents - [ ] Accessibility compliance score - [ ] Code quality metrics (complexity, duplication) ## 💡 FUTURE ENHANCEMENTS ### Advanced AI Features - [ ] Natural language query interface - [ ] Predictive analytics for team patterns - [ ] Automated workflow suggestions - [ ] Smart notification prioritization - [ ] AI-powered team insights - [ ] Automated report generation - [ ] Sentiment analysis across platforms ### Enterprise Features - [ ] Single Sign-On (SSO) integration - [ ] Advanced role-based access control - [ ] Audit logging and compliance - [ ] Data governance and retention - [ ] Advanced security features - [ ] Custom branding and white-labeling - [ ] Enterprise support and SLA ### Platform Integrations - [x] Microsoft Teams integration (UI completed, backend planned) - [x] Google Workspace integration (UI completed, backend planned) - [x] Jira integration (UI completed, backend planned) - [x] Trello integration (UI completed, backend planned) - [x] Discord integration (UI completed, backend planned) - [x] Linear integration (UI completed, backend planned) - [x] Asana integration (UI completed, backend planned) - [ ] Calendar integrations (Google, Outlook) - [ ] Email integrations - [ ] CRM integrations (Salesforce, HubSpot) ### Advanced Analytics - [ ] Team productivity dashboards - [ ] Cross-platform activity correlation - [ ] Predictive team insights - [ ] Custom KPI tracking - [ ] Advanced reporting and exports - [ ] Data visualization improvements - [ ] Machine learning recommendations ### Tools & Technologies - [x] **Frontend**: Next.js, React, TypeScript, Tailwind CSS - [x] **Backend**: Next.js API routes, Prisma, PostgreSQL - [x] **Authentication**: Better Auth, OAuth providers - [ ] **AI/ML**: OpenAI API, prompt engineering - [ ] **Monitoring**: Vercel Analytics, Sentry, DataDog ### Third-Party Services - [x] **GitHub**: OAuth, REST API, Webhooks - [x] **Slack**: OAuth, Web API, Events API - [ ] **OpenAI**: GPT API for AI features - [x] **Database**: PostgreSQL (Supabase/Neon) - [ ] **Hosting**: Vercel (recommended) - [ ] **CDN**: Vercel Edge Network - [ ] **Monitoring**: Vercel Analytics, Sentry ================================================================================ ================================================================================ FILE: README.md Relevance Score: 0.970 | Chunks Retrieved: 4 | Tokens: 4,460 ================================================================================ # UnifiedHQ - Team Activity Dashboard

**One dashboard to see everything your team did today** Connect Slack, GitHub, and more — get a unified feed and daily AI summary. [![Next.js](https://img.shields.io/badge/Next.js-15.5.4-black?style=flat-square&logo=next.js)](https://nextjs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/) [![Prisma](https://img.shields.io/badge/Prisma-6.17.1-2D3748?style=flat-square&logo=prisma)](https://www.prisma.io/) [![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.1.14-38B2AC?style=flat-square&logo=tailwind-css)](https://tailwindcss.com/) [![Bun](https://img.shields.io/badge/Bun-Latest-000000?style=flat-square&logo=bun)](https://bun.sh/) [![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)

## 🌟 Overview UnifiedHQ is a comprehensive team activity dashboard that aggregates data from multiple sources (GitHub, Slack, and more) to provide teams with a unified view of their daily activities. Powered by AI, it generates intelligent summaries and insights to help teams stay informed and productive. ### ✨ Key Benefits - **🎯 Centralized Visibility**: See all team activities in one place - **🤖 AI-Powered Insights**: Get intelligent summaries and productivity trends - **⚡ Real-time Updates**: Live activity feeds with instant notifications - **🔒 Enterprise Security**: OAuth integration with secure session management - **📱 Responsive Design**: Works seamlessly across all devices - **🎨 Modern UI**: Beautiful dark/light theme with accessibility support ## 🚀 Features ### 🔗 **Integrations** - **GitHub** - Track commits, pull requests, issues, and repository activity - **Slack** - Monitor messages, channels, and team communications - **Coming Soon** - Microsoft Teams, Google Workspace, Jira, Trello, Discord, Linear, Asana ### 🤖 **AI-Powered Insights** - **Daily Summaries** - Automated daily team activity summaries - **Smart Categorization** - Intelligent activity classification and filtering - **Productivity Analytics** - Trends, patterns, and performance insights - **Predictive Notifications** - Smart alerts based on team behavior - **Custom Insights** - Personalized recommendations and suggestions ### 📊 **Dashboard & Analytics** - **Real-time Activity Feed** - Live updates with WebSocket connections - **Customizable Views** - Select repositories, channels, and time ranges - **Team Statistics** - Comprehensive team performance metrics - **Historical Data** - Track progress over time with detailed analytics - **Export Capabilities** - Download reports and data for external analysis ### 🔐 **Security & Compliance** - **OAuth 2.0 Authentication** - Secure integration with GitHub and Slack - **Session Management** - Advanced session security with IP tracking - **Rate Limiting** - API protection against abuse and DDoS attacks - **Data Encryption** - End-to-end encryption for sensitive data - **GDPR Compliance** - Privacy controls and data protection measures - **Audit Logging** - Comprehensive activity tracking and monitoring ### 🎨 **User Experience** - **Responsive Design** - Optimized for desktop, tablet, and mobile - **Dark/Light Themes** - Automatic theme switching with user preferences - **Accessibility** - WCAG 2.1 AA compliant with screen reader support - **Performance Optimized** - Fast loading with image optimization and caching - **Intuitive Navigation** - Clean, modern interface with easy-to-use controls ## 🛠️ Tech Stack ### **Frontend** - **Next.js 15** - React framework with App Router - **React 19** - Latest React with concurrent features - **TypeScript 5.0** - Type-safe development - **Tailwind CSS 4.1** - Utility-first styling - **Radix UI** - Accessible component primitives - **Framer Motion** - Smooth animations and transitions ### **Backend & Database** - **PostgreSQL** - Robust relational database - **Prisma 6.17** - Type-safe database ORM - **Better Auth** - Modern authentication library - **Redis** - Caching and session storage - **WebSocket** - Real-time communication ### **Integrations & Services** - **GitHub API** - Repository and activity data - **Slack API** - Team communication data - **OpenAI API** - AI-powered summaries and insights - **Sentry** - Error monitoring and performance tracking ### **Development & Deployment** - **Bun** - Fast package manager and runtime - **Vercel** - Deployment and hosting platform - **ESLint & Prettier** - Code quality and formatting - **Playwright** - End-to-end testing - **GitHub Actions** - CI/CD pipeline ## 🚀 Quick Start ### Prerequisites - **Node.js 18+** or **Bun** (recommended) - **PostgreSQL 14+** database - **GitHub OAuth App** for authentication - **Slack App** for team integration (optional) - **OpenAI API Key** for AI features (optional) ### Installation 1. **Clone the repository** ```bash git clone https://github.com/your-username/unifiedhq.git cd unifiedhq ``` 2. **Install dependencies** ```bash bun install # or npm install ``` 3. **Set up environment variables** ```bash cp .env.example .env.local ``` Configure your environment variables: ```env # Database DATABASE_URL="postgresql://username:password@localhost:5432/unifiedhq" # Authentication BETTER_AUTH_SECRET="your-secret-key-here" BETTER_AUTH_URL="http://localhost:3000" # GitHub OAuth GITHUB_CLIENT_ID="your-github-client-id" GITHUB_CLIENT_SECRET="your-github-client-secret" # Slack Integration SLACK_CLIENT_ID="your-slack-client-id" SLACK_CLIENT_SECRET="your-slack-client-secret" # AI Services OPENAI_API_KEY="your-openai-api-key" OPENROUTER_API_KEY="your-openrouter-api-key" # Security ENCRYPTION_KEY="your-32-character-encryption-key" CRON_SECRET_TOKEN="your-cron-secret-token" ``` 4. **Set up the database** ```bash bun prisma migrate dev bun prisma generate ``` 5. **Start the development server** ```bash bun dev # or bun run dev ``` 6. **Open your browser** Navigate to [http://localhost:3000](http://localhost:3000) ## 📖 Documentation ### **Setup Guides** - [GitHub Integration Setup](docs/GITHUB_INTEGRATION_SETUP.md) - Connect GitHub repositories - [Slack Integration Setup](docs/SLACK_INTEGRATION_SETUP.md) - Connect Slack workspace - [AI Summary Setup](docs/AI_SUMMARY_SETUP.md) - Configure AI-powered summaries ### **Development** - [Performance Optimizations](docs/PERFORMANCE_OPTIMIZATIONS.md) - Performance best practices - [Accessibility Implementation](docs/ACCESSIBILITY_IMPLEMENTATION.md) - Accessibility guidelines - [Component Styling Standards](docs/COMPONENT_STYLING_STANDARDS.md) - UI/UX guidelines - [Git Workflow Guide](docs/GIT_WORKFLOW_QUICK_START.md) - Development workflow ### **Security & Compliance** - [Security Policy](SECURITY.md) - Security policies and procedures - [Security Documentation](docs/SECURITY.md) - Technical security implementation - [Security Best Practices](docs/SECURITY_BEST_PRACTICES.md) - Development security guidelines - [Incident Response Plan](docs/INCIDENT_RESPONSE.md) - Security incident procedures ### **Operations** - [GitHub Caching](docs/GITHUB_CACHING.md) - API caching implementation - [Retry Mechanisms](docs/RETRY_MECHANISMS.md) - Error handling and retry logic - [Image Optimization](docs/IMAGE_OPTIMIZATION.md) - WebP and image optimization - [Scroll Optimization](docs/SCROLL_OPTIMIZATION.md) - Performance optimizations ## 🎯 Project Status ### **Overall Progress**: ~75% Complete | Feature | Status | Progress | Notes | |---------|--------|----------|-------| | **GitHub Integration** | ✅ Complete | 100% | Full OAuth, caching, and activity tracking | | **Slack Integration** | ✅ Complete | 100% | Complete workspace and channel integration | | **Authentication** | ✅ Complete | 100% | Better Auth with OAuth 2.0 and session management | | **UI/UX** | ✅ Complete | 95% | Modern design with accessibility support | | **AI Features** | 🚧 In Progress | 60% | Daily summaries implemented, more features planned | | **Security** | ✅ Complete | 95% | Comprehensive security implementation | | **Performance** | ✅ Complete | 90% | Optimized with caching and monitoring | | **Documentation** | ✅ Complete | 85% | Comprehensive docs and guides | ### **Recent Updates** - ✅ **Team Activity Dashboard** - Complete implementation with real-time updates - ✅ **GitHub Caching System** - Advanced caching for improved performance - ✅ **Security Framework** - Comprehensive security policies and procedures - ✅ **Error Handling** - Robust error handling with retry mechanisms - ✅ **Accessibility** - WCAG 2.1 AA compliance implementation ## 🛠️ Available Scripts ### **Development** ```bash bun dev # Start development server bun build # Build for production bun start # Start production server bun lint # Run ESLint bun format # Format code with Prettier bun format:check # Check code formatting ``` ### **Database** ```bash bun prisma migrate dev # Run database migrations bun prisma generate # Generate Prisma client bun prisma studio # Open Prisma Studio bun prisma db seed # Seed database with sample data ``` ### **Branch Management** ```bash bun run branch:create # Create new feature branch bun run branch:list # List all branches bun run branch:cleanup # Clean up merged branches bun run branch:health # Check branch health bun run branch:validate # Validate branch structure ``` ### **Release Management** ```bash bun run release:create # Create new release bun run release:bump # Bump version number bun run release:changelog # Generate changelog bun run release:notes # Generate release notes bun run release:tag # Create release tag ``` ### **Performance & Monitoring** ```bash bun run perf:monitor # Monitor performance metrics bun run perf:analyze # Analyze performance data bun run perf:compare # Compare performance metrics bun run review:check # Run comprehensive code review bun run review:analyze # Analyze code quality ``` ### **AI & Analytics** ```bash bun run ai-summary:setup # Setup AI summary system bun run ai-summary:test # Test AI summary functionality ``` ## 🏗️ Architecture ### **Project Structure** ``` src/ ├── app/ # Next.js App Router │ ├── api/ # API routes and endpoints │ │ ├──