Key Decisions

Last Verified: 2026-02-17 | Owner: John 
 
 BasicFakta — Key Decisions 
 Strategic Decisions 
 Backend Separation (Date TBD) 
 Decision: Host backend API separately from frontend repo.
 Rationale: Protects proprietary algorithm, easier to scale backend independently.
 Trade-off: Makes algorithm improvements harder, blocks accuracy work.
 Current impact: Task #100 blocked pending backend import. 
 Deployment on Vercel (Date TBD) 
 Decision: Auto-deploy from GitHub main branch via Vercel.
 Rationale: Zero-config deployment, global CDN, preview deployments.
 Status: Active and working. 
 Technical Decisions 
 Frontend Stack 
 
 Modern web framework (details in repo) 
 Vercel hosting 
 GitHub version control (HTTPS auth) 
 
 Security Measures (2026-02) 
 Decision: Implement comprehensive security hardening.
 Implemented: 
 
 Input sanitization (XSS prevention) 
 Rate limiting (authentication bypass fix) 
 API key sanitization 
 Security headers via vercel.json 
 
 Accessibility (2026-02) 
 Decision: Achieve WCAG 2.1 compliance.
 Implemented: 
 
 Screen reader support 
 Keyboard navigation 
 Mobile-friendly touch targets 
 
 Development Decisions 
 GitHub Auth (2026-02) 
 Decision: Switch from SSH to HTTPS authentication.
 Reason: ~/.zshenv had GITHUB_TOKEN=CHANGE_ME placeholder that overrode gh CLI token.
 Fix: Commented out line 40, use gh CLI token (ghp_ PAT in ~/.config/gh/hosts.yml). 
 Test Strategy (Current) 
 Status: 42/65 tests passing
 Blocker: 23 tests fail due to backend algorithm issues (factScore too high for known fake news)
 Next step: Backend import required before test fixes 
 Operational Decisions 
 Email Domain 
 
 Domain: basicfakta.no 
 Status: Email monitoring blocked (task #79) 
 Issue: Missing IMAP credentials (host/port/user) 
 Required from Alem: IMAP access details