커밋!

README.md

@@ -1,3 +1,40 @@
 # lms-be
 
-lms 백엔드
+Nest.js backend API for the LMS Electron frontend.
+
+## Local development
+
+```bash
+npm install
+cp .env.example .env
+npm run prisma:generate
+npm run start:dev
+```
+
+The API listens on `http://localhost:4400`.
+
+- `GET /health`
+- `GET /health/db`
+- `GET /api`
+
+## Database
+
+Local PostgreSQL is included in Docker Compose.
+
+```bash
+docker compose up -d postgres
+npm run prisma:migrate
+npm run start:dev
+```
+
+For a separated database server, set `DATABASE_URL` to the remote PostgreSQL host:
+
+```bash
+DATABASE_URL=postgresql://USER:PASSWORD@DB_HOST:5432/DB_NAME?schema=public
+```
+
+## Docker
+
+```bash
+docker compose up --build
+```