已将业务时间生成入口统一为 Asia/Shanghai,不依赖服务器默认时区
This commit is contained in:
+14
-14
@@ -90,7 +90,7 @@
|
||||
|
||||
### 时间和版本
|
||||
|
||||
项目和评论的时间字段按 UTC 保存,JSON 格式为 `2026-10-13T08:30:00`,可能带小数秒,**没有时区后缀**。前端解析这些字段时应按 UTC 处理,再转换成用户时区;不要直接当成本地时间。历史提交的 `authorDate` 来自仓库服务,可带 `Z` 或时区偏移。
|
||||
项目、评论及上传过期时间统一使用上海时间(`Asia/Shanghai`,UTC+8),JSON 格式为 `2026-10-13T08:30:00`,可能带小数秒,**没有时区后缀**。前端解析这些字段时应补充 `+08:00`,再转换成用户时区;不能继续补 `Z` 或依赖浏览器本地时区。历史提交的 `authorDate` 来自仓库服务,可带 `Z` 或时区偏移。
|
||||
|
||||
Git SHA 使用完整的 40 或 64 位十六进制字符串,不使用缩写。几个版本字段的用途不同:
|
||||
|
||||
@@ -149,8 +149,8 @@ Git SHA 使用完整的 40 或 64 位十六进制字符串,不使用缩写。
|
||||
以下 TypeScript 类型与当前 JSON 字段对应。项目列表、工作区详情、社区详情、创建、修改、发布和 Fork 共用 Project 结构。
|
||||
|
||||
```typescript
|
||||
/** 无时区后缀,按 UTC 解释。 */
|
||||
export type UtcDateTime = string;
|
||||
/** 无时区后缀,按 Asia/Shanghai(UTC+8)解释。 */
|
||||
export type ShanghaiDateTime = string;
|
||||
|
||||
export interface ApiResponse<T> {
|
||||
code: string;
|
||||
@@ -219,7 +219,7 @@ export interface Project {
|
||||
repoStatus: 'CREATING' | 'READY' | 'FAILED';
|
||||
publishStatus: 'UNPUBLISHED' | 'PUBLISHED' | 'BLOCKED';
|
||||
publishedCommitSha: string | null;
|
||||
publishedAt: UtcDateTime | null;
|
||||
publishedAt: ShanghaiDateTime | null;
|
||||
sourceProjectCode: string | null;
|
||||
sourceCommitSha: string | null;
|
||||
sourceRepositoryUrl: string | null; // 在线迁移任务记录的原仓库地址
|
||||
@@ -227,15 +227,15 @@ export interface Project {
|
||||
likeCount: number;
|
||||
commentCount: number;
|
||||
liked: boolean;
|
||||
createdAt: UtcDateTime;
|
||||
updatedAt: UtcDateTime;
|
||||
createdAt: ShanghaiDateTime;
|
||||
updatedAt: ShanghaiDateTime;
|
||||
}
|
||||
|
||||
export interface CoverUploadSignature {
|
||||
uploadUrl: string;
|
||||
objectKey: string;
|
||||
coverUrl: string;
|
||||
expiresAt: UtcDateTime; // 无时区后缀,按 UTC 解释
|
||||
expiresAt: ShanghaiDateTime; // 无时区后缀,按 Asia/Shanghai(UTC+8)解释
|
||||
formFields: Record<string, string>;
|
||||
}
|
||||
|
||||
@@ -248,7 +248,7 @@ export interface UrdfUploadSignature {
|
||||
batchCode: string;
|
||||
mainRelativePath: string;
|
||||
uploadUrl: string;
|
||||
expiresAt: UtcDateTime; // 无时区后缀,按 UTC 解释
|
||||
expiresAt: ShanghaiDateTime; // 无时区后缀,按 Asia/Shanghai(UTC+8)解释
|
||||
files: Array<{
|
||||
relativePath: string;
|
||||
objectKey: string;
|
||||
@@ -296,7 +296,7 @@ export interface Comment {
|
||||
commentCode: string;
|
||||
author: PublicUser;
|
||||
content: string;
|
||||
createdAt: UtcDateTime;
|
||||
createdAt: ShanghaiDateTime;
|
||||
}
|
||||
```
|
||||
|
||||
@@ -543,7 +543,7 @@ data 示例中 image 仅展示格式前缀,实际值为完整图片:
|
||||
}
|
||||
```
|
||||
|
||||
签名有效期为 5 分钟;策略绑定 Bucket、完整对象 key、Content-Type、1 字节~5 MiB 的大小范围和成功状态码 200。文件类型按声明的 MIME 约束,后端不读取或解码图片。对象路径由后端生成,日期使用 UTC:test 为 `vibemake_dev/project-covers/{userCode}/{yyyyMMdd}/{随机编码}.{扩展名}`,prod 为 `vibemake/project-covers/...`。不要修改 formFields、对象路径或上传类型。
|
||||
签名有效期为 5 分钟;策略绑定 Bucket、完整对象 key、Content-Type、1 字节~5 MiB 的大小范围和成功状态码 200。文件类型按声明的 MIME 约束,后端不读取或解码图片。对象路径由后端生成,日期使用 Asia/Shanghai:test 为 `vibemake_dev/project-covers/{userCode}/{yyyyMMdd}/{随机编码}.{扩展名}`,prod 为 `vibemake/project-covers/...`。不要修改 formFields、对象路径或上传类型。
|
||||
|
||||
### 浏览器直传与保存项目
|
||||
|
||||
@@ -1471,14 +1471,14 @@ async function downloadWorkspaceFile(projectCode: string, path: string, token: s
|
||||
}
|
||||
```
|
||||
|
||||
### UTC 时间解析
|
||||
### 上海时间解析
|
||||
|
||||
只对项目、评论中不带时区的 UTC 字段使用这个函数;历史 authorDate 已带时区时按其原值解析。
|
||||
对项目、评论、上传过期时间等不带时区的上海时间字段使用这个函数;历史 authorDate 已带时区时按其原值解析。前端与后端需同时切换,旧版补 `Z` 的解析方式会多显示 8 小时。
|
||||
|
||||
```typescript
|
||||
function parseUtcTime(value: UtcDateTime): Date {
|
||||
function parseShanghaiTime(value: ShanghaiDateTime): Date {
|
||||
const hasTimezone = /(?:Z|[+-]\d{2}:\d{2})$/i.test(value);
|
||||
return new Date(hasTimezone ? value : `${value}Z`);
|
||||
return new Date(hasTimezone ? value : `${value}+08:00`);
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user