HappyKids is a mobile app which supports the parents and teachers in managing kids activities during the day.
The backend server is shutdown due to shortage in maintenence cost. Please deploy the system on your device for preview. Thank you
Download apk file at demo/demo.apk to experiment. In the app, users of different roles could have different views, please use below test accounts to experiment.
| Role | Username | Password |
|---|---|---|
| Teacher | bach_teacher1 | password123 |
| Parent | bach_parent1 | password123 |
Please watch demo videos in folder demo
To get it running, follow the steps below:
1. Node version
v19.x.x
2. Install dependencies
pnpm i
3. Configure environment variables. There is an `.env.example` in the root directory you can use for reference. Move it to `/nextjs` as well.
cp .env.example .env
4. Start containers
docker-compose up
5. Generate Kysely Models from Mysql
pnpm kysely-codegen
6. Run at the project root folder.
pnpm dev
(Optional) It might be easier to run each app in separate terminal windows so you get the logs from each app separately
pnpm --filter expo dev
pnpm --filter nextjs dev
Follow the guidance here for expo setup details: https://docs.expo.dev/build/setup/
eas update
Run the update command above then copy the configs in the terminal's output to app.config.ts. The config looks like:
{
"updates": {
"url": "https://u.expo.dev/..."
},
"runtimeVersion": {
"policy": "sdkVersion"
}
}
cd apps/expo && eas build --profile preview --platform android
eas update:configure --platform android
Copy lines of code as the output suggests in to app.config.ts. Then run the following command.
cd apps/expo && eas update --branch preview --message "Updating the app" --platform android
Database is deployed in docker-compose. The schema SQL script need to be run manually. First, you need to copy mysql scripts to container.
sudo docker cp mysql happykids_mysql:/
Go into the docker container: to execute.
sudo docker exec -it happykids_mysql /bin/sh
Open mysql shell:
mysql -u root --default-character-set=utf8 -p
Then, paste these commands for seeding the database.
source mysql/schema.sql
source mysql/seed.sql
First remember to create a .env file inside app/nextjs
A nodejs docker is deployed to expose API for client to call. Nginx should be the web server.
Should manually install and build nextjs first, then start the service.
pnpm install
sudo pnpm kysely-codegen
pnpm --filter nextjs build
sudo docker-compose start
For authentication to work, we need to generate encryption keys:
cd apps/nextjs/public/storage/secret/
ssh-keygen -t rsa -m PEM -f access.key
openssl rsa -in access.key -pubout -outform PEM -out access.key.pub