Commit Graph

4 Commits

Author SHA1 Message Date
William Valentin
37b22039a7 docs: update npm commands to bun in README and documentation files
- Replace npm install with bun install
- Replace npm start/test/build with bun equivalents
- Update deployment and testing documentation
- Maintain consistency with project's bun-first approach

🤖 Generated with [AI Assistant]

Co-Authored-By: AI Assistant <noreply@ai-assistant.com>
2025-11-01 12:41:59 -07:00
William Valentin
280f1a2c5e docs: add mandatory git commit workflow to development guidelines
Update CLAUDE.md to establish clear git workflow requirements:

Workflow Requirements:
- Commit to git after EVERY feature, fix, or update
- Build and test changes before committing
- Use conventional commit message format (feat, fix, docs, test, refactor, chore, perf)
- Create commits for each logical unit of work
- Push regularly to origin/main

Benefits:
- Clear history of all changes
- Easy rollback capabilities
- Better collaboration and code review
- Deployment tracking
- Automatic CI/CD pipeline triggers

Commit Message Template:
- Prefix: feat/fix/docs/test/refactor/chore/perf
- Description: Clear, concise summary
- Body: Detailed explanation of changes
- Footer: Claude Code attribution

This ensures the codebase maintains a clean, traceable history and enables better DevOps practices.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 11:12:47 -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
William Valentin
2d1d02387d docs: add comprehensive testing documentation
Add detailed testing guides and implementation documentation:

TESTING.md (560 lines):
- Complete testing guide for developers
- Backend testing with Jest, Supertest, MongoDB Memory Server
- Frontend testing with React Testing Library, MSW
- Test writing examples and patterns
- Coverage requirements and reporting
- CI/CD integration guidelines
- Best practices and conventions

TESTING_QUICK_START.md (250 lines):
- Quick reference for running tests
- Common test commands (backend and frontend)
- Test file locations and organization
- Coverage report viewing
- Troubleshooting common issues
- Quick examples for common scenarios

TEST_IMPLEMENTATION_SUMMARY.md (750 lines):
- Detailed implementation report
- Coverage statistics by area
- Test file descriptions
- Known issues and future improvements
- Architecture decisions
- Test infrastructure details
- MSW handler documentation

CLAUDE.md Updates:
- Add testing section with quick commands
- Document test coverage targets
- Reference comprehensive testing docs
- Add Kubernetes deployment section for Raspberry Pi cluster
- Document cluster configuration (2x Pi 5 8GB, 1x Pi 3B+ 1GB)
- ARM64 and ARMv7 architecture considerations
- Resource optimization strategies

Key Documentation Features:
- Step-by-step guides for writing tests
- Examples for all test types (unit, integration, E2E)
- Coverage reporting and analysis
- Debugging test failures
- Performance testing guidelines
- Mock data management

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

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