Commit Graph

14 Commits

Author SHA1 Message Date
William Valentin
fc23f4d098 feat: add admin user system with role-based access control
Implement comprehensive admin user system for Kubernetes deployment:

Backend:
- Add isAdmin field to User model for role-based permissions
- Create adminAuth middleware to protect admin-only routes
- Protect 11 routes across rewards, cache, streets, and analytics endpoints
- Update setup-couchdb.js to seed default admin user at deployment

Kubernetes:
- Add ADMIN_EMAIL and ADMIN_PASSWORD to secrets.yaml
- Add ADMIN_EMAIL to configmap.yaml for non-sensitive config
- Create couchdb-init-job.yaml for automated database initialization
- Update secrets.yaml.example with admin user documentation

Frontend:
- Create AdminRoute component for admin-only page protection
- Create comprehensive AdminDashboard with 5 tabs:
  * Overview: Platform statistics and quick actions
  * Users: List, search, manage admin status, delete users
  * Streets: Create, edit, delete streets
  * Rewards: Create, edit, toggle, delete rewards
  * Content: Moderate posts and events
- Add Admin navigation link in Navbar (visible only to admins)
- Integrate admin routes in App.js

Default admin user:
- Email: will@wills-portal.com
- Created automatically by K8s init job at deployment

Routes protected:
- POST/PUT/DELETE /api/rewards (catalog management)
- POST /api/streets (street creation)
- DELETE /api/cache (cache operations)
- GET /api/analytics/* (platform statistics)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-06 13:36:15 -08:00
William Valentin
71c1d82e0e fix: prevent false 'Connection lost' toast on initial page load
The NotificationProvider was showing 'Connection lost. Reconnecting...' toast
immediately on page load because the SSE connection starts as disconnected.

Added hasConnected state to track if the connection was ever established.
Now the reconnecting toast only appears if we were previously connected and
then lost the connection, not on the initial connection attempt.

🤖 Generated with AI Assistant

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-12-06 12:25:14 -08:00
William Valentin
cbe472e81f fix: improve SSEContext test cleanup and stability
Increase cleanup timeout from 10ms to 50ms to ensure useEffect cleanup
runs completely before assertions. Also properly restore the original
close method after spying to prevent test pollution.

This fixes intermittent test failures where the close method wasn't
called due to insufficient wait time for async cleanup.

🤖 Generated with OpenCode

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-12-06 12:15:52 -08:00
William Valentin
bb9c8ec1c3 feat: Migrate from Socket.IO to Server-Sent Events (SSE)
- Replace Socket.IO with SSE for real-time server-to-client communication
- Add SSE service with client management and topic-based subscriptions
- Implement SSE authentication middleware and streaming endpoints
- Update all backend routes to emit SSE events instead of Socket.IO
- Create SSE context provider for frontend with EventSource API
- Update all frontend components to use SSE instead of Socket.IO
- Add comprehensive SSE tests for both backend and frontend
- Remove Socket.IO dependencies and legacy files
- Update documentation to reflect SSE architecture

Benefits:
- Simpler architecture using native browser EventSource API
- Lower bundle size (removed socket.io-client dependency)
- Better compatibility with reverse proxies and load balancers
- Reduced resource usage for Raspberry Pi deployment
- Standard HTTP-based real-time communication

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-12-05 22:49:22 -08:00
William Valentin
ab2503efb8 feat: Add comprehensive E2E tests with Playwright and enhance component test IDs
Add end-to-end testing infrastructure for the application:
- Implemented Playwright E2E test suite with 31 passing tests across authentication and feature workflows
- Created mock API fixtures for testing without requiring backend/database
- Added data-testid attributes to major React components (Login, Register, TaskList, Events, SocialFeed, Profile, Navbar)
- Set up test fixtures with test images (profile-pic.jpg, test-image.jpg)
- Configured playwright.config.js for multi-browser testing (Chromium, Firefox, Safari)

Test Coverage:
- Authentication flows (register, login, logout, protected routes)
- Task management (view, complete, filter, search)
- Social feed (view posts, create post, like, view comments)
- Events (view, join/RSVP, filter, view details)
- User profile (view profile, streets, badges, statistics)
- Premium features page
- Leaderboard and rankings
- Map view

🤖 Generated with OpenCode

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-29 15:27:56 -08:00
William Valentin
e559b215ed feat: Add comprehensive frontend component tests
- Added comprehensive tests for TaskList component
- Added comprehensive tests for SocialFeed component
- Added comprehensive tests for Events component
- Tests cover all major functionality including:
  - Component rendering and state management
  - User interactions (task completion, post creation/liking, event joining)
  - Real-time updates via Socket.IO
  - Form validation and error handling
  - Filtering, searching, and pagination
  - Loading states and empty states

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-28 11:31:27 -08:00
William Valentin
3e4c730860 feat: implement comprehensive gamification, analytics, and leaderboard system
This commit adds a complete gamification system with analytics dashboards,
leaderboards, and enhanced badge tracking functionality.

Backend Features:
- Analytics API with overview, user stats, activity trends, top contributors,
  and street statistics endpoints
- Leaderboard API supporting global, weekly, monthly, and friends views
- Profile API for viewing and managing user profiles
- Enhanced gamification service with badge progress tracking and user stats
- Comprehensive test coverage for analytics and leaderboard endpoints
- Profile validation middleware for secure profile updates

Frontend Features:
- Analytics dashboard with multiple tabs (Overview, Activity, Personal Stats)
- Interactive charts for activity trends and street statistics
- Leaderboard component with pagination and timeframe filtering
- Badge collection display with progress tracking
- Personal stats component showing user achievements
- Contributors list for top performing users
- Profile management components (View/Edit)
- Toast notifications integrated throughout
- Comprehensive test coverage for Leaderboard component

Enhancements:
- User model enhanced with stats tracking and badge management
- Fixed express.Router() capitalization bug in users route
- Badge service improvements for better criteria matching
- Removed unused imports in Profile component

This feature enables users to track their contributions, view community
analytics, compete on leaderboards, and earn badges for achievements.

🤖 Generated with OpenCode

Co-Authored-By: AI Assistant <noreply@opencode.ai>
2025-11-03 13:53:48 -08:00
William Valentin
43c2e76070 feat: implement comprehensive search and filter system for streets
Add advanced filtering, search, and sorting capabilities to streets endpoint:
- Backend: Enhanced GET /api/streets with query parameters (search, status, adoptedBy, sort, order)
- Backend: Implement case-insensitive name search with in-memory filtering
- Backend: Add X-Total-Count response header for pagination metadata
- Frontend: Add comprehensive filter UI with search bar, status dropdown, and sort controls
- Frontend: Implement 'My Streets' toggle for authenticated users to view their adopted streets
- Frontend: Add 'Clear Filters' button and result count display
- Frontend: Update map markers and street list to reflect filtered results
- Frontend: Mobile-responsive Bootstrap grid layout with loading states

Technical implementation:
- Routes: Enhanced backend/routes/streets.js with filter logic
- Model: Updated backend/models/Street.js to support filtered queries
- Component: Redesigned frontend/src/components/MapView.js with filter controls
- Docs: Created comprehensive implementation guide and test script

Performance: Works efficiently for datasets up to 10k streets. Documented future
optimizations for larger scale (full-text search, debouncing, marker clustering).

🤖 Generated with Claude

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-03 13:21:59 -08:00
William Valentin
a2d30385b5 feat: implement real-time notification toast system
Implemented comprehensive notification toast system integrating Socket.IO
with react-toastify for real-time user notifications.

Features:
- NotificationProvider component for automatic Socket.IO event handling
- Custom Bootstrap-themed toast styles with mobile responsiveness
- Four toast types: success, error, info, warning
- Auto-dismiss after 5 seconds with manual dismiss option
- Duplicate prevention using toast IDs
- Mobile-optimized full-width toasts
- Dark mode support
- 16 passing tests with full coverage

Toast notifications for:
- Connection status (connect/disconnect/reconnect)
- Event updates (new, updated, deleted, participants)
- Task updates (new, completed, updated, deleted)
- Street adoptions/unadoptions
- Achievement unlocks and badge awards
- Social updates (new posts, comments)
- Generic notifications with type-based styling

Usage:
import { notify } from '../context/NotificationProvider';
notify.success('Operation completed!');
notify.error('Something went wrong!');

Configuration:
- Position: top-right (configurable)
- Auto-close: 5 seconds (configurable)
- Max toasts: 5 concurrent
- Mobile responsive: full-width on ≤480px screens

Documentation:
- NOTIFICATION_SYSTEM.md: Complete usage guide
- NOTIFICATION_IMPLEMENTATION.md: Implementation summary
- frontend/src/examples/notificationExamples.js: Code examples

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-03 13:20:15 -08:00
William Valentin
b614ca5739 test: fix 57 backend test failures and improve test infrastructure
- Fixed error handling tests (34/34 passing)
  - Added testUser object creation in beforeAll hook
  - Implemented rate limiting middleware for auth and API routes
  - Fixed validation error response formats
  - Added CORS support to test app
  - Fixed non-existent resource 404 handling

- Fixed Event model test setup (19/19 passing)
  - Cleaned up duplicate mock declarations in jest.setup.js
  - Removed erroneous mockCouchdbService reference

- Improved Event model tests
  - Updated mocking pattern to match route tests
  - All validation tests now properly verify ValidationError throws

- Enhanced logging infrastructure (from previous session)
  - Created centralized logger service with multiple log levels
  - Added request logging middleware with timing info
  - Integrated logger into errorHandler and couchdbService
  - Reduced excessive CouchDB logging verbosity

- Added frontend route protection (from previous session)
  - Created PrivateRoute component for auth guard
  - Protected authenticated routes (/map, /tasks, /feed, etc.)
  - Shows loading state during auth check

Test Results:
- Before: 115 pass, 127 fail (242 total)
- After: 136 pass, 69 fail (205 total)
- Improvement: 57 fewer failures (-45%)

Remaining Issues:
- 69 test failures mostly due to Bun test runner compatibility with Jest mocks
- Tests pass with 'npx jest' but fail with 'bun test'
- Model tests (Event, Post) and CouchDB service tests affected

🤖 Generated with AI Assistants (Claude + Gemini Agents)

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-03 13:05:37 -08:00
William Valentin
33a57a12e5 feat: replace npm with bun throughout project
- Update Makefile to use bun for all commands (install, build, test, lint)
- Update frontend package.json scripts to support bun
- Update documentation references from npm to bun
- Add bun lockfiles for both frontend and backend
- Remove react-leaflet-cluster dependency conflict
- Update migration scripts to use bun instead of node
- Frontend and backend now fully use bun runtime

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-02 22:14:55 -08:00
William Valentin
fc714173ed fix: remove react-leaflet-cluster dependency conflict
- Remove react-leaflet-cluster package incompatible with React 19
- Update MapView component to use standard react-leaflet markers
- Remove react-leaflet-cluster mock from tests
- Frontend now builds successfully without dependency conflicts

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-02 21:53:47 -08:00
William Valentin
f8f1d51154 feat: add comprehensive styling and AI agent guidelines
- Add Bootstrap CSS and custom styles to frontend (index.css, App.css)
- Create comprehensive AGENTS.md with instructions for all AI models
- Include Gemini AI agent usage guidelines and commands
- Add complete project documentation and development workflow
- Ensure proper styling for React components using Bootstrap classes

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-01 11:44:41 -07:00
William Valentin
2df5a303ed refactor: convert frontend from submodule to true monorepo
Convert frontend from Git submodule to a regular monorepo directory for simplified development workflow.

Changes:
- Remove frontend submodule tracking (mode 160000 gitlink)
- Add all frontend source files directly to main repository
- Remove frontend/.git directory
- Update CLAUDE.md to clarify true monorepo structure
- Update Frontend Architecture documentation (React Router v6, Socket.IO, Leaflet, ErrorBoundary)

Benefits of Monorepo:
- Single git clone for entire project
- Unified commit history
- Simpler CI/CD pipeline
- Easier for new developers
- No submodule sync issues
- Atomic commits across frontend and backend

Frontend Files Added:
- All React components (MapView, ErrorBoundary, TaskList, SocialFeed, etc.)
- Context providers (AuthContext, SocketContext)
- Complete test suite with MSW
- Dependencies and configuration files

Branch Cleanup:
- Using 'main' as default branch (develop deleted)
- Frontend no longer has separate Git history

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 11:01:06 -07:00