EDUNEXXUSS SCHOOL SYSTEM · version 58
=====================================
Three ways to run it:

1) TRY IT ON THIS COMPUTER (only you)
   Install Node.js 22 LTS (nodejs.org). Version 22.5 or newer is needed.
   Older Macs: Node.js 23 and newer need macOS 13.5 or later. On an older Mac use Node.js 22,
   or use start-online-mac.sh, which downloads Node.js 22 into this folder by itself.
   Windows: double-click start-windows.bat.  Mac/Linux: in Terminal run  bash start-linux.sh
   Open http://localhost:8080. The first person to open Sign in creates the super admin.
   Every sign-in asks for a 6-digit code sent to the account's email. Until a mail server is set in
   server/config.json, the code is shown in the server window and the emails are saved in server/data/outbox.

2) TEST ONLINE FROM A MAC (phones and other people can open it)
   In Terminal run:  bash ~/Downloads/edunexxuss-school/start-online-mac.sh
   It starts the system, makes a free temporary https link (Cloudflare quick tunnel), saves the link
   in server/config.json, keeps the Mac awake and opens the link. Keep the window open; Control + C stops it.
   The link changes each time. For testing only: use made-up learners, not real children's data.

3) GO LIVE FOR A SCHOOL
   Follow the "Edunexxuss v58 Technical Specification and Go-Live Guide" ("Going live" section)
   and the files in server/deploy/ (Ubuntu server, HTTPS with Caddy, firewall, one service per school).
   Before the first real school:
   - set "baseUrl" to the school's https address and fill in the "mail" section of server/config.json
   - set the school name, short code and logo in public/school-config.js
   - keep "twoFactor": "email" (code by email at each sign-in) or set "authenticator" for staff
   - copy server/data/backups off the server every week

FOLDERS
   public/          the portal, textbook library, family app (/app/) and scanner page (/kiosk.html)
   public/school-config.js   this school's name, short code, colours, logo, video server
   server/          edx-server.js (the whole server, no extra packages), config.example.json, deploy/
   server/data/     created on first start: the database, uploaded files, daily backups. Back this up. Never share it.
   mobile/          the iPhone and Android "Edunexxuss Family" app project (Capacitor) for the App Store and Google Play
                    (one app for every school: parents type their school's portal address once)

Each school gets its own copy of this folder. Nothing is shared between schools.
