How anmoryli/teachagent works
Purpose and entry point
TeachAgent is a Java teaching-support backend with teacher, student, and user-facing API layers. Its executable application entry point is src/main/java/com/anmory/teachagent/TeachAgentApplication.java. Maven build/dependency definition is in pom.xml; runtime settings are centralized in src/main/resources/application.yml.
API and request boundary
HTTP requests enter role-oriented controllers: src/main/java/com/anmory/teachagent/controller/TeacherController.java, src/main/java/com/anmory/teachagent/controller/StudentController.java, and src/main/java/com/anmory/teachagent/controller/UserController.java. Controllers are the boundary between clients and application services, using DTOs such as src/main/java/com/anmory/teachagent/dto/LessonPlanDto.java and src/main/java/com/anmory/teachagent/dto/JudgeStudentAnswerDto.java.
Authentication and cross-cutting web behavior
Login enforcement is separated into src/main/java/com/anmory/teachagent/interceptor/LoginInterceptor.java, with interceptor registration likely managed by src/main/java/com/anmory/teachagent/config/WebConfig.java. Cross-origin handling, normalized responses, and error translation are handled at the web boundary through src/main/java/com/anmory/teachagent/config/CorsConfig.java, src/main/java/com/anmory/teachagent/config/ResponseAdvice.java, and src/main/java/com/anmory/teachagent/config/GlobalExceptionHandler.java.
Teaching workflow services
The core instructional domain is organized as services for courses, materials, questions, answers, practice records, and lesson plans: src/main/java/com/anmory/teachagent/service/CourseService.java, src/main/java/com/anmory/teachagent/service/LessonPlanService.java, and src/main/java/com/anmory/teachagent/service/PracticeRecordService.java. Their persisted domain objects include src/main/java/com/anmory/teachagent/model/Course.java, src/main/java/com/anmory/teachagent/model/LessonPlan.java, and src/main/java/com/anmory/teachagent/model/PracticeRecord.java.
AI-assisted generation and evaluation
AI-related capabilities are isolated behind service boundaries: src/main/java/com/anmory/teachagent/service/AiService.java, src/main/java/com/anmory/teachagent/service/RagService.java, and src/main/java/com/anmory/teachagent/service/JudgePrommingService.java. These likely support retrieval-augmented generation, prompt management, student-answer evaluation, and generated teaching artifacts; adjacent services include src/main/java/com/anmory/teachagent/service/PPTService.java and src/main/java/com/anmory/teachagent/service/PromptService.java. The actual AI provider and integration protocol are not evident from the tree.
Persistence, analytics, and reporting
Persistence is mediated through mapper interfaces, including src/main/java/com/anmory/teachagent/mapper/UserMapper.java, src/main/java/com/anmory/teachagent/mapper/LessonPlanMapper.java, and src/main/java/com/anmory/teachagent/mapper/QuestionMapper.java. Database schema and seed/query SQL are present at src/main/resources/sql/db.sql, src/main/resources/sql/insert.sql, and src/main/resources/sql/analyse.sql. Analytics/reporting is a distinct flow via src/main/java/com/anmory/teachagent/service/AnalyseService.java, src/main/java/com/anmory/teachagent/service/StatisticsService.java, and src/main/java/com/anmory/teachagent/service/CountService.java, producing metrics-oriented DTOs.
Client delivery and activity observability
The repository includes a bundled static browser client at src/main/resources/static/index.html and src/main/resources/static/app.js, served alongside the backend rather than as a separate frontend project. User or system activity is modeled and serviced through src/main/java/com/anmory/teachagent/model/ActivityLog.java and src/main/java/com/anmory/teachagent/service/ActivityLogService.java; request timing is cross-cutting via src/main/java/com/anmory/teachagent/aspect/TimeAspect.java.
Main entry points: TeacherController.java Teacher API · CourseService.java Teaching Workflow Services · LessonPlanMapper.java Persistence Mappers · StudentController.java Student API
Components 22
Web Boundary
- Bundled Browser Client
src/main/resources/static/index.html - Web Configuration · Registers interception and cross-origin behavior.
src/main/java/com/anmory/teachagent/config/WebConfig.java - Login Interceptor
src/main/java/com/anmory/teachagent/interceptor/LoginInterceptor.java - Teacher API
src/main/java/com/anmory/teachagent/controller/TeacherController.java - Student API
src/main/java/com/anmory/teachagent/controller/StudentController.java - User API
src/main/java/com/anmory/teachagent/controller/UserController.java - Response & Error Handling · Normalizes responses and translates errors.
src/main/java/com/anmory/teachagent/config/ResponseAdvice.java - Request/Response DTOs
src/main/java/com/anmory/teachagent/dto/LessonPlanDto.java
Teaching Domain
- Teaching Workflow Services · Manages courses, lesson plans, materials, questions, answers, and practice.
src/main/java/com/anmory/teachagent/service/CourseService.java - Lesson Plan Service
src/main/java/com/anmory/teachagent/service/LessonPlanService.java - Practice Records
src/main/java/com/anmory/teachagent/service/PracticeRecordService.java
AI Capabilities
- AI Generation · Generates AI-assisted teaching artifacts.
src/main/java/com/anmory/teachagent/service/AiService.java - Retrieval-Augmented Generation
src/main/java/com/anmory/teachagent/service/RagService.java - Answer Evaluation
src/main/java/com/anmory/teachagent/service/JudgePrommingService.java
Data & Reporting
- Persistence Mappers · Maps users, lesson plans, questions, and related domain data.
src/main/java/com/anmory/teachagent/mapper/LessonPlanMapper.java - Teaching Data Store · Schema, seed data, and analysis queries are maintained as SQL.
src/main/resources/sql/db.sql - Analytics & Statistics · Produces metrics from teaching and practice data.
src/main/java/com/anmory/teachagent/service/AnalyseService.java - Activity Logging
src/main/java/com/anmory/teachagent/service/ActivityLogService.java
Other components
- Spring Boot Application
src/main/java/com/anmory/teachagent/TeachAgentApplication.java - Request Timing
src/main/java/com/anmory/teachagent/aspect/TimeAspect.java - Runtime Settings
src/main/resources/application.yml - Maven Build
pom.xml
Connections 26
- Bundled Browser Client → Teacher API: teacher requests
- Bundled Browser Client → Student API: student requests
- Bundled Browser Client → User API: user requests
- Web Configuration → Login Interceptor: registers
- Login Interceptor → Teacher API: protects
- Login Interceptor → Student API: protects
- Teacher API → Request/Response DTOs: uses
- Student API → Request/Response DTOs: uses
- Teacher API → Teaching Workflow Services: orchestrates
- Student API → Practice Records: records practice
- User API → Teaching Workflow Services: accesses
- Teacher API → Lesson Plan Service: manages
- Response & Error Handling → Teacher API: wraps responses
- Teaching Workflow Services → Persistence Mappers: persists
- Lesson Plan Service → Persistence Mappers: persists
- Practice Records → Persistence Mappers: persists
- Lesson Plan Service → AI Generation: generates with
- Teaching Workflow Services → Answer Evaluation: evaluates answers
- AI Generation → Retrieval-Augmented Generation: uses retrieval
- Persistence Mappers → Teaching Data Store: reads and writes
- Analytics & Statistics → Persistence Mappers: queries metrics
- Analytics & Statistics → Teaching Data Store: uses analysis SQL
- Teaching Workflow Services → Activity Logging: logs activity
- Request Timing → Teacher API: times requests
- Spring Boot Application → Runtime Settings: loads
- Maven Build → Spring Boot Application: builds