mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-11-16 23:04:24 +08:00
fix(i18n): use English runtime text and localize system UI
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
import type { RuntimeTranslator } from '@/i18n/runtime';
|
||||
import { type PolicySection } from './types';
|
||||
import { CodeBlock } from '@/components/ui/code-block';
|
||||
import {
|
||||
@@ -16,57 +17,65 @@ export const DOCS_LAST_UPDATED = '2026-06-07';
|
||||
* API 文档
|
||||
* ------------------------------------------------------------------
|
||||
*/
|
||||
export const apiSections: PolicySection[] = [
|
||||
{
|
||||
value: 'api-specs',
|
||||
title: '1. 接口规范与鉴权说明',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-6'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
平台统一接口调用格式规范以及开发者访问令牌鉴权方式说明
|
||||
</p>
|
||||
</div>
|
||||
export function createApiSections(rt: RuntimeTranslator): PolicySection[] {
|
||||
return [
|
||||
{
|
||||
value: 'api-specs',
|
||||
title: rt('1_api_conventions_and_authentication_e6d4df61'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-6'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
{rt(
|
||||
'standard_api_request_conventions_and_developer_access_39eb956e',
|
||||
)}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<h3
|
||||
id='1-1-response-format'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-3'
|
||||
>
|
||||
1.1 统一响应格式
|
||||
</h3>
|
||||
<p>系统所有 API 接口均遵循标准 JSON 响应结构:</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>字段</DocsTableHead>
|
||||
<DocsTableHead className='w-[100px]'>类型</DocsTableHead>
|
||||
<DocsTableHead>说明</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
error_msg
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
错误信息。请求成功时为空字符串
|
||||
`""`,失败时包含错误详情描述。
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>data</DocsTableCell>
|
||||
<DocsTableCell>any</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
接口返回的具体数据内容。请求失败或无数据返回时为 `null`。
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
<h3
|
||||
id='1-1-response-format'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-3'
|
||||
>
|
||||
{rt('1_1_standard_response_format_5cddae2f')}
|
||||
</h3>
|
||||
<p>{rt('all_api_endpoints_use_a_standard_json_87c92fb0')}</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>
|
||||
{rt('field_49ecd0e3')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead className='w-[100px]'>
|
||||
{rt('type_ba40014f')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead>{rt('description_4262c45d')}</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
error_msg
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
{rt('error_message_empty_on_success_contains_error_d89d457f')}
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
data
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>any</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
{rt('the_response_payload_null_when_the_request_97b8b29c')}
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
|
||||
<p className='mt-2'>成功响应示例:</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
<p className='mt-2'>{rt('successful_response_example_8917e853')}</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
"error_msg": "",
|
||||
"data": {
|
||||
"id": 1,
|
||||
@@ -74,263 +83,290 @@ export const apiSections: PolicySection[] = [
|
||||
"nickname": "Ryan"
|
||||
}
|
||||
}`}
|
||||
language='json'
|
||||
/>
|
||||
language='json'
|
||||
/>
|
||||
|
||||
<p className='mt-2'>失败响应示例:</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
"error_msg": "用户密码错误",
|
||||
"data": null
|
||||
}`}
|
||||
language='json'
|
||||
/>
|
||||
<p className='mt-2'>{rt('failed_response_example_eae899e1')}</p>
|
||||
<CodeBlock
|
||||
code={rt.raw('error_msg_incorrect_password_data_null_b2eccc86')}
|
||||
language='json'
|
||||
/>
|
||||
|
||||
<h3
|
||||
id='1-2-authentication'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-3'
|
||||
>
|
||||
1.2 鉴权方式
|
||||
</h3>
|
||||
<p>
|
||||
除了公共公开接口(如登录、注册、配置)外,受保护的接口需要携带凭证才能正常访问:
|
||||
</p>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>Session 凭证:</strong>浏览器环境下支持利用常规 Session
|
||||
Cookie 会话保持登录。
|
||||
</li>
|
||||
<li>
|
||||
<strong>AccessToken 令牌:</strong>
|
||||
供后台调用或第三方应用集成使用。客户端生成 API
|
||||
访问令牌后,需要在请求头(Request Header)中携带以进行身份校验。
|
||||
</li>
|
||||
</ul>
|
||||
<div className='bg-muted border rounded-xl p-4 mt-2 space-y-2'>
|
||||
<p className='font-bold text-xs'>
|
||||
支持携带令牌的请求头格式(二选一):
|
||||
<h3
|
||||
id='1-2-authentication'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-3'
|
||||
>
|
||||
{rt('1_2_authentication_methods_3c5db38a')}
|
||||
</h3>
|
||||
<p>
|
||||
{rt(
|
||||
'protected_endpoints_require_credentials_except_public_endpoints_1fa0a24c',
|
||||
)}
|
||||
</p>
|
||||
<ul className='list-disc pl-5 text-xs text-muted-foreground space-y-1'>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<code className='bg-muted-foreground/10 px-1 rounded text-[11px] font-mono'>
|
||||
Authorization: Bearer at_xxx
|
||||
</code>
|
||||
<strong>{rt('session_credentials_de72024d')}</strong>{' '}
|
||||
{rt('browser_clients_can_stay_signed_in_using_f316279b')}
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted-foreground/10 px-1 rounded text-[11px] font-mono'>
|
||||
X-Access-Token: at_xxx
|
||||
</code>
|
||||
<strong>{rt('access_tokens_8de23550')}</strong>{' '}
|
||||
{rt('for_backend_calls_and_third_party_integrations_dfd8bf0f')}
|
||||
</li>
|
||||
</ul>
|
||||
<div className='bg-muted border rounded-xl p-4 mt-2 space-y-2'>
|
||||
<p className='font-bold text-xs'>
|
||||
{rt('use_either_of_the_following_request_headers_1e03b04b')}
|
||||
</p>
|
||||
<ul className='list-disc pl-5 text-xs text-muted-foreground space-y-1'>
|
||||
<li>
|
||||
<code className='bg-muted-foreground/10 px-1 rounded text-[11px] font-mono'>
|
||||
Authorization: Bearer at_xxx
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted-foreground/10 px-1 rounded text-[11px] font-mono'>
|
||||
X-Access-Token: at_xxx
|
||||
</code>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '1-1-response-format', title: '1.1 统一响应格式' },
|
||||
{ value: '1-2-authentication', title: '1.2 鉴权方式' },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'auth-apis',
|
||||
title: '2. 用户与认证接口',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<h3
|
||||
id='2-1-register'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
2.1 用户注册
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/register
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>注册本地账户(在后台注册开关开启状态下)。
|
||||
</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>参数</DocsTableHead>
|
||||
<DocsTableHead className='w-[80px]'>必填</DocsTableHead>
|
||||
<DocsTableHead>类型</DocsTableHead>
|
||||
<DocsTableHead>说明</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
username
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>是</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>用户名,必须唯一且无空格。</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
password
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>是</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>密码,长度必须大于等于 8 位。</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
nickname
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>否</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>昵称。未传时默认与用户名一致。</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
),
|
||||
children: [
|
||||
{
|
||||
value: '1-1-response-format',
|
||||
title: rt('1_1_standard_response_format_5cddae2f'),
|
||||
},
|
||||
{
|
||||
value: '1-2-authentication',
|
||||
title: rt('1_2_authentication_methods_3c5db38a'),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'auth-apis',
|
||||
title: rt('2_user_and_authentication_endpoints_4a89d429'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<h3
|
||||
id='2-1-register'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('2_1_user_registration_4f332f85')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/register
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('register_a_local_account_when_registration_is_938891dc')}
|
||||
</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>
|
||||
{rt('parameter_9634fb08')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead className='w-[80px]'>
|
||||
{rt('required_11da9dc4')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead>{rt('type_ba40014f')}</DocsTableHead>
|
||||
<DocsTableHead>{rt('description_4262c45d')}</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
username
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>{rt('yes_b5141d3d')}</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
{rt('username_must_be_unique_and_contain_no_e81c1e5c')}
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
password
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>{rt('yes_b5141d3d')}</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
{rt('password_at_least_8_characters_37cdc807')}
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
nickname
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>{rt('no_0c70665b')}</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>
|
||||
{rt(
|
||||
'nickname_defaults_to_the_username_when_omitted_676aae7e',
|
||||
)}
|
||||
</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
|
||||
<h3
|
||||
id='2-2-login'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
2.2 密码登录
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/login
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>通过常规用户名密码进行登录校验,成功后建立
|
||||
Session Cookie 会话。
|
||||
</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>参数</DocsTableHead>
|
||||
<DocsTableHead className='w-[80px]'>必填</DocsTableHead>
|
||||
<DocsTableHead>类型</DocsTableHead>
|
||||
<DocsTableHead>说明</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
username
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>是</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>用户名</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
password
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>是</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>密码</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
<h3
|
||||
id='2-2-login'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('2_2_password_login_271483ba')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/login
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt(
|
||||
'authenticate_with_a_username_and_password_establishing_a38ff252',
|
||||
)}
|
||||
</p>
|
||||
<DocsTable>
|
||||
<DocsTableHeader>
|
||||
<DocsTableRow>
|
||||
<DocsTableHead className='w-[120px]'>
|
||||
{rt('parameter_9634fb08')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead className='w-[80px]'>
|
||||
{rt('required_11da9dc4')}
|
||||
</DocsTableHead>
|
||||
<DocsTableHead>{rt('type_ba40014f')}</DocsTableHead>
|
||||
<DocsTableHead>{rt('description_4262c45d')}</DocsTableHead>
|
||||
</DocsTableRow>
|
||||
</DocsTableHeader>
|
||||
<DocsTableBody>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
username
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>{rt('yes_b5141d3d')}</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>{rt('username_1a3f0617')}</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
<DocsTableRow>
|
||||
<DocsTableCell className='font-mono text-xs'>
|
||||
password
|
||||
</DocsTableCell>
|
||||
<DocsTableCell>{rt('yes_b5141d3d')}</DocsTableCell>
|
||||
<DocsTableCell>string</DocsTableCell>
|
||||
<DocsTableCell>{rt('password_a621ab60')}</DocsTableCell>
|
||||
</DocsTableRow>
|
||||
</DocsTableBody>
|
||||
</DocsTable>
|
||||
|
||||
<h3
|
||||
id='2-3-logout'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
2.3 退出登录
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/logout
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>销毁当前会话 Cookie 并退出登录状态。
|
||||
</p>
|
||||
<h3
|
||||
id='2-3-logout'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('2_3_sign_out_3252611d')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/logout
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('delete_the_current_session_cookie_and_sign_c213ffd9')}
|
||||
</p>
|
||||
|
||||
<h3
|
||||
id='2-4-profile'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
2.4 获取个人资料
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/self
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>获取当前登录账户的基本数据模型(包含
|
||||
ID、角色、昵称等)。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '2-1-register', title: '2.1 用户注册' },
|
||||
{ value: '2-2-login', title: '2.2 密码登录' },
|
||||
{ value: '2-3-logout', title: '2.3 退出登录' },
|
||||
{ value: '2-4-profile', title: '2.4 获取个人资料' },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'token-apis',
|
||||
title: '3. 个人访问令牌 (AccessToken) 接口',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-4'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
AccessToken 管理相关接口均要求通过 Session
|
||||
登录后调用,支持普通用户权限。
|
||||
<h3
|
||||
id='2-4-profile'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('2_4_get_profile_7b96110a')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/self
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('get_the_signed_in_account_s_basic_b0eb8cfa')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '2-1-register', title: rt('2_1_user_registration_4f332f85') },
|
||||
{ value: '2-2-login', title: rt('2_2_password_login_271483ba') },
|
||||
{ value: '2-3-logout', title: rt('2_3_sign_out_3252611d') },
|
||||
{ value: '2-4-profile', title: rt('2_4_get_profile_7b96110a') },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'token-apis',
|
||||
title: rt('3_personal_access_token_endpoints_989f5d7c'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-4'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
{rt('access_token_management_requires_a_session_login_42d91543')}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<h3
|
||||
id='3-1-list-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
3.1 获取令牌列表
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>
|
||||
查询当前用户已创建的所有令牌详情(令牌明文已被脱敏)。
|
||||
</p>
|
||||
<h3
|
||||
id='3-1-list-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('3_1_list_tokens_9840c227')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('list_the_current_user_s_tokens_with_c34d2210')}
|
||||
</p>
|
||||
|
||||
<h3
|
||||
id='3-2-create-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
3.2 新建访问令牌
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>参数:</strong>JSON Body{' '}
|
||||
<code className='bg-muted px-1.5 rounded text-xs font-mono'>{`{"name": "token名称", "is_admin": false}`}</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>生成一个全新访问令牌。返回体中包含一次性明文
|
||||
Token,切勿遗失。
|
||||
</p>
|
||||
<p className='mt-1 text-xs text-muted-foreground'>
|
||||
<code className='bg-muted px-1 rounded'>is_admin</code>(可选,默认{' '}
|
||||
<code className='bg-muted px-1 rounded'>false</code>
|
||||
):是否赋予令牌管理员权限,仅管理员用户可设置。非管理员令牌无法访问{' '}
|
||||
<code className='bg-muted px-1 rounded'>/admin/**</code> 端点。
|
||||
</p>
|
||||
<p className='mt-2'>成功返回样例:</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
<h3
|
||||
id='3-2-create-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('3_2_create_an_access_token_e53bd784')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('parameters_ba89685c')}</strong> JSON Body{' '}
|
||||
<code className='bg-muted px-1.5 rounded text-xs font-mono'>
|
||||
{rt.raw('name_token_name_is_admin_false_4f3e4868')}
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('generate_an_access_token_the_response_includes_70552390')}
|
||||
</p>
|
||||
<p className='mt-1 text-xs text-muted-foreground'>
|
||||
<code className='bg-muted px-1 rounded'>is_admin</code>
|
||||
{rt('optional_default_210b9d8f')}{' '}
|
||||
<code className='bg-muted px-1 rounded'>false</code>
|
||||
{rt('grant_administrator_privileges_to_the_token_only_2292cad8')}{' '}
|
||||
<code className='bg-muted px-1 rounded'>/admin/**</code>{' '}
|
||||
{rt('endpoints_815c88e5')}
|
||||
</p>
|
||||
<p className='mt-2'>{rt('successful_response_example_7783a39c')}</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
"error_msg": "",
|
||||
"data": {
|
||||
"token": "at_628d022b7a95e26bcd8b29c9...",
|
||||
@@ -344,76 +380,84 @@ export const apiSections: PolicySection[] = [
|
||||
}
|
||||
}
|
||||
}`}
|
||||
language='json'
|
||||
/>
|
||||
language='json'
|
||||
/>
|
||||
|
||||
<h3
|
||||
id='3-3-delete-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
3.3 撤销/删除令牌
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>DELETE{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens/:id
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>通过 ID
|
||||
物理删除对应访问令牌,该令牌将立即失效。
|
||||
</p>
|
||||
<h3
|
||||
id='3-3-delete-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('3_3_revoke_delete_a_token_ae510f58')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> DELETE{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens/:id
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('permanently_delete_a_token_by_id_immediately_145287f6')}
|
||||
</p>
|
||||
|
||||
<h3
|
||||
id='3-4-rotate-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
3.4 轮换令牌密钥
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens/:id/rotate
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>
|
||||
轮换指定令牌的物理密钥值。系统将废弃原有密钥,返回新生成的明文
|
||||
Token,令牌名称与 ID 保持一致。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '3-1-list-token', title: '3.1 获取令牌列表' },
|
||||
{ value: '3-2-create-token', title: '3.2 新建访问令牌' },
|
||||
{ value: '3-3-delete-token', title: '3.3 撤销/删除令牌' },
|
||||
{ value: '3-4-rotate-token', title: '3.4 轮换令牌密钥' },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'config-apis',
|
||||
title: '4. 公共配置与管理接口',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<h3
|
||||
id='4-1-public-config'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
4.1 公共系统配置
|
||||
</h3>
|
||||
<p>
|
||||
<strong>接口:</strong>GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/config/public
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>说明:</strong>
|
||||
无感获取当前系统配置表中公共可见的键值集合。供前端页面动态渲染使用。
|
||||
</p>
|
||||
<p className='mt-2'>返回数据结构样例:</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
<h3
|
||||
id='3-4-rotate-token'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('3_4_rotate_a_token_secret_79209983')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> POST{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/user/access-tokens/:id/rotate
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('replace_a_token_s_secret_and_return_d2caca89')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '3-1-list-token', title: rt('3_1_list_tokens_9840c227') },
|
||||
{
|
||||
value: '3-2-create-token',
|
||||
title: rt('3_2_create_an_access_token_e53bd784'),
|
||||
},
|
||||
{
|
||||
value: '3-3-delete-token',
|
||||
title: rt('3_3_revoke_delete_a_token_ae510f58'),
|
||||
},
|
||||
{
|
||||
value: '3-4-rotate-token',
|
||||
title: rt('3_4_rotate_a_token_secret_79209983'),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'config-apis',
|
||||
title: rt('4_public_configuration_and_administration_17ebdbd5'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<h3
|
||||
id='4-1-public-config'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('4_1_public_system_configuration_2be912e4')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('endpoint_79a2369a')}</strong> GET{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
/api/v1/config/public
|
||||
</code>
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt('get_publicly_visible_configuration_keys_and_values_bc7bff66')}
|
||||
</p>
|
||||
<p className='mt-2'>{rt('response_example_d3087445')}</p>
|
||||
<CodeBlock
|
||||
code={`{
|
||||
"error_msg": "",
|
||||
"data": {
|
||||
"site_name": "OpenFlare",
|
||||
@@ -424,50 +468,61 @@ export const apiSections: PolicySection[] = [
|
||||
"oidc_login_enabled": "true"
|
||||
}
|
||||
}`}
|
||||
language='json'
|
||||
/>
|
||||
language='json'
|
||||
/>
|
||||
|
||||
<h3
|
||||
id='4-2-admin-configs'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
4.2 系统配置项 CRUD (管理员)
|
||||
</h3>
|
||||
<p>
|
||||
<strong>说明:</strong>用于在后台对 `system_configs`
|
||||
配置进行动态变更,要求管理员权限会话调用。
|
||||
</p>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>获取配置列表:</strong>GET{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs?type=system
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>新建配置项:</strong>POST{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>修改指定配置值:</strong>PUT{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs/:key
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>删除配置项:</strong>DELETE{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs/:key
|
||||
</code>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '4-1-public-config', title: '4.1 公共系统配置' },
|
||||
{ value: '4-2-admin-configs', title: '4.2 系统配置项 CRUD (管理员)' },
|
||||
],
|
||||
},
|
||||
];
|
||||
<h3
|
||||
id='4-2-admin-configs'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-6 mb-2'
|
||||
>
|
||||
{rt('4_2_system_configuration_crud_administrator_2ce66c8b')}
|
||||
</h3>
|
||||
<p>
|
||||
<strong>{rt('description_3e633a20')}</strong>{' '}
|
||||
{rt(
|
||||
'manage_system_configs_dynamically_through_an_administrator_acdcdb99',
|
||||
)}
|
||||
</p>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('list_configuration_3d58680b')}</strong> GET{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs?type=system
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('create_a_configuration_entry_1d995264')}</strong>{' '}
|
||||
POST{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('update_a_configuration_value_2a0b0b76')}</strong> PUT{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs/:key
|
||||
</code>
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('delete_a_configuration_entry_1b77a6ea')}</strong>{' '}
|
||||
DELETE{' '}
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
/api/v1/admin/system-configs/:key
|
||||
</code>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{
|
||||
value: '4-1-public-config',
|
||||
title: rt('4_1_public_system_configuration_2be912e4'),
|
||||
},
|
||||
{
|
||||
value: '4-2-admin-configs',
|
||||
title: rt('4_2_system_configuration_crud_administrator_2ce66c8b'),
|
||||
},
|
||||
],
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
import type { RuntimeTranslator } from '@/i18n/runtime';
|
||||
import { type PolicySection } from './types';
|
||||
import { CodeBlock } from '@/components/ui/code-block';
|
||||
|
||||
@@ -6,249 +7,273 @@ import { CodeBlock } from '@/components/ui/code-block';
|
||||
* 使用指南 (How To Use)
|
||||
* ------------------------------------------------------------------
|
||||
*/
|
||||
export const howToUseSections: PolicySection[] = [
|
||||
{
|
||||
value: 'quick-start',
|
||||
title: '1. 快速开始',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-6'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
为开发者提供通用全栈开发脚手架 (Boilerplate) 平台使用说明
|
||||
</p>
|
||||
export function createHowToUseSections(rt: RuntimeTranslator): PolicySection[] {
|
||||
return [
|
||||
{
|
||||
value: 'quick-start',
|
||||
title: rt('1_quick_start_ef8fbb58'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<div className='bg-muted/50 border border-border/50 rounded-lg px-3 py-2 mb-6'>
|
||||
<p className='text-muted-foreground m-0'>
|
||||
{rt('a_guide_to_the_general_purpose_full_9cd8c987')}
|
||||
</p>
|
||||
</div>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('architecture_e992b65c')}</strong>{' '}
|
||||
{rt('go_gin_gorm_redis_asynq_backend_react_d5fe02d3')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('authentication_d36b345b')}</strong>{' '}
|
||||
{rt(
|
||||
'local_username_password_registration_and_login_plus_583ab638',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('access_tokens_b7b856d3')}</strong>{' '}
|
||||
{rt('personal_developer_access_tokens_api_keys_for_4b407149')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('observability_ea0cc1bf')}</strong>{' '}
|
||||
{rt(
|
||||
'zap_structured_logging_and_opentelemetry_distributed_tracing_9fd6da9f',
|
||||
)}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<ul className='list-disc pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>架构底座:</strong>Go (Gin + GORM + Redis + Asynq) 后端 +
|
||||
React (Next.js 16 + Tailwind CSS 4 + Shadcn UI) 前端
|
||||
</li>
|
||||
<li>
|
||||
<strong>认证体系:</strong>支持本地常规账号密码注册登录 +
|
||||
第三方自定义 OIDC (OAuth2) 认证源绑定
|
||||
</li>
|
||||
<li>
|
||||
<strong>访问令牌:</strong>提供开发者个人 AccessToken (API
|
||||
Key),用于通过 Http Header 鉴权直接调用系统 API
|
||||
</li>
|
||||
<li>
|
||||
<strong>可观测性:</strong>集成 Zap 结构化日志与 OpenTelemetry
|
||||
全链路 Tracing 追踪
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'auth-security',
|
||||
title: '2. 身份认证与安全设置',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>平台采用混合式身份认证,满足不同的部署和业务场景需求:</p>
|
||||
<h3
|
||||
id='2-1-login'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
2.1 常规账号密码认证
|
||||
</h3>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>自主注册与密码登录:</strong>
|
||||
支持普通用户通过用户名及密码直接进行注册与会话建立,密码在后端采用{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
bcrypt
|
||||
</code>{' '}
|
||||
高强度加盐哈希存储。
|
||||
</li>
|
||||
<li>
|
||||
<strong>系统开关控制:</strong>
|
||||
管理员可在后台配置动态开关,随时禁用自主密码注册或密码登录,以转为纯第三方认证模式。
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3
|
||||
id='2-2-oidc'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
2.2 第三方 OIDC 认证源
|
||||
</h3>
|
||||
<p>用户可以在个人资料页面关联绑定外部授权账户:</p>
|
||||
<ol className='list-decimal pl-4 md:pl-5 space-y-1'>
|
||||
<li>
|
||||
进入 <strong>设置 / 个人资料</strong> 页面。
|
||||
</li>
|
||||
<li>
|
||||
在“第三方账号绑定”栏目下查看当前绑定的账号,或点击未绑定的可用 OIDC
|
||||
认证源直接触发 OAuth2 绑定流。
|
||||
</li>
|
||||
<li>
|
||||
绑定成功后,用户在登录界面可直接点击 OIDC 登录按钮实现快捷跳转。
|
||||
</li>
|
||||
</ol>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '2-1-login', title: '2.1 常规账号密码认证' },
|
||||
{ value: '2-2-oidc', title: '2.2 第三方 OIDC 认证源' },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'access-token',
|
||||
title: '3. 个人访问令牌 (AccessToken) 接口对接',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
为便于开发者或第三方工具直接调用系统
|
||||
API,平台提供个人访问令牌管理功能。
|
||||
</p>
|
||||
<h3
|
||||
id='3-1-generation'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
3.1 令牌生成与存储规范
|
||||
</h3>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>一次性明文展示:</strong>创建令牌时生成的随机明文 Token 值
|
||||
(形如{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
at_xxx
|
||||
</code>
|
||||
)
|
||||
仅会在弹窗中展示一次。请立即复制保存,关闭弹窗后系统将无法重新获取。
|
||||
</li>
|
||||
<li>
|
||||
<strong>安全哈希存储:</strong>数据库仅存储 Token 的 SHA-256
|
||||
哈希指纹,即使数据库泄漏,攻击者也无法通过摘要逆向恢复令牌原文。
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3
|
||||
id='3-2-usage'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
3.2 携带 Header 进行 API 调用
|
||||
</h3>
|
||||
<p>
|
||||
您可以凭借保存的明文 Token 随时调用系统开放接口,系统认证支持以下两种
|
||||
Http 请求头携带方式之一:
|
||||
</p>
|
||||
<div className='space-y-2'>
|
||||
<p className='font-semibold text-xs text-muted-foreground'>
|
||||
方式一:Authorization Bearer 头
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'auth-security',
|
||||
title: rt('2_authentication_and_security_settings_76967059'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt(
|
||||
'the_platform_combines_authentication_methods_to_support_bc9f1772',
|
||||
)}
|
||||
</p>
|
||||
<CodeBlock
|
||||
code={`GET /api/v1/user/self HTTP/1.1
|
||||
<h3
|
||||
id='2-1-login'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('2_1_username_and_password_authentication_97184f8f')}
|
||||
</h3>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('registration_and_password_login_c5bd6cb4')}</strong>{' '}
|
||||
{rt('users_can_register_and_create_sessions_with_21883e04')}{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
bcrypt
|
||||
</code>{' '}
|
||||
{rt('salted_hashing_dc2a9b63')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('system_switches_53741557')}</strong>{' '}
|
||||
{rt(
|
||||
'administrators_can_disable_password_registration_or_login_a2648e62',
|
||||
)}
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3
|
||||
id='2-2-oidc'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('2_2_third_party_oidc_providers_f14083c8')}
|
||||
</h3>
|
||||
<p>{rt('users_can_link_external_accounts_from_their_c08d3f5a')}</p>
|
||||
<ol className='list-decimal pl-4 md:pl-5 space-y-1'>
|
||||
<li>
|
||||
{rt('open_4540d74d')}
|
||||
<strong>{rt('settings_profile_32835b0d')}</strong>{' '}
|
||||
{rt('message_a173cce8')}
|
||||
</li>
|
||||
<li>
|
||||
{rt(
|
||||
'under_linked_accounts_view_existing_connections_or_5151eb9b',
|
||||
)}
|
||||
</li>
|
||||
<li>{rt('after_linking_use_the_oidc_login_button_6095b15d')}</li>
|
||||
</ol>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{
|
||||
value: '2-1-login',
|
||||
title: rt('2_1_username_and_password_authentication_97184f8f'),
|
||||
},
|
||||
{
|
||||
value: '2-2-oidc',
|
||||
title: rt('2_2_third_party_oidc_providers_f14083c8'),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'access-token',
|
||||
title: rt('3_integrating_personal_access_tokens_af2647b5'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt('personal_access_tokens_allow_developers_and_third_9a242a0e')}
|
||||
</p>
|
||||
<h3
|
||||
id='3-1-generation'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('3_1_token_generation_and_storage_2b78c681')}
|
||||
</h3>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('one_time_plaintext_display_fd13912a')}</strong>{' '}
|
||||
{rt('a_newly_generated_plaintext_token_such_as_57eb11a1')}{' '}
|
||||
<code className='bg-muted px-1.5 py-0.5 rounded text-xs font-mono'>
|
||||
at_xxx
|
||||
</code>
|
||||
{rt('is_displayed_only_once_copy_and_save_8d378c8a')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('secure_hash_storage_1ce392ff')}</strong>{' '}
|
||||
{rt('only_a_sha_256_hash_of_the_dbf434b1')}
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3
|
||||
id='3-2-usage'
|
||||
className='text-base md:text-lg font-semibold text-foreground mt-4 mb-2'
|
||||
>
|
||||
{rt('3_2_calling_apis_with_headers_fccd7b0d')}
|
||||
</h3>
|
||||
<p>{rt('use_your_saved_plaintext_token_with_either_3af53a05')}</p>
|
||||
<div className='space-y-2'>
|
||||
<p className='font-semibold text-xs text-muted-foreground'>
|
||||
{rt('method_1_authorization_bearer_header_2a9c2a6c')}
|
||||
</p>
|
||||
<CodeBlock
|
||||
code={`GET /api/v1/user/self HTTP/1.1
|
||||
Host: localhost:3000
|
||||
Authorization: Bearer at_628d022b7a95e26b...`}
|
||||
language='http'
|
||||
/>
|
||||
</div>
|
||||
<div className='space-y-2'>
|
||||
<p className='font-semibold text-xs text-muted-foreground'>
|
||||
方式二:X-Access-Token 自定义头
|
||||
</p>
|
||||
<CodeBlock
|
||||
code={`GET /api/v1/user/self HTTP/1.1
|
||||
language='http'
|
||||
/>
|
||||
</div>
|
||||
<div className='space-y-2'>
|
||||
<p className='font-semibold text-xs text-muted-foreground'>
|
||||
{rt('method_2_custom_x_access_token_header_4548169f')}
|
||||
</p>
|
||||
<CodeBlock
|
||||
code={`GET /api/v1/user/self HTTP/1.1
|
||||
Host: localhost:3000
|
||||
X-Access-Token: at_628d022b7a95e26b...`}
|
||||
language='http'
|
||||
/>
|
||||
language='http'
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
),
|
||||
children: [
|
||||
{ value: '3-1-generation', title: '3.1 令牌生成与存储规范' },
|
||||
{ value: '3-2-usage', title: '3.2 携带 Header 进行 API 调用' },
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'config-system',
|
||||
title: '4. 动态系统配置项',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
平台内置了完备的 KV 配置管理模块,允许管理员动态调整系统运行状态:
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>缓存读取加速:</strong>配置加载基于 GORM 读取数据库,并辅以
|
||||
Redis Hash 结构进行多层缓存加速,大幅降低配置查询耗时。
|
||||
</li>
|
||||
<li>
|
||||
<strong>核心系统配置项说明:</strong>
|
||||
<ul className='list-[circle] pl-5 mt-1 space-y-1 text-muted-foreground'>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
site_name
|
||||
</code>
|
||||
:平台展示名称
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
password_login_enabled
|
||||
</code>
|
||||
:密码登录开关
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
registration_enabled
|
||||
</code>
|
||||
:用户自主注册开关
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
max_api_keys_per_user
|
||||
</code>
|
||||
:普通用户创建令牌的最大数限制 (默认5)
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'worker-scheduler',
|
||||
title: '5. 异步任务与定时调度',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
项目借助 Cobra 实现多命令入口分发,通过独立部署 Worker
|
||||
服务解耦复杂计算或高延迟IO:
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>定时任务派发 (CMD scheduler):</strong>负责按 Cron
|
||||
表达式配置,定时将待执行任务推送到 Redis 队列中。
|
||||
</li>
|
||||
<li>
|
||||
<strong>多优先级 Worker (CMD worker):</strong>基于 Asynq
|
||||
驱动,按优先级拉取任务并并发调度执行(如定时清理临时上传目录、同步外部系统日志等)。
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'tracing-metrics',
|
||||
title: '6. 链路追踪与结构化日志',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>为了保障分布式微服务架构下的可观测性,平台接入了高级监控组件:</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>OpenTelemetry Tracing:</strong>自动传递 Tracing
|
||||
上下文,所有经由 Gin 中间件、外部请求或 GORM
|
||||
数据库的事务操作都将带有全局唯一的
|
||||
Span,用于排查链路耗时或调用异常。
|
||||
</li>
|
||||
<li>
|
||||
<strong>Zap 结构化日志:</strong>
|
||||
将后端控制台或日志输出格式统一规范化为 JSON,方便与 ELK、Loki
|
||||
等日志收集分析工具无缝对接。
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
),
|
||||
children: [
|
||||
{
|
||||
value: '3-1-generation',
|
||||
title: rt('3_1_token_generation_and_storage_2b78c681'),
|
||||
},
|
||||
{
|
||||
value: '3-2-usage',
|
||||
title: rt('3_2_calling_apis_with_headers_fccd7b0d'),
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
value: 'config-system',
|
||||
title: rt('4_dynamic_system_configuration_b3bf8c49'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>{rt('the_built_in_key_value_configuration_module_713f6d05')}</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('cached_reads_35828322')}</strong>{' '}
|
||||
{rt('configuration_is_read_from_the_database_through_3e9f6a34')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('core_system_configuration_keys_6dc02be8')}</strong>
|
||||
<ul className='list-[circle] pl-5 mt-1 space-y-1 text-muted-foreground'>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
site_name
|
||||
</code>
|
||||
{rt('platform_display_name_116219b1')}
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
password_login_enabled
|
||||
</code>
|
||||
{rt('password_login_switch_153eaa45')}
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
registration_enabled
|
||||
</code>
|
||||
{rt('user_registration_switch_827b5b21')}
|
||||
</li>
|
||||
<li>
|
||||
<code className='bg-muted px-1 rounded text-xs font-mono'>
|
||||
max_api_keys_per_user
|
||||
</code>
|
||||
{rt('maximum_tokens_per_regular_user_default_5_5dd6d9e7')}
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'worker-scheduler',
|
||||
title: rt('5_background_tasks_and_scheduling_7142ce96'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt('cobra_provides_separate_commands_so_worker_services_1bbae2df')}
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>
|
||||
{rt('scheduled_dispatch_scheduler_command_e79062ad')}
|
||||
</strong>{' '}
|
||||
{rt('enqueues_tasks_in_redis_according_to_their_694e5985')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>
|
||||
{rt('workers_with_queue_priorities_worker_command_faa970b1')}
|
||||
</strong>{' '}
|
||||
{rt('asynq_consumes_tasks_by_priority_and_executes_69d82251')}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'tracing-metrics',
|
||||
title: rt('6_distributed_tracing_and_structured_logs_e8971cad'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt(
|
||||
'the_platform_integrates_monitoring_components_for_observability_2b1da50f',
|
||||
)}
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>OpenTelemetry Tracing:</strong>{' '}
|
||||
{rt(
|
||||
'tracing_context_is_propagated_automatically_gin_requests_0f549cce',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('zap_structured_logs_1c9725e8')}</strong>{' '}
|
||||
{rt('standardizes_backend_console_and_log_output_as_16970757')}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import * as React from 'react';
|
||||
import Link from 'next/link';
|
||||
import { ArrowLeft, Calendar, Check, Copy, FileText } from 'lucide-react';
|
||||
@@ -21,6 +22,8 @@ export function LegalPageLayout({
|
||||
sections,
|
||||
description,
|
||||
}: LegalPageLayoutProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const [activeSection, setActiveSection] = React.useState<string>(
|
||||
sections[0]?.value || '',
|
||||
);
|
||||
@@ -192,7 +195,7 @@ export function LegalPageLayout({
|
||||
const lines: string[] = [];
|
||||
lines.push(`# ${title}`);
|
||||
lines.push('');
|
||||
lines.push(`最后更新:${lastUpdated}`);
|
||||
lines.push(rt('last_updated_value0_87a896df', { value0: lastUpdated }));
|
||||
if (description) {
|
||||
const descriptionElement = contentRoot.querySelector(
|
||||
'[data-docs-description]',
|
||||
@@ -303,7 +306,7 @@ export function LegalPageLayout({
|
||||
className='gap-2 pl-0 text-muted-foreground hover:text-foreground hover:bg-transparent -ml-2'
|
||||
>
|
||||
<ArrowLeft className='w-4 h-4' />
|
||||
返回首页
|
||||
{rt('back_to_home_d66f4359')}
|
||||
</Button>
|
||||
</Link>
|
||||
|
||||
@@ -318,11 +321,12 @@ export function LegalPageLayout({
|
||||
<div className='flex flex-wrap items-center gap-4 text-xs text-muted-foreground mb-8'>
|
||||
<span className='flex items-center gap-1.5 bg-muted/50 px-3 py-1 rounded-full border border-border/50'>
|
||||
<FileText className='w-3.5 h-3.5' />
|
||||
{sections.length} 个内容
|
||||
{sections.length} {rt('sections_fcb2696e')}
|
||||
</span>
|
||||
<span className='flex items-center gap-1.5 bg-muted/50 px-3 py-1 rounded-full border border-border/50'>
|
||||
<Calendar className='w-3.5 h-3.5' />
|
||||
最后更新:{lastUpdated}
|
||||
{rt('last_updated_a83cd480')}
|
||||
{lastUpdated}
|
||||
</span>
|
||||
<Button
|
||||
type='button'
|
||||
@@ -336,7 +340,9 @@ export function LegalPageLayout({
|
||||
) : (
|
||||
<Copy className='w-3.5 h-3.5' />
|
||||
)}
|
||||
{hasCopied ? '已复制' : '复制 Markdown'}
|
||||
{hasCopied
|
||||
? rt('copied_8f6f8d97')
|
||||
: rt('copy_markdown_f9c71ee4')}
|
||||
</Button>
|
||||
</div>
|
||||
{description && (
|
||||
@@ -357,7 +363,7 @@ export function LegalPageLayout({
|
||||
<div className='sticky top-24'>
|
||||
<div className='space-y-2 max-h-[calc(100vh-8rem)] overflow-y-auto pr-4 scrollbar-thin'>
|
||||
<div className='text-sm font-semibold text-foreground mb-4 pl-3'>
|
||||
目录
|
||||
{rt('table_of_contents_52daa71e')}
|
||||
</div>
|
||||
<nav className='space-y-1'>
|
||||
{sections.map((section) => (
|
||||
@@ -445,7 +451,7 @@ export function LegalPageLayout({
|
||||
<div className='pt-16 border-t border-border mt-20'>
|
||||
<div className='bg-muted/30 rounded-2xl p-8 text-center'>
|
||||
<p className='text-muted-foreground text-sm mb-4'>
|
||||
对这些内容有疑问?
|
||||
{rt('questions_about_this_content_feb7d44a')}
|
||||
</p>
|
||||
<div className='flex justify-center gap-4'>
|
||||
<Link
|
||||
@@ -453,7 +459,7 @@ export function LegalPageLayout({
|
||||
target='_blank'
|
||||
>
|
||||
<Button variant='outline' className='h-9 text-xs'>
|
||||
联系支持
|
||||
{rt('contact_support_4cac90c8')}
|
||||
</Button>
|
||||
</Link>
|
||||
</div>
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
import type { RuntimeTranslator } from '@/i18n/runtime';
|
||||
import { type PolicySection } from './types';
|
||||
|
||||
/**
|
||||
@@ -5,156 +6,162 @@ import { type PolicySection } from './types';
|
||||
* 隐私政策 (PRIVACY POLICY)
|
||||
* ------------------------------------------------------------------
|
||||
*/
|
||||
export const privacySections: PolicySection[] = [
|
||||
{
|
||||
value: 'collection-details',
|
||||
title: '1. 详细信息收集说明',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
我们仅遵循合法、正当、必要的原则,收集为您提供服务所必需的信息。我们的数据收集范围严格限制如下:
|
||||
</p>
|
||||
<div className='space-y-3'>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
1.1 身份鉴权信息:
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
当您通过本地账号注册或绑定第三方 OIDC
|
||||
认证源登录时,我们会收集您的用户名、关联的邮箱、加密后的密码哈希指纹及关联的第三方
|
||||
OpenID 标识符。
|
||||
<strong>
|
||||
我们不强制要求绑定手机号、身份证件或任何真实社会信用实体信息。
|
||||
</strong>
|
||||
</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
1.2 服务与接口日志信息:
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
为保障系统运行安全及满足安全审计要求,我们会自动收集您的操作日志,包括
|
||||
IP 地址、访问日期和时间、个人访问令牌 API
|
||||
调用历史记录、User-Agent(浏览器/设备/请求工具类型)。
|
||||
</p>
|
||||
export function createPrivacySections(rt: RuntimeTranslator): PolicySection[] {
|
||||
return [
|
||||
{
|
||||
value: 'collection-details',
|
||||
title: rt('1_information_we_collect_af0db091'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>{rt('we_collect_only_the_information_necessary_to_72f6e528')}</p>
|
||||
<div className='space-y-3'>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
{rt('1_1_authentication_information_60199ee9')}
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
{rt('when_you_register_locally_or_sign_in_acdd6bd1')}{' '}
|
||||
<strong>
|
||||
{rt('we_do_not_require_a_phone_number_3540dfca')}
|
||||
</strong>
|
||||
</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
{rt('1_2_service_and_api_logs_46c9a04d')}
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
{rt(
|
||||
'for_system_security_and_auditing_we_automatically_89737fdd',
|
||||
)}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'storage-security',
|
||||
title: '2. 数据存储与安全保护',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>我们深知数据安全的重要性,并采取业界领先的技术措施保护您的数据:</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>存储安全:</strong>
|
||||
用户数据独立存储于专用的云数据库或本地容器化持久层中,仅供授权系统应用挂载读取。
|
||||
</li>
|
||||
<li>
|
||||
<strong>加密技术:</strong>
|
||||
敏感的密码指纹和个人访问令牌哈希在数据库中均采用高强度算法加密存储。API
|
||||
数据传输链路强制使用 SSL/TLS 进行安全加密。
|
||||
</li>
|
||||
<li>
|
||||
<strong>访问控制:</strong>我们实行严格的最小权限原则(Least
|
||||
Privilege),平台数据不会对外共享,所有系统级内部运维操作均有审计日志可查。
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'usage-rules',
|
||||
title: '3. 信息使用规范',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>我们收集的信息将仅用于以下目的:</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1'>
|
||||
<li>
|
||||
<strong>身份识别:</strong>
|
||||
用于确认您的注册身份,展示您的个人中心及设置页面数据。
|
||||
</li>
|
||||
<li>
|
||||
<strong>业务功能:</strong>用于识别并处理您的个人访问令牌 API
|
||||
鉴权指令。
|
||||
</li>
|
||||
<li>
|
||||
<strong>安全风控:</strong>利用 IP
|
||||
及行为日志进行接口反作弊、反暴力破解分析,保障后台服务稳定性。
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
<strong>禁止用途:</strong>我们承诺<strong>绝不</strong>
|
||||
将您的数据出售给第三方,亦不会向任何机构提供任何用户画像分析或广告推送服务。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'sharing-disclosure',
|
||||
title: '4. 信息共享与对外披露',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>4.1 共享原则:</strong>
|
||||
除以下极端情况外,我们不会向任何第三方(包括且不限于关联公司、商业合作伙伴)共享您的个人信息:
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1 text-muted-foreground'>
|
||||
<li>事先获得您的明确授权或同意;</li>
|
||||
<li>
|
||||
根据适用的法律法规、法律程序的要求、强制性的行政或司法要求所必须的情况下进行提供。
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
<strong>4.2 转让与公开披露:</strong>
|
||||
我们不会将您的个人信息转让给任何公司、组织和个人,亦不进行任何公开商业披露。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'user-rights',
|
||||
title: '5. 您的权利与数据管理',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
依照《中华人民共和国个人信息保护法》,您对您的个人信息享有完整的控制权:
|
||||
</p>
|
||||
<div className='space-y-3'>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
5.1 查阅与管理权:
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
您可以随时登录本平台,查阅您的基础个人信息,生成、轮换或撤销您的
|
||||
AccessToken (API 密钥)。
|
||||
</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
5.2 删除与注销权:
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
若您决定停止使用本服务,您可以申请注销账户。注销后,我们将立即从活跃存储媒介中删除您的所有敏感信息,法律法规要求留存的安全日志除外。
|
||||
</p>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'storage-security',
|
||||
title: rt('2_data_storage_and_security_7cc5cdef'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>{rt('we_recognize_the_importance_of_data_security_cd3bd4d9')}</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('storage_security_a33cfbef')}</strong>{' '}
|
||||
{rt('user_data_is_stored_in_a_dedicated_132af7bb')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('cryptography_9a15a88b')}</strong>{' '}
|
||||
{rt(
|
||||
'sensitive_password_and_personal_access_token_hashes_9f724cd8',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('access_control_3471eafa')}</strong>{' '}
|
||||
{rt('we_apply_the_principle_of_least_privilege_79328c28')}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'usage-rules',
|
||||
title: rt('3_how_we_use_information_41b4d6ad'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>{rt('collected_information_is_used_only_for_the_4868b538')}</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1'>
|
||||
<li>
|
||||
<strong>{rt('identification_481b07f4')}</strong>{' '}
|
||||
{rt('to_identify_your_registered_account_and_display_8c559094')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('service_functions_c5834f20')}</strong>{' '}
|
||||
{rt(
|
||||
'to_identify_and_process_api_authentication_requests_d48a36a2',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('security_e7132437')}</strong>{' '}
|
||||
{rt('to_analyze_ip_addresses_and_activity_logs_5210836a')}
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
<strong>{rt('prohibited_uses_b13fde94')}</strong>{' '}
|
||||
{rt('we_will_8856fb95')}
|
||||
<strong>{rt('never_c1d7d603')}</strong>{' '}
|
||||
{rt('sell_your_data_to_third_parties_or_7bb4d77a')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'sharing-disclosure',
|
||||
title: rt('4_information_sharing_and_disclosure_c034d295'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>{rt('4_1_sharing_principles_b89eb890')}</strong>{' '}
|
||||
{rt('we_do_not_share_personal_information_with_ffcf1e8f')}
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1 text-muted-foreground'>
|
||||
<li>
|
||||
{rt('with_your_prior_explicit_authorization_or_consent_0fa05878')}
|
||||
</li>
|
||||
<li>
|
||||
{rt(
|
||||
'when_required_by_applicable_laws_legal_proceedings_cb547dd6',
|
||||
)}
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
<strong>{rt('4_2_transfer_and_public_disclosure_383d35be')}</strong>{' '}
|
||||
{rt('we_do_not_transfer_your_personal_information_e3339921')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'user-rights',
|
||||
title: rt('5_your_rights_and_data_management_08999326'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt('under_the_personal_information_protection_law_of_94ea405e')}
|
||||
</p>
|
||||
<div className='space-y-3'>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
{rt('5_1_access_and_management_854d0793')}
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
{rt('you_may_sign_in_at_any_time_8727c5be')}
|
||||
</p>
|
||||
</div>
|
||||
<div>
|
||||
<span className='font-semibold text-foreground'>
|
||||
{rt('5_2_deletion_and_account_closure_9d1e7aba')}
|
||||
</span>
|
||||
<p className='mt-1 text-muted-foreground'>
|
||||
{rt('if_you_stop_using_the_service_you_24c642c6')}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'policy-update',
|
||||
title: '6. 政策更新与通知',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>随着业务的发展或法律法规的变动,本《隐私政策》条款可能发生变更。</p>
|
||||
<p>
|
||||
当条款发生重大变更时,我们会以显著方式(如平台公告、站内弹窗等)予以通知。如果您继续使用本服务,即表示您同意接受修订后的政策约束。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'policy-update',
|
||||
title: rt('6_policy_updates_and_notices_444076f5'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>{rt('this_privacy_policy_may_change_as_the_2a270464')}</p>
|
||||
<p>
|
||||
{rt('we_will_prominently_announce_material_changes_for_210fbd3b')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
import type { RuntimeTranslator } from '@/i18n/runtime';
|
||||
import { type PolicySection } from './types';
|
||||
|
||||
export const TERMS_LAST_UPDATED = '2026-06-07';
|
||||
@@ -7,153 +8,176 @@ export const TERMS_LAST_UPDATED = '2026-06-07';
|
||||
* 服务条款 (TERMS OF SERVICE)
|
||||
* ------------------------------------------------------------------
|
||||
*/
|
||||
export const termsSections: PolicySection[] = [
|
||||
{
|
||||
value: 'contract-establishment',
|
||||
title: '1. 缔约申明与服务综述',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>1.1 缔约主体:</strong>
|
||||
本《服务协议》(以下简称“本协议”)是您(以下称“用户”或“开发者”)与本通用开发脚手架平台(以下简称“本系统”或“平台”)运营维护方之间关于使用本系统所订立的契约。
|
||||
</p>
|
||||
<p>
|
||||
<strong>1.2 审慎阅读:</strong>
|
||||
本系统作为一个通用的、面向二次开发的全栈软件底座,旨在为用户提供基础的注册、会话、OIDC
|
||||
接入、API Key
|
||||
令牌鉴权及后台管理服务。若您使用本系统,请务必仔细阅读本协议各条款。
|
||||
</p>
|
||||
<p>
|
||||
<strong>1.3 协议构成:</strong>
|
||||
本协议内容包括协议正文及所有我们已经发布或将来可能发布的各类规则、声明、说明。所有规则为本协议不可分割的组成部分,与协议正文具有同等法律效力。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'service-definition',
|
||||
title: '2. 服务定义与性质界定',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>责任自担:</strong>
|
||||
关于用户对本系统进行二次开发并应用于其他生产环境产生的任何业务行为,由二开部署运营主体承担全部合规责任。
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'account-specifications',
|
||||
title: '3. 账号注册与使用规范',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>3.1 账号体系:</strong>
|
||||
用户可通过本系统的前端注册表单自助创建账户,或通过系统管理员配置并启用的自定义第三方
|
||||
OIDC 认证源进行登录关联。
|
||||
</p>
|
||||
<p>
|
||||
<strong>3.2 密码及令牌安全责任:</strong>
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>密码安全:</strong>您应妥善保管您账户的登录密码。
|
||||
</li>
|
||||
<li>
|
||||
<strong>API Token 安全:</strong>个人生成的 AccessToken (API Key)
|
||||
代表您账户的完整调用权限。
|
||||
<strong>
|
||||
因您保管不善导致 Token
|
||||
泄漏而造成的一切数据丢失或系统损失,均由您自行承担。
|
||||
</strong>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'user-conduct',
|
||||
title: '4. 用户行为准则(负面清单)',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
您在使用本系统时,必须严格遵守《中华人民共和国网络安全法》、《计算机信息网络国际联网安全保护管理办法》等法律法规。
|
||||
<strong>严禁利用本平台从事以下活动(“红线条款”):</strong>
|
||||
</p>
|
||||
<div className='bg-red-500/5 border border-red-500/20 rounded-lg p-3 md:p-4 space-y-3'>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2 text-red-600 dark:text-red-400 font-medium'>
|
||||
export function createTermsSections(rt: RuntimeTranslator): PolicySection[] {
|
||||
return [
|
||||
{
|
||||
value: 'contract-establishment',
|
||||
title: rt('1_agreement_and_service_overview_511c6782'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>{rt('1_1_parties_d2bf79cd')}</strong>{' '}
|
||||
{rt('these_terms_of_service_the_agreement_govern_1e6754fc')}
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('1_2_read_carefully_dfde346e')}</strong>{' '}
|
||||
{rt('this_system_is_a_general_purpose_full_f1d395fe')}
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('1_3_agreement_contents_f05cebc0')}</strong>{' '}
|
||||
{rt('the_agreement_includes_these_terms_and_any_43e244b6')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'service-definition',
|
||||
title: rt('2_service_definition_and_nature_61db87f8'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>危害国家安全:</strong>
|
||||
反对宪法所确定的基本原则、危害国家安全、泄露国家秘密、颠覆国家政权、破坏国家统一的;
|
||||
</li>
|
||||
<li>
|
||||
<strong>非法信息服务:</strong>黑客攻击工具、DDoS
|
||||
攻击服务、服务器爆破等其他非法信息服务平台;
|
||||
</li>
|
||||
<li>
|
||||
<strong>黄赌毒关联:</strong>
|
||||
制作、复制、发布、传播淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的;
|
||||
</li>
|
||||
<li>
|
||||
<strong>侵犯知识产权:</strong>
|
||||
销售盗版软件、盗版影视资源、非法游戏外挂、私服、黑号、社工库数据等;
|
||||
</li>
|
||||
<li>
|
||||
<strong>其他违法信息:</strong>
|
||||
涉及散布谣言、宣扬邪教/封建迷信、侮辱/诽谤他人、侵害他人合法权益的。
|
||||
<strong>{rt('your_responsibility_527cbdbf')}</strong>{' '}
|
||||
{rt('the_entity_deploying_and_operating_a_customized_047c6a8f')}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<p>
|
||||
<strong>处理规则:</strong>
|
||||
一旦发现您违反上述规定,平台运维主体有权不经通知
|
||||
<strong>
|
||||
立即永久封禁您的账号、拦截所有 AccessToken
|
||||
请求,并依法向公安机关、网安部门移交相关线索。
|
||||
</strong>
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'liability-limitation',
|
||||
title: '5. 免责声明与不可抗力',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>5.1 基础免责:</strong>
|
||||
本开发底座按“现状”(As-Is)及“现有”(As-Available)状态提供。我们不保证服务一定能满足您的特定开发需求,对服务的及时性、安全性、准确性都不作额外担保。
|
||||
</p>
|
||||
<p>
|
||||
<strong>5.2 技术服务中断:</strong>
|
||||
对于因以下不可抗力原因导致的服务中断、数据丢失或账号损坏,平台不承担赔偿责任:
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1 text-muted-foreground'>
|
||||
<li>自然灾害(台风、地震、海啸、洪水等);</li>
|
||||
<li>政府行为、网络安全法律法规调整或行政命令;</li>
|
||||
<li>电信部门线路技术故障、机房海底光缆损毁;</li>
|
||||
<li>黑客入侵、勒索病毒感染导致的数据损毁或宕机。</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'governing-law',
|
||||
title: '6. 法律适用与争议解决',
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>6.1 法律适用:</strong>
|
||||
本协议的订立、执行、解释及争议的解决均适用
|
||||
<strong>中华人民共和国法律</strong>(不包括港澳台地区冲突法)。
|
||||
</p>
|
||||
<p>
|
||||
<strong>6.2 争议解决:</strong>
|
||||
若发生任何争议或纠纷,首先应友好协商解决;协商不成的,应提交至本系统部署或运营方所在地有管辖权的人民法院管辖。
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'account-specifications',
|
||||
title: rt('3_registration_and_account_use_cfab1555'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>{rt('3_1_accounts_2631c114')}</strong>{' '}
|
||||
{rt('users_may_register_through_the_frontend_or_e527ef52')}
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('3_2_password_and_token_security_80dd80d9')}</strong>
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2'>
|
||||
<li>
|
||||
<strong>{rt('password_security_7a29e44e')}</strong>{' '}
|
||||
{rt('keep_your_account_password_secure_eb9adf10')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('api_token_security_34af066f')}</strong>{' '}
|
||||
{rt('a_personal_access_token_api_key_represents_6215b3b0')}{' '}
|
||||
<strong>
|
||||
{rt('you_are_responsible_for_data_loss_or_0c9acc88')}
|
||||
</strong>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'user-conduct',
|
||||
title: rt('4_prohibited_user_conduct_bd5628b6'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
{rt('when_using_this_system_you_must_comply_1e54356c')}{' '}
|
||||
<strong>
|
||||
{rt('the_following_activities_are_strictly_prohibited_5b57de7f')}
|
||||
</strong>
|
||||
</p>
|
||||
<div className='bg-red-500/5 border border-red-500/20 rounded-lg p-3 md:p-4 space-y-3'>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-2 text-red-600 dark:text-red-400 font-medium'>
|
||||
<li>
|
||||
<strong>{rt('endangering_national_security_4a160c4e')}</strong>{' '}
|
||||
{rt(
|
||||
'opposing_constitutional_principles_endangering_national_security_disclosing_bdfb8814',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('illegal_information_services_c97748bb')}</strong>{' '}
|
||||
{rt('hacking_tools_ddos_attack_services_server_brute_686746c4')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('pornography_gambling_and_drugs_fdb44a54')}</strong>{' '}
|
||||
{rt(
|
||||
'creating_copying_publishing_or_distributing_obscene_pornographic_ec8c0fdb',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
<strong>
|
||||
{rt('intellectual_property_infringement_cc10b950')}
|
||||
</strong>{' '}
|
||||
{rt('selling_pirated_software_or_media_illegal_game_3f0f4159')}
|
||||
</li>
|
||||
<li>
|
||||
<strong>{rt('other_unlawful_information_4085c17c')}</strong>{' '}
|
||||
{rt(
|
||||
'spreading_rumors_promoting_cults_or_superstition_insulting_a062981a',
|
||||
)}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<p>
|
||||
<strong>{rt('enforcement_9c7cfd68')}</strong>{' '}
|
||||
{rt('if_these_rules_are_violated_the_platform_86df3b18')}
|
||||
<strong>
|
||||
{rt('permanently_suspend_your_account_block_all_access_b9f04a42')}
|
||||
</strong>
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'liability-limitation',
|
||||
title: rt('5_disclaimer_and_force_majeure_be649f43'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>{rt('5_1_general_disclaimer_30d01f0d')}</strong>{' '}
|
||||
{rt('this_development_platform_is_provided_as_is_23bc2b55')}
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('5_2_service_interruptions_16558fa8')}</strong>{' '}
|
||||
{rt('the_platform_is_not_liable_for_interruptions_405b1c95')}
|
||||
</p>
|
||||
<ul className='list-disc pl-4 md:pl-5 space-y-1 text-muted-foreground'>
|
||||
<li>
|
||||
{rt(
|
||||
'natural_disasters_including_typhoons_earthquakes_tsunamis_and_1bbbfb21',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
{rt(
|
||||
'government_actions_cybersecurity_law_changes_or_administrative_2b7322f5',
|
||||
)}
|
||||
</li>
|
||||
<li>
|
||||
{rt('telecommunication_faults_or_damage_to_data_center_259a542f')}
|
||||
</li>
|
||||
<li>
|
||||
{rt('data_corruption_or_downtime_caused_by_hacking_68f2e04f')}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{
|
||||
value: 'governing-law',
|
||||
title: rt('6_governing_law_and_disputes_b9663c86'),
|
||||
content: (
|
||||
<div className='space-y-4 text-sm leading-relaxed'>
|
||||
<p>
|
||||
<strong>{rt('6_1_governing_law_ff2afc5e')}</strong>{' '}
|
||||
{rt(
|
||||
'the_formation_performance_interpretation_and_resolution_of_c1510775',
|
||||
)}
|
||||
<strong>{rt('the_laws_of_the_people_s_republic_5d5c80d6')}</strong>{' '}
|
||||
{rt('excluding_the_conflict_of_laws_rules_of_b235c4e3')}
|
||||
</p>
|
||||
<p>
|
||||
<strong>{rt('6_2_dispute_resolution_44e871de')}</strong>{' '}
|
||||
{rt('disputes_should_first_be_resolved_through_friendly_1ccf4610')}
|
||||
</p>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
];
|
||||
}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import * as React from 'react';
|
||||
import { ImageOff } from 'lucide-react';
|
||||
|
||||
@@ -23,6 +24,8 @@ export function FileImagePreview({
|
||||
fallbackClassName,
|
||||
variant = 'default',
|
||||
}: FileImagePreviewProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const [failed, setFailed] = React.useState(false);
|
||||
const src = getFileUrl(fileId, quality);
|
||||
|
||||
@@ -34,7 +37,7 @@ export function FileImagePreview({
|
||||
return (
|
||||
<div
|
||||
role='img'
|
||||
aria-label={`${alt} 加载失败`}
|
||||
aria-label={rt('failed_to_load_value0_7f5a06a3', { value0: alt })}
|
||||
className={cn(
|
||||
'flex size-full flex-col items-center justify-center gap-1 bg-muted/50 text-muted-foreground',
|
||||
fallbackClassName,
|
||||
@@ -47,7 +50,9 @@ export function FileImagePreview({
|
||||
)}
|
||||
/>
|
||||
{variant === 'default' && (
|
||||
<span className='text-[10px] leading-none'>加载失败</span>
|
||||
<span className='text-[10px] leading-none'>
|
||||
{rt('load_failed_d1d04482')}
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
|
||||
@@ -1,3 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import { useState } from 'react';
|
||||
import { toast } from 'sonner';
|
||||
import { Button } from '@/components/ui/button';
|
||||
@@ -78,11 +81,15 @@ export function ManagePage<T>({
|
||||
columns,
|
||||
renderDetail,
|
||||
emptyIcon = Layers,
|
||||
emptyDescription = '暂无数据',
|
||||
loadingDescription = '加载中',
|
||||
emptyDescription = undefined,
|
||||
loadingDescription = undefined,
|
||||
getId,
|
||||
headerExtra,
|
||||
}: ManagePageProps<T>) {
|
||||
const rt = useTranslations('runtime');
|
||||
emptyDescription ??= rt('no_data_497c8569');
|
||||
loadingDescription ??= rt('loading_d04fcbda');
|
||||
|
||||
/** 悬停状态 */
|
||||
const [hoveredItem, setHoveredItem] = useState<T | null>(null);
|
||||
const [selectedItem, setSelectedItem] = useState<T | null>(null);
|
||||
@@ -125,10 +132,11 @@ export function ManagePage<T>({
|
||||
try {
|
||||
setSaving(true);
|
||||
await onSave(selectedItem, editData);
|
||||
toast.success('保存成功');
|
||||
toast.success(rt('saved_e05ddf99'));
|
||||
} catch (error) {
|
||||
toast.error('保存失败', {
|
||||
description: error instanceof Error ? error.message : '未知错误',
|
||||
toast.error(rt('save_failed_6309a3bb'), {
|
||||
description:
|
||||
error instanceof Error ? error.message : rt('unknown_error_13a46616'),
|
||||
});
|
||||
} finally {
|
||||
setSaving(false);
|
||||
@@ -144,7 +152,7 @@ export function ManagePage<T>({
|
||||
if (!deletingItem || !onDelete) return;
|
||||
try {
|
||||
await onDelete(deletingItem);
|
||||
toast.success('删除成功');
|
||||
toast.success(rt('deleted_5223f91b'));
|
||||
setDeletingItem(null);
|
||||
// 如果删除的是当前选中的项,清除选中状态
|
||||
if (selectedItem && getId(selectedItem) === getId(deletingItem)) {
|
||||
@@ -152,8 +160,9 @@ export function ManagePage<T>({
|
||||
setEditData({});
|
||||
}
|
||||
} catch (error) {
|
||||
toast.error('删除失败', {
|
||||
description: error instanceof Error ? error.message : '未知错误',
|
||||
toast.error(rt('delete_failed_c228558c'), {
|
||||
description:
|
||||
error instanceof Error ? error.message : rt('unknown_error_13a46616'),
|
||||
});
|
||||
}
|
||||
};
|
||||
@@ -216,7 +225,9 @@ export function ManagePage<T>({
|
||||
<div className='space-y-6'>
|
||||
<div>
|
||||
<div className='mb-4'>
|
||||
<div className='font-semibold'>配置列表</div>
|
||||
<div className='font-semibold'>
|
||||
{rt('configuration_list_53052147')}
|
||||
</div>
|
||||
</div>
|
||||
{renderContent()}
|
||||
</div>
|
||||
@@ -239,18 +250,18 @@ export function ManagePage<T>({
|
||||
>
|
||||
<AlertDialogContent>
|
||||
<AlertDialogHeader>
|
||||
<AlertDialogTitle>确认删除?</AlertDialogTitle>
|
||||
<AlertDialogTitle>{rt('confirm_delete_2d61cf17')}</AlertDialogTitle>
|
||||
<AlertDialogDescription>
|
||||
此操作无法撤销。这将永久删除该配置。
|
||||
{rt('this_cannot_be_undone_this_will_permanently_8c896756')}
|
||||
</AlertDialogDescription>
|
||||
</AlertDialogHeader>
|
||||
<AlertDialogFooter>
|
||||
<AlertDialogCancel>取消</AlertDialogCancel>
|
||||
<AlertDialogCancel>{rt('cancel_2cd0f3be')}</AlertDialogCancel>
|
||||
<AlertDialogAction
|
||||
onClick={handleConfirmDelete}
|
||||
className='bg-red-600 hover:bg-red-700'
|
||||
>
|
||||
确认删除
|
||||
{rt('confirm_delete_a3ea3c17')}
|
||||
</AlertDialogAction>
|
||||
</AlertDialogFooter>
|
||||
</AlertDialogContent>
|
||||
@@ -271,13 +282,17 @@ interface ManageDetailPanelProps {
|
||||
|
||||
/** 详情面板 */
|
||||
export function ManageDetailPanel({
|
||||
title = '配置信息',
|
||||
title = undefined,
|
||||
isEmpty,
|
||||
emptyDescription = '请选择配置查看详情',
|
||||
emptyDescription = undefined,
|
||||
onSave,
|
||||
saving = false,
|
||||
children,
|
||||
}: ManageDetailPanelProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
title ??= rt('configuration_info_7f69a860');
|
||||
emptyDescription ??= rt('select_a_configuration_to_view_details_ec4949ab');
|
||||
|
||||
if (isEmpty) {
|
||||
return (
|
||||
<div className='space-y-4'>
|
||||
@@ -301,10 +316,10 @@ export function ManageDetailPanel({
|
||||
>
|
||||
{saving ? (
|
||||
<>
|
||||
<Spinner /> 更新中
|
||||
<Spinner /> {rt('updating_e1d9dd03')}
|
||||
</>
|
||||
) : (
|
||||
'更新'
|
||||
rt('update_3055a035')
|
||||
)}
|
||||
</Button>
|
||||
)}
|
||||
@@ -341,6 +356,8 @@ export function ManageTable<T>({
|
||||
onDelete?: (item: T) => void;
|
||||
getId: (item: T) => string | number;
|
||||
}) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
return (
|
||||
<div className='border border-dashed shadow-none rounded-lg overflow-hidden'>
|
||||
<ScrollArea className='w-full'>
|
||||
@@ -358,7 +375,7 @@ export function ManageTable<T>({
|
||||
))}
|
||||
{onDelete && (
|
||||
<TableHead className='whitespace-nowrap text-center w-[120px]'>
|
||||
操作
|
||||
{rt('actions_ed31fbb4')}
|
||||
</TableHead>
|
||||
)}
|
||||
</TableRow>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import * as React from 'react';
|
||||
import { useState } from 'react';
|
||||
import {
|
||||
@@ -36,9 +37,13 @@ export function PasswordDialog({
|
||||
onOpenChange,
|
||||
onConfirm,
|
||||
loading = false,
|
||||
title = '请输入密码',
|
||||
description = '为了您的账户安全,请输入6位认证密码进行验证',
|
||||
title = undefined,
|
||||
description = undefined,
|
||||
}: PasswordDialogProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
title ??= rt('enter_password_728a7b60');
|
||||
description ??= rt('for_your_account_security_please_enter_the_28fc0bbd');
|
||||
|
||||
const [password, setPassword] = useState('');
|
||||
|
||||
const handleConfirm = () => {
|
||||
@@ -92,7 +97,7 @@ export function PasswordDialog({
|
||||
disabled={loading}
|
||||
className='h-8 text-xs'
|
||||
>
|
||||
取消
|
||||
{rt('cancel_2cd0f3be')}
|
||||
</Button>
|
||||
<Button
|
||||
type='button'
|
||||
@@ -103,10 +108,10 @@ export function PasswordDialog({
|
||||
{loading ? (
|
||||
<>
|
||||
<Spinner className='mr-2 h-4 w-4' />
|
||||
验证中...
|
||||
{rt('verifying_6c128e0a')}
|
||||
</>
|
||||
) : (
|
||||
'确认'
|
||||
rt('confirm_36f33ada')
|
||||
)}
|
||||
</Button>
|
||||
</div>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import * as React from 'react';
|
||||
import { AnimatePresence, motion } from 'motion/react';
|
||||
import { useUser } from '@/contexts/user-context';
|
||||
@@ -18,13 +19,17 @@ import {
|
||||
import Link from 'next/link';
|
||||
|
||||
export function HomeMain() {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const { user } = useUser();
|
||||
const [isBannerVisible, setIsBannerVisible] = React.useState(true);
|
||||
|
||||
const quickLinks = [
|
||||
{
|
||||
title: '个人资料',
|
||||
description: '管理您的个人账户信息及个性化配置',
|
||||
title: rt('profile_b94d13a4'),
|
||||
description: rt(
|
||||
'manage_your_account_information_and_preferences_cced83b4',
|
||||
),
|
||||
icon: User,
|
||||
url: '/settings/profile',
|
||||
color: 'text-blue-500',
|
||||
@@ -32,8 +37,8 @@ export function HomeMain() {
|
||||
borderColor: 'hover:border-blue-500/30',
|
||||
},
|
||||
{
|
||||
title: '使用文档',
|
||||
description: '学习如何集成 API 及日常操作帮助指南',
|
||||
title: rt('user_guide_c83b6b0a'),
|
||||
description: rt('api_integration_and_everyday_operation_guides_281269a1'),
|
||||
icon: HelpCircle,
|
||||
url: 'https://openflare.fyrn.link/',
|
||||
color: 'text-purple-500',
|
||||
@@ -45,8 +50,10 @@ export function HomeMain() {
|
||||
|
||||
const adminLinks = [
|
||||
{
|
||||
title: '系统设置',
|
||||
description: '管理登录注册开关与认证源安全策略',
|
||||
title: rt('system_settings_68ea5dd4'),
|
||||
description: rt(
|
||||
'manage_registration_login_and_authentication_provider_security_f378ed37',
|
||||
),
|
||||
icon: Shield,
|
||||
url: '/admin/settings',
|
||||
color: 'text-amber-500',
|
||||
@@ -54,8 +61,8 @@ export function HomeMain() {
|
||||
borderColor: 'hover:border-amber-500/30',
|
||||
},
|
||||
{
|
||||
title: '全局系统配置',
|
||||
description: '动态管理平台运行时核心配置参数',
|
||||
title: rt('global_system_configuration_1eb8931e'),
|
||||
description: rt('manage_core_platform_runtime_settings_341e4182'),
|
||||
icon: ShieldCheck,
|
||||
url: '/admin/system',
|
||||
color: 'text-indigo-500',
|
||||
@@ -63,8 +70,8 @@ export function HomeMain() {
|
||||
borderColor: 'hover:border-indigo-500/30',
|
||||
},
|
||||
{
|
||||
title: '用户权限管理',
|
||||
description: '集中查询并管理系统注册用户的启用状态',
|
||||
title: rt('user_permissions_8e8b1d33'),
|
||||
description: rt('view_and_manage_registered_users_and_their_db533b7c'),
|
||||
icon: User,
|
||||
url: '/admin/users',
|
||||
color: 'text-rose-500',
|
||||
@@ -72,8 +79,10 @@ export function HomeMain() {
|
||||
borderColor: 'hover:border-rose-500/30',
|
||||
},
|
||||
{
|
||||
title: '后台任务调度',
|
||||
description: '分发与观测系统异步定时任务的执行情况',
|
||||
title: rt('background_task_scheduling_408172d1'),
|
||||
description: rt(
|
||||
'dispatch_and_monitor_background_and_scheduled_tasks_83967fc9',
|
||||
),
|
||||
icon: Layers,
|
||||
url: '/admin/tasks',
|
||||
color: 'text-teal-500',
|
||||
@@ -81,8 +90,8 @@ export function HomeMain() {
|
||||
borderColor: 'hover:border-teal-500/30',
|
||||
},
|
||||
{
|
||||
title: '系统日志',
|
||||
description: '查看异步任务执行日志与系统运行状态详情',
|
||||
title: rt('system_logs_366ada1d'),
|
||||
description: rt('view_background_task_logs_and_system_status_24fd6a7d'),
|
||||
icon: Terminal,
|
||||
url: '/admin/logs',
|
||||
color: 'text-cyan-500',
|
||||
@@ -109,8 +118,9 @@ export function HomeMain() {
|
||||
Modern Platform
|
||||
</h3>
|
||||
<p className='text-xs text-muted-foreground leading-relaxed'>
|
||||
通用的、现代化的后台管理系统脚手架,
|
||||
开箱即用、完整基建、极易扩展,助您快速构建企业级应用。
|
||||
{rt(
|
||||
'a_modern_extensible_administration_platform_with_ready_0d95c0c1',
|
||||
)}
|
||||
</p>
|
||||
<div className='flex gap-2.5'>
|
||||
<Button
|
||||
@@ -118,7 +128,7 @@ export function HomeMain() {
|
||||
className='bg-indigo-600 hover:bg-indigo-700 text-xs font-semibold px-4 shadow-sm h-7'
|
||||
asChild
|
||||
>
|
||||
<Link href='/'>开始使用</Link>
|
||||
<Link href='/'>{rt('get_started_715ee9dc')}</Link>
|
||||
</Button>
|
||||
<Button
|
||||
size='sm'
|
||||
@@ -126,7 +136,7 @@ export function HomeMain() {
|
||||
className='text-xs font-medium hover:bg-black/5 dark:hover:bg-white/5 h-7'
|
||||
onClick={() => setIsBannerVisible(false)}
|
||||
>
|
||||
隐藏提示
|
||||
{rt('hide_tip_738f4b27')}
|
||||
</Button>
|
||||
</div>
|
||||
</div>
|
||||
@@ -137,7 +147,9 @@ export function HomeMain() {
|
||||
|
||||
{/* 快捷导航 */}
|
||||
<div className='space-y-4'>
|
||||
<h2 className='text-lg font-semibold tracking-tight'>常用功能导航</h2>
|
||||
<h2 className='text-lg font-semibold tracking-tight'>
|
||||
{rt('quick_navigation_05deefcb')}
|
||||
</h2>
|
||||
<div className='grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4'>
|
||||
{quickLinks.map((link, idx) => (
|
||||
<motion.div
|
||||
@@ -179,7 +191,8 @@ export function HomeMain() {
|
||||
target='_blank'
|
||||
rel='noopener noreferrer'
|
||||
>
|
||||
立即跳转 <ArrowRight className='size-3 ml-1' />
|
||||
{rt('open_fee3b5a5')}
|
||||
<ArrowRight className='size-3 ml-1' />
|
||||
</Link>
|
||||
</Button>
|
||||
) : (
|
||||
@@ -189,7 +202,8 @@ export function HomeMain() {
|
||||
asChild
|
||||
>
|
||||
<Link href={link.url}>
|
||||
立即进入 <ArrowRight className='size-3 ml-1' />
|
||||
{rt('open_df42ebc3')}
|
||||
<ArrowRight className='size-3 ml-1' />
|
||||
</Link>
|
||||
</Button>
|
||||
)}
|
||||
@@ -205,7 +219,7 @@ export function HomeMain() {
|
||||
<div className='space-y-4 pt-2'>
|
||||
<h2 className='text-lg font-semibold tracking-tight text-rose-500 flex items-center gap-1.5'>
|
||||
<Shield className='size-5' />
|
||||
后台管理控制台
|
||||
{rt('administration_console_ceb0c289')}
|
||||
</h2>
|
||||
<div className='grid grid-cols-1 md:grid-cols-3 gap-4'>
|
||||
{adminLinks.map((link, idx) => (
|
||||
@@ -240,7 +254,8 @@ export function HomeMain() {
|
||||
asChild
|
||||
>
|
||||
<Link href={link.url}>
|
||||
立即进入 <ArrowRight className='size-3 ml-1' />
|
||||
{rt('open_df42ebc3')}
|
||||
<ArrowRight className='size-3 ml-1' />
|
||||
</Link>
|
||||
</Button>
|
||||
</div>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { useTranslations } from 'next-intl';
|
||||
import { useRef, useState } from 'react';
|
||||
import { useTheme } from 'next-themes';
|
||||
import CodeMirror from '@uiw/react-codemirror';
|
||||
@@ -39,8 +40,11 @@ export function HtmlEditorWorkspace({
|
||||
</>
|
||||
),
|
||||
showPreviewLink = true,
|
||||
previewTitle = '源站错误页实时预览',
|
||||
previewTitle = undefined,
|
||||
}: HtmlEditorWorkspaceProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
previewTitle ??= rt('live_origin_error_page_preview_a2a12823');
|
||||
|
||||
const containerRef = useRef<HTMLDivElement>(null);
|
||||
const [editorWidthPercent, setEditorWidthPercent] = useState(48);
|
||||
const { resolvedTheme } = useTheme();
|
||||
@@ -79,10 +83,14 @@ export function HtmlEditorWorkspace({
|
||||
<div className='flex items-center justify-between px-4 py-2 border-b bg-muted/40 shrink-0 gap-4 flex-wrap'>
|
||||
<div className='flex items-center gap-2 min-w-0'>
|
||||
<Terminal className='size-4 text-primary shrink-0' />
|
||||
<span className='text-xs font-semibold'>HTML 编辑器</span>
|
||||
<span className='text-xs font-semibold'>
|
||||
{rt('html_editor_19f0d7b7')}
|
||||
</span>
|
||||
<span className='text-[11px] text-muted-foreground font-mono truncate'>
|
||||
{htmlBytes} / {maxBytes} 字节
|
||||
{value.trim() === '' ? ' · 空则使用内置默认' : ''}
|
||||
{htmlBytes} / {maxBytes} {rt('bytes_f5d87a8b')}
|
||||
{value.trim() === ''
|
||||
? rt('leave_empty_for_the_built_in_default_29ffce9f')
|
||||
: ''}
|
||||
</span>
|
||||
</div>
|
||||
<div className='flex items-center gap-1.5 flex-wrap'>
|
||||
@@ -109,21 +117,21 @@ export function HtmlEditorWorkspace({
|
||||
allowMultipleSelections: false,
|
||||
indentOnInput: true,
|
||||
}}
|
||||
placeholder='留空使用内置默认模板…'
|
||||
placeholder={rt('leave_empty_to_use_the_built_in_e57252bd')}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div
|
||||
onMouseDown={handleMouseDown}
|
||||
className='w-1.5 bg-border/60 hover:bg-primary/50 cursor-col-resize transition-colors flex items-center justify-center shrink-0 select-none z-10'
|
||||
title='拖动调整宽度'
|
||||
title={rt('drag_to_resize_b5154511')}
|
||||
>
|
||||
<div className='h-8 w-1 rounded bg-muted-foreground/30' />
|
||||
</div>
|
||||
|
||||
<div className='flex-1 min-w-[200px] flex flex-col overflow-hidden bg-muted/10'>
|
||||
<div className='flex items-center justify-between px-4 py-1.5 border-b bg-muted/20 shrink-0 text-[11px] text-muted-foreground font-mono gap-2'>
|
||||
<span className='font-semibold'>实时预览</span>
|
||||
<span className='font-semibold'>{rt('live_preview_a76fdaad')}</span>
|
||||
<div className='flex items-center gap-2'>
|
||||
<span
|
||||
className={footerHint === null ? 'hidden' : 'hidden sm:inline'}
|
||||
@@ -139,7 +147,7 @@ export function HtmlEditorWorkspace({
|
||||
>
|
||||
<Link href='/error-pages/preview'>
|
||||
<Expand className='size-3' />
|
||||
预览
|
||||
{rt('preview_13d61fea')}
|
||||
</Link>
|
||||
</Button>
|
||||
) : null}
|
||||
|
||||
@@ -9,9 +9,17 @@ import {
|
||||
DropdownMenuItem,
|
||||
DropdownMenuTrigger,
|
||||
} from '@/components/ui/dropdown-menu';
|
||||
import { localeLabels, locales, type AppLocale } from '@/i18n/config';
|
||||
import { locales, type AppLocale } from '@/i18n/config';
|
||||
import { switchLocale } from '@/i18n/client';
|
||||
import { cn } from '@/lib/utils';
|
||||
import enNames from '@/messages/fragments/languages.en.json';
|
||||
import zhCNNames from '@/messages/fragments/languages.zh-CN.json';
|
||||
|
||||
// Language names always use their own locale, regardless of the active UI.
|
||||
const nativeNames: Record<AppLocale, string> = {
|
||||
en: enNames.languageNames.en,
|
||||
'zh-CN': zhCNNames.languageNames['zh-CN'],
|
||||
};
|
||||
|
||||
type LanguageSwitcherProps = {
|
||||
variant?: 'icon' | 'full';
|
||||
@@ -38,7 +46,7 @@ export function LanguageSwitcher({
|
||||
if (item !== locale) switchLocale(item);
|
||||
}}
|
||||
>
|
||||
{localeLabels[item]}
|
||||
{nativeNames[item]}
|
||||
</Button>
|
||||
))}
|
||||
</div>
|
||||
@@ -55,7 +63,7 @@ export function LanguageSwitcher({
|
||||
'size-9 text-muted-foreground hover:text-foreground',
|
||||
className,
|
||||
)}
|
||||
aria-label={localeLabels[locale]}
|
||||
aria-label={nativeNames[locale]}
|
||||
>
|
||||
<Languages className='size-[18px]' />
|
||||
</Button>
|
||||
@@ -69,7 +77,7 @@ export function LanguageSwitcher({
|
||||
}}
|
||||
className={item === locale ? 'bg-accent' : undefined}
|
||||
>
|
||||
{localeLabels[item]}
|
||||
{nativeNames[item]}
|
||||
</DropdownMenuItem>
|
||||
))}
|
||||
</DropdownMenuContent>
|
||||
|
||||
@@ -40,6 +40,8 @@ export function AuthSourceModal({
|
||||
onClose: () => void;
|
||||
onChanged: () => Promise<void>;
|
||||
}) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const t = useTranslations('settings.authSourceModal');
|
||||
const [form, setForm] = useState<AuthSourceRequest>(emptyForm);
|
||||
const [saving, setSaving] = useState(false);
|
||||
@@ -108,7 +110,7 @@ export function AuthSourceModal({
|
||||
onChange={(e) =>
|
||||
setForm((prev) => ({ ...prev, name: e.target.value }))
|
||||
}
|
||||
placeholder='例如: github'
|
||||
placeholder={rt('for_example_github_1061e2e4')}
|
||||
/>
|
||||
</div>
|
||||
<div className='space-y-2'>
|
||||
@@ -118,7 +120,7 @@ export function AuthSourceModal({
|
||||
onChange={(e) =>
|
||||
setForm((prev) => ({ ...prev, display_name: e.target.value }))
|
||||
}
|
||||
placeholder='例如: GitHub 登录'
|
||||
placeholder={rt('for_example_github_login_1e0c113c')}
|
||||
/>
|
||||
</div>
|
||||
<div className='space-y-2'>
|
||||
@@ -169,7 +171,7 @@ export function AuthSourceModal({
|
||||
onChange={(e) =>
|
||||
setForm((prev) => ({ ...prev, icon_url: e.target.value }))
|
||||
}
|
||||
placeholder='https://... 或留空'
|
||||
placeholder={rt('https_or_leave_empty_a0d86d9b')}
|
||||
/>
|
||||
</div>
|
||||
<div className='flex items-center justify-between rounded-xl border border-dashed p-3 md:col-span-2 bg-muted/10'>
|
||||
|
||||
@@ -60,6 +60,8 @@ export function OperationTab({
|
||||
configs,
|
||||
systemConfigsQuery,
|
||||
}: OperationTabProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const queryClient = useQueryClient();
|
||||
const t = useTranslations('settings.operation');
|
||||
|
||||
@@ -108,7 +110,9 @@ export function OperationTab({
|
||||
}
|
||||
const config = businessConfigs[field.key];
|
||||
if (!config) {
|
||||
throw new Error(`缺少配置项: ${field.key}`);
|
||||
throw new Error(
|
||||
rt('missing_configuration_value0_31b43fa6', { value0: field.key }),
|
||||
);
|
||||
}
|
||||
await services.adminSystemConfig.updateSystemConfig(field.key, {
|
||||
value: String(num),
|
||||
@@ -131,7 +135,9 @@ export function OperationTab({
|
||||
mutationFn: async (newValue: string) => {
|
||||
const config = configs['file_access_whitelist'];
|
||||
if (!config) {
|
||||
throw new Error('缺少配置项: file_access_whitelist');
|
||||
throw new Error(
|
||||
rt('missing_configuration_file_access_whitelist_6dd80936'),
|
||||
);
|
||||
}
|
||||
await services.adminSystemConfig.updateSystemConfig(
|
||||
'file_access_whitelist',
|
||||
|
||||
@@ -207,6 +207,8 @@ interface OtherTabProps {
|
||||
}
|
||||
|
||||
export function OtherTab({ configs }: OtherTabProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const queryClient = useQueryClient();
|
||||
const t = useTranslations('settings.other');
|
||||
const tNav = useTranslations('layout.nav');
|
||||
@@ -237,7 +239,9 @@ export function OtherTab({ configs }: OtherTabProps) {
|
||||
value: JSON.stringify(newConfig),
|
||||
description:
|
||||
currentCfg?.description ||
|
||||
'目录显示配置(JSON 字符串,格式为 {url: enabled})',
|
||||
rt.raw(
|
||||
'directory_visibility_configuration_json_string_format_url_8e3c0671',
|
||||
),
|
||||
},
|
||||
);
|
||||
},
|
||||
@@ -336,7 +340,7 @@ export function OtherTab({ configs }: OtherTabProps) {
|
||||
<div className='text-xs text-muted-foreground leading-relaxed'>
|
||||
<span className='font-semibold text-foreground'>
|
||||
{t('securityTipTitle')}
|
||||
</span>
|
||||
</span>{' '}
|
||||
{t('securityTipDesc')}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -101,6 +101,8 @@ interface SecurityTabProps {
|
||||
}
|
||||
|
||||
export function SecurityTab({ configs, systemConfigsQuery }: SecurityTabProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const queryClient = useQueryClient();
|
||||
const t = useTranslations('settings.security');
|
||||
const tCommon = useTranslations('common');
|
||||
@@ -154,7 +156,9 @@ export function SecurityTab({ configs, systemConfigsQuery }: SecurityTabProps) {
|
||||
mutationFn: async (value: string) => {
|
||||
const config = configs['login_session_ttl_hours'];
|
||||
if (!config) {
|
||||
throw new Error('缺少配置项: login_session_ttl_hours');
|
||||
throw new Error(
|
||||
rt('missing_configuration_login_session_ttl_hours_d6f433c2'),
|
||||
);
|
||||
}
|
||||
await services.adminSystemConfig.updateSystemConfig(
|
||||
'login_session_ttl_hours',
|
||||
@@ -203,7 +207,9 @@ export function SecurityTab({ configs, systemConfigsQuery }: SecurityTabProps) {
|
||||
mutationFn: async ({ key, value }: { key: string; value: boolean }) => {
|
||||
const config = configs[key];
|
||||
if (!config) {
|
||||
throw new Error(`缺少配置项: ${key}`);
|
||||
throw new Error(
|
||||
rt('missing_configuration_value0_31b43fa6', { value0: key }),
|
||||
);
|
||||
}
|
||||
await services.adminSystemConfig.updateSystemConfig(key, {
|
||||
value: value ? 'true' : 'false',
|
||||
|
||||
@@ -39,6 +39,8 @@ interface SystemTabProps {
|
||||
}
|
||||
|
||||
export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
const rt = useTranslations('runtime');
|
||||
|
||||
const queryClient = useQueryClient();
|
||||
const t = useTranslations('settings.system');
|
||||
const [serverAddress, setServerAddress] = useState('');
|
||||
@@ -75,7 +77,9 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
mutationFn: async ({ key, value }: { key: string; value: boolean }) => {
|
||||
const config = configs[key];
|
||||
if (!config) {
|
||||
throw new Error(`缺少配置项: ${key}`);
|
||||
throw new Error(
|
||||
rt('missing_configuration_value0_31b43fa6', { value0: key }),
|
||||
);
|
||||
}
|
||||
await services.adminSystemConfig.updateSystemConfig(key, {
|
||||
value: value ? 'true' : 'false',
|
||||
@@ -101,11 +105,13 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
await Promise.all([
|
||||
services.adminSystemConfig.updateSystemConfig('server_address', {
|
||||
value: serverAddress,
|
||||
description: currentAddrCfg?.description || '服务器地址',
|
||||
description:
|
||||
currentAddrCfg?.description || rt('server_address_d3716cc5'),
|
||||
}),
|
||||
services.adminSystemConfig.updateSystemConfig('site_name', {
|
||||
value: siteName,
|
||||
description: currentSiteCfg?.description || '系统平台的展示名称',
|
||||
description:
|
||||
currentSiteCfg?.description || rt('platform_display_name_4b656edf'),
|
||||
}),
|
||||
]);
|
||||
},
|
||||
@@ -249,7 +255,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
type='text'
|
||||
value={siteName}
|
||||
onChange={(e) => setSiteName(e.target.value)}
|
||||
placeholder='例如: OpenFlare'
|
||||
placeholder={rt('for_example_openflare_28e07341')}
|
||||
className='border-dashed bg-card text-xs'
|
||||
/>
|
||||
<p className='text-[11px] leading-relaxed text-muted-foreground'>
|
||||
@@ -281,7 +287,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
type='url'
|
||||
value={serverAddress}
|
||||
onChange={(e) => setServerAddress(e.target.value)}
|
||||
placeholder='例如: https://example.com'
|
||||
placeholder={rt('for_example_https_example_com_9cf31711')}
|
||||
className='border-dashed bg-card text-xs'
|
||||
/>
|
||||
<p className='text-[11px] leading-relaxed text-muted-foreground'>
|
||||
@@ -313,7 +319,9 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
</div>
|
||||
|
||||
<Switch
|
||||
aria-label='允许搜索引擎抓取与收录'
|
||||
aria-label={rt(
|
||||
'allow_search_engines_to_crawl_and_index_59eff8b5',
|
||||
)}
|
||||
checked={indexingEnabled}
|
||||
disabled={
|
||||
updateConfigMutation.isPending || systemConfigsQuery.isPending
|
||||
@@ -383,7 +391,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
type='text'
|
||||
value={smtpHost}
|
||||
onChange={(e) => setSmtpHost(e.target.value)}
|
||||
placeholder='例如: smtp.example.com'
|
||||
placeholder={rt('for_example_smtp_example_com_834569b4')}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
</div>
|
||||
@@ -397,7 +405,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
type='number'
|
||||
value={smtpPort}
|
||||
onChange={(e) => setSmtpPort(e.target.value)}
|
||||
placeholder='例如: 587 或 465'
|
||||
placeholder={rt('for_example_587_or_465_1bd015a5')}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
</div>
|
||||
@@ -414,7 +422,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
type='text'
|
||||
value={smtpUsername}
|
||||
onChange={(e) => setSmtpUsername(e.target.value)}
|
||||
placeholder='例如: sender@example.com'
|
||||
placeholder={rt('for_example_sender_example_com_1795f7c6')}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
</div>
|
||||
@@ -498,7 +506,7 @@ export function SystemTab({ configs, systemConfigsQuery }: SystemTabProps) {
|
||||
required
|
||||
value={smtpTestTo}
|
||||
onChange={(e) => setSmtpTestTo(e.target.value)}
|
||||
placeholder='例如: receiver@example.com'
|
||||
placeholder={rt('for_example_receiver_example_com_ade0ff8b')}
|
||||
className='bg-card border-dashed text-xs'
|
||||
disabled={testSmtpMutation.isPending}
|
||||
/>
|
||||
|
||||
@@ -36,9 +36,13 @@ import {
|
||||
import services from '@/lib/services';
|
||||
import type { Template } from '@/lib/services/admin/types';
|
||||
import { toast } from 'sonner';
|
||||
import { useTranslations } from 'next-intl';
|
||||
import { useLocale, useTranslations } from 'next-intl';
|
||||
import { localizeTemplateMetadata } from '@/i18n/builtin-metadata';
|
||||
|
||||
export function TemplatesManager() {
|
||||
const rt = useTranslations('runtime');
|
||||
const locale = useLocale();
|
||||
|
||||
const queryClient = useQueryClient();
|
||||
const t = useTranslations('settings.templates');
|
||||
const [modalOpen, setModalOpen] = useState(false);
|
||||
@@ -191,7 +195,13 @@ export function TemplatesManager() {
|
||||
<div className='space-y-1.5'>
|
||||
<div className='flex items-center gap-2 flex-wrap'>
|
||||
<span className='font-semibold text-sm text-foreground'>
|
||||
{tmpl.name}
|
||||
{localizeTemplateMetadata(
|
||||
tmpl.key,
|
||||
tmpl.is_system,
|
||||
'name',
|
||||
tmpl.name,
|
||||
locale,
|
||||
)}
|
||||
</span>
|
||||
<span
|
||||
className={`text-[10px] px-2 py-0.5 rounded-full border font-medium ${
|
||||
@@ -215,7 +225,13 @@ export function TemplatesManager() {
|
||||
</div>
|
||||
{tmpl.description && (
|
||||
<p className='text-xs text-muted-foreground/80 leading-relaxed max-w-xl'>
|
||||
{tmpl.description}
|
||||
{localizeTemplateMetadata(
|
||||
tmpl.key,
|
||||
tmpl.is_system,
|
||||
'description',
|
||||
tmpl.description,
|
||||
locale,
|
||||
)}
|
||||
</p>
|
||||
)}
|
||||
</div>
|
||||
@@ -226,6 +242,7 @@ export function TemplatesManager() {
|
||||
size='icon'
|
||||
className='size-8 text-muted-foreground hover:text-primary hover:bg-primary/10 rounded-lg transition-colors'
|
||||
onClick={() => handleOpenEdit(tmpl)}
|
||||
aria-label={t('editTemplate')}
|
||||
>
|
||||
<Pencil className='size-4' />
|
||||
</Button>
|
||||
@@ -238,6 +255,7 @@ export function TemplatesManager() {
|
||||
tmpl.is_system || deleteTemplateMutation.isPending
|
||||
}
|
||||
onClick={() => setDeleteTarget(tmpl)}
|
||||
aria-label={t('deleteTemplateTitle')}
|
||||
>
|
||||
<Trash2 className='size-4' />
|
||||
</Button>
|
||||
@@ -286,7 +304,7 @@ export function TemplatesManager() {
|
||||
required
|
||||
value={key}
|
||||
onChange={(e) => setKey(e.target.value)}
|
||||
placeholder='例如: login_email'
|
||||
placeholder={rt('for_example_login_email_c7212e1f')}
|
||||
className='bg-card border-dashed text-xs'
|
||||
disabled={!!selectedTemplate}
|
||||
/>
|
||||
@@ -303,9 +321,17 @@ export function TemplatesManager() {
|
||||
id='tmpl_name'
|
||||
type='text'
|
||||
required
|
||||
value={name}
|
||||
value={localizeTemplateMetadata(
|
||||
key,
|
||||
!!selectedTemplate?.is_system,
|
||||
'name',
|
||||
name,
|
||||
locale,
|
||||
)}
|
||||
onChange={(e) => setName(e.target.value)}
|
||||
placeholder='例如: 登录验证码邮件'
|
||||
placeholder={rt(
|
||||
'for_example_login_verification_email_9d28f166',
|
||||
)}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
<p className='text-[10px] text-muted-foreground leading-normal'>
|
||||
@@ -340,7 +366,9 @@ export function TemplatesManager() {
|
||||
type='text'
|
||||
value={subject}
|
||||
onChange={(e) => setSubject(e.target.value)}
|
||||
placeholder='例如: OpenFlare 登录验证码'
|
||||
placeholder={rt(
|
||||
'for_example_openflare_login_verification_code_0925e8d4',
|
||||
)}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
<p className='text-[10px] text-muted-foreground leading-normal'>
|
||||
@@ -359,9 +387,17 @@ export function TemplatesManager() {
|
||||
<Input
|
||||
id='tmpl_description'
|
||||
type='text'
|
||||
value={description}
|
||||
value={localizeTemplateMetadata(
|
||||
key,
|
||||
!!selectedTemplate?.is_system,
|
||||
'description',
|
||||
description,
|
||||
locale,
|
||||
)}
|
||||
onChange={(e) => setDescription(e.target.value)}
|
||||
placeholder='例如: 包含变量:{{.Code}},5分钟内有效'
|
||||
placeholder={rt.raw(
|
||||
'for_example_your_code_is_code_valid_44cf273f',
|
||||
)}
|
||||
className='bg-card border-dashed text-xs'
|
||||
/>
|
||||
</div>
|
||||
@@ -375,7 +411,9 @@ export function TemplatesManager() {
|
||||
required
|
||||
value={content}
|
||||
onChange={(e) => setContent(e.target.value)}
|
||||
placeholder='<h3>正文标题</h3><p>内容段落,可用变量 {{.Code}}</p>'
|
||||
placeholder={rt.raw(
|
||||
'h3_message_title_h3_p_message_content_20c91d04',
|
||||
)}
|
||||
rows={8}
|
||||
className='bg-card border-dashed text-xs font-mono'
|
||||
/>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
'use client';
|
||||
|
||||
import { getFormattingLocale } from '@/i18n/format';
|
||||
import * as React from 'react';
|
||||
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
|
||||
import {
|
||||
@@ -60,7 +61,7 @@ function getFileIcon(mimeType: string, className = 'size-10') {
|
||||
}
|
||||
|
||||
function formatDate(dateStr: string) {
|
||||
return new Date(dateStr).toLocaleString('zh-CN', {
|
||||
return new Date(dateStr).toLocaleString(getFormattingLocale(), {
|
||||
year: 'numeric',
|
||||
month: '2-digit',
|
||||
day: '2-digit',
|
||||
|
||||
Reference in New Issue
Block a user