refactor: frontend dir path

Author: ahaodev

.githooks/pre-commit

@@ -12,11 +12,11 @@ go test ./...
 
 # Frontend lint/format (if dependencies installed)
 if [ -f "frontend/package.json" ]; then
-  if command -v pnpm >/dev/null 2>&1 && [ -d "web/node_modules" ]; then
-    echo "[pre-commit] Running web lint and format checks"
-    (cd web && pnpm -s lint && pnpm -s format:check)
+  if command -v pnpm >/dev/null 2>&1 && [ -d "frontend/node_modules" ]; then
+    echo "[pre-commit] Running frontend lint and format checks"
+    (cd frontend && pnpm -s lint && pnpm -s format:check)
   else
-    echo "[pre-commit] Skipping web lint: pnpm not available or dependencies not installed"
+    echo "[pre-commit] Skipping frontend lint: pnpm not available or dependencies not installed"
   fi
 fi
 

.github/skills/shadmin-dev/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: shadmin-dev
-description: Apply Shadmin feature-development standards (backend Go/Gin/Ent + frontend React/TS). Use when adding/modifying features, CRUD modules, API routes/controllers/usecases/repositories, Ent schemas, web pages/routes, React components, TanStack hooks, or any full-stack work in this project. Trigger whenever the user mentions new features, backend changes, frontend changes, database schema changes, permissions, UI pages, tables, forms, or API endpoints — even if they don't explicitly say "feature development."
+description: Apply Shadmin feature-development standards (backend Go/Gin/Ent + frontend React/TS). Use when adding/modifying features, CRUD modules, API routes/controllers/usecases/repositories, Ent schemas, frontend pages/routes, React components, TanStack hooks, or any full-stack work in this project. Trigger whenever the user mentions new features, backend changes, frontend changes, database schema changes, permissions, UI pages, tables, forms, or API endpoints — even if they don't explicitly say "feature development."
 ---
 
 # Shadmin Feature Development

Dockerfile

@@ -1,8 +1,8 @@
-#---------------------build web------------------------
-FROM docker.io/library/node:22-alpine AS build_web
-WORKDIR /app/web
+#---------------------build frontend------------------------
+FROM docker.io/library/node:22-alpine AS build_frontend
+WORKDIR /app/frontend
 RUN corepack enable
-COPY frontend/package.json web/pnpm-lock.yaml web/pnpm-workspace.yaml ./
+COPY frontend/package.json frontend/pnpm-lock.yaml frontend/pnpm-workspace.yaml ./
 RUN pnpm install --frozen-lockfile
 COPY frontend/ ./
 RUN pnpm run build
@@ -13,7 +13,7 @@ WORKDIR /app
 COPY go.mod go.sum ./
 RUN go mod download
 COPY . .
-COPY --from=build_web /app/web/dist /app/web/dist
+COPY --from=build_frontend /app/frontend/dist /app/frontend/dist
 
 # 安装 ent 与 swagger（swag）
 RUN go install entgo.io/ent/cmd/ent@latest

README.md

@@ -45,10 +45,10 @@ git clone https://github.com/ahaodev/shadmin.git
 cd shadmin
 
 # Install & build frontend
-cd web && pnpm install && pnpm build
+cd frontend && pnpm install && pnpm build
 
 # Start backend (from project root)
-# Generates Ent code, embeds web/dist/, listens on :55667
+# Generates Ent code, embeds frontend/dist/, listens on :55667
 # .env auto‑generated on first run
 cd ..
 go generate ./ent
@@ -77,7 +77,7 @@ shadmin/
 ├── usecase/        # Business logic
 ├── internal/       # Internal utilities
 ├── pkg/            # Shared packages
-├── web/            # React frontend (Vite + shadcn/ui)
+├── frontend/            # React frontend (Vite + shadcn/ui)
 │   └── src/
 │       ├── routes/       # TanStack file‑based routing
 │       ├── features/     # Feature modules

README.zh.md

@@ -45,10 +45,10 @@ git clone https://github.com/ahaodev/shadmin.git
 cd shadmin
 
 # 安装依赖并构建前端
-cd web && pnpm install && pnpm build
+cd frontend && pnpm install && pnpm build
 
 # 启动后端（从项目根目录执行）
-# 生成 Ent 代码，内嵌 web/dist/，监听 :55667
+# 生成 Ent 代码，内嵌 frontend/dist/，监听 :55667
 # 首次运行时自动生成 .env
 cd ..
 go generate ./ent
@@ -77,7 +77,7 @@ shadmin/
 ├── usecase/        # 业务逻辑层
 ├── internal/       # 内部工具
 ├── pkg/            # 公共包
-├── web/            # React 前端（Vite + shadcn/ui）
+├── frontend/            # React 前端（Vite + shadcn/ui）
 │   └── src/
 │       ├── routes/       # TanStack 文件路由
 │       ├── features/     # 功能模块

cli/README.md

@@ -140,5 +140,5 @@ The following items are explicitly **out of scope** for the MVP and tracked for
 later iterations:
 
 - Write commands (create / update / delete) gated by stricter audit.
-- Backend audit field distinguishing CLI vs Web origin.
+- Backend audit field distinguishing CLI vs frontend origin.
 - Optional MCP server packaging on top of the same client layer.

docs/department-feature-evaluation.md

@@ -58,9 +58,9 @@ bootstrap/admin_init.go                      # 种子菜单数据（修改）
 ent/schema/user.go                           # 添加 department edge（修改）
 
 # Frontend
-web/src/types/department.ts                  # 类型定义
-web/src/services/departmentApi.ts            # API 服务
-web/src/features/system/departments/         # 功能模块目录
+frontend/src/types/department.ts                  # 类型定义
+frontend/src/services/departmentApi.ts            # API 服务
+frontend/src/features/system/departments/         # 功能模块目录
   ├── index.tsx                              # 页面入口
   ├── components/
   │   ├── departments-table.tsx              # 树形表格组件
@@ -72,7 +72,7 @@ web/src/features/system/departments/         # 功能模块目录
   │   └── use-departments.ts                 # TanStack Query hooks
   └── data/
       └── schema.ts                          # Zod 验证 schema
-web/src/routes/_authenticated/system/departments.tsx  # 路由文件
+frontend/src/routes/_authenticated/system/departments.tsx  # 路由文件
 ```
 
 ### 2.2 Backend 详细设计
@@ -230,7 +230,7 @@ app.DB.Menu.Create().SetParentID(deptMgmt.ID).SetName("删除部门").SetSequenc
 
 ### 2.3 Frontend 详细设计
 
-#### 2.3.1 类型定义 — `web/src/types/department.ts`
+#### 2.3.1 类型定义 — `frontend/src/types/department.ts`
 
 ```typescript
 export interface Department {
@@ -278,7 +278,7 @@ export interface UpdateDepartmentRequest {
 #### 2.3.3 权限常量
 
 ```typescript
-// web/src/constants/permissions.ts 中新增
+// frontend/src/constants/permissions.ts 中新增
 DEPARTMENT: {
   READ: 'system:dept:read',
   CREATE: 'system:dept:add',
@@ -328,11 +328,11 @@ DEPARTMENT: {
 | Backend Repository | `repository/department_repository.go` | 中（树形查询） |
 | Backend Usecase | `usecase/department_usecase.go` | 中（循环引用检测） |
 | Backend Controller | `api/controller/department_controller.go` | 低 |
-| Frontend Types | `web/src/types/department.ts` | 低 |
-| Frontend Service | `web/src/services/departmentApi.ts` | 低 |
-| Frontend Page | `web/src/features/system/departments/index.tsx` | 中 |
+| Frontend Types | `frontend/src/types/department.ts` | 低 |
+| Frontend Service | `frontend/src/services/departmentApi.ts` | 低 |
+| Frontend Page | `frontend/src/features/system/departments/index.tsx` | 中 |
 | Frontend Components | `departments-table.tsx`, dialogs, provider | 中（树形表格） |
-| Frontend Route | `web/src/routes/.../departments.tsx` | 低 |
+| Frontend Route | `frontend/src/routes/.../departments.tsx` | 低 |
 
 ### 4.2 修改文件（约 8 个）
 
@@ -411,9 +411,9 @@ DEPARTMENT: {
 
 ### Phase 4：Frontend 部门模块
 
-15. 创建 `web/src/types/department.ts`
-16. 创建 `web/src/services/departmentApi.ts`
-17. 创建 `web/src/features/system/departments/` 整个模块
+15. 创建 `frontend/src/types/department.ts`
+16. 创建 `frontend/src/services/departmentApi.ts`
+17. 创建 `frontend/src/features/system/departments/` 整个模块
 18. 创建路由文件
 
 ### Phase 5：Frontend 用户集成

docs/getting-started/architecture.en.md

@@ -58,7 +58,7 @@ shadmin/
 ├── internal/            # Internal utilities: Casbin manager, token service, login security
 ├── pkg/                 # Shared utilities: logging, etc.
 ├── docs/                # Swagger generated files + architecture docs
-├── web/                 # React frontend
+├── frontend/                 # React frontend
 │   ├── src/
 │   │   ├── routes/      # File-based routing (TanStack Router)
 │   │   ├── features/    # Feature modules (pages + components + hooks + schema)
@@ -69,7 +69,7 @@ shadmin/
 │   │   ├── types/       # TypeScript type definitions
 │   │   ├── lib/         # Utility functions
 │   │   └── context/     # React Context Providers
-│   └── web.go           # Go embed, embeds dist/ into the binary
+│   └── frontend.go           # Go embed, embeds dist/ into the binary
 └── .env.example         # Environment variable template
 ```
 
@@ -180,7 +180,7 @@ sequenceDiagram
 The frontend uses TanStack Router's **file-based routing**, where file paths map to URL paths:
 
 ```
-web/src/routes/
+frontend/src/routes/
 ├── __root.tsx              # Root layout (DevTools, progress bar)
 ├── (auth)/                 # Public route group (login, register)
 │   └── sign-in.tsx
@@ -303,7 +303,7 @@ main.go
 
 ## Frontend-Backend Collaboration
 
-- **Production Mode**: Frontend build output (`web/dist/`) is embedded into the binary via `web/web.go` using Go embed. The backend serves both the SPA and API.
+- **Production Mode**: Frontend build output (`frontend/dist/`) is embedded into the binary via `frontend/frontend.go` using Go embed. The backend serves both the SPA and API.
 - **Development Mode**: Vite dev server runs on `:5173` and proxies `/api` requests to the backend at `:55667` via `vite.config.ts`.
 
 ## Next Steps

docs/getting-started/architecture.zh.md

@@ -58,7 +58,7 @@ shadmin/
 ├── internal/            # 内部工具：Casbin 管理器、Token 服务、登录安全
 ├── pkg/                 # 公共工具：日志等
 ├── docs/                # Swagger 生成文件 + 架构文档
-├── web/                 # React 前端
+├── frontend/                 # React 前端
 │   ├── src/
 │   │   ├── routes/      # 文件路由（TanStack Router）
 │   │   ├── features/    # 功能模块（页面 + 组件 + hooks + schema）
@@ -69,7 +69,7 @@ shadmin/
 │   │   ├── types/       # TypeScript 类型定义
 │   │   ├── lib/         # 工具函数
 │   │   └── context/     # React Context Providers
-│   └── web.go           # Go embed，将 dist/ 嵌入二进制
+│   └── frontend.go           # Go embed，将 dist/ 嵌入二进制
 └── .env.example         # 环境变量模板
 ```
 
@@ -180,7 +180,7 @@ sequenceDiagram
 前端使用 TanStack Router 的 **文件路由**，路由定义即文件路径：
 
 ```
-web/src/routes/
+frontend/src/routes/
 ├── __root.tsx              # 根布局（DevTools、进度条）
 ├── (auth)/                 # 公开路由组（登录、注册）
 │   └── sign-in.tsx
@@ -303,7 +303,7 @@ main.go
 
 ## 前后端协作
 
-- **生产模式**：前端构建产物 (`web/dist/`) 通过 `web/web.go` 以 Go embed 方式嵌入二进制，由后端统一提供 SPA + API 服务
+- **生产模式**：前端构建产物 (`frontend/dist/`) 通过 `frontend/frontend.go` 以 Go embed 方式嵌入二进制，由后端统一提供 SPA + API 服务
 - **开发模式**：前端 Vite 开发服务器运行在 `:5173`，通过 `vite.config.ts` 中的 proxy 将 `/api` 请求代理到后端 `:55667`
 
 ## 下一步

docs/getting-started/deployment.en.md

@@ -18,7 +18,7 @@ This document covers deploying Shadmin to production, including single Docker co
 
 ```bash
 # 1. Build the frontend
-cd web && pnpm install && pnpm run build && cd ..
+cd frontend && pnpm install && pnpm run build && cd ..
 
 # 2. Build the backend (with version injection)
 VERSION=$(git describe --tags --always 2>/dev/null || echo "dev")
@@ -30,7 +30,7 @@ CGO_ENABLED=1 go build \
   -o shadmin .
 ```
 
-> **Note:** The frontend must be built first (`pnpm run build`), because `web/web.go` uses Go embed to include `web/dist/`.
+> **Note:** The frontend must be built first (`pnpm run build`), because `frontend/frontend.go` uses Go embed to include `frontend/dist/`.
 
 The build output `shadmin` is a self-contained single binary that includes frontend assets, backend logic, and Swagger documentation.
 
@@ -43,7 +43,7 @@ docker build -t shadmin:latest .
 ```
 
 Build stages:
-1. **Stage 1 (Node)**: Install frontend dependencies and build `web/dist/`
+1. **Stage 1 (Node)**: Install frontend dependencies and build `frontend/dist/`
 2. **Stage 2 (Go)**: Compile Go backend with embedded frontend assets
 3. **Stage 3 (UPX)**: Compress the binary to reduce image size
 4. **Stage 4 (Debian slim)**: Final runtime image