Product Requirements Document (PRD)

Survey Form Application

Organization: HERE AND NOW AI
Website: https://hereandnowai.com
Contact: info@hereandnowai.com | +91 996 296 1000
Slogan: AI is Good

---

1. Overview

1.1 Product Vision

Build a modern, scalable survey form application that allows users to create, distribute, and analyze surveys with a focus on AI-driven insights and user experience. The primary use case is to assess people's understanding of key AI concepts through a standardized questionnaire.

1.2 Primary Survey Focus

This application is specifically designed to assess understanding of six core AI/ML concepts:

1. Artificial Intelligence (AI) - Fundamental AI concepts and applications
2. Machine Learning (ML) - ML algorithms, training, and data-driven learning
3. Deep Learning (DL) - Neural networks and advanced ML architectures
4. Generative AI (GenAI) - Content generation, LLMs, and creative AI
5. AI Agents - Autonomous systems, goal-oriented behavior, and decision-making
6. Model Context Protocol (MCP) - Standardized protocols for AI interoperability

The default survey includes 30 carefully crafted questions (5 per concept) using a 5-point Likert scale to measure comprehension levels.

1.3 Target Audience

• Technology professionals and developers
• Students and educators in AI/ML fields
• Business leaders exploring AI adoption
• Researchers and academics in computer science
• Organizations assessing team AI knowledge
• Anyone interested in understanding AI concepts

---

2. Technical Architecture

2.1 Technology Stack

Frontend:

• Framework: React
• Deployment: Cloudflare Pages
• Repository: Public GitHub repository under github.com/hereandnowai

Backend:

• Language: Java (Spring Boot recommended)
• Hosting: Self-hosted on macOS
• Access: Cloudflare Tunnel (cloudflared)
• API: RESTful API

Database:

• Database: PostgreSQL
• Hosting: Self-hosted on macOS

Branding:

• Primary Color: #FFDF00 (Yellow)
• Secondary Color: #004040 (Teal)
• Logo:
• Favicon: https://raw.githubusercontent.com/hereandnowai/images/refs/heads/main/logos/favicon-logo-with-name.png

2.2 Deployment Architecture

┌─────────────────────────────────────────┐
│         Internet Users                  │
└─────────────────┬───────────────────────┘
                  │
    ┌─────────────┴──────────────┐
    │                            │
    ▼                            ▼
┌───────────────┐        ┌──────────────────┐
│  Cloudflare   │        │   Cloudflare     │
│    Pages      │        │     Tunnel       │
│  (Frontend)   │        │   (Backend API)  │
└───────────────┘        └────────┬─────────┘
                                  │
                         ┌────────▼─────────┐
                         │   macOS Server   │
                         │  ┌────────────┐  │
                         │  │ Java API   │  │
                         │  └──────┬─────┘  │
                         │         │        │
                         │  ┌──────▼─────┐  │
                         │  │ PostgreSQL │  │
                         │  └────────────┘  │
                         └──────────────────┘

---

3. Core Features

3.1 User Management

• User registration and authentication
• Role-based access control (Admin, Survey Creator, Respondent)
• Profile management
• Password reset functionality

3.2 Survey Creation

• Drag-and-drop survey builder
• Multiple question types:
  • Likert scale (primary) - 5-point scale (Strongly Disagree to Strongly Agree)
  • Multiple choice (single/multi-select)
  • Text input (short/long answer)
  • Rating scales (star rating, numeric)
  • Date/time picker
  • File upload
  • Matrix questions
  • Ranking questions
• Pre-built AI Knowledge Assessment template with 30 questions across 6 concepts
• Concept-based question organization
• Conditional logic (skip logic, branching)
• Question validation rules
• Survey templates library
• Preview mode

3.3 Survey Distribution

• Unique survey links
• Email invitations
• QR code generation
• Embed options for websites
• Response tracking
• Survey scheduling (start/end dates)
• Access control (public, private, password-protected)

3.4 Response Collection

• Real-time response capture
• Anonymous and identified responses
• Partial response saving (draft mode)
• Response limits
• IP address tracking (optional)
• Device/browser information capture
• Timestamp recording

3.5 Analytics & Reporting

• Real-time response dashboard
• Visual data representation (charts, graphs)
• Concept-based scoring - Score calculation per AI concept (max 25 points each)
• Overall knowledge assessment - Total score across all 30 questions (max 150 points)
• Knowledge level classification - Expert, Advanced, Intermediate, Beginner, Limited
• Likert scale distribution visualization
• Concept comparison and correlation analysis
• Export capabilities (CSV, Excel, PDF)
• Filter and segment responses
• Cross-tabulation analysis
• Response summary statistics
• Individual response viewing with score breakdown

3.6 Administrative Features

• Survey management (create, edit, delete, duplicate)
• User management
• System settings
• Audit logs
• Data backup and export
• Survey archiving

---

4. User Interface Requirements

4.1 Design Principles

• Clean, modern interface
• Mobile-responsive design
• Accessibility compliant (WCAG 2.1 AA)
• Consistent branding with HERE AND NOW AI colors
• Intuitive navigation
• Fast loading times

4.2 Key Pages

Public Pages:

• Landing page
• Survey response page
• Thank you page

Authenticated Pages:

• Dashboard
• Survey builder
• Survey list
• Analytics page
• Settings page
• Profile page

4.3 Branding Integration

• Use primary color (#FFDF00) for CTAs, highlights
• Use secondary color (#004040) for headers, navigation
• Display HERE AND NOW AI logo in header
• Include social media links in footer:
  • Blog: https://hereandnowai.com/blog
  • LinkedIn: https://www.linkedin.com/company/hereandnowai/
  • Instagram: https://instagram.com/hereandnow_ai
  • GitHub: https://github.com/hereandnowai
  • X: https://x.com/hereandnow_ai
  • YouTube: https://youtube.com/@hereandnow_ai

---

5. API Specifications

5.1 Authentication Endpoints

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• POST /api/auth/logout - User logout
• POST /api/auth/refresh - Refresh token
• POST /api/auth/forgot-password - Password reset request
• POST /api/auth/reset-password - Password reset

5.2 Survey Management Endpoints

• GET /api/surveys - List all surveys
• POST /api/surveys - Create new survey
• GET /api/surveys/{id} - Get survey details
• PUT /api/surveys/{id} - Update survey
• DELETE /api/surveys/{id} - Delete survey
• POST /api/surveys/{id}/duplicate - Duplicate survey
• PUT /api/surveys/{id}/publish - Publish survey
• PUT /api/surveys/{id}/close - Close survey

5.3 Question Management Endpoints

• POST /api/surveys/{surveyId}/questions - Add question
• PUT /api/surveys/{surveyId}/questions/{questionId} - Update question
• DELETE /api/surveys/{surveyId}/questions/{questionId} - Delete question
• PUT /api/surveys/{surveyId}/questions/reorder - Reorder questions

5.4 Response Endpoints

• POST /api/surveys/{id}/responses - Submit response
• GET /api/surveys/{id}/responses - Get all responses
• GET /api/surveys/{id}/responses/{responseId} - Get specific response
• GET /api/surveys/{id}/responses/export - Export responses

5.5 Analytics Endpoints

• GET /api/surveys/{id}/analytics/summary - Get response summary
• GET /api/surveys/{id}/analytics/questions/{questionId} - Get question analytics

---

6. Database Schema

6.1 Core Tables

users

• id (UUID, PK)
• email (VARCHAR, UNIQUE)
• password_hash (VARCHAR)
• first_name (VARCHAR)
• last_name (VARCHAR)
• role (ENUM: admin, creator, respondent)
• created_at (TIMESTAMP)
• updated_at (TIMESTAMP)

surveys

• id (UUID, PK)
• user_id (UUID, FK → users)
• title (VARCHAR)
• description (TEXT)
• status (ENUM: draft, active, closed, archived)
• settings (JSONB)
• created_at (TIMESTAMP)
• updated_at (TIMESTAMP)
• published_at (TIMESTAMP)
• closed_at (TIMESTAMP)

questions

• id (UUID, PK)
• survey_id (UUID, FK → surveys)
• type (ENUM: multiple_choice, text, rating, date, file, matrix, ranking)
• question_text (TEXT)
• options (JSONB)
• validation_rules (JSONB)
• required (BOOLEAN)
• order_index (INTEGER)
• created_at (TIMESTAMP)

responses

• id (UUID, PK)
• survey_id (UUID, FK → surveys)
• user_id (UUID, FK → users, NULLABLE)
• is_complete (BOOLEAN)
• ip_address (VARCHAR)
• user_agent (TEXT)
• submitted_at (TIMESTAMP)

answers

• id (UUID, PK)
• response_id (UUID, FK → responses)
• question_id (UUID, FK → questions)
• answer_value (JSONB)
• created_at (TIMESTAMP)

---

7. Security Requirements

7.1 Authentication & Authorization

• JWT-based authentication
• Secure password hashing (bcrypt)
• Token expiration and refresh mechanism
• Role-based access control (RBAC)

7.2 Data Security

• HTTPS only communication
• SQL injection prevention (parameterized queries)
• XSS protection
• CSRF protection
• Input validation and sanitization
• Rate limiting on API endpoints

7.3 Privacy

• GDPR compliance considerations
• Data anonymization options
• Clear privacy policy
• User data export capability
• User data deletion capability

---

8. Performance Requirements

8.1 Response Times

• Page load: < 2 seconds
• API response: < 500ms for standard queries
• Survey submission: < 1 second

8.2 Scalability

• Support 1,000 concurrent users
• Handle surveys with up to 100 questions
• Store up to 100,000 responses per survey

8.3 Availability

• 99% uptime target
• Automated backups daily
• Disaster recovery plan

---

9. Testing Requirements

9.1 Frontend Testing

• Unit tests (Jest, React Testing Library)
• Integration tests
• E2E tests (Cypress/Playwright)
• Cross-browser testing
• Mobile responsiveness testing

9.2 Backend Testing

• Unit tests (JUnit)
• Integration tests
• API contract tests
• Load testing
• Security testing

9.3 Database Testing

• Migration tests
• Data integrity tests
• Performance tests

---

10. Documentation Requirements

10.1 Technical Documentation

• API documentation (Swagger/OpenAPI)
• Database schema documentation
• Setup and deployment guides
• Architecture decision records

10.2 User Documentation

• User guide
• Survey creation tutorial
• FAQ section
• Video tutorials

---

11. Success Metrics

11.1 User Engagement

• Number of surveys created
• Number of responses collected
• Daily/Monthly active users
• User retention rate

11.2 Performance Metrics

• Average survey completion rate
• Average time to create a survey
• API response times
• Error rates

11.3 Business Metrics

• User growth rate
• Survey distribution reach
• Feature adoption rates

---

12. Future Enhancements

12.1 Phase 2 Features

• AI-powered question suggestions for new concepts
• Personalized learning recommendations based on scores
• Knowledge gap analysis and training suggestions
• Sentiment analysis of text responses
• Advanced data visualization (radar charts, heat maps)
• Comparative benchmarking across industries/roles
• Survey collaboration (multiple editors)
• White-label branding options
• Additional AI concept modules (Computer Vision, NLP, Robotics, etc.)

12.2 Phase 3 Features

• Mobile apps (iOS, Android)
• Integration with third-party tools (Slack, Teams, etc.)
• Advanced survey logic (A/B testing)
• Multi-language support
• Voice/video response collection

---

13. Timeline & Milestones

Milestone 1: Project Setup (Week 1-2)

• Repository setup
• Development environment configuration
• CI/CD pipeline setup
• Database setup

Milestone 2: MVP Development (Week 3-8)

• User authentication
• Basic survey creation
• Survey response collection
• Basic analytics dashboard

Milestone 3: Enhanced Features (Week 9-12)

• Advanced question types
• Conditional logic
• Enhanced analytics
• Email invitations

Milestone 4: Testing & Deployment (Week 13-14)

• Comprehensive testing
• Bug fixes
• Production deployment
• Documentation completion

Milestone 5: Launch (Week 15)

• User acceptance testing
• Performance optimization
• Marketing preparation
• Official launch

---

14. Risks & Mitigation

14.1 Technical Risks

• Risk: Cloudflare Tunnel connectivity issues
  • Mitigation: Regular monitoring, backup connection methods
• Risk: Database performance degradation
  • Mitigation: Proper indexing, query optimization, regular maintenance

14.2 Security Risks

• Risk: Data breaches
  • Mitigation: Regular security audits, penetration testing
• Risk: DDoS attacks
  • Mitigation: Cloudflare DDoS protection, rate limiting

14.3 Operational Risks

• Risk: Mac server downtime
  • Mitigation: Automated monitoring, backup hardware
• Risk: Data loss
  • Mitigation: Automated daily backups, tested recovery procedures

---

15. Stakeholders

Project Owner: HERE AND NOW AI
Development Team: TBD
Target Users: Survey creators, respondents
Maintenance: HERE AND NOW AI technical team

---

16. Approval & Sign-off

Document Version: 1.0
Last Updated: February 1, 2026
Status: Draft

---

Contact Information:
HERE AND NOW AI
Email: info@hereandnowai.com
Phone: +91 996 296 1000
Website: https://hereandnowai.com