Earthworm

English | 中文

⚡ Introduction

By constructing sentences with conjunctions, it helps you learn English better~ 😊

How to start ?

⚠️ Requirements

Node.js version >= v20
Docker. please make sure it is installed and running successfully on your local machine.
The mentioned operations below are based on the root directory of the current project, please be attentive to ensure there are no errors.

docker --version # Docker version 24.0.7, build afdd53b

node --version # v20+

1. Install dependencies

pnpm install

2. Copy the contents of `.env.example` to the `.env` file

If the file doesn't exist, you need to create it manually. Linux users can perform the operation with the following command.

It primarily stores environmental variable information for the main storage system, such as database connection addresses, usernames, passwords, ports, keys, and so on. The backend service will read configuration from this file. Of course, you can also customize it with your own configuration information.

cp .env.example .env

3. Start/stop/delete Docker Compose service

The backend relies on MySQL and Redis services. Start and stop these services using the commands configured in package.json below.

# start
pnpm docker:start
# stop
pnpm docker:stop
# delete
pnpm docker:delete

If you prefer manual, you can use the commands below.

docker compose up -d
docker compose stop
docker compose down

# commands compatible with older versions of Docker
docker-compose up -d

4. Initialize Database

When executing the current command, try to wait for a short interval after the previous command, as we are using the -d parameter, which runs the services in the background. They might still be in a 'running' state. If you encounter an error, try running the command again.

pnpm db:init

5. Create and upload course data (only execute this during the initial database initialization)

pnpm db:upload

6. Start the backend service

pnpm dev:serve

7. Start the frontend service

pnpm dev:client

FAQ

How to correctly update course data ?

Repeatedly executing the pnpm db:upload command may lead to a continuous increment of course id in the database, potentially causing overwrites.So, when you identify incorrect course data and make modifications, you should use the following command to update the course data in the database.

pnpm db:update

The backend service encounters errors when the course id in the database are overwritten due to script-based auto-increment ?

Attempted to delete Docker container, but after restarting, the previous data is still retained?

Because the data is stored in the local Docker Volumes, specifically configured in the top-level parameters 'volumes' in the docker-compose.yml file, even if you stop or delete the containers, the data will still be retained.

To solve this issue is actually quite simple; you just need to delete the volumes data. Of course, we also provide a command for you.

pnpm docker:down

# Run the command `pnpm docker:down`,which essentially performs the following command:
# stop and delete the container service and the created volumes data
docker-compose down --volumes

⚠️ However, please note that using this command will delete all data in the database. You will need to rerun the steps in 'How to Start' (starting from step 3)

pnpm install Error?

Some dependencies require compilation during installation, necessitating the presence of relevant build environments. If these environments are not available, the compilation process may fail. Additionally, different modules may require different build environments, so specific issues need to be analyzed individually. Below are specific problems encountered along with their solutions.

First try the following command to update pnpm

pnpm i -g
# or
pnpm i -g pnpm

Error installing the argon2 module on Windows:

Install Visual Studio 2015 or later, specifically the "Desktop development with C++" component. (In practice, any component containing C++ development tools and libraries will suffice.)
If you encounter Chinese characters display issues during compilation, execute chcp 437 in the command prompt, then rerun the install command.

Docker Permission Denied in Docker?

When using WSL2 as a development environment in Windows, the following error occurs when starting Docker with docker compose up -d :

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.24/containers/json": dial unix /var/run/docker.sock: connect: permission denied

Solution:

Add the current user to the docker group:

# Add docker user group
sudo groupadd docker
# Add the logged-in user to the docker user group
sudo gpasswd -a $USER docker
# Update user group
newgrp docker
# Test if docker command is working properly
docker images

Frontend Development Guideline

Do not Destructure Pinia store.
- The readability will be better when using store
- Destructuring can lead to reactivity loss and using storeToRefs is also quite cumbersome
Avoid including UI logic in composables.
1. Such as useMessage
2. We categorize the router as UI logic, and for ease of testing, avoid including routerrelated logic in there

NansenHo/earthworm