Owner: Engineering Team | Last Updated: 2026-01-30 | Status: Current
Quick reference for common development workflows. Each entry links to the detailed guide or documentation page.
- Install prerequisites
- Follow Dev Environment Setup
- Clone repos from Repository Map
- Complete First Day Checklist
→ Web App - Local Setup
git clone <repo-url>
cd app-main
cp .env.example .env.local # Configure env vars
npm install
npm run dev # Starts with Turbopack on port 3001
→ Guide: Adding a New Feature
- Create feature branch:
feature/TICKET-description
- Implement backend changes (Django model/view/serializer)
- Implement frontend changes (component/page/state)
- Add i18n translation strings
- Test locally → Create PR → Code review → Merge
- Create branch:
bugfix/TICKET-description
- Reproduce the issue locally
- Write a failing test (if test suite exists)
- Fix the bug with minimal changes
- Verify fix doesn't introduce regressions
- Create PR with clear description of root cause and fix
→ Environment Configuration
- Push to
dev branch → Auto-deploys to development environment
- Preproduction deployment: Follow CI/CD pipeline procedure
→ Environment Configuration
- Merge to
main branch → Manual trigger in GitHub Actions
- Verify in staging first!
→ Guide: Adding a New Language
- Create
messages/{locale}.json
- Update
i18n/routing.ts
- Test all pages in new locale
→ Guide: Adding a New Detector
- Modify Django backend (view, serializer, URL)
- Update frontend API integration (
utils/api.ts)
- Update API Reference documentation
→ Guide: Debugging Production Issues
- Check Sentry for error details
- Check CloudWatch logs
- Check PostHog for user event trail
- Use Clarity session replay (production only)
¶ Understand the Architecture
→ System Overview
→ Service Map
→ Data Flow
→ Code Review Checklist
| Date |
Author |
Change |
| 2026-01-30 |
Admin |
Initial creation |
Prev: Key Concepts & Glossary | Up: General