feat: initial commit

2026-05-07 18:39:00 +08:00
commit cdee21ee8e
653 changed files with 63946 additions and 0 deletions
@@ -0,0 +1,104 @@
+# Simple Template
+
+## Quick Start
+
+This project contains:
+
+- `backend`: Spring Boot admin API.
+- `frontend/web`: Vite + Vue 3 admin frontend.
+- `frontend/app`: Taro + Vue 3 app frontend.
+
+The local development flow starts MySQL and Redis with Docker, then runs the
+backend and web frontend locally.
+
+### Requirements
+
+- JDK 8+
+- Docker Desktop or Docker Engine with Compose
+- Node.js
+- pnpm
+
+### Start Infrastructure
+
+The development backend is configured to use the same defaults as
+`backend/docker-compose.yml`:
+
+- MySQL: `localhost:3306`, user `root`, password `root123`
+- Redis: `localhost:6379`, password `redis123`
+- Database name: `agileboot_pure`
+
+You can start MySQL and Redis manually:
+
+```bash
+cd backend
+docker compose up -d
+```
+
+On a fresh Docker volume, Compose creates the MySQL database `agileboot_pure`.
+Import the SQL files under `backend/sql/` before starting the backend.
+
+### Install Frontend Dependencies
+
+```bash
+cd frontend
+pnpm install
+```
+
+### Start Backend and Web Frontend
+
+Start the backend:
+
+```bash
+cd backend
+./mvnw -pl agileboot-admin -am spring-boot:run
+```
+
+Start the web frontend:
+
+```bash
+cd frontend
+pnpm dev:web
+```
+
+- Backend: `http://localhost:8080`
+- Frontend: Vite output, usually `http://localhost:80/`
+
+The frontend development proxy maps `/dev-api` to `http://localhost:8080`.
+
+Optional app commands:
+
+```bash
+cd frontend
+pnpm dev:app:weapp
+pnpm dev:app:h5
+```
+
+## Git Hooks
+
+This repository uses `.githooks` as the single Git hooks entrypoint.
+
+```bash
+git config core.hooksPath .githooks
+```
+
+The frontend workspace uses pnpm:
+
+```bash
+cd frontend
+pnpm install
+pnpm dev:web
+pnpm build:web
+pnpm dev:app:weapp
+pnpm build:app:weapp
+pnpm lint
+pnpm typecheck
+```
+
+## Frontend
+
+`frontend` is a pnpm workspace:
+
+- `web`: Vite + Vue 3 admin frontend.
+- `app`: Taro + Vue 3 app frontend.
+
+Shared engineering configuration lives in `frontend` root. Subprojects should extend the shared TypeScript, ESLint, Stylelint, Prettier, commitlint, and lint-staged configuration instead of duplicating it.