# GeekerVue

**Repository Path**: mpbillion/geeker-vue

## Basic Information

- **Project Name**: GeekerVue
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-20
- **Last Updated**: 2026-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# geeker-vue MES（LamexMES.BSVue）文档索引

> 仓库根：`D:\ProjectData\MES Sys\MpSys\geeker-vue`
> Web 前端 = `Mue.Vue`（Vue3 + Element Plus + TS），后端 = `Mue.Net`（.NET 8），移动端 = `Mue.UniApp`
> 数据库：SQL Server `MueAdmin_Dev`（系统 26 表）+ `MueAdmin_Report`（报表/代码生成 11 表）+ `MueAdmin_Bom`（BOM 业务 8 表），另预留 MySQL/PG/SQLite
> 默认账号：`admin` / `123456`

## 权威文档（本目录只保留这 3 份 + 本索引）

| 文档 | 说明 |
|---|---|
| [01-前后端使用教程.md](01-前后端使用教程.md) | 环境要求、数据库准备、后端/前端启动、登录、系统管理/消息中心/工作流/BOM 全模块使用、多库机制、通用组件、常见问题、数据库表族总览 |
| [02-代码生成器使用教程.md](02-代码生成器使用教程.md) | 五步生成流程、表级/列级配置逐参说明、多库选表、UniApp 生成、前后端扩展预留、API 参考（逐参数）、数据库前置条件与排障 |
| [03-数据库初始化_GUID完整版.sql](03-数据库初始化_GUID完整版.sql) | **GUID 主键完整初始化脚本**：3 库 / 45 表 / 515 行种子数据，含主键、默认值、唯一约束、非聚集索引、外键；可重复执行 |

> 旧的方案/验证/迁移过程文档已全部删除（需要时从 git 历史找回）。后续新增内容请**更新**上面三份文档，不要再新增平行文档。

## 快速启动

```powershell
# 1. 数据库（3 库 + 全部表 + 种子数据；-f 65001 必须有，否则中文乱码）
#    三个库均以 COLLATE Chinese_PRC_CI_AS 创建（中文拼音排序、大小写不敏感）
sqlcmd -S localhost -U sa -P <密码> -f 65001 -i "docs\03-数据库初始化_GUID完整版.sql"

# 2. 后端（首次需编译；端口 5000）
cd "Mue.Net\Mue.WebApi"
#    2.1 首次先生成本机配置：仓库只存模板，真实密码不入库
Copy-Item appsettings.Example.json appsettings.json
#        把 DatabaseSettings.Databases[*].ConnectionString 里的 CHANGE_ME 换成你的 SQL 密码（3 个 SqlServer 库都要改）
dotnet build
dotnet run --no-build --urls http://localhost:5000

# 3. 前端（端口 5001）
cd "..\..\Mue.Vue"
pnpm install
pnpm dev

# 4. 打开 http://localhost:5001 ，登录 admin / 123456
```

## 本次修复记录

| 问题 | 根因 | 处理 |
|---|---|---|
| 拉取代码后 `dotnet build` 失败：`CSC : error CS1566: 读取资源"seed_fixed_ids_inserts.sql"时出错` | 该文件是 `Mue.WebApi.csproj` 的嵌入资源，原路径指向 `docs/sql/`；归档文档时被移走 | 迁到 `Mue.Net\Mue.WebApi\Sql\seed_fixed_ids_inserts.sql`，csproj 改用工程内相对路径，与 `docs/` 彻底解耦 |
| 旧迁移脚本只覆盖 2 个库、数据不全 | 手工拼装 | 改为从真实运行库导出 3 库 / 45 表 / 515 行，并在临时库实跑 + 重跑验证通过 |
| 新建库中文排序/比较不一致 | `CREATE DATABASE` 未写排序规则，继承实例默认（英文实例多为 `SQL_Latin1_General_CP1_CI_AS`） | 初始化脚本与后端 `DbSeeder` 建库语句统一加 `COLLATE Chinese_PRC_CI_AS` |

## 常见问题一句话

- 页面 404 / 菜单不出现：新增菜单未绑定角色，或未整页刷新（动态路由按 `/geeker/menu/list` 注册）。
- 菜单打开空白无数据：接口异常或未授权，F12 看 console/network 后刷新。
- 后端新增表后 Dapper 全 500：新表缺 BaseEntity 审计列（`Version/CreateUser/CreateTime/UpdateUser/UpdateTime/IsDeleted`）。
- sqlcmd 中文乱码：加 `-f 65001`（UTF-8）。
- 改后端后启动没变化：先停旧 dotnet 进程（DLL 被占用），再 `dotnet build`。