How adimogli2/ezscore works
Main Components
A. Client-Side (Frontend):
• Web Browser Interface (HTML/CSS/JavaScript)
• Real-time Score Display Component
• Essay Input Component
• Rubric Input Component
B. Server-Side (Backend):
• Flask Web Server
• AI Grading Service (OpenAI Integration)
• Dropbox Storage Service
C. External Services:
• OpenAI ChatGPT API
• Dropbox API
[Frontend Layer]
• ↕
[Backend Layer]
• ↕
[External Services Layer]
Component Relationships
• Frontend → Backend: HTTP/REST API calls
• Backend → OpenAI: API calls for essay grading
• Backend → Dropbox: Storage API calls
• Backend → Frontend: Response data
Detailed Component Breakdown
Frontend (index.html, style.css, script.js):
[Web Interface]
• ↓
[Essay Input] → [Rubric Input]
• ↓
[Real-time Display]
Backend (main.py):
[Flask Server]
• ↓
[Request Handler]
• ↓
[AI Processing Service] → [Storage Service]
Key Interactions to Highlight
• Essay Submission Flow:
Browser → Flask Server → OpenAI API → Flask Server → Browser
• Storage Flow:
Flask Server → Dropbox API → Confirmation → Flask Server
Additional Elements
Supporting components:
• API Gateway/Endpoints
• Data transformation layers
• Error handling paths
• Authentication flows (if any)
Notes for Implementation
• The simplicity of the architecture (single server, clear separation of concerns)
• The real-time nature of the scoring system
• The integration points with external services
• The data flow from essay submission to feedback storage