tractatus/src/models
TheFlow ccb4bdaabf feat(api): implement research inquiry endpoint and Umami analytics
HIGH PRIORITY: Fixes production 404 error on research inquiry form

Research Inquiry API:
- Add POST /api/research-inquiry endpoint for form submissions
- Add admin endpoints for inquiry management (list, get, assign, respond, delete)
- Create ResearchInquiry model with MongoDB integration
- Add to moderation queue for human review (strategic quadrant)
- Include rate limiting (5 req/min) and CSRF protection
- Tested locally: endpoint responding, data saving to DB

Umami Analytics (Privacy-First):
- Add Docker Compose config for Umami + PostgreSQL
- Create nginx reverse proxy config with SSL support
- Implement privacy-first tracking script (DNT, opt-out, no cookies)
- Integrate tracking across 26 public HTML pages
- Exclude admin pages from tracking (privacy boundary)
- Add comprehensive deployment guide (UMAMI_SETUP_GUIDE.md)
- Environment variables added to .env.example

Files Created (9):
- src/models/ResearchInquiry.model.js
- src/controllers/research.controller.js
- src/routes/research.routes.js
- public/js/components/umami-tracker.js
- deployment-quickstart/nginx-analytics.conf
- deployment-quickstart/UMAMI_SETUP_GUIDE.md
- scripts/add-umami-tracking.sh
- scripts/add-tracking-python.py
- SESSION_SUMMARY_ANALYTICS_RESEARCH_INQUIRY.md

Files Modified (29):
- src/routes/index.js (research routes)
- deployment-quickstart/docker-compose.yml (umami services)
- deployment-quickstart/.env.example (umami config)
- 26 public HTML pages (tracking script)

Values Alignment:
 Privacy-First Design (cookie-free, DNT honored, opt-out available)
 Human Agency (research inquiries require human review)
 Data Sovereignty (self-hosted analytics, no third-party sharing)
 GDPR Compliance (no personal data in analytics)
 Transparency (open-source tools, documented setup)

Testing Status:
 Research inquiry: Locally tested, data verified in MongoDB
 Umami analytics: Pending production deployment

Next Steps:
1. Deploy to production (./scripts/deploy.sh)
2. Test research form on live site
3. Deploy Umami following UMAMI_SETUP_GUIDE.md
4. Update umami-tracker.js with website ID after setup

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-29 01:31:02 +13:00
..
ActivityTimeline.model.js feat(crm): complete Phase 3 multi-project CRM + critical bug fixes 2025-10-24 18:10:14 +13:00
Analytics.model.js fix(analytics): remove SessionSchema.index sessionId duplicate 2025-10-24 10:25:02 +13:00
AuditLog.model.js feat(research): add cross-environment audit log sync infrastructure 2025-10-27 12:11:16 +13:00
BlogPost.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
CaseSubmission.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
Contact.model.js feat(crm): implement unified contact form system 2025-10-24 16:56:21 +13:00
DeliberationSession.model.js chore: update dependencies and documentation 2025-10-19 12:48:37 +13:00
Document.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
Donation.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
GovernanceLog.model.js feat: fix documentation system - cards, PDFs, TOC, and navigation 2025-10-07 22:51:55 +13:00
GovernanceRule.model.js fix(models): remove duplicate schema indexes for clean startup 2025-10-12 16:35:45 +13:00
index.js feat(server): add security middleware and website-specific routes 2025-10-23 10:57:20 +13:00
MediaInquiry.model.js feat(cultural-sensitivity): implement Phase 1 - detection and flagging (inst_081) 2025-10-25 11:10:06 +13:00
MissedBreach.model.js feat(research): add missed breach tracking system for framework effectiveness measurement 2025-10-27 12:26:53 +13:00
ModerationQueue.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
NewsletterSubscription.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
Organization.model.js feat(crm): complete Phase 3 multi-project CRM + critical bug fixes 2025-10-24 18:10:14 +13:00
Precedent.model.js chore: update dependencies and documentation 2025-10-19 12:48:37 +13:00
Project.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
PublicationRelationship.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
ResearchInquiry.model.js feat(api): implement research inquiry endpoint and Umami analytics 2025-10-29 01:31:02 +13:00
Resource.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
ResponseTemplate.model.js feat(governance): extend framework checks to all external communications 2025-10-25 09:53:09 +13:00
ScheduledTask.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
SessionState.model.js fix: MongoDB persistence and inst_016-018 content validation enforcement 2025-10-11 00:17:03 +13:00
SLATracking.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
SubmissionTracking.model.js fix(submissions): resolve Mongoose populate error for hybrid BlogPost model 2025-10-24 10:19:33 +13:00
SyncMetadata.model.js feat(research): add cross-environment audit log sync infrastructure 2025-10-27 12:11:16 +13:00
UnifiedContact.model.js feat(crm): complete Phase 3 multi-project CRM + critical bug fixes 2025-10-24 18:10:14 +13:00
User.model.js fix(submissions): restructure Economist package and fix article display 2025-10-24 08:47:42 +13:00
VariableValue.model.js refactor(lint): fix code style and unused variables across src/ 2025-10-24 20:15:26 +13:00
VerificationLog.model.js chore(framework): session tracking, test enforcement, and schema improvements 2025-10-21 04:05:09 +13:00