How jeimaku/talkready-ai-powered-communication-practice-platform works
TalkReady is a role-based English communication practice and learning platform. Students enter through the web app, authenticate, access structured lessons and practice activities, and review performance feedback; trainers manage classes and assessments, while administrators oversee users and platform activity. The frontend uses Firebase for authentication and application data, with backend services and external AI integrations documented in the README. Several feature modules are represented from the tree and README, but their internal wiring was not sampled, so uncertain connections are omitted.
Main entry points: firebase.js Firebase data services · App.jsx App routing · authContext/index.jsx Authentication context · courseoutline/index.jsx Course outline
Components 24
Web application
- App routing
src/App.jsx - Login and registration
src/components/auth/login/Login.jsx - Authentication context
src/contexts/authContext/index.jsx - Landing page
src/components/landingpage/landingpage.jsx
Learning practice
- Course outline
src/components/courseoutline/index.jsx - Course structure
src/components/courseoutline/courseStructure.js - Lessons and activities
src/components/courseoutline/beginner/module1/Lesson1.1.jsx - Call simulation
src/components/courseoutline/advanced/module6/AdvancedCallSimulation.jsx - Assessment activities
src/components/courseoutline/assessments/ModuleAssessment.jsx - AI practice chatbot
src/components/chatbot/index.jsx - Learner reports
src/components/my-reports/index.jsx
Classroom management
- Trainer workflows
src/components/TrainerSection/TrainerClassDashboard.jsx - Trainer assessment review
src/components/TrainerSection/assessments/TrainerReviewPage.jsx - Student assessment review
src/components/student/ReviewAssessmentAttemptPage.jsx
Administration
- Admin workflows
src/components/homepage/AdminHomepage.jsx - User management
src/components/admin/UserManagement.jsx - Admin operations
src/utils/adminFunctions.js
Platform services
- Firebase data services
src/firebase/firebase.js - Firebase auth adapter
src/firebase/auth.js - Session management
src/utils/sessionManager.js - Express backend
server.js - Cloud Functions
functions/index.js
Other components
- Learner or staff
- AI services
Connections 22
- Learner or staff → App routing: uses
README.md - App routing → Login and registration: routes to
src/App.jsx - App routing → Course outline: routes to
src/App.jsx - App routing → Trainer workflows: routes to
src/App.jsx - App routing → Admin workflows: routes to
src/App.jsx - Login and registration → Authentication context: uses
src/components/auth/login/Login.jsx - Authentication context → Session management: validates sessions
src/contexts/authContext/index.jsx - Authentication context → Firebase data services: reads user data
src/contexts/authContext/index.jsx - Firebase auth adapter → Firebase data services: saves user data
src/firebase/auth.js - Course outline → Course structure: loads structure
src/components/courseoutline/index.jsx - Course outline → Lessons and activities: routes to lessons
src/App.jsx - Lessons and activities → Assessment activities: includes assessments
- Trainer assessment review → Firebase data services: loads and saves reviews
src/components/TrainerSection/assessments/TrainerReviewPage.jsx - Student assessment review → Firebase data services: marks reviewed
src/components/student/ReviewAssessmentAttemptPage.jsx - Admin workflows → User management: routes to
- User management → Admin operations: manages accounts
- Admin operations → Cloud Functions: calls functions
src/utils/adminFunctions.js - Admin operations → Firebase data services: updates records
src/utils/adminFunctions.js - AI practice chatbot → AI services: uses AI
README.md - Learner or staff → Express backend: uses backend
README.md - Express backend → AI services: integrates AI
README.md - Express backend → Firebase data services: uses Firebase
README.md