3

README.md

@@ -2,6 +2,8 @@
 
 面向普通高校的教务管理系统。后端使用 ASP.NET Core 10、EF Core 10，前端使用 Vue 3、TypeScript 和 Element Plus。
 
+当前已实现系统登录与角色权限、基础数据、用户管理、教师档案、学生档案、课程库和首页统计。人员及课程列表支持组合筛选、服务端分页和完整增删改查。
+
 ## 本地开发：热更新模式
 
 本地开发固定使用 SQLite。首次启动会自动创建 `src/Jiaowu.Api/data/jiaowu-dev.sqlite` 并写入演示组织数据。
@@ -55,7 +57,7 @@ dotnet tool restore
 dotnet ef migrations list --project src/Jiaowu.Api --startup-project src/Jiaowu.Api
 ```
 
-应用启动时会自动执行尚未应用的 MySQL 迁移。SQLite 只用于本地开发，并通过 `EnsureCreated` 建立本地数据库；开发模型变化后，可删除本地 SQLite 文件重新生成，不能把该文件用于生产。
+应用启动时会自动执行尚未应用的 MySQL 迁移。SQLite 只用于本地开发：新库通过 `EnsureCreated` 建立，已有开发库通过轻量、版本化的本地升级脚本补齐结构，不需要手动删除数据文件。SQLite 文件不能用于生产。
 
 ## 验证
 

scripts/smoke-test.ps1

@@ -66,6 +66,9 @@ try {
     $headers = @{ Authorization = "Bearer $($login.token)" }
     $dashboard = Invoke-RestMethod -Uri 'http://localhost:5255/api/dashboard' -Headers $headers
     $campuses = Invoke-RestMethod -Uri 'http://localhost:5255/api/base-data/campuses' -Headers $headers
+    $teachers = Invoke-RestMethod -Uri 'http://localhost:5255/api/personnel/teachers?page=1&pageSize=10' -Headers $headers
+    $students = Invoke-RestMethod -Uri 'http://localhost:5255/api/personnel/students?page=1&pageSize=10' -Headers $headers
+    $courses = Invoke-RestMethod -Uri 'http://localhost:5255/api/courses?page=1&pageSize=10' -Headers $headers
     $frontend = Invoke-WebRequest -Uri 'http://localhost:5255/' -TimeoutSec 5
     $spaFallback = Invoke-WebRequest -Uri 'http://localhost:5255/base-data' -TimeoutSec 5
     $unknownApiParameters = @{
@@ -81,6 +84,9 @@ try {
         User         = $login.user.displayName
         Term         = $dashboard.currentTerm.name
         Campuses     = @($campuses).Count
+        Teachers     = $teachers.total
+        Students     = $students.total
+        Courses      = $courses.total
         StaticIndex  = $frontend.Content.Contains('明序教务管理系统')
         SpaFallback  = $spaFallback.StatusCode
         ApiNotFound  = $unknownApi.StatusCode

scripts/start-visual-test.ps1

@@ -0,0 +1,13 @@
+$ErrorActionPreference = 'Stop'
+$env:ASPNETCORE_ENVIRONMENT = 'Development'
+$env:ASPNETCORE_URLS = 'http://localhost:5256'
+
+$workspaceRoot = Split-Path -Parent $PSScriptRoot
+$publishRoot = Join-Path $workspaceRoot '.artifacts/publish'
+$process = Start-Process `
+    -FilePath (Join-Path $publishRoot 'Jiaowu.Api.exe') `
+    -WorkingDirectory $publishRoot `
+    -WindowStyle Hidden `
+    -PassThru
+
+$process.Id