Learn here. Prove yourself anywhere.
Development of an Educational Ecosystem for UNT Mathematics Preparation with AI-Generated Personalized Learning Plans
Astana IT University · Software Engineering · 2026-2027
Repository component: Web/PWA
Documentation reviewed: 22 October 2026
Product guide · YouTrack project · Task board · Web repository · Telegram repository
Open the section navigator
|
AkadilEDU is the parent learning brand. AkadilEDU PRIME is its Telegram practice sub-brand.
↓
|
The brand relationship connects the product family. The two applications currently keep separate learner records; verified account linking and shared progress remain planned integrations.
AkadilEDU is a proposed integrated ecosystem for mathematics preparation for Kazakhstan's Unified National Testing (UNT / ҰБТ / ЕНТ). The diploma builds on an existing Web/PWA for courses and practice tests and an existing Telegram bot for quizzes, topic practice and mistake review.
The diploma contribution is to connect the two learning channels, identify gaps from actual learner attempts and generate individual learning plans that refer to available material. This repository contains the course and practice-test application, including the student interface, content administration and supporting server functions.
The product guide documents the implemented application, its workflows and operating requirements. This README presents the academic scope and evidence expected for the diploma checkpoint.
Learners can complete a course or a practice test without knowing which mathematics topics deserve attention next. When study material, test results and short practice sessions are split between applications, the learner also has to connect those results manually.
The project addresses that preparation workflow by bringing evidence from both channels into a topic-level view and using it to recommend an actionable study plan. The accessibility motivation includes learners in rural areas and learners with limited financial resources who may have fewer opportunities for individual tutoring. Whether the system improves their access or learning outcomes must be established through user evidence and evaluation; universal free access is not an implemented guarantee.
| User group | Need addressed |
|---|---|
| Students preparing for UNT mathematics | Understand weak topics and decide what to study next |
| Students with limited tutoring opportunities | Use existing digital material and regular practice with clear guidance |
| Mathematics educators and content administrators | Maintain material and interpret progress at topic level |
User interviews and other research evidence must distinguish observed needs from these initial assumptions. They are tracked in AEDU-2.
Aim: Develop an educational ecosystem that supports UNT mathematics preparation through connected learning channels and AI-generated individual learning plans grounded in learner progress.
The project objectives are to:
- Establish verifiable learner needs, requirements and a realistic scope.
- Define a consistent mathematics topic structure and a shared representation of practice results.
- Link Web and Telegram identities through a verified, revocable mechanism.
- Identify topic-level gaps from actual answers and make the evidence visible to the learner.
- Generate structured study steps linked to existing courses and practice material.
- Present and update the learner's plan across both applications.
- Verify the implementation and assess the usefulness of the proposed preparation workflow.
| Expected outcome | Evidence of fulfilment |
|---|---|
| Connected Web and Telegram learning records | A verified linked account and consistent topic progress |
| Explainable diagnostic priorities | Recorded attempts and a visible reason for each weak-topic priority |
| A usable individual learning plan | Validated steps referring to resources that exist |
| An updated preparation workflow | New practice results reflected in progress and subsequent plan steps |
| An assessed engineering result | Recorded verification and an evaluation against a defined baseline |
These are expected diploma results. No improvement in UNT scores or learning effectiveness is asserted without collected evidence.
| Role | Person | Responsibilities |
|---|---|---|
| Sole student author | Akadil Alish (Әліш Ақәділ), SE-2426, AQADIL | Problem analysis, requirements, architecture, UI/UX, Web and Telegram development, data integration, verification, documentation and project management |
| Scientific supervisor | Elvira Aitmukhanbetova | Academic supervision, review of selected significant deliverables and feedback at agreed checkpoints |
This is an individual diploma project. Tasks are assigned to the student. Supervisor feedback is recorded when an actual review occurs; the supervisor is not presented as a co-developer or as having already approved unfinished materials.
| Component | Available implementation | Repository |
|---|---|---|
| Web/PWA | Courses, video lessons, lesson quizzes, practice tests, results, learner accounts and content administration | AkadilEDU |
| Telegram | Topic/random practice, scheduled channel quizzes, personal mistake review, statistics and administration | AkadilEDU PRIME |
| Project management | Assigned and prioritised tasks with expected outcomes, acceptance criteria and target dates | AEDU project |
| Work item | Current state | Task |
|---|---|---|
| Verified account linking | Planned | AEDU-12 |
| Shared learning events and topic progress | Planned | AEDU-13 |
| AI-generated personalised learning plans | Planned | AEDU-14 |
| Entry diagnostic and gap explanation | Planned | AEDU-17 |
| Plan presentation in Web and Telegram | Planned | AEDU-18 |
The two applications currently have separate identity and progress records. Existing administrative AI tools assist with content workflows; they are not the proposed student learning-plan service. The diploma scope excludes the existing question-filling script and Question Studio as research contributions. Official UNT question ownership, guaranteed admission results, a new foundation model and universal offline media access are outside the stated scope.
Learner records and assessment data must be handled with appropriate access controls. The AI component must handle insufficient evidence and invalid recommendations explicitly, and human review remains necessary for educational content and interpretation.
The following stack is present in the repositories; the integration design and model/provider choice for student plans remain subject to the technology comparison.
| Area | Current technologies | Role |
|---|---|---|
| Web/PWA | React 18, React Router, Vite 7, Tailwind CSS, i18next | Courses, assessment UI and multilingual navigation |
| Telegram service | Node.js 22, grammY | Bot interactions, channel answers and topic practice |
| Administration Mini App | React 19, Vite 8, Tailwind CSS | Content and campaign management |
| Server and data | Cloud Functions, Realtime Database, Authentication, Storage | Server operations, identities, learning data and materials |
| Verification and delivery | ESLint, Node.js tests and rule emulators in the Web repository; component lint/build commands in the bot repository; GitHub Actions for the Web project | Available checks and configured delivery |
Dependency versions and scripts are defined by each component's manifests and lockfiles. The product guide gives the detailed implementation map. Technology alternatives and justification are tracked in AEDU-5.
The current navigation deliberately links to existing evidence or its tracked task. A task link does not mean that the corresponding academic document has been completed or approved.
| Required material | Available location / next deliverable |
|---|---|
| Project title, problem, users, scope and expected outcomes | Sections above; standalone proposal tracked in AEDU-1 |
| Evidence of learner needs | AEDU-2; discussion records and findings remain to be committed |
| Literature review | AEDU-3; critical review and source analysis table remain to be committed |
| Comparison of existing systems | AEDU-4; evidence-backed comparison remains to be committed |
| Technology comparison | AEDU-5; alternatives and decision rationale remain to be committed |
| Requirements and acceptance criteria | AEDU-6; system specification remains to be committed |
| Context, use-case and component diagrams | AEDU-7; editable sources and exports remain to be committed |
| UX / prototype materials | AEDU-8; integrated learner-plan flows remain to be documented |
| Verification and evaluation plan | AEDU-9; measures, conditions and baseline remain to be committed |
| Responsibility, priorities, milestones and task outcomes | YouTrack project and board |
| Repository preparation | AEDU-10 |
| Supervisor review and resulting revisions | AEDU-11; record actual feedback before closing |
| Implementation and individual contributions | src/, functions/, tests/; commit history |
Academic material should be versioned alongside the implementation when ready. Diagrams need editable source as well as readable exports. Review comments and resulting revisions should remain traceable. The product guides and source code are not substitutes for the literature review, comparison tables or evaluation plan.
Use Node.js 22.12 or later and a Firebase environment you are authorised to access. Cloud Functions target Node.js 22.
git clone https://github.com/AQADIL/AkadilEDU.git
cd AkadilEDU
npm ci
npm ci --prefix functionsCopy .env.example to .env; configure the listed Firebase project values, function region, development host/port and relevant integrations. Backend configuration has its own functions/.env.example. Authorise authentication domains and providers, provision real course/test content, and deploy the required Functions and rules in the intended environment. Private service credentials must remain server-side.
npm run dev
npm run checknpm run check runs the repository's security checks, lint, tests and production build. npm test and npm run build are available separately. The CI workflow also performs dependency audits and runs Database/Storage rule tests under Firebase emulators. These commands describe available checks, not the result of a new test run.
See the product development guide for the full configuration, workflow and repository map.
| Component | Version for the current form |
|---|---|
| Web/PWA | prob-period-1 |
| Telegram | prob-period-1 |
The prob-period-1 tags identify previously fixed snapshots. README and other changes made later on main are not automatically included in those snapshots. A submitted tag must remain stable, and uploaded material must correspond to the declared version. These README updates do not move the existing tags.
Created and owned by Akadil Alish. The source and documentation are provided under the repository's proprietary LICENSE. Third-party dependencies retain their respective terms. See SECURITY.md for private vulnerability reporting.