门店支持;登陆接口优化

李曜臣
1 parent 957e20a0
Showing 3 changed files with 98 additions and 23 deletions
美国版/Food Labeling Management Code/Yi.Abp.Net8/module/food-labeling-us/FoodLabeling.Application/Services/LocationSupportAppService.cs
美国版/Food Labeling Management Code/Yi.Abp.Net8/module/rbac/Yi.Framework.Rbac.Application/Services/AccountService.cs
项目相关文档/美国版App登录接口说明.md
@@ -33,8 +33,9 @@ public class LocationSupportAppService : ApplicationService, ILocationSupportApp
             throw new UserFriendlyException("门店Id不能为空");
         }
  
+        // 全门店共用一套 Support 联系方式，按任意门店 Id 查询都返回同一条配置。
         var entity = await _dbContext.SqlSugarClient.Queryable<FlLocationSupportDbEntity>()
-            .FirstAsync(x => !x.IsDeleted && x.LocationId == lid);
+            .FirstAsync(x => !x.IsDeleted);
         if (entity is null)
         {
             return null;
@@ -60,10 +61,10 @@ public class LocationSupportAppService : ApplicationService, ILocationSupportApp
         await EnsureLocationExistsAsync(locationId);
  
         var existed = await _dbContext.SqlSugarClient.Queryable<FlLocationSupportDbEntity>()
-            .AnyAsync(x => !x.IsDeleted && x.LocationId == locationId);
+            .AnyAsync(x => !x.IsDeleted);
         if (existed)
         {
-            throw new UserFriendlyException("该门店已配置 Support 联系方式，请使用编辑接口");
+            throw new UserFriendlyException("已存在全局 Support 联系方式，请使用编辑接口");
         }
  
         var now = Clock.Now;
@@ -113,10 +114,10 @@ public class LocationSupportAppService : ApplicationService, ILocationSupportApp
         await EnsureLocationExistsAsync(locationId);
  
         var conflict = await _dbContext.SqlSugarClient.Queryable<FlLocationSupportDbEntity>()
-            .AnyAsync(x => !x.IsDeleted && x.LocationId == locationId && x.Id != supportId);
+            .AnyAsync(x => !x.IsDeleted && x.Id != supportId);
         if (conflict)
         {
-            throw new UserFriendlyException("目标门店已配置 Support 联系方式，一个门店仅允许一条");
+            throw new UserFriendlyException("系统仅允许一条全局 Support 联系方式");
         }
  
         entity.LocationId = locationId;
@@ -6,6 +6,7 @@ using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.Caching.Distributed;
 using Microsoft.Extensions.Options;
+using SqlSugar;
 using Volo.Abp.Application.Services;
 using Volo.Abp.Authorization;
 using Volo.Abp.Caching;
@@ -83,7 +84,7 @@ namespace Yi.Framework.Rbac.Application.Services
                 //登录不想要验证码 ，可不校验
                 if (!_captcha.Validate(uuid, code))
                 {
-                    throw new UserFriendlyException("验证码错误");
+                    throw new UserFriendlyException("Invalid captcha.");
                 }
             }
         }
@@ -97,21 +98,46 @@ namespace Yi.Framework.Rbac.Application.Services
         [AllowAnonymous]
         public async Task<LoginOutputDto> PostLoginAsync(LoginInputVo input)
         {
-            if (string.IsNullOrEmpty(input.Password) || string.IsNullOrEmpty(input.UserName))
+            var email = input.UserName?.Trim();
+            var password = input.Password ?? string.Empty;
+            if (string.IsNullOrWhiteSpace(email) || string.IsNullOrWhiteSpace(password))
             {
-                throw new UserFriendlyException("请输入合理数据！");
+                throw new UserFriendlyException("Email and password are required.");
+            }
+
+            if (!IsPlausibleEmail(email))
+            {
+                // Platform sign-in supports email only.
+                throw new UserFriendlyException("Sign-in failed: email is required as the account.");
             }
  
             //校验验证码
             ValidationImageCaptcha(input.Uuid,input.Code);
  
-            UserAggregateRoot user = new();
-            //校验
-            await _accountManager.LoginValidationAsync(input.UserName, input.Password, x => user = x);
+            var normalized = email.ToLowerInvariant();
+            var candidates = await _userRepository._DbQueryable
+                .Where(u => !u.IsDeleted && u.State == true)
+                .Where(u => u.Email != null && SqlFunc.ToLower(u.Email) == normalized)
+                .ToListAsync();
+            var user = candidates.FirstOrDefault();
+            if (user is null)
+            {
+                throw new UserFriendlyException("Sign-in failed: account not found.");
+            }
+
+            if (!user.JudgePassword(password))
+            {
+                throw new UserFriendlyException("Sign-in failed: incorrect email or password.");
+            }
  
             return await PostLoginAsync(user.Id);
         }
  
+        private static bool IsPlausibleEmail(string email) =>
+            email.Contains("@", StringComparison.Ordinal) &&
+            !email.StartsWith("@", StringComparison.Ordinal) &&
+            !email.EndsWith("@", StringComparison.Ordinal);
+
  
         /// <summary>
         /// 提供其他服务使用，根据用户id，直接返回token
@@ -287,8 +287,8 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
  
 ## 接口 6：门店 Support 联系方式（App 展示）
  
-用于 App「Support」页面读取当前门店的联系方式（电话、邮箱）。  
-后台由 `LocationSupportAppService` 维护，规则是 **一个门店仅允许一条** 联系方式记录。
+用于 App「Support」页面读取联系方式（电话、邮箱）。  
+后台由 `LocationSupportAppService` 维护，规则已调整为 **全门店共用一条全局联系方式**。
  
 ### HTTP
  
@@ -300,15 +300,15 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
  
 | 参数名 | 位置 | 类型 | 必填 | 说明 |
 |--------|------|------|------|------|
-| `locationId` | Query | string | 是 | 门店主键（Guid 字符串） |
+| `locationId` | Query | string | 是 | 门店主键（Guid 字符串）。当前用于入参兼容，返回值按全局联系方式配置 |
  
 ### 响应体（LocationSupportGetOutputDto）
  
 | 字段（JSON） | 类型 | 说明 |
 |--------------|------|------|
 | `id` | string | 联系方式主键 |
-| `locationId` | string | 门店主键 |
-| `locationName` | string \| null | 门店名称 |
+| `locationId` | string | 配置记录中的门店主键（仅作兼容字段） |
+| `locationName` | string \| null | 配置记录中的门店名称（仅作兼容字段） |
 | `supportPhone` | string | Support 电话 |
 | `supportEmail` | string | Support 邮箱 |
  
@@ -330,9 +330,9 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
  
 ## 后台维护接口：Location Support（新增/编辑）
  
-仅后台管理端使用，用于配置 App Support 页面展示内容。
+仅后台管理端使用，用于配置 App Support 页面展示内容（全局唯一）。
  
-### 接口 A：新增门店联系方式
+### 接口 A：新增 Support 联系方式（全局）
  
 - **方法**：`POST`
 - **路径**：`/api/app/location-support`
@@ -349,9 +349,9 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
 ```
  
 约束：
-- 同一 `locationId` 只能新增一条，重复会报错：`该门店已配置 Support 联系方式，请使用编辑接口`
+- 系统内仅允许存在一条未删除记录；若已存在，再次新增会报错：`已存在全局 Support 联系方式，请使用编辑接口`
  
-### 接口 B：编辑门店联系方式
+### 接口 B：编辑 Support 联系方式（全局）
  
 - **方法**：`PUT`
 - **路径**：`/api/app/location-support/{id}`
@@ -371,7 +371,55 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
 - `门店Id不能为空` / `门店Id格式不正确`
 - `Support 电话不能为空`
 - `Support 邮箱不能为空` / `Support 邮箱格式不正确`
-- `目标门店已配置 Support 联系方式，一个门店仅允许一条`
+- `系统仅允许一条全局 Support 联系方式`
+
+---
+
+## 平台端登录接口（Web）
+
+> 对应 `RBAC.AccountService.PostLoginAsync`。当前平台端登录规则已调整为：**仅支持 Email 作为账号，不再支持 UserName**。
+
+### HTTP
+
+- **方法**：`POST`
+- **路径**：`/api/app/account/login`（以 Swagger 中 `Account` 为准）
+- **Content-Type**：`application/json`
+- **鉴权**：匿名
+
+### 请求体（LoginInputVo）
+
+| 字段（JSON） | 类型 | 必填 | 说明 |
+|--------------|------|------|------|
+| `userName` | string | 是 | 兼容历史字段名；现必须传 **邮箱**（例如 `admin@example.com`） |
+| `password` | string | 是 | 密码 |
+| `uuid` | string | 条件 | 开启图形验证码时必填 |
+| `code` | string | 条件 | 开启图形验证码时必填 |
+
+### 请求示例
+
+```json
+{
+  "userName": "admin@example.com",
+  "password": "YourPassword",
+  "uuid": "captcha-uuid",
+  "code": "captcha-code"
+}
+```
+
+### 响应体（LoginOutputDto）
+
+| 字段（JSON） | 类型 | 说明 |
+|--------------|------|------|
+| `token` | string | Access Token |
+| `refreshToken` | string | Refresh Token |
+
+### 错误文案（英文）
+
+- `Email and password are required.`
+- `Sign-in failed: email is required as the account.`
+- `Sign-in failed: account not found.`
+- `Sign-in failed: incorrect email or password.`
+- `Invalid captcha.`
  
 ---
  
@@ -379,7 +427,7 @@ Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
  
 | 场景 | 说明 |
 |------|------|
-| Web 管理端 | 仍使用 RBAC **`AccountService.PostLoginAsync`**，一般为人 **`userName`** + 密码 |
-| 美国版 App | **仅**本模块 **`/api/app/us-app-auth/login`** 使用 **邮箱 + 密码** |
+| Web 管理端 | 使用 RBAC **`/api/app/account/login`**，字段名虽为 `userName`，但值必须是 **Email** |
+| 美国版 App | 使用 **`/api/app/us-app-auth/login`**，显式字段 `email` + `password` |
  
 两者共用同一 `User` 表与 JWT 体系；App 端需保证账号已维护 **`Email`** 字段，否则无法通过邮箱登录。