How vaaman5-web/ace-platform-db works
ACE is an education and placement-readiness platform. A learner uses the web interface to register, explore companies, assess skills and quiz readiness, then review preparation plans and reports. The backend exposes these capabilities through Express routes and uses PostgreSQL for application data; the sampled matching service queries that database, while the scoring engine computes readiness results. AI generation can use external language-model providers. Several route implementations were not sampled, so uncertain route-to-service and report-generation links are omitted.
Main entry points: server.js Express server · api.js API client · database.js PostgreSQL · aiService.js AI generation
Components 20
Learner interface
- Web interface
public/index.html - API client
public/js/api.js - Company data UI
public/js/companies-data.js - Adaptive quiz UI
public/js/quiz-ai.js
API and identity
- Express server
server.js - Authentication routes
routes/auth.js - Company routes
routes/companies.js - Analysis routes
routes/analysis.js - Quiz routes
routes/quiz.js - Report routes
routes/reports.js - AI routes
routes/ai.js - Admin routes
routes/admin.js
Readiness and preparation
- Readiness scoring
services/scoringEngine.js - Company matching
services/matchingService.js - AI generation
services/aiService.js - PDF generation
services/pdfGenerator.js
Application data
- PostgreSQL
config/database.js
External providers
- OpenAI
- Gemini
Other components
- Learner
Connections 17
- Learner → Web interface: uses
- Web interface → API client: calls
- API client → Express server: sends requests
- Company data UI → API client: uses
- Adaptive quiz UI → AI routes: requests quizzes
- Express server → Authentication routes: mounts
- Express server → Company routes: mounts
- Express server → Analysis routes: mounts
- Express server → Quiz routes: mounts
- Express server → Report routes: mounts
- Express server → AI routes: mounts
- Express server → Admin routes: mounts
- Authentication routes → PostgreSQL: queries
- Express server → PostgreSQL: checks health
- Company matching → PostgreSQL: queries
- AI generation → OpenAI: calls optionally
- AI generation → Gemini: calls optionally