Skip to content

Repository files navigation

ECJTU Academic Assistant

华东交大教务小工具:成绩、课表、培养方案、实际选课与 GPA 规划

Chrome Extension ECJTU License

An unofficial privacy-first Chrome extension for East China Jiaotong University (ECJTU / 华东交通大学). It syncs the pages a student already opens in the academic system and presents GPA, timetable, curriculum, course-registration status, semester estimates, and academic-planning reminders in one local interface.

下载最新版 / Download latest release

ECJTU Academic Assistant empty-state popup

Features

  • Sync grades across semesters.
  • Show today, tomorrow, and full-week timetables.
  • Combine grades, curriculum credits, and actual course registration.
  • Calculate semester GPA and cumulative GPA.
  • Estimate pending courses without changing issued grades.
  • Plan toward a target GPA and show early academic-risk reminders.
  • Keep semester, historical timetable, and teaching-week state separate.
  • Local JSON backup and CSV export.
  • Data stays in chrome.storage.local; no developer backend or analytics.

Install

  1. Download the latest ZIP from Releases.
  2. Extract it to a stable local folder.
  3. Open chrome://extensions/ and enable Developer mode.
  4. Click Load unpacked and select the folder containing manifest.json.
  5. Pin 华东交大教务小工具 to the toolbar.
  6. Log in to the official ECJTU academic system and open the grade, timetable, curriculum, and course-registration pages you want to sync.

Do not move or delete the unpacked folder while the extension is installed.

Data model

The extension treats each page as a different source of truth:

  • Actual registration decides which courses are being taken.
  • Curriculum provides official credits and recommended semesters.
  • Issued grades are locked facts.
  • Pending courses may be estimated locally.
  • Timetables are stored as semester snapshots to avoid showing stale courses as current.

Privacy and permissions

See PRIVACY.md. The extension requests only storage plus exact ECJTU academic-system page matches. It does not save passwords, cookies, browsing history, full URLs, student IDs, class identifiers, or raw exam/retake records.

The release package contains no real grade, timetable, student record, account, email address, or absolute local path.

Important disclaimer

This project is unofficial and is not endorsed by East China Jiaotong University. GPA planning and academic-risk reminders are personal estimates, not official academic-status decisions. The extension depends on the current structure of jwxt.ecjtu.edu.cn and may require updates after a site redesign.

Development

node --test tests/static.test.mjs

Authorship

The workflow, academic-domain rules, failure boundaries, and real-device testing were led by aibuqin-code. Most implementation was developed with AI assistance. The project is published with that boundary stated explicitly rather than presenting AI-assisted code as fully hand-written.

License

MIT. See LICENSE.

About

Unofficial ECJTU Chrome extension for GPA, timetable, curriculum, course registration and academic planning.

Topics

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages