Compare commits
63 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 49d1f706e7 | |||
| d13c3602c9 | |||
| 3755b0f873 | |||
| be4e8212ec | |||
| 0cab61af91 | |||
| 104b04064d | |||
| b6c413aad9 | |||
| 5a0a899e93 | |||
| 254bef6162 | |||
| 610b81c32d | |||
| afb0880d8e | |||
| 3b50528435 | |||
| c4b179464b | |||
| 6ea358bab5 | |||
| dede23ead9 | |||
| 2b3e91167e | |||
| 660ee0a545 | |||
| 7c8452c731 | |||
| 7beb911efb | |||
| a8db6212a1 | |||
| af807eeb53 | |||
| 70252fbd94 | |||
| c364b6d27f | |||
| 7632b9a4ef | |||
| efd29a9d63 | |||
| 48bc50e221 | |||
| da2a7391da | |||
| 9aec9d2829 | |||
| 16181e2e9d | |||
| 7d3df0ec49 | |||
| fc846fa24d | |||
| 4710166942 | |||
| 96705e965d | |||
| fc916c7c1d | |||
| ece366c4d7 | |||
| 46984c2687 | |||
| 712ed1919f | |||
| 553e055a96 | |||
| 985662cb22 | |||
| 924bcd6aa2 | |||
| 896bb0ca7d | |||
| 3d3765cdbf | |||
| 13a4a333ff | |||
| e6293ce52f | |||
| 219d6cfb4f | |||
| da5f08f8c1 | |||
| f1608c3546 | |||
| e49e8606da | |||
| d922c2c242 | |||
| 3dd1beb567 | |||
| da661d4495 | |||
| f5fd28621e | |||
| 76796613b4 | |||
| 168c160bd4 | |||
| e1ab34b7ec | |||
| 484ecd85a3 | |||
| 28d0c9ad3d | |||
| 653a144736 | |||
| 011c9211f5 | |||
| fd20ca2c52 | |||
| 38db2ae6f2 | |||
| babd0f5615 | |||
| a6125718f5 |
3
.gitignore
vendored
@@ -1,8 +1,5 @@
|
|||||||
### Custom ###
|
### Custom ###
|
||||||
|
|
||||||
# SQLite database
|
|
||||||
data/
|
|
||||||
|
|
||||||
# TanStack
|
# TanStack
|
||||||
.tanstack/
|
.tanstack/
|
||||||
|
|
||||||
|
|||||||
3
.vscode/settings.json
vendored
@@ -37,7 +37,8 @@
|
|||||||
"files.associations": {
|
"files.associations": {
|
||||||
".env": "dotenv",
|
".env": "dotenv",
|
||||||
".env.*": "dotenv",
|
".env.*": "dotenv",
|
||||||
"**/tsconfig*.json": "jsonc",
|
"**/tsconfig.json": "jsonc",
|
||||||
|
"**/tsconfig.*.json": "jsonc",
|
||||||
"**/biome.json": "jsonc",
|
"**/biome.json": "jsonc",
|
||||||
"**/opencode.json": "jsonc"
|
"**/opencode.json": "jsonc"
|
||||||
},
|
},
|
||||||
|
|||||||
242
README.md
@@ -1,242 +0,0 @@
|
|||||||
# Fullstack Starter (SQLite)
|
|
||||||
|
|
||||||
一个基于 **TanStack Start + Bun + Tauri + SQLite** 的全栈桌面应用脚手架。
|
|
||||||
|
|
||||||
包含一个完整的 **Todo List** 示例,展示了从前端到后端的完整数据流。
|
|
||||||
|
|
||||||
## 技术栈
|
|
||||||
|
|
||||||
| 层级 | 技术 |
|
|
||||||
|------|------|
|
|
||||||
| 前端框架 | React 19 + TanStack Router (文件路由) |
|
|
||||||
| 状态管理 | TanStack Query |
|
|
||||||
| 样式 | Tailwind CSS v4 |
|
|
||||||
| RPC 通信 | ORPC (类型安全,契约优先) |
|
|
||||||
| 数据库 | SQLite (Bun 内置) + Drizzle ORM |
|
|
||||||
| 桌面壳 | Tauri v2 |
|
|
||||||
| 运行时 | Bun |
|
|
||||||
| 构建 | Vite + Turbo |
|
|
||||||
|
|
||||||
## 快速开始
|
|
||||||
|
|
||||||
### 前置要求
|
|
||||||
|
|
||||||
- [Bun](https://bun.sh/) >= 1.0
|
|
||||||
- [Rust](https://www.rust-lang.org/) (仅 Tauri 桌面应用需要)
|
|
||||||
|
|
||||||
### 安装与运行
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 1. 克隆项目
|
|
||||||
git clone <your-repo-url>
|
|
||||||
cd fullstack-starter-SQLite
|
|
||||||
|
|
||||||
# 2. 安装依赖
|
|
||||||
bun install
|
|
||||||
|
|
||||||
# 3. 初始化数据库
|
|
||||||
bun run db:init
|
|
||||||
|
|
||||||
# 4. 启动开发服务器
|
|
||||||
bun run dev:vite # 仅 Web (http://localhost:3000)
|
|
||||||
bun run dev # Tauri 桌面应用 + Web
|
|
||||||
```
|
|
||||||
|
|
||||||
### 构建
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bun run build:vite # 构建 Web 版本
|
|
||||||
bun run build # 构建 Tauri 桌面安装包
|
|
||||||
```
|
|
||||||
|
|
||||||
## 项目结构
|
|
||||||
|
|
||||||
```
|
|
||||||
├── src/
|
|
||||||
│ ├── components/ # 可复用组件
|
|
||||||
│ │ ├── Error.tsx # 错误边界组件
|
|
||||||
│ │ └── NotFound.tsx # 404 页面组件
|
|
||||||
│ │
|
|
||||||
│ ├── db/ # 数据库层
|
|
||||||
│ │ ├── index.ts # 数据库连接
|
|
||||||
│ │ └── schema/ # Drizzle 表定义
|
|
||||||
│ │ ├── index.ts # Schema 导出入口
|
|
||||||
│ │ └── todo.ts # Todo 表定义
|
|
||||||
│ │
|
|
||||||
│ ├── orpc/ # RPC 层 (后端 API)
|
|
||||||
│ │ ├── contracts/ # 契约定义 (输入/输出 Schema)
|
|
||||||
│ │ │ └── todo.ts # Todo API 契约
|
|
||||||
│ │ ├── handlers/ # 业务逻辑实现
|
|
||||||
│ │ │ └── todo.ts # Todo CRUD 处理器
|
|
||||||
│ │ ├── middlewares/ # 中间件
|
|
||||||
│ │ │ └── db.ts # 数据库注入中间件
|
|
||||||
│ │ ├── contract.ts # 契约聚合
|
|
||||||
│ │ ├── router.ts # 路由聚合
|
|
||||||
│ │ ├── client.ts # 同构客户端 (SSR/CSR)
|
|
||||||
│ │ ├── server.ts # 服务端实例
|
|
||||||
│ │ └── index.ts # 导出入口
|
|
||||||
│ │
|
|
||||||
│ ├── routes/ # 页面路由 (文件路由)
|
|
||||||
│ │ ├── __root.tsx # 根布局
|
|
||||||
│ │ ├── index.tsx # 首页 (Todo List)
|
|
||||||
│ │ └── api/
|
|
||||||
│ │ └── rpc.$.ts # RPC HTTP 端点
|
|
||||||
│ │
|
|
||||||
│ ├── integrations/ # 第三方库集成
|
|
||||||
│ ├── lib/ # 工具函数
|
|
||||||
│ ├── env.ts # 环境变量验证
|
|
||||||
│ ├── router.tsx # 路由配置
|
|
||||||
│ └── styles.css # 全局样式
|
|
||||||
│
|
|
||||||
├── scripts/
|
|
||||||
│ └── init-db.ts # 数据库初始化脚本
|
|
||||||
│
|
|
||||||
├── src-tauri/ # Tauri 桌面应用配置
|
|
||||||
├── data/ # SQLite 数据库文件 (gitignore)
|
|
||||||
└── drizzle.config.ts # Drizzle 配置
|
|
||||||
```
|
|
||||||
|
|
||||||
## 开发指南
|
|
||||||
|
|
||||||
### 添加新功能的步骤
|
|
||||||
|
|
||||||
以添加一个 "Note" 功能为例:
|
|
||||||
|
|
||||||
#### 1. 定义数据库 Schema
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/db/schema/note.ts
|
|
||||||
import { sql } from 'drizzle-orm'
|
|
||||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
|
||||||
|
|
||||||
export const noteTable = sqliteTable('note', {
|
|
||||||
id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
|
|
||||||
content: text('content').notNull(),
|
|
||||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
|
||||||
.notNull()
|
|
||||||
.default(sql`(unixepoch())`),
|
|
||||||
})
|
|
||||||
```
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/db/schema/index.ts
|
|
||||||
export * from './todo.ts'
|
|
||||||
export * from './note.ts' // 添加导出
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 2. 定义 API 契约
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/orpc/contracts/note.ts
|
|
||||||
import { oc } from '@orpc/contract'
|
|
||||||
import { z } from 'zod'
|
|
||||||
|
|
||||||
export const note = {
|
|
||||||
list: oc.output(z.array(noteSchema)),
|
|
||||||
create: oc.input(z.object({ content: z.string() })).output(noteSchema),
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 3. 实现业务逻辑
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/orpc/handlers/note.ts
|
|
||||||
import { os } from '@/orpc/server'
|
|
||||||
import { dbProvider } from '@/orpc/middlewares/db'
|
|
||||||
import { noteTable } from '@/db/schema'
|
|
||||||
|
|
||||||
export const list = os.note.list
|
|
||||||
.use(dbProvider)
|
|
||||||
.handler(async ({ context }) => {
|
|
||||||
return context.db.select().from(noteTable)
|
|
||||||
})
|
|
||||||
|
|
||||||
export const create = os.note.create
|
|
||||||
.use(dbProvider)
|
|
||||||
.handler(async ({ context, input }) => {
|
|
||||||
const [note] = await context.db.insert(noteTable).values(input).returning()
|
|
||||||
return note
|
|
||||||
})
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 4. 注册到路由
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/orpc/contract.ts
|
|
||||||
import { note } from './contracts/note'
|
|
||||||
export const contract = { todo, note }
|
|
||||||
|
|
||||||
// src/orpc/router.ts
|
|
||||||
import * as note from './handlers/note'
|
|
||||||
export const router = os.router({ todo, note })
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 5. 在页面中使用
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
// src/routes/notes.tsx
|
|
||||||
import { orpc } from '@/orpc'
|
|
||||||
import { useSuspenseQuery, useMutation } from '@tanstack/react-query'
|
|
||||||
|
|
||||||
const NotesPage = () => {
|
|
||||||
const { data: notes } = useSuspenseQuery(orpc.note.list.queryOptions())
|
|
||||||
const createNote = useMutation(orpc.note.create.mutationOptions())
|
|
||||||
|
|
||||||
// ...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 常用命令
|
|
||||||
|
|
||||||
| 命令 | 说明 |
|
|
||||||
|------|------|
|
|
||||||
| `bun run dev` | 启动 Tauri + Vite 开发服务器 |
|
|
||||||
| `bun run dev:vite` | 仅启动 Vite 开发服务器 |
|
|
||||||
| `bun run build` | 完整构建 (Tauri 桌面应用) |
|
|
||||||
| `bun run build:vite` | 仅构建 Web 版本 |
|
|
||||||
| `bun run db:init` | 初始化/重置数据库 |
|
|
||||||
| `bun run db:studio` | 打开 Drizzle Studio |
|
|
||||||
| `bun run typecheck` | TypeScript 类型检查 |
|
|
||||||
| `bun run fix` | 自动修复格式和 Lint 问题 |
|
|
||||||
|
|
||||||
### 代码规范
|
|
||||||
|
|
||||||
- **格式化**: 使用 Biome,2 空格缩进,单引号
|
|
||||||
- **导入**: 使用 `@/*` 路径别名
|
|
||||||
- **组件**: 箭头函数组件
|
|
||||||
- **命名**: 文件 kebab-case,组件 PascalCase
|
|
||||||
|
|
||||||
## 核心概念
|
|
||||||
|
|
||||||
### ORPC 数据流
|
|
||||||
|
|
||||||
```
|
|
||||||
前端组件
|
|
||||||
↓ useSuspenseQuery / useMutation
|
|
||||||
ORPC 客户端 (src/orpc/client.ts)
|
|
||||||
↓ 自动选择 SSR 直调 / CSR HTTP
|
|
||||||
契约验证 (src/orpc/contracts/)
|
|
||||||
↓ 输入/输出类型安全
|
|
||||||
处理器 (src/orpc/handlers/)
|
|
||||||
↓ 业务逻辑
|
|
||||||
中间件 (src/orpc/middlewares/)
|
|
||||||
↓ 注入数据库连接
|
|
||||||
Drizzle ORM
|
|
||||||
↓ 类型安全查询
|
|
||||||
SQLite 数据库
|
|
||||||
```
|
|
||||||
|
|
||||||
### 同构渲染
|
|
||||||
|
|
||||||
- **SSR**: 服务端直接调用 router,无 HTTP 开销
|
|
||||||
- **CSR**: 客户端通过 `/api/rpc` 端点调用
|
|
||||||
|
|
||||||
### 数据库
|
|
||||||
|
|
||||||
- SQLite 文件存储在 `./data/app.db`
|
|
||||||
- 使用 WAL 模式提高并发性能
|
|
||||||
- 单例模式管理连接
|
|
||||||
|
|
||||||
## 许可证
|
|
||||||
|
|
||||||
MIT
|
|
||||||
24
apps/desktop/.gitignore
vendored
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
lerna-debug.log*
|
||||||
|
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
dist-ssr
|
||||||
|
*.local
|
||||||
|
|
||||||
|
# Editor directories and files
|
||||||
|
.vscode/*
|
||||||
|
!.vscode/extensions.json
|
||||||
|
.idea
|
||||||
|
.DS_Store
|
||||||
|
*.suo
|
||||||
|
*.ntvs*
|
||||||
|
*.njsproj
|
||||||
|
*.sln
|
||||||
|
*.sw?
|
||||||
470
apps/desktop/copy.ts
Normal file
@@ -0,0 +1,470 @@
|
|||||||
|
import * as path from 'node:path'
|
||||||
|
import { Schema } from '@effect/schema'
|
||||||
|
import { $ } from 'bun'
|
||||||
|
import { Console, Context, Data, Effect, Layer } from 'effect'
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Domain Models & Schema
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Bun 构建目标后缀
|
||||||
|
*/
|
||||||
|
const BunTargetSuffixSchema = Schema.Literal(
|
||||||
|
'windows-x64',
|
||||||
|
'darwin-arm64',
|
||||||
|
'darwin-x64',
|
||||||
|
'linux-x64',
|
||||||
|
'linux-arm64',
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tauri sidecar 目标三元组
|
||||||
|
*/
|
||||||
|
const TauriTargetSchema = Schema.Literal(
|
||||||
|
'x86_64-pc-windows-msvc',
|
||||||
|
'aarch64-apple-darwin',
|
||||||
|
'x86_64-apple-darwin',
|
||||||
|
'x86_64-unknown-linux-gnu',
|
||||||
|
'aarch64-unknown-linux-gnu',
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 目标映射配置
|
||||||
|
*/
|
||||||
|
const TargetMappingSchema = Schema.Struct({
|
||||||
|
bunSuffix: BunTargetSuffixSchema,
|
||||||
|
tauriTarget: TauriTargetSchema,
|
||||||
|
})
|
||||||
|
|
||||||
|
type TargetMapping = Schema.Schema.Type<typeof TargetMappingSchema>
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 复制配置
|
||||||
|
*/
|
||||||
|
const CopyConfigSchema = Schema.Struct({
|
||||||
|
sourceDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
|
targetDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
|
baseName: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
|
mappings: Schema.Array(TargetMappingSchema).pipe(Schema.minItems(1)),
|
||||||
|
})
|
||||||
|
|
||||||
|
type CopyConfig = Schema.Schema.Type<typeof CopyConfigSchema>
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 复制结果
|
||||||
|
*/
|
||||||
|
const CopyResultSchema = Schema.Struct({
|
||||||
|
bunSuffix: BunTargetSuffixSchema,
|
||||||
|
tauriTarget: TauriTargetSchema,
|
||||||
|
sourceFile: Schema.String,
|
||||||
|
targetFile: Schema.String,
|
||||||
|
success: Schema.Boolean,
|
||||||
|
})
|
||||||
|
|
||||||
|
type CopyResult = Schema.Schema.Type<typeof CopyResultSchema>
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Error Models
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
class ConfigError extends Data.TaggedError('ConfigError')<{
|
||||||
|
readonly message: string
|
||||||
|
readonly cause: unknown
|
||||||
|
}> {}
|
||||||
|
|
||||||
|
class FileSystemError extends Data.TaggedError('FileSystemError')<{
|
||||||
|
readonly operation: string
|
||||||
|
readonly path: string
|
||||||
|
readonly cause: unknown
|
||||||
|
}> {}
|
||||||
|
|
||||||
|
class CopyError extends Data.TaggedError('CopyError')<{
|
||||||
|
readonly source: string
|
||||||
|
readonly target: string
|
||||||
|
readonly cause: unknown
|
||||||
|
}> {}
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Services
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 配置服务
|
||||||
|
*/
|
||||||
|
class CopyConfigService extends Context.Tag('CopyConfigService')<
|
||||||
|
CopyConfigService,
|
||||||
|
CopyConfig
|
||||||
|
>() {
|
||||||
|
/**
|
||||||
|
* 从原始数据创建并验证配置
|
||||||
|
*/
|
||||||
|
static fromRaw = (raw: unknown) =>
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const decoded = yield* Schema.decodeUnknown(CopyConfigSchema)(raw)
|
||||||
|
return decoded
|
||||||
|
}).pipe(
|
||||||
|
Effect.catchAll((error) =>
|
||||||
|
Effect.fail(
|
||||||
|
new ConfigError({
|
||||||
|
message: '配置验证失败',
|
||||||
|
cause: error,
|
||||||
|
}),
|
||||||
|
),
|
||||||
|
),
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 默认配置 Layer
|
||||||
|
*/
|
||||||
|
static readonly Live = Layer.effect(
|
||||||
|
CopyConfigService,
|
||||||
|
CopyConfigService.fromRaw({
|
||||||
|
sourceDir: path.join(__dirname, '..', 'server', 'out'),
|
||||||
|
targetDir: path.join(__dirname, 'src-tauri', 'binaries'),
|
||||||
|
baseName: 'server',
|
||||||
|
mappings: [
|
||||||
|
{
|
||||||
|
bunSuffix: 'windows-x64',
|
||||||
|
tauriTarget: 'x86_64-pc-windows-msvc',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
bunSuffix: 'darwin-arm64',
|
||||||
|
tauriTarget: 'aarch64-apple-darwin',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
bunSuffix: 'darwin-x64',
|
||||||
|
tauriTarget: 'x86_64-apple-darwin',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
bunSuffix: 'linux-x64',
|
||||||
|
tauriTarget: 'x86_64-unknown-linux-gnu',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
bunSuffix: 'linux-arm64',
|
||||||
|
tauriTarget: 'aarch64-unknown-linux-gnu',
|
||||||
|
},
|
||||||
|
],
|
||||||
|
} satisfies CopyConfig),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 文件系统服务
|
||||||
|
*/
|
||||||
|
class FileSystemService extends Context.Tag('FileSystemService')<
|
||||||
|
FileSystemService,
|
||||||
|
{
|
||||||
|
readonly ensureDir: (dir: string) => Effect.Effect<void, FileSystemError>
|
||||||
|
readonly fileExists: (
|
||||||
|
filePath: string,
|
||||||
|
) => Effect.Effect<boolean, FileSystemError>
|
||||||
|
readonly dirExists: (
|
||||||
|
dirPath: string,
|
||||||
|
) => Effect.Effect<boolean, FileSystemError>
|
||||||
|
readonly copyFile: (
|
||||||
|
source: string,
|
||||||
|
target: string,
|
||||||
|
) => Effect.Effect<void, CopyError>
|
||||||
|
}
|
||||||
|
>() {
|
||||||
|
static readonly Live = Layer.succeed(FileSystemService, {
|
||||||
|
ensureDir: (dir: string) =>
|
||||||
|
Effect.tryPromise({
|
||||||
|
try: async () => {
|
||||||
|
await $`mkdir -p ${dir}`
|
||||||
|
},
|
||||||
|
catch: (cause: unknown) =>
|
||||||
|
new FileSystemError({
|
||||||
|
operation: 'ensureDir',
|
||||||
|
path: dir,
|
||||||
|
cause,
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
|
||||||
|
fileExists: (filePath: string) =>
|
||||||
|
Effect.tryPromise({
|
||||||
|
try: async () => {
|
||||||
|
const file = Bun.file(filePath)
|
||||||
|
return await file.exists()
|
||||||
|
},
|
||||||
|
catch: (cause: unknown) =>
|
||||||
|
new FileSystemError({
|
||||||
|
operation: 'fileExists',
|
||||||
|
path: filePath,
|
||||||
|
cause,
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
|
||||||
|
dirExists: (dirPath: string) =>
|
||||||
|
Effect.tryPromise({
|
||||||
|
try: async () => {
|
||||||
|
const { default: fs } = await import('node:fs/promises')
|
||||||
|
try {
|
||||||
|
const stat = await fs.stat(dirPath)
|
||||||
|
return stat.isDirectory()
|
||||||
|
} catch {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
},
|
||||||
|
catch: (cause: unknown) =>
|
||||||
|
new FileSystemError({
|
||||||
|
operation: 'dirExists',
|
||||||
|
path: dirPath,
|
||||||
|
cause,
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
|
||||||
|
copyFile: (source: string, target: string) =>
|
||||||
|
Effect.tryPromise({
|
||||||
|
try: async () => {
|
||||||
|
await $`cp ${source} ${target}`
|
||||||
|
},
|
||||||
|
catch: (cause: unknown) =>
|
||||||
|
new CopyError({
|
||||||
|
source,
|
||||||
|
target,
|
||||||
|
cause,
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 复制服务
|
||||||
|
*/
|
||||||
|
class CopyService extends Context.Tag('CopyService')<
|
||||||
|
CopyService,
|
||||||
|
{
|
||||||
|
readonly copyBinary: (
|
||||||
|
config: CopyConfig,
|
||||||
|
mapping: TargetMapping,
|
||||||
|
) => Effect.Effect<CopyResult, CopyError | FileSystemError>
|
||||||
|
readonly copyAllBinaries: (
|
||||||
|
config: CopyConfig,
|
||||||
|
) => Effect.Effect<ReadonlyArray<CopyResult>, CopyError | FileSystemError>
|
||||||
|
}
|
||||||
|
>() {
|
||||||
|
static readonly Live = Layer.effect(
|
||||||
|
CopyService,
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const fs = yield* FileSystemService
|
||||||
|
|
||||||
|
return {
|
||||||
|
copyBinary: (config: CopyConfig, mapping: TargetMapping) =>
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const { sourceDir, targetDir, baseName } = config
|
||||||
|
const { bunSuffix, tauriTarget } = mapping
|
||||||
|
|
||||||
|
// 确定文件扩展名(Windows 需要 .exe)
|
||||||
|
const ext = tauriTarget.includes('windows') ? '.exe' : ''
|
||||||
|
|
||||||
|
// 构建源文件和目标文件路径
|
||||||
|
const sourceFile = path.join(
|
||||||
|
sourceDir,
|
||||||
|
`${baseName}-${bunSuffix}${ext}`,
|
||||||
|
)
|
||||||
|
const targetFile = path.join(
|
||||||
|
targetDir,
|
||||||
|
`${baseName}-${tauriTarget}${ext}`,
|
||||||
|
)
|
||||||
|
|
||||||
|
// 检查源文件是否存在
|
||||||
|
const exists = yield* fs.fileExists(sourceFile)
|
||||||
|
if (!exists) {
|
||||||
|
yield* Console.log(`⚠️ 跳过 ${bunSuffix}: 源文件不存在`)
|
||||||
|
return {
|
||||||
|
bunSuffix,
|
||||||
|
tauriTarget,
|
||||||
|
sourceFile,
|
||||||
|
targetFile,
|
||||||
|
success: false,
|
||||||
|
} satisfies CopyResult
|
||||||
|
}
|
||||||
|
|
||||||
|
// 复制文件
|
||||||
|
yield* fs.copyFile(sourceFile, targetFile)
|
||||||
|
|
||||||
|
yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
|
||||||
|
yield* Console.log(` ${sourceFile}`)
|
||||||
|
yield* Console.log(` → ${targetFile}\n`)
|
||||||
|
|
||||||
|
return {
|
||||||
|
bunSuffix,
|
||||||
|
tauriTarget,
|
||||||
|
sourceFile,
|
||||||
|
targetFile,
|
||||||
|
success: true,
|
||||||
|
} satisfies CopyResult
|
||||||
|
}),
|
||||||
|
|
||||||
|
copyAllBinaries: (config: CopyConfig) =>
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const effects = config.mappings.map((mapping) =>
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const { sourceDir, targetDir, baseName } = config
|
||||||
|
const { bunSuffix, tauriTarget } = mapping
|
||||||
|
|
||||||
|
const ext = tauriTarget.includes('windows') ? '.exe' : ''
|
||||||
|
const sourceFile = path.join(
|
||||||
|
sourceDir,
|
||||||
|
`${baseName}-${bunSuffix}${ext}`,
|
||||||
|
)
|
||||||
|
const targetFile = path.join(
|
||||||
|
targetDir,
|
||||||
|
`${baseName}-${tauriTarget}${ext}`,
|
||||||
|
)
|
||||||
|
|
||||||
|
const exists = yield* fs.fileExists(sourceFile)
|
||||||
|
if (!exists) {
|
||||||
|
yield* Console.log(`⚠️ 跳过 ${bunSuffix}: 源文件不存在`)
|
||||||
|
return {
|
||||||
|
bunSuffix,
|
||||||
|
tauriTarget,
|
||||||
|
sourceFile,
|
||||||
|
targetFile,
|
||||||
|
success: false,
|
||||||
|
} satisfies CopyResult
|
||||||
|
}
|
||||||
|
|
||||||
|
yield* fs.copyFile(sourceFile, targetFile)
|
||||||
|
|
||||||
|
yield* Console.log(`✓ ${bunSuffix} → ${tauriTarget}`)
|
||||||
|
yield* Console.log(` ${sourceFile}`)
|
||||||
|
yield* Console.log(` → ${targetFile}\n`)
|
||||||
|
|
||||||
|
return {
|
||||||
|
bunSuffix,
|
||||||
|
tauriTarget,
|
||||||
|
sourceFile,
|
||||||
|
targetFile,
|
||||||
|
success: true,
|
||||||
|
} satisfies CopyResult
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
|
||||||
|
return yield* Effect.all(effects, { concurrency: 'unbounded' })
|
||||||
|
}),
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 报告服务
|
||||||
|
*/
|
||||||
|
class ReporterService extends Context.Tag('ReporterService')<
|
||||||
|
ReporterService,
|
||||||
|
{
|
||||||
|
readonly printSummary: (
|
||||||
|
results: ReadonlyArray<CopyResult>,
|
||||||
|
) => Effect.Effect<void>
|
||||||
|
}
|
||||||
|
>() {
|
||||||
|
static readonly Live = Layer.succeed(ReporterService, {
|
||||||
|
printSummary: (results: ReadonlyArray<CopyResult>) =>
|
||||||
|
Effect.gen(function* () {
|
||||||
|
const successful = results.filter((r) => r.success)
|
||||||
|
const failed = results.filter((r) => !r.success)
|
||||||
|
|
||||||
|
yield* Console.log('\n📦 复制摘要:')
|
||||||
|
yield* Console.log(` ✅ 成功: ${successful.length}`)
|
||||||
|
yield* Console.log(` ⚠️ 跳过: ${failed.length}`)
|
||||||
|
|
||||||
|
if (successful.length > 0) {
|
||||||
|
yield* Console.log('\n成功复制的文件:')
|
||||||
|
for (const result of successful) {
|
||||||
|
yield* Console.log(
|
||||||
|
` • ${result.bunSuffix} → ${result.tauriTarget}`,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (failed.length > 0) {
|
||||||
|
yield* Console.log('\n跳过的文件:')
|
||||||
|
for (const result of failed) {
|
||||||
|
yield* Console.log(` • ${result.bunSuffix} (源文件不存在)`)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Main Program
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
const program = Effect.gen(function* () {
|
||||||
|
const config = yield* CopyConfigService
|
||||||
|
const fs = yield* FileSystemService
|
||||||
|
const copier = yield* CopyService
|
||||||
|
const reporter = yield* ReporterService
|
||||||
|
|
||||||
|
yield* Console.log('📦 开始复制二进制文件到 Tauri sidecar 目录...\n')
|
||||||
|
|
||||||
|
// 1. 检查源目录
|
||||||
|
const sourceExists = yield* fs.dirExists(config.sourceDir)
|
||||||
|
if (!sourceExists) {
|
||||||
|
yield* Console.error(`❌ 源目录不存在: ${config.sourceDir}`)
|
||||||
|
yield* Console.log(
|
||||||
|
'💡 提示: 请先在 apps/server 中运行 bun run compile 构建服务器二进制文件',
|
||||||
|
)
|
||||||
|
return yield* Effect.fail(
|
||||||
|
new FileSystemError({
|
||||||
|
operation: 'checkSourceDir',
|
||||||
|
path: config.sourceDir,
|
||||||
|
cause: '源目录不存在',
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. 创建目标目录
|
||||||
|
yield* fs.ensureDir(config.targetDir)
|
||||||
|
yield* Console.log(`✓ 目标目录: ${config.targetDir}\n`)
|
||||||
|
|
||||||
|
// 3. 并行复制所有二进制文件
|
||||||
|
const results = yield* copier.copyAllBinaries(config)
|
||||||
|
|
||||||
|
// 4. 输出摘要
|
||||||
|
yield* reporter.printSummary(results)
|
||||||
|
|
||||||
|
return results
|
||||||
|
})
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Layer Composition
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
const MainLayer = Layer.mergeAll(
|
||||||
|
CopyConfigService.Live,
|
||||||
|
FileSystemService.Live,
|
||||||
|
CopyService.Live.pipe(Layer.provide(FileSystemService.Live)),
|
||||||
|
ReporterService.Live,
|
||||||
|
)
|
||||||
|
|
||||||
|
// ============================================================================
|
||||||
|
// Runner
|
||||||
|
// ============================================================================
|
||||||
|
|
||||||
|
const runnable = program.pipe(
|
||||||
|
Effect.provide(MainLayer),
|
||||||
|
Effect.catchTags({
|
||||||
|
ConfigError: (error) =>
|
||||||
|
Console.error(`❌ 配置错误: ${error.message}`, error.cause),
|
||||||
|
FileSystemError: (error) =>
|
||||||
|
Console.error(
|
||||||
|
`❌ 文件系统错误 [${error.operation}]: ${error.path}`,
|
||||||
|
error.cause,
|
||||||
|
),
|
||||||
|
CopyError: (error) =>
|
||||||
|
Console.error(
|
||||||
|
`❌ 复制失败: ${error.source} → ${error.target}`,
|
||||||
|
error.cause,
|
||||||
|
),
|
||||||
|
}),
|
||||||
|
Effect.tapErrorCause((cause) => Console.error('❌ 未预期的错误:', cause)),
|
||||||
|
)
|
||||||
|
|
||||||
|
Effect.runPromise(runnable).catch(() => {
|
||||||
|
process.exit(1)
|
||||||
|
})
|
||||||
19
apps/desktop/package.json
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
{
|
||||||
|
"name": "@furtherverse/desktop",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"private": true,
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"build": "bun run copy && tauri build",
|
||||||
|
"copy": "rm -rf binaries && bun --bun copy.ts",
|
||||||
|
"dev": "bun run copy && tauri dev"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@effect/schema": "catalog:",
|
||||||
|
"@furtherverse/tsconfig": "workspace:*",
|
||||||
|
"@tauri-apps/cli": "catalog:",
|
||||||
|
"@types/bun": "catalog:",
|
||||||
|
"effect": "catalog:",
|
||||||
|
"typescript": "catalog:"
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -91,7 +91,7 @@ cargo clean
|
|||||||
## 项目结构
|
## 项目结构
|
||||||
|
|
||||||
```
|
```
|
||||||
app-desktop/
|
server-desktop/
|
||||||
├── src/
|
├── src/
|
||||||
│ ├── main.rs # 入口文件 (仅调用 lib::run)
|
│ ├── main.rs # 入口文件 (仅调用 lib::run)
|
||||||
│ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态)
|
│ ├── lib.rs # 核心应用逻辑 (注册插件、命令、状态)
|
||||||
@@ -47,17 +47,6 @@ version = "1.0.100"
|
|||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
|
checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61"
|
||||||
|
|
||||||
[[package]]
|
|
||||||
name = "app-desktop"
|
|
||||||
version = "0.1.0"
|
|
||||||
dependencies = [
|
|
||||||
"serde",
|
|
||||||
"tauri",
|
|
||||||
"tauri-build",
|
|
||||||
"tauri-plugin-shell",
|
|
||||||
"tokio",
|
|
||||||
]
|
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "atk"
|
name = "atk"
|
||||||
version = "0.18.2"
|
version = "0.18.2"
|
||||||
@@ -2913,6 +2902,17 @@ dependencies = [
|
|||||||
"syn 2.0.114",
|
"syn 2.0.114",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "server-desktop"
|
||||||
|
version = "0.1.0"
|
||||||
|
dependencies = [
|
||||||
|
"serde",
|
||||||
|
"tauri",
|
||||||
|
"tauri-build",
|
||||||
|
"tauri-plugin-shell",
|
||||||
|
"tokio",
|
||||||
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "servo_arc"
|
name = "servo_arc"
|
||||||
version = "0.2.0"
|
version = "0.2.0"
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "app-desktop"
|
name = "server-desktop"
|
||||||
version = "0.1.0"
|
version = "0.1.0"
|
||||||
description = "A Tauri App"
|
description = "A Tauri App"
|
||||||
authors = ["imbytecat"]
|
authors = ["imbytecat"]
|
||||||
@@ -11,7 +11,7 @@ edition = "2021"
|
|||||||
# The `_lib` suffix may seem redundant but it is necessary
|
# The `_lib` suffix may seem redundant but it is necessary
|
||||||
# to make the lib name unique and wouldn't conflict with the bin name.
|
# to make the lib name unique and wouldn't conflict with the bin name.
|
||||||
# This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
|
# This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
|
||||||
name = "app_desktop_lib"
|
name = "server_desktop_lib"
|
||||||
crate-type = ["staticlib", "cdylib", "rlib"]
|
crate-type = ["staticlib", "cdylib", "rlib"]
|
||||||
|
|
||||||
[build-dependencies]
|
[build-dependencies]
|
||||||
|
Before Width: | Height: | Size: 3.4 KiB After Width: | Height: | Size: 3.4 KiB |
|
Before Width: | Height: | Size: 6.8 KiB After Width: | Height: | Size: 6.8 KiB |
|
Before Width: | Height: | Size: 974 B After Width: | Height: | Size: 974 B |
|
Before Width: | Height: | Size: 2.8 KiB After Width: | Height: | Size: 2.8 KiB |
|
Before Width: | Height: | Size: 3.8 KiB After Width: | Height: | Size: 3.8 KiB |
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
|
Before Width: | Height: | Size: 7.6 KiB After Width: | Height: | Size: 7.6 KiB |
|
Before Width: | Height: | Size: 903 B After Width: | Height: | Size: 903 B |
|
Before Width: | Height: | Size: 8.4 KiB After Width: | Height: | Size: 8.4 KiB |
|
Before Width: | Height: | Size: 1.3 KiB After Width: | Height: | Size: 1.3 KiB |
|
Before Width: | Height: | Size: 2.0 KiB After Width: | Height: | Size: 2.0 KiB |
|
Before Width: | Height: | Size: 2.4 KiB After Width: | Height: | Size: 2.4 KiB |
|
Before Width: | Height: | Size: 1.5 KiB After Width: | Height: | Size: 1.5 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
@@ -2,5 +2,5 @@
|
|||||||
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
|
#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
|
||||||
|
|
||||||
fn main() {
|
fn main() {
|
||||||
app_desktop_lib::run()
|
server_desktop_lib::run()
|
||||||
}
|
}
|
||||||
@@ -86,7 +86,7 @@ pub fn spawn_sidecar(app_handle: tauri::AppHandle) {
|
|||||||
// 启动 sidecar
|
// 启动 sidecar
|
||||||
let sidecar = app_handle
|
let sidecar = app_handle
|
||||||
.shell()
|
.shell()
|
||||||
.sidecar("app")
|
.sidecar("server")
|
||||||
.expect("无法找到 app")
|
.expect("无法找到 app")
|
||||||
.env("PORT", port.to_string());
|
.env("PORT", port.to_string());
|
||||||
|
|
||||||
@@ -1,8 +1,8 @@
|
|||||||
{
|
{
|
||||||
"$schema": "https://schema.tauri.app/config/2",
|
"$schema": "https://schema.tauri.app/config/2",
|
||||||
"productName": "app-desktop",
|
"productName": "server-desktop",
|
||||||
"version": "0.1.0",
|
"version": "0.1.0",
|
||||||
"identifier": "com.imbytecat.app-desktop",
|
"identifier": "com.imbytecat.server-desktop",
|
||||||
"app": {
|
"app": {
|
||||||
"withGlobalTauri": true,
|
"withGlobalTauri": true,
|
||||||
"windows": [],
|
"windows": [],
|
||||||
@@ -20,6 +20,6 @@
|
|||||||
"icons/icon.icns",
|
"icons/icon.icns",
|
||||||
"icons/icon.ico"
|
"icons/icon.ico"
|
||||||
],
|
],
|
||||||
"externalBin": ["binaries/app"]
|
"externalBin": ["binaries/server"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
4
apps/desktop/tsconfig.json
Normal file
@@ -0,0 +1,4 @@
|
|||||||
|
{
|
||||||
|
"extends": "@furtherverse/tsconfig/bun.json",
|
||||||
|
"exclude": ["node_modules", "src-tauri"]
|
||||||
|
}
|
||||||
14
apps/desktop/turbo.json
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"$schema": "../../node_modules/turbo/schema.json",
|
||||||
|
"extends": ["//"],
|
||||||
|
"tasks": {
|
||||||
|
"build": {
|
||||||
|
"dependsOn": ["@furtherverse/server#compile"],
|
||||||
|
"outputs": ["src-tauri/target/release/**"]
|
||||||
|
},
|
||||||
|
"dev": {
|
||||||
|
"dependsOn": ["@furtherverse/server#compile"],
|
||||||
|
"with": ["@furtherverse/server#dev"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -8,7 +8,7 @@
|
|||||||
- **运行时**: Bun
|
- **运行时**: Bun
|
||||||
- **语言**: TypeScript (strict mode, ESNext)
|
- **语言**: TypeScript (strict mode, ESNext)
|
||||||
- **样式**: Tailwind CSS v4
|
- **样式**: Tailwind CSS v4
|
||||||
- **数据库**: SQLite (Bun 内置) + Drizzle ORM
|
- **数据库**: PostgreSQL + Drizzle ORM
|
||||||
- **状态管理**: TanStack Query
|
- **状态管理**: TanStack Query
|
||||||
- **路由**: TanStack Router (文件路由)
|
- **路由**: TanStack Router (文件路由)
|
||||||
- **RPC**: ORPC (类型安全 RPC,契约优先)
|
- **RPC**: ORPC (类型安全 RPC,契约优先)
|
||||||
@@ -44,10 +44,9 @@ biome format --write . # 仅格式化代码
|
|||||||
|
|
||||||
### 数据库
|
### 数据库
|
||||||
```bash
|
```bash
|
||||||
bun db:init # 初始化 SQLite 数据库 (创建表)
|
|
||||||
bun db:generate # 从 schema 生成迁移文件
|
bun db:generate # 从 schema 生成迁移文件
|
||||||
bun db:migrate # 执行数据库迁移
|
bun db:migrate # 执行数据库迁移
|
||||||
bun db:studio # 打开 Drizzle Studio 数据库管理界面
|
bun db:push # 直接推送 schema 变更 (仅开发环境)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 测试
|
### 测试
|
||||||
@@ -146,25 +145,20 @@ export const Route = createFileRoute('/')({
|
|||||||
|
|
||||||
- 在 `src/db/schema/*.ts` 定义 schema
|
- 在 `src/db/schema/*.ts` 定义 schema
|
||||||
- 从 `src/db/schema/index.ts` 导出
|
- 从 `src/db/schema/index.ts` 导出
|
||||||
- 使用 `drizzle-orm/sqlite-core` 的 SQLite 类型
|
- 使用 `drizzle-orm/pg-core` 的 PostgreSQL 类型
|
||||||
- 主键使用 `crypto.randomUUID()` 生成 UUID
|
- 主键使用 `uuidv7()` (需要 PostgreSQL 扩展)
|
||||||
- 始终包含 `createdAt` 和 `updatedAt` 时间戳
|
- 始终包含 `createdAt` 和 `updatedAt` 时间戳
|
||||||
|
|
||||||
示例:
|
示例:
|
||||||
```typescript
|
```typescript
|
||||||
|
import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
|
||||||
import { sql } from 'drizzle-orm'
|
import { sql } from 'drizzle-orm'
|
||||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
|
||||||
|
|
||||||
export const myTable = sqliteTable('my_table', {
|
export const myTable = pgTable('my_table', {
|
||||||
id: text('id').primaryKey().$defaultFn(() => crypto.randomUUID()),
|
id: uuid().primaryKey().default(sql`uuidv7()`),
|
||||||
name: text('name').notNull(),
|
name: text().notNull(),
|
||||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
createdAt: timestamp({ withTimezone: true }).notNull().defaultNow(),
|
||||||
.notNull()
|
updatedAt: timestamp({ withTimezone: true }).notNull().defaultNow().$onUpdateFn(() => new Date()),
|
||||||
.default(sql`(unixepoch())`),
|
|
||||||
updatedAt: integer('updated_at', { mode: 'timestamp' })
|
|
||||||
.notNull()
|
|
||||||
.default(sql`(unixepoch())`)
|
|
||||||
.$onUpdateFn(() => new Date()),
|
|
||||||
})
|
})
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -279,5 +273,5 @@ const mutation = useMutation(orpc.myFeature.create.mutationOptions())
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**最后更新**: 2026-01-20
|
**最后更新**: 2026-01-18
|
||||||
**项目版本**: 基于 package.json 依赖版本
|
**项目版本**: 基于 package.json 依赖版本
|
||||||
7
apps/server/biome.json
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"$schema": "../../node_modules/@biomejs/biome/configuration_schema.json",
|
||||||
|
"extends": "//",
|
||||||
|
"files": {
|
||||||
|
"includes": ["**", "!**/routeTree.gen.ts"]
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -6,14 +6,6 @@ import { Console, Context, Data, Effect, Layer } from 'effect'
|
|||||||
// Domain Models & Schema
|
// Domain Models & Schema
|
||||||
// ============================================================================
|
// ============================================================================
|
||||||
|
|
||||||
const targetMap = {
|
|
||||||
'bun-windows-x64': 'x86_64-pc-windows-msvc',
|
|
||||||
'bun-darwin-arm64': 'aarch64-apple-darwin',
|
|
||||||
'bun-darwin-x64': 'x86_64-apple-darwin',
|
|
||||||
'bun-linux-x64': 'x86_64-unknown-linux-gnu',
|
|
||||||
'bun-linux-arm64': 'aarch64-unknown-linux-gnu',
|
|
||||||
} as const
|
|
||||||
|
|
||||||
const BunTargetSchema = Schema.Literal(
|
const BunTargetSchema = Schema.Literal(
|
||||||
'bun-windows-x64',
|
'bun-windows-x64',
|
||||||
'bun-darwin-arm64',
|
'bun-darwin-arm64',
|
||||||
@@ -22,11 +14,19 @@ const BunTargetSchema = Schema.Literal(
|
|||||||
'bun-linux-arm64',
|
'bun-linux-arm64',
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 bun target 转换为文件后缀 (去掉 'bun-' 前缀)
|
||||||
|
*/
|
||||||
|
const getTargetSuffix = (target: BunTarget): string => {
|
||||||
|
return target.replace('bun-', '')
|
||||||
|
}
|
||||||
|
|
||||||
type BunTarget = Schema.Schema.Type<typeof BunTargetSchema>
|
type BunTarget = Schema.Schema.Type<typeof BunTargetSchema>
|
||||||
|
|
||||||
const BuildConfigSchema = Schema.Struct({
|
const BuildConfigSchema = Schema.Struct({
|
||||||
entrypoint: Schema.String.pipe(Schema.nonEmptyString()),
|
entrypoint: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
outputDir: Schema.String.pipe(Schema.nonEmptyString()),
|
outputDir: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
|
outfile: Schema.String.pipe(Schema.nonEmptyString()),
|
||||||
targets: Schema.Array(BunTargetSchema).pipe(Schema.minItems(1)),
|
targets: Schema.Array(BunTargetSchema).pipe(Schema.minItems(1)),
|
||||||
})
|
})
|
||||||
|
|
||||||
@@ -94,10 +94,10 @@ class BuildConfigService extends Context.Tag('BuildConfigService')<
|
|||||||
BuildConfigService,
|
BuildConfigService,
|
||||||
BuildConfigService.fromRaw({
|
BuildConfigService.fromRaw({
|
||||||
entrypoint: '.output/server/index.mjs',
|
entrypoint: '.output/server/index.mjs',
|
||||||
// outputDir: 'out',
|
outputDir: 'out',
|
||||||
outputDir: 'src-tauri/binaries',
|
outfile: 'server',
|
||||||
targets: ['bun-windows-x64', 'bun-darwin-arm64', 'bun-linux-x64'],
|
targets: ['bun-windows-x64', 'bun-darwin-arm64', 'bun-linux-x64'],
|
||||||
}),
|
} satisfies BuildConfig),
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -150,7 +150,7 @@ class BuildService extends Context.Tag('BuildService')<
|
|||||||
Bun.build({
|
Bun.build({
|
||||||
entrypoints: [config.entrypoint],
|
entrypoints: [config.entrypoint],
|
||||||
compile: {
|
compile: {
|
||||||
outfile: `app-${targetMap[target]}`,
|
outfile: `${config.outfile}-${getTargetSuffix(target)}`,
|
||||||
target: target,
|
target: target,
|
||||||
},
|
},
|
||||||
outdir: config.outputDir,
|
outdir: config.outputDir,
|
||||||
@@ -181,7 +181,7 @@ class BuildService extends Context.Tag('BuildService')<
|
|||||||
Bun.build({
|
Bun.build({
|
||||||
entrypoints: [config.entrypoint],
|
entrypoints: [config.entrypoint],
|
||||||
compile: {
|
compile: {
|
||||||
outfile: `app-${targetMap[target]}`,
|
outfile: `${config.outfile}-${getTargetSuffix(target)}`,
|
||||||
target: target,
|
target: target,
|
||||||
},
|
},
|
||||||
outdir: config.outputDir,
|
outdir: config.outputDir,
|
||||||
11
apps/server/drizzle.config.ts
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
import { defineConfig } from 'drizzle-kit'
|
||||||
|
import { env } from '@/env'
|
||||||
|
|
||||||
|
export default defineConfig({
|
||||||
|
out: './drizzle',
|
||||||
|
schema: './src/server/db/schema/index.ts',
|
||||||
|
dialect: 'postgresql',
|
||||||
|
dbCredentials: {
|
||||||
|
url: env.DATABASE_URL,
|
||||||
|
},
|
||||||
|
})
|
||||||
59
apps/server/package.json
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
{
|
||||||
|
"name": "@furtherverse/server",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"private": true,
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"build": "vite build",
|
||||||
|
"compile": "bun build.ts",
|
||||||
|
"db:generate": "drizzle-kit generate",
|
||||||
|
"db:migrate": "drizzle-kit migrate",
|
||||||
|
"db:push": "drizzle-kit push",
|
||||||
|
"db:studio": "drizzle-kit studio",
|
||||||
|
"dev": "vite dev",
|
||||||
|
"fix": "biome check --write",
|
||||||
|
"typecheck": "tsc --noEmit"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@furtherverse/utils": "workspace:*",
|
||||||
|
"@orpc/client": "catalog:",
|
||||||
|
"@orpc/contract": "catalog:",
|
||||||
|
"@orpc/openapi": "catalog:",
|
||||||
|
"@orpc/server": "catalog:",
|
||||||
|
"@orpc/tanstack-query": "catalog:",
|
||||||
|
"@orpc/zod": "catalog:",
|
||||||
|
"@t3-oss/env-core": "catalog:",
|
||||||
|
"@tanstack/react-query": "catalog:",
|
||||||
|
"@tanstack/react-router": "catalog:",
|
||||||
|
"@tanstack/react-router-ssr-query": "catalog:",
|
||||||
|
"@tanstack/react-start": "catalog:",
|
||||||
|
"@tauri-apps/api": "catalog:",
|
||||||
|
"drizzle-orm": "catalog:",
|
||||||
|
"drizzle-zod": "catalog:",
|
||||||
|
"postgres": "catalog:",
|
||||||
|
"react": "catalog:",
|
||||||
|
"react-dom": "catalog:",
|
||||||
|
"uuid": "catalog:",
|
||||||
|
"zod": "catalog:"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@effect/platform": "catalog:",
|
||||||
|
"@effect/schema": "catalog:",
|
||||||
|
"@furtherverse/tsconfig": "workspace:*",
|
||||||
|
"@tailwindcss/vite": "catalog:",
|
||||||
|
"@tanstack/devtools-vite": "catalog:",
|
||||||
|
"@tanstack/react-devtools": "catalog:",
|
||||||
|
"@tanstack/react-query-devtools": "catalog:",
|
||||||
|
"@tanstack/react-router-devtools": "catalog:",
|
||||||
|
"@types/bun": "catalog:",
|
||||||
|
"@vitejs/plugin-react": "catalog:",
|
||||||
|
"babel-plugin-react-compiler": "catalog:",
|
||||||
|
"drizzle-kit": "catalog:",
|
||||||
|
"effect": "catalog:",
|
||||||
|
"nitro": "catalog:",
|
||||||
|
"tailwindcss": "catalog:",
|
||||||
|
"typescript": "catalog:",
|
||||||
|
"vite": "catalog:",
|
||||||
|
"vite-tsconfig-paths": "catalog:"
|
||||||
|
}
|
||||||
|
}
|
||||||
24
apps/server/src/client/orpc.client.ts
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
import { createORPCClient } from '@orpc/client'
|
||||||
|
import { RPCLink } from '@orpc/client/fetch'
|
||||||
|
import { createRouterClient } from '@orpc/server'
|
||||||
|
import { createIsomorphicFn } from '@tanstack/react-start'
|
||||||
|
import { getRequestHeaders } from '@tanstack/react-start/server'
|
||||||
|
import { router } from '@/server/api/routers'
|
||||||
|
import type { RouterClient } from '@/server/api/types'
|
||||||
|
|
||||||
|
const getORPCClient = createIsomorphicFn()
|
||||||
|
.server(() =>
|
||||||
|
createRouterClient(router, {
|
||||||
|
context: () => ({
|
||||||
|
headers: getRequestHeaders(),
|
||||||
|
}),
|
||||||
|
}),
|
||||||
|
)
|
||||||
|
.client(() => {
|
||||||
|
const link = new RPCLink({
|
||||||
|
url: `${window.location.origin}/api/rpc`,
|
||||||
|
})
|
||||||
|
return createORPCClient<RouterClient>(link)
|
||||||
|
})
|
||||||
|
|
||||||
|
export const orpc: RouterClient = getORPCClient()
|
||||||
30
apps/server/src/client/query-client.ts
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
import { createTanstackQueryUtils } from '@orpc/tanstack-query'
|
||||||
|
import { orpc as orpcClient } from './orpc.client'
|
||||||
|
|
||||||
|
export const orpc = createTanstackQueryUtils(orpcClient, {
|
||||||
|
experimental_defaults: {
|
||||||
|
todo: {
|
||||||
|
create: {
|
||||||
|
mutationOptions: {
|
||||||
|
onSuccess: (_, __, ___, ctx) => {
|
||||||
|
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
update: {
|
||||||
|
mutationOptions: {
|
||||||
|
onSuccess: (_, __, ___, ctx) => {
|
||||||
|
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
remove: {
|
||||||
|
mutationOptions: {
|
||||||
|
onSuccess: (_, __, ___, ctx) => {
|
||||||
|
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
@@ -2,7 +2,9 @@ import { createEnv } from '@t3-oss/env-core'
|
|||||||
import { z } from 'zod'
|
import { z } from 'zod'
|
||||||
|
|
||||||
export const env = createEnv({
|
export const env = createEnv({
|
||||||
server: {},
|
server: {
|
||||||
|
DATABASE_URL: z.url(),
|
||||||
|
},
|
||||||
clientPrefix: 'VITE_',
|
clientPrefix: 'VITE_',
|
||||||
client: {
|
client: {
|
||||||
VITE_APP_TITLE: z.string().min(1).optional(),
|
VITE_APP_TITLE: z.string().min(1).optional(),
|
||||||
@@ -10,6 +10,7 @@
|
|||||||
|
|
||||||
import { Route as rootRouteImport } from './routes/__root'
|
import { Route as rootRouteImport } from './routes/__root'
|
||||||
import { Route as IndexRouteImport } from './routes/index'
|
import { Route as IndexRouteImport } from './routes/index'
|
||||||
|
import { Route as ApiSplatRouteImport } from './routes/api/$'
|
||||||
import { Route as ApiRpcSplatRouteImport } from './routes/api/rpc.$'
|
import { Route as ApiRpcSplatRouteImport } from './routes/api/rpc.$'
|
||||||
|
|
||||||
const IndexRoute = IndexRouteImport.update({
|
const IndexRoute = IndexRouteImport.update({
|
||||||
@@ -17,6 +18,11 @@ const IndexRoute = IndexRouteImport.update({
|
|||||||
path: '/',
|
path: '/',
|
||||||
getParentRoute: () => rootRouteImport,
|
getParentRoute: () => rootRouteImport,
|
||||||
} as any)
|
} as any)
|
||||||
|
const ApiSplatRoute = ApiSplatRouteImport.update({
|
||||||
|
id: '/api/$',
|
||||||
|
path: '/api/$',
|
||||||
|
getParentRoute: () => rootRouteImport,
|
||||||
|
} as any)
|
||||||
const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
|
const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
|
||||||
id: '/api/rpc/$',
|
id: '/api/rpc/$',
|
||||||
path: '/api/rpc/$',
|
path: '/api/rpc/$',
|
||||||
@@ -25,27 +31,31 @@ const ApiRpcSplatRoute = ApiRpcSplatRouteImport.update({
|
|||||||
|
|
||||||
export interface FileRoutesByFullPath {
|
export interface FileRoutesByFullPath {
|
||||||
'/': typeof IndexRoute
|
'/': typeof IndexRoute
|
||||||
|
'/api/$': typeof ApiSplatRoute
|
||||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||||
}
|
}
|
||||||
export interface FileRoutesByTo {
|
export interface FileRoutesByTo {
|
||||||
'/': typeof IndexRoute
|
'/': typeof IndexRoute
|
||||||
|
'/api/$': typeof ApiSplatRoute
|
||||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||||
}
|
}
|
||||||
export interface FileRoutesById {
|
export interface FileRoutesById {
|
||||||
__root__: typeof rootRouteImport
|
__root__: typeof rootRouteImport
|
||||||
'/': typeof IndexRoute
|
'/': typeof IndexRoute
|
||||||
|
'/api/$': typeof ApiSplatRoute
|
||||||
'/api/rpc/$': typeof ApiRpcSplatRoute
|
'/api/rpc/$': typeof ApiRpcSplatRoute
|
||||||
}
|
}
|
||||||
export interface FileRouteTypes {
|
export interface FileRouteTypes {
|
||||||
fileRoutesByFullPath: FileRoutesByFullPath
|
fileRoutesByFullPath: FileRoutesByFullPath
|
||||||
fullPaths: '/' | '/api/rpc/$'
|
fullPaths: '/' | '/api/$' | '/api/rpc/$'
|
||||||
fileRoutesByTo: FileRoutesByTo
|
fileRoutesByTo: FileRoutesByTo
|
||||||
to: '/' | '/api/rpc/$'
|
to: '/' | '/api/$' | '/api/rpc/$'
|
||||||
id: '__root__' | '/' | '/api/rpc/$'
|
id: '__root__' | '/' | '/api/$' | '/api/rpc/$'
|
||||||
fileRoutesById: FileRoutesById
|
fileRoutesById: FileRoutesById
|
||||||
}
|
}
|
||||||
export interface RootRouteChildren {
|
export interface RootRouteChildren {
|
||||||
IndexRoute: typeof IndexRoute
|
IndexRoute: typeof IndexRoute
|
||||||
|
ApiSplatRoute: typeof ApiSplatRoute
|
||||||
ApiRpcSplatRoute: typeof ApiRpcSplatRoute
|
ApiRpcSplatRoute: typeof ApiRpcSplatRoute
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -58,6 +68,13 @@ declare module '@tanstack/react-router' {
|
|||||||
preLoaderRoute: typeof IndexRouteImport
|
preLoaderRoute: typeof IndexRouteImport
|
||||||
parentRoute: typeof rootRouteImport
|
parentRoute: typeof rootRouteImport
|
||||||
}
|
}
|
||||||
|
'/api/$': {
|
||||||
|
id: '/api/$'
|
||||||
|
path: '/api/$'
|
||||||
|
fullPath: '/api/$'
|
||||||
|
preLoaderRoute: typeof ApiSplatRouteImport
|
||||||
|
parentRoute: typeof rootRouteImport
|
||||||
|
}
|
||||||
'/api/rpc/$': {
|
'/api/rpc/$': {
|
||||||
id: '/api/rpc/$'
|
id: '/api/rpc/$'
|
||||||
path: '/api/rpc/$'
|
path: '/api/rpc/$'
|
||||||
@@ -70,6 +87,7 @@ declare module '@tanstack/react-router' {
|
|||||||
|
|
||||||
const rootRouteChildren: RootRouteChildren = {
|
const rootRouteChildren: RootRouteChildren = {
|
||||||
IndexRoute: IndexRoute,
|
IndexRoute: IndexRoute,
|
||||||
|
ApiSplatRoute: ApiSplatRoute,
|
||||||
ApiRpcSplatRoute: ApiRpcSplatRoute,
|
ApiRpcSplatRoute: ApiRpcSplatRoute,
|
||||||
}
|
}
|
||||||
export const routeTree = rootRouteImport
|
export const routeTree = rootRouteImport
|
||||||
@@ -1,15 +1,15 @@
|
|||||||
import { TanStackDevtools } from '@tanstack/react-devtools'
|
import { TanStackDevtools } from '@tanstack/react-devtools'
|
||||||
import type { QueryClient } from '@tanstack/react-query'
|
import type { QueryClient } from '@tanstack/react-query'
|
||||||
|
import { ReactQueryDevtoolsPanel } from '@tanstack/react-query-devtools'
|
||||||
import {
|
import {
|
||||||
createRootRouteWithContext,
|
createRootRouteWithContext,
|
||||||
HeadContent,
|
HeadContent,
|
||||||
Scripts,
|
Scripts,
|
||||||
} from '@tanstack/react-router'
|
} from '@tanstack/react-router'
|
||||||
|
import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
|
||||||
import type { ReactNode } from 'react'
|
import type { ReactNode } from 'react'
|
||||||
import { ErrorComponent } from '@/components/Error'
|
import { ErrorComponent } from '@/components/Error'
|
||||||
import { NotFoundComponent } from '@/components/NotFount'
|
import { NotFoundComponent } from '@/components/NotFount'
|
||||||
import { devtools as queryDevtools } from '@/integrations/tanstack-query'
|
|
||||||
import { devtools as routerDevtools } from '@/integrations/tanstack-router'
|
|
||||||
import appCss from '@/styles.css?url'
|
import appCss from '@/styles.css?url'
|
||||||
|
|
||||||
export interface RouterContext {
|
export interface RouterContext {
|
||||||
@@ -27,7 +27,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
|
|||||||
content: 'width=device-width, initial-scale=1',
|
content: 'width=device-width, initial-scale=1',
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
title: 'Fullstack Starter',
|
title: 'Furtherverse',
|
||||||
},
|
},
|
||||||
],
|
],
|
||||||
links: [
|
links: [
|
||||||
@@ -54,7 +54,16 @@ function RootDocument({ children }: Readonly<{ children: ReactNode }>) {
|
|||||||
config={{
|
config={{
|
||||||
position: 'bottom-right',
|
position: 'bottom-right',
|
||||||
}}
|
}}
|
||||||
plugins={[routerDevtools, queryDevtools]}
|
plugins={[
|
||||||
|
{
|
||||||
|
name: 'TanStack Router',
|
||||||
|
render: <TanStackRouterDevtoolsPanel />,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'TanStack Query',
|
||||||
|
render: <ReactQueryDevtoolsPanel />,
|
||||||
|
},
|
||||||
|
]}
|
||||||
/>
|
/>
|
||||||
<Scripts />
|
<Scripts />
|
||||||
</body>
|
</body>
|
||||||
86
apps/server/src/routes/api/$.ts
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
import { OpenAPIHandler } from '@orpc/openapi/fetch'
|
||||||
|
import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
|
||||||
|
import { ORPCError, onError, ValidationError } from '@orpc/server'
|
||||||
|
import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
|
||||||
|
import { createFileRoute } from '@tanstack/react-router'
|
||||||
|
import { z } from 'zod'
|
||||||
|
import { name, version } from '@/../package.json'
|
||||||
|
import { router } from '@/server/api/routers'
|
||||||
|
|
||||||
|
const handler = new OpenAPIHandler(router, {
|
||||||
|
plugins: [
|
||||||
|
new OpenAPIReferencePlugin({
|
||||||
|
docsProvider: 'scalar',
|
||||||
|
schemaConverters: [new ZodToJsonSchemaConverter()],
|
||||||
|
specGenerateOptions: {
|
||||||
|
info: {
|
||||||
|
title: name,
|
||||||
|
version,
|
||||||
|
},
|
||||||
|
// components: {
|
||||||
|
// securitySchemes: {
|
||||||
|
// bearerAuth: {
|
||||||
|
// type: 'http',
|
||||||
|
// scheme: 'bearer',
|
||||||
|
// },
|
||||||
|
// },
|
||||||
|
// },
|
||||||
|
},
|
||||||
|
docsPath: '/docs',
|
||||||
|
specPath: '/spec.json',
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
interceptors: [
|
||||||
|
onError((error) => {
|
||||||
|
console.error(error)
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
clientInterceptors: [
|
||||||
|
onError((error) => {
|
||||||
|
if (
|
||||||
|
error instanceof ORPCError &&
|
||||||
|
error.code === 'BAD_REQUEST' &&
|
||||||
|
error.cause instanceof ValidationError
|
||||||
|
) {
|
||||||
|
// If you only use Zod you can safely cast to ZodIssue[]
|
||||||
|
const zodError = new z.ZodError(
|
||||||
|
error.cause.issues as z.core.$ZodIssue[],
|
||||||
|
)
|
||||||
|
|
||||||
|
throw new ORPCError('INPUT_VALIDATION_FAILED', {
|
||||||
|
status: 422,
|
||||||
|
message: z.prettifyError(zodError),
|
||||||
|
data: z.flattenError(zodError),
|
||||||
|
cause: error.cause,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if (
|
||||||
|
error instanceof ORPCError &&
|
||||||
|
error.code === 'INTERNAL_SERVER_ERROR' &&
|
||||||
|
error.cause instanceof ValidationError
|
||||||
|
) {
|
||||||
|
throw new ORPCError('OUTPUT_VALIDATION_FAILED', {
|
||||||
|
cause: error.cause,
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
})
|
||||||
|
|
||||||
|
export const Route = createFileRoute('/api/$')({
|
||||||
|
server: {
|
||||||
|
handlers: {
|
||||||
|
ANY: async ({ request }) => {
|
||||||
|
const { response } = await handler.handle(request, {
|
||||||
|
prefix: '/api',
|
||||||
|
context: {
|
||||||
|
headers: request.headers,
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
return response ?? new Response('Not Found', { status: 404 })
|
||||||
|
},
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
@@ -2,7 +2,7 @@ import { ORPCError, onError, ValidationError } from '@orpc/server'
|
|||||||
import { RPCHandler } from '@orpc/server/fetch'
|
import { RPCHandler } from '@orpc/server/fetch'
|
||||||
import { createFileRoute } from '@tanstack/react-router'
|
import { createFileRoute } from '@tanstack/react-router'
|
||||||
import { z } from 'zod'
|
import { z } from 'zod'
|
||||||
import { router } from '@/orpc/router'
|
import { router } from '@/server/api/routers'
|
||||||
|
|
||||||
const handler = new RPCHandler(router, {
|
const handler = new RPCHandler(router, {
|
||||||
interceptors: [
|
interceptors: [
|
||||||
@@ -49,7 +49,9 @@ export const Route = createFileRoute('/api/rpc/$')({
|
|||||||
ANY: async ({ request }) => {
|
ANY: async ({ request }) => {
|
||||||
const { response } = await handler.handle(request, {
|
const { response } = await handler.handle(request, {
|
||||||
prefix: '/api/rpc',
|
prefix: '/api/rpc',
|
||||||
context: {},
|
context: {
|
||||||
|
headers: request.headers,
|
||||||
|
},
|
||||||
})
|
})
|
||||||
|
|
||||||
return response ?? new Response('Not Found', { status: 404 })
|
return response ?? new Response('Not Found', { status: 404 })
|
||||||
@@ -4,7 +4,7 @@ import { isTauri } from '@tauri-apps/api/core'
|
|||||||
import { getCurrentWindow } from '@tauri-apps/api/window'
|
import { getCurrentWindow } from '@tauri-apps/api/window'
|
||||||
import type { ChangeEventHandler, FormEventHandler } from 'react'
|
import type { ChangeEventHandler, FormEventHandler } from 'react'
|
||||||
import { useEffect, useState } from 'react'
|
import { useEffect, useState } from 'react'
|
||||||
import { orpc } from '@/orpc'
|
import { orpc } from '@/client/query-client'
|
||||||
|
|
||||||
export const Route = createFileRoute('/')({
|
export const Route = createFileRoute('/')({
|
||||||
component: Todos,
|
component: Todos,
|
||||||
25
apps/server/src/server/api/context.ts
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
import type { DB } from '@/server/db'
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基础 Context - 所有请求都包含的上下文
|
||||||
|
*/
|
||||||
|
export interface BaseContext {
|
||||||
|
headers: Headers
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 数据库 Context - 通过 db middleware 扩展
|
||||||
|
*/
|
||||||
|
export interface DBContext extends BaseContext {
|
||||||
|
db: DB
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 认证 Context - 通过 auth middleware 扩展(未来使用)
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* export interface AuthContext extends DBContext {
|
||||||
|
* userId: string
|
||||||
|
* user: User
|
||||||
|
* }
|
||||||
|
*/
|
||||||
7
apps/server/src/server/api/contracts/index.ts
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
import * as todo from './todo.contract'
|
||||||
|
|
||||||
|
export const contract = {
|
||||||
|
todo,
|
||||||
|
}
|
||||||
|
|
||||||
|
export type Contract = typeof contract
|
||||||
@@ -1,9 +1,3 @@
|
|||||||
/**
|
|
||||||
* Todo API 契约
|
|
||||||
*
|
|
||||||
* 使用 ORPC 契约定义 API 的输入/输出类型。
|
|
||||||
* drizzle-zod 自动从表 schema 生成验证规则。
|
|
||||||
*/
|
|
||||||
import { oc } from '@orpc/contract'
|
import { oc } from '@orpc/contract'
|
||||||
import {
|
import {
|
||||||
createInsertSchema,
|
createInsertSchema,
|
||||||
@@ -11,36 +5,26 @@ import {
|
|||||||
createUpdateSchema,
|
createUpdateSchema,
|
||||||
} from 'drizzle-zod'
|
} from 'drizzle-zod'
|
||||||
import { z } from 'zod'
|
import { z } from 'zod'
|
||||||
import { todoTable } from '@/db/schema'
|
import { todoTable } from '@/server/db/schema'
|
||||||
|
|
||||||
/** 查询返回的完整 Todo 类型 */
|
|
||||||
const selectSchema = createSelectSchema(todoTable)
|
const selectSchema = createSelectSchema(todoTable)
|
||||||
|
|
||||||
/** 创建 Todo 时的输入类型 (排除自动生成的字段) */
|
|
||||||
const insertSchema = createInsertSchema(todoTable).omit({
|
const insertSchema = createInsertSchema(todoTable).omit({
|
||||||
id: true,
|
id: true,
|
||||||
createdAt: true,
|
createdAt: true,
|
||||||
updatedAt: true,
|
updatedAt: true,
|
||||||
})
|
})
|
||||||
|
|
||||||
/** 更新 Todo 时的输入类型 (所有字段可选) */
|
|
||||||
const updateSchema = createUpdateSchema(todoTable).omit({
|
const updateSchema = createUpdateSchema(todoTable).omit({
|
||||||
id: true,
|
id: true,
|
||||||
createdAt: true,
|
createdAt: true,
|
||||||
updatedAt: true,
|
updatedAt: true,
|
||||||
})
|
})
|
||||||
|
|
||||||
// ============================================================
|
|
||||||
// API 契约定义
|
|
||||||
// ============================================================
|
|
||||||
|
|
||||||
/** 获取所有 Todo */
|
|
||||||
export const list = oc.input(z.void()).output(z.array(selectSchema))
|
export const list = oc.input(z.void()).output(z.array(selectSchema))
|
||||||
|
|
||||||
/** 创建新 Todo */
|
|
||||||
export const create = oc.input(insertSchema).output(selectSchema)
|
export const create = oc.input(insertSchema).output(selectSchema)
|
||||||
|
|
||||||
/** 更新 Todo */
|
|
||||||
export const update = oc
|
export const update = oc
|
||||||
.input(
|
.input(
|
||||||
z.object({
|
z.object({
|
||||||
@@ -50,7 +34,6 @@ export const update = oc
|
|||||||
)
|
)
|
||||||
.output(selectSchema)
|
.output(selectSchema)
|
||||||
|
|
||||||
/** 删除 Todo */
|
|
||||||
export const remove = oc
|
export const remove = oc
|
||||||
.input(
|
.input(
|
||||||
z.object({
|
z.object({
|
||||||
11
apps/server/src/server/api/middlewares/db.middleware.ts
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
import { os } from '@orpc/server'
|
||||||
|
import { getDB } from '@/server/db'
|
||||||
|
|
||||||
|
export const db = os.middleware(async ({ context, next }) => {
|
||||||
|
return next({
|
||||||
|
context: {
|
||||||
|
...context,
|
||||||
|
db: getDB(),
|
||||||
|
},
|
||||||
|
})
|
||||||
|
})
|
||||||
1
apps/server/src/server/api/middlewares/index.ts
Normal file
@@ -0,0 +1 @@
|
|||||||
|
export * from './db.middleware'
|
||||||
6
apps/server/src/server/api/routers/index.ts
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
import { os } from '../server'
|
||||||
|
import * as todo from './todo.router'
|
||||||
|
|
||||||
|
export const router = os.router({
|
||||||
|
todo,
|
||||||
|
})
|
||||||
@@ -1,36 +1,18 @@
|
|||||||
/**
|
|
||||||
* Todo API 处理器
|
|
||||||
*
|
|
||||||
* 实现 Todo CRUD 操作的业务逻辑。
|
|
||||||
* 每个处理器都使用 dbProvider 中间件获取数据库连接。
|
|
||||||
*/
|
|
||||||
import { ORPCError } from '@orpc/server'
|
import { ORPCError } from '@orpc/server'
|
||||||
import { eq } from 'drizzle-orm'
|
import { eq } from 'drizzle-orm'
|
||||||
import { todoTable } from '@/db/schema'
|
import { todoTable } from '@/server/db/schema'
|
||||||
import { dbProvider } from '@/orpc/middlewares'
|
import { db } from '../middlewares'
|
||||||
import { os } from '@/orpc/server'
|
import { os } from '../server'
|
||||||
|
|
||||||
/**
|
export const list = os.todo.list.use(db).handler(async ({ context }) => {
|
||||||
* 获取所有 Todo
|
|
||||||
*
|
|
||||||
* 按创建时间倒序排列 (最新的在前)
|
|
||||||
*/
|
|
||||||
export const list = os.todo.list
|
|
||||||
.use(dbProvider)
|
|
||||||
.handler(async ({ context }) => {
|
|
||||||
const todos = await context.db.query.todoTable.findMany({
|
const todos = await context.db.query.todoTable.findMany({
|
||||||
orderBy: (todos, { desc }) => [desc(todos.createdAt)],
|
orderBy: (todos, { desc }) => [desc(todos.createdAt)],
|
||||||
})
|
})
|
||||||
return todos
|
return todos
|
||||||
})
|
})
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建新 Todo
|
|
||||||
*
|
|
||||||
* @throws ORPCError NOT_FOUND - 创建失败时
|
|
||||||
*/
|
|
||||||
export const create = os.todo.create
|
export const create = os.todo.create
|
||||||
.use(dbProvider)
|
.use(db)
|
||||||
.handler(async ({ context, input }) => {
|
.handler(async ({ context, input }) => {
|
||||||
const [newTodo] = await context.db
|
const [newTodo] = await context.db
|
||||||
.insert(todoTable)
|
.insert(todoTable)
|
||||||
@@ -44,13 +26,8 @@ export const create = os.todo.create
|
|||||||
return newTodo
|
return newTodo
|
||||||
})
|
})
|
||||||
|
|
||||||
/**
|
|
||||||
* 更新 Todo
|
|
||||||
*
|
|
||||||
* @throws ORPCError NOT_FOUND - Todo 不存在时
|
|
||||||
*/
|
|
||||||
export const update = os.todo.update
|
export const update = os.todo.update
|
||||||
.use(dbProvider)
|
.use(db)
|
||||||
.handler(async ({ context, input }) => {
|
.handler(async ({ context, input }) => {
|
||||||
const [updatedTodo] = await context.db
|
const [updatedTodo] = await context.db
|
||||||
.update(todoTable)
|
.update(todoTable)
|
||||||
@@ -65,11 +42,8 @@ export const update = os.todo.update
|
|||||||
return updatedTodo
|
return updatedTodo
|
||||||
})
|
})
|
||||||
|
|
||||||
/**
|
|
||||||
* 删除 Todo
|
|
||||||
*/
|
|
||||||
export const remove = os.todo.remove
|
export const remove = os.todo.remove
|
||||||
.use(dbProvider)
|
.use(db)
|
||||||
.handler(async ({ context, input }) => {
|
.handler(async ({ context, input }) => {
|
||||||
await context.db.delete(todoTable).where(eq(todoTable.id, input.id))
|
await context.db.delete(todoTable).where(eq(todoTable.id, input.id))
|
||||||
})
|
})
|
||||||
5
apps/server/src/server/api/server.ts
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
import { implement } from '@orpc/server'
|
||||||
|
import type { BaseContext } from './context'
|
||||||
|
import { contract } from './contracts'
|
||||||
|
|
||||||
|
export const os = implement(contract).$context<BaseContext>()
|
||||||
@@ -3,9 +3,8 @@ import type {
|
|||||||
InferContractRouterInputs,
|
InferContractRouterInputs,
|
||||||
InferContractRouterOutputs,
|
InferContractRouterOutputs,
|
||||||
} from '@orpc/contract'
|
} from '@orpc/contract'
|
||||||
import type { contract } from './contract'
|
import type { Contract } from './contracts'
|
||||||
|
|
||||||
export type Contract = typeof contract
|
|
||||||
export type RouterClient = ContractRouterClient<Contract>
|
export type RouterClient = ContractRouterClient<Contract>
|
||||||
export type RouterInputs = InferContractRouterInputs<Contract>
|
export type RouterInputs = InferContractRouterInputs<Contract>
|
||||||
export type RouterOutputs = InferContractRouterOutputs<Contract>
|
export type RouterOutputs = InferContractRouterOutputs<Contract>
|
||||||
27
apps/server/src/server/db/index.ts
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
import { drizzle } from 'drizzle-orm/postgres-js'
|
||||||
|
import { env } from '@/env'
|
||||||
|
import * as schema from '@/server/db/schema'
|
||||||
|
|
||||||
|
export const createDB = () =>
|
||||||
|
drizzle({
|
||||||
|
connection: {
|
||||||
|
url: env.DATABASE_URL,
|
||||||
|
prepare: true,
|
||||||
|
},
|
||||||
|
schema,
|
||||||
|
})
|
||||||
|
|
||||||
|
export type DB = ReturnType<typeof createDB>
|
||||||
|
|
||||||
|
export const getDB = (() => {
|
||||||
|
let db: DB | null = null
|
||||||
|
|
||||||
|
return (singleton = true): DB => {
|
||||||
|
if (!singleton) {
|
||||||
|
return createDB()
|
||||||
|
}
|
||||||
|
|
||||||
|
db ??= createDB()
|
||||||
|
return db
|
||||||
|
}
|
||||||
|
})()
|
||||||
8
apps/server/src/server/db/schema/todo.ts
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
import { boolean, pgTable, text } from 'drizzle-orm/pg-core'
|
||||||
|
import { generatedFields } from './utils/field'
|
||||||
|
|
||||||
|
export const todoTable = pgTable('todo', {
|
||||||
|
...generatedFields,
|
||||||
|
title: text('title').notNull(),
|
||||||
|
completed: boolean('completed').notNull().default(false),
|
||||||
|
})
|
||||||
58
apps/server/src/server/db/schema/utils/field.ts
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
import { sql } from 'drizzle-orm'
|
||||||
|
import { timestamp, uuid } from 'drizzle-orm/pg-core'
|
||||||
|
import { v7 as uuidv7 } from 'uuid'
|
||||||
|
|
||||||
|
// id
|
||||||
|
|
||||||
|
export const id = (name: string) => uuid(name)
|
||||||
|
export const pk = (name: string, strategy?: 'native' | 'extension') => {
|
||||||
|
switch (strategy) {
|
||||||
|
// PG 18+
|
||||||
|
case 'native':
|
||||||
|
return id(name).primaryKey().default(sql`uuidv7()`)
|
||||||
|
|
||||||
|
// PG 13+ with extension
|
||||||
|
case 'extension':
|
||||||
|
return id(name).primaryKey().default(sql`uuid_generate_v7()`)
|
||||||
|
|
||||||
|
// Any PG version
|
||||||
|
default:
|
||||||
|
return id(name)
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => uuidv7())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// timestamp
|
||||||
|
|
||||||
|
export const createdAt = (name = 'created_at') =>
|
||||||
|
timestamp(name, { withTimezone: true }).notNull().defaultNow()
|
||||||
|
|
||||||
|
export const updatedAt = (name = 'updated_at') =>
|
||||||
|
timestamp(name, { withTimezone: true })
|
||||||
|
.notNull()
|
||||||
|
.defaultNow()
|
||||||
|
.$onUpdateFn(() => new Date())
|
||||||
|
|
||||||
|
// generated fields
|
||||||
|
|
||||||
|
export const generatedFields = {
|
||||||
|
id: pk('id'),
|
||||||
|
createdAt: createdAt('created_at'),
|
||||||
|
updatedAt: updatedAt('updated_at'),
|
||||||
|
}
|
||||||
|
|
||||||
|
// Helper to create omit keys from generatedFields
|
||||||
|
const createGeneratedFieldKeys = <T extends Record<string, unknown>>(
|
||||||
|
fields: T,
|
||||||
|
): Record<keyof T, true> => {
|
||||||
|
return Object.keys(fields).reduce(
|
||||||
|
(acc, key) => {
|
||||||
|
acc[key as keyof T] = true
|
||||||
|
return acc
|
||||||
|
},
|
||||||
|
{} as Record<keyof T, true>,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
export const generatedFieldKeys = createGeneratedFieldKeys(generatedFields)
|
||||||
9
apps/server/tsconfig.json
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
{
|
||||||
|
"extends": "@furtherverse/tsconfig/react.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"baseUrl": ".",
|
||||||
|
"paths": {
|
||||||
|
"@/*": ["./src/*"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
10
apps/server/turbo.json
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
{
|
||||||
|
"$schema": "../../node_modules/turbo/schema.json",
|
||||||
|
"extends": ["//"],
|
||||||
|
"tasks": {
|
||||||
|
"compile": {
|
||||||
|
"dependsOn": ["build"],
|
||||||
|
"outputs": ["out/**"]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -6,7 +6,6 @@
|
|||||||
"useIgnoreFile": true
|
"useIgnoreFile": true
|
||||||
},
|
},
|
||||||
"files": {
|
"files": {
|
||||||
"includes": ["**", "!**/routeTree.gen.ts"],
|
|
||||||
"ignoreUnknown": false
|
"ignoreUnknown": false
|
||||||
},
|
},
|
||||||
"formatter": {
|
"formatter": {
|
||||||
|
|||||||
2
bunfig.toml
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
[install]
|
||||||
|
publicHoistPattern = ["@types/*", "bun-types", "nitro*"]
|
||||||
@@ -1,10 +0,0 @@
|
|||||||
import { defineConfig } from 'drizzle-kit'
|
|
||||||
|
|
||||||
export default defineConfig({
|
|
||||||
out: './drizzle',
|
|
||||||
schema: './src/db/schema/index.ts',
|
|
||||||
dialect: 'sqlite',
|
|
||||||
dbCredentials: {
|
|
||||||
url: './data/app.db',
|
|
||||||
},
|
|
||||||
})
|
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
[tools]
|
[tools]
|
||||||
node = "24"
|
node = "latest"
|
||||||
bun = "1"
|
bun = "1"
|
||||||
rust = 'latest'
|
rust = 'latest'
|
||||||
|
|||||||
74
package.json
@@ -1,59 +1,65 @@
|
|||||||
{
|
{
|
||||||
"name": "fullstack-starter",
|
"name": "@furtherverse/monorepo",
|
||||||
|
"version": "1.0.0",
|
||||||
"private": true,
|
"private": true,
|
||||||
"type": "module",
|
"type": "module",
|
||||||
|
"workspaces": [
|
||||||
|
"apps/*",
|
||||||
|
"packages/*"
|
||||||
|
],
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "turbo build:tauri",
|
"build": "turbo run build",
|
||||||
"build:compile": "bun build.ts",
|
"compile": "turbo run compile",
|
||||||
"build:tauri": "tauri build",
|
"deploy": "turbo run deploy",
|
||||||
"build:vite": "vite build",
|
"dev": "turbo run dev",
|
||||||
"db:generate": "drizzle-kit generate",
|
"fix": "turbo run fix",
|
||||||
"db:init": "bun run scripts/init-db.ts",
|
"typecheck": "turbo run typecheck"
|
||||||
"db:migrate": "drizzle-kit migrate",
|
|
||||||
"db:push": "drizzle-kit push",
|
|
||||||
"db:studio": "drizzle-kit studio",
|
|
||||||
"dev": "turbo dev:tauri",
|
|
||||||
"dev:tauri": "tauri dev",
|
|
||||||
"dev:vite": "vite dev",
|
|
||||||
"fix": "biome check --write",
|
|
||||||
"typecheck": "tsc -b"
|
|
||||||
},
|
},
|
||||||
"dependencies": {
|
"devDependencies": {
|
||||||
|
"@biomejs/biome": "^2.3.11",
|
||||||
|
"turbo": "^2.7.5"
|
||||||
|
},
|
||||||
|
"catalog": {
|
||||||
|
"@biomejs/biome": "^2.3.11",
|
||||||
|
"@effect/platform": "^0.94.2",
|
||||||
|
"@effect/schema": "^0.75.5",
|
||||||
"@orpc/client": "^1.13.4",
|
"@orpc/client": "^1.13.4",
|
||||||
"@orpc/contract": "^1.13.4",
|
"@orpc/contract": "^1.13.4",
|
||||||
|
"@orpc/openapi": "^1.13.4",
|
||||||
"@orpc/server": "^1.13.4",
|
"@orpc/server": "^1.13.4",
|
||||||
"@orpc/tanstack-query": "^1.13.4",
|
"@orpc/tanstack-query": "^1.13.4",
|
||||||
"@orpc/zod": "^1.13.4",
|
"@orpc/zod": "^1.13.4",
|
||||||
"@t3-oss/env-core": "^0.13.10",
|
"@t3-oss/env-core": "^0.13.10",
|
||||||
"@tanstack/react-query": "^5.90.18",
|
|
||||||
"@tanstack/react-router": "^1.151.0",
|
|
||||||
"@tanstack/react-router-ssr-query": "^1.151.0",
|
|
||||||
"@tanstack/react-start": "^1.151.0",
|
|
||||||
"@tauri-apps/api": "^2.9.1",
|
|
||||||
"drizzle-orm": "^0.45.1",
|
|
||||||
"drizzle-zod": "^0.8.3",
|
|
||||||
"react": "^19.2.3",
|
|
||||||
"react-dom": "^19.2.3",
|
|
||||||
"zod": "^4.3.5"
|
|
||||||
},
|
|
||||||
"devDependencies": {
|
|
||||||
"@biomejs/biome": "^2.3.11",
|
|
||||||
"@tailwindcss/vite": "^4.1.18",
|
"@tailwindcss/vite": "^4.1.18",
|
||||||
"@tanstack/devtools-vite": "^0.4.1",
|
"@tanstack/devtools-vite": "^0.4.1",
|
||||||
"@tanstack/react-devtools": "^0.9.2",
|
"@tanstack/react-devtools": "^0.9.2",
|
||||||
|
"@tanstack/react-query": "^5.90.19",
|
||||||
"@tanstack/react-query-devtools": "^5.91.2",
|
"@tanstack/react-query-devtools": "^5.91.2",
|
||||||
"@tanstack/react-router-devtools": "^1.151.0",
|
"@tanstack/react-router": "^1.154.12",
|
||||||
|
"@tanstack/react-router-devtools": "^1.154.12",
|
||||||
|
"@tanstack/react-router-ssr-query": "^1.154.12",
|
||||||
|
"@tanstack/react-start": "^1.154.12",
|
||||||
|
"@tauri-apps/api": "^2.9.1",
|
||||||
"@tauri-apps/cli": "^2.9.6",
|
"@tauri-apps/cli": "^2.9.6",
|
||||||
"@types/bun": "^1.3.6",
|
"@types/bun": "^1.3.6",
|
||||||
"@vitejs/plugin-react": "^5.1.2",
|
"@vitejs/plugin-react": "^5.1.2",
|
||||||
"babel-plugin-react-compiler": "^1.0.0",
|
"babel-plugin-react-compiler": "^1.0.0",
|
||||||
"drizzle-kit": "^0.31.8",
|
"drizzle-kit": "^0.31.8",
|
||||||
"effect": "^3.19.14",
|
"drizzle-orm": "^0.45.1",
|
||||||
"nitro": "npm:nitro-nightly@latest",
|
"drizzle-zod": "^0.8.3",
|
||||||
|
"effect": "^3.19.15",
|
||||||
|
"nitro": "npm:nitro-nightly@3.0.1-20260122-201913-dfdff9e9",
|
||||||
|
"ohash": "^2.0.11",
|
||||||
|
"postgres": "^3.4.8",
|
||||||
|
"react": "^19.2.3",
|
||||||
|
"react-dom": "^19.2.3",
|
||||||
"tailwindcss": "^4.1.18",
|
"tailwindcss": "^4.1.18",
|
||||||
"turbo": "^2.7.5",
|
"turbo": "^2.7.5",
|
||||||
"typescript": "^5.9.3",
|
"typescript": "^5.9.3",
|
||||||
"vite": "^8.0.0-beta.8",
|
"uuid": "^13.0.0",
|
||||||
"vite-tsconfig-paths": "^6.0.4"
|
"systeminformation": "^5.30.5",
|
||||||
|
"vite": "^8.0.0-beta.9",
|
||||||
|
"vite-tsconfig-paths": "^6.0.4",
|
||||||
|
"zod": "^4.3.6"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
26
packages/tsconfig/base.json
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json.schemastore.org/tsconfig",
|
||||||
|
"display": "Base",
|
||||||
|
"compilerOptions": {
|
||||||
|
"target": "esnext",
|
||||||
|
"lib": ["ESNext"],
|
||||||
|
"module": "preserve",
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
|
||||||
|
"strict": true,
|
||||||
|
"noUnusedLocals": false,
|
||||||
|
"noUnusedParameters": false,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true,
|
||||||
|
"noUncheckedSideEffectImports": true,
|
||||||
|
"noUncheckedIndexedAccess": true,
|
||||||
|
"noImplicitOverride": true
|
||||||
|
},
|
||||||
|
"exclude": ["node_modules"]
|
||||||
|
}
|
||||||
8
packages/tsconfig/bun.json
Normal file
@@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json.schemastore.org/tsconfig",
|
||||||
|
"display": "Bun",
|
||||||
|
"extends": "./base.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"types": ["bun-types"]
|
||||||
|
}
|
||||||
|
}
|
||||||
11
packages/tsconfig/package.json
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
{
|
||||||
|
"name": "@furtherverse/tsconfig",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"private": true,
|
||||||
|
"type": "module",
|
||||||
|
"exports": {
|
||||||
|
"./base.json": "./base.json",
|
||||||
|
"./bun.json": "./bun.json",
|
||||||
|
"./react.json": "./react.json"
|
||||||
|
}
|
||||||
|
}
|
||||||
9
packages/tsconfig/react.json
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json.schemastore.org/tsconfig",
|
||||||
|
"display": "React",
|
||||||
|
"extends": "./base.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"lib": ["ESNext", "DOM", "DOM.Iterable"],
|
||||||
|
"jsx": "react-jsx"
|
||||||
|
}
|
||||||
|
}
|
||||||
21
packages/utils/package.json
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
{
|
||||||
|
"name": "@furtherverse/utils",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"private": true,
|
||||||
|
"type": "module",
|
||||||
|
"imports": {
|
||||||
|
"#*": "./src/*"
|
||||||
|
},
|
||||||
|
"exports": {
|
||||||
|
".": "./src/index.ts",
|
||||||
|
"./*": "./src/*.ts"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"ohash": "catalog:",
|
||||||
|
"systeminformation": "catalog:"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@furtherverse/tsconfig": "workspace:*",
|
||||||
|
"typescript": "catalog:"
|
||||||
|
}
|
||||||
|
}
|
||||||
29
packages/utils/src/fingerprint.ts
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
import { hash } from 'ohash'
|
||||||
|
import si from 'systeminformation'
|
||||||
|
|
||||||
|
async function getSystemInfo() {
|
||||||
|
const [uuid, baseboard, bios, system, diskLayout, networkInterfaces] =
|
||||||
|
await Promise.all([
|
||||||
|
si.uuid(),
|
||||||
|
si.baseboard(),
|
||||||
|
si.bios(),
|
||||||
|
si.system(),
|
||||||
|
si.diskLayout(),
|
||||||
|
si.networkInterfaces(),
|
||||||
|
])
|
||||||
|
|
||||||
|
return {
|
||||||
|
uuid,
|
||||||
|
baseboard,
|
||||||
|
bios,
|
||||||
|
system,
|
||||||
|
diskLayout,
|
||||||
|
networkInterfaces,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function getHardwareFingerprint() {
|
||||||
|
const systemInfo = await getSystemInfo()
|
||||||
|
|
||||||
|
return hash(systemInfo)
|
||||||
|
}
|
||||||
1
packages/utils/src/index.ts
Normal file
@@ -0,0 +1 @@
|
|||||||
|
export * from './fingerprint'
|
||||||
@@ -1,22 +0,0 @@
|
|||||||
import { Database } from 'bun:sqlite'
|
|
||||||
import { mkdir } from 'node:fs/promises'
|
|
||||||
|
|
||||||
// Ensure data directory exists
|
|
||||||
await mkdir('./data', { recursive: true })
|
|
||||||
|
|
||||||
const db = new Database('./data/app.db', { create: true })
|
|
||||||
db.exec('PRAGMA journal_mode = WAL;')
|
|
||||||
|
|
||||||
// Create todo table
|
|
||||||
db.exec(`
|
|
||||||
CREATE TABLE IF NOT EXISTS todo (
|
|
||||||
id TEXT PRIMARY KEY,
|
|
||||||
title TEXT NOT NULL,
|
|
||||||
completed INTEGER NOT NULL DEFAULT 0,
|
|
||||||
created_at INTEGER NOT NULL DEFAULT (unixepoch()),
|
|
||||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch())
|
|
||||||
);
|
|
||||||
`)
|
|
||||||
|
|
||||||
console.log('Database initialized successfully!')
|
|
||||||
db.close()
|
|
||||||
@@ -1,69 +0,0 @@
|
|||||||
/**
|
|
||||||
* 数据库连接模块
|
|
||||||
*
|
|
||||||
* 使用 Bun 内置的 SQLite 驱动,无需额外安装原生模块。
|
|
||||||
* 数据库文件存储在可执行文件同级的 data/app.db
|
|
||||||
*/
|
|
||||||
|
|
||||||
import { Database } from 'bun:sqlite'
|
|
||||||
import { existsSync, mkdirSync } from 'node:fs'
|
|
||||||
import { dirname, join } from 'node:path'
|
|
||||||
import { drizzle } from 'drizzle-orm/bun-sqlite'
|
|
||||||
import * as schema from '@/db/schema'
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取数据库路径
|
|
||||||
* - 在打包后的 sidecar 中,使用可执行文件所在目录
|
|
||||||
* - 在开发模式下,使用项目根目录
|
|
||||||
*/
|
|
||||||
function getDbPath(): string {
|
|
||||||
const execPath = process.execPath
|
|
||||||
const isBundled = !execPath.includes('node') && !execPath.includes('bun')
|
|
||||||
|
|
||||||
const baseDir = isBundled ? dirname(execPath) : process.cwd()
|
|
||||||
const dataDir = join(baseDir, 'data')
|
|
||||||
|
|
||||||
// 确保 data 目录存在
|
|
||||||
if (!existsSync(dataDir)) {
|
|
||||||
mkdirSync(dataDir, { recursive: true })
|
|
||||||
}
|
|
||||||
|
|
||||||
return join(dataDir, 'app.db')
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 数据库文件路径 */
|
|
||||||
const DB_PATH = getDbPath()
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 初始化数据库表结构
|
|
||||||
*/
|
|
||||||
function initTables(sqlite: Database) {
|
|
||||||
sqlite.exec(`
|
|
||||||
CREATE TABLE IF NOT EXISTS todo (
|
|
||||||
id TEXT PRIMARY KEY,
|
|
||||||
title TEXT NOT NULL,
|
|
||||||
completed INTEGER NOT NULL DEFAULT 0,
|
|
||||||
created_at INTEGER NOT NULL DEFAULT (unixepoch()),
|
|
||||||
updated_at INTEGER NOT NULL DEFAULT (unixepoch())
|
|
||||||
);
|
|
||||||
`)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建数据库连接
|
|
||||||
*
|
|
||||||
* 启用 WAL (Write-Ahead Logging) 模式以提高并发读写性能。
|
|
||||||
* 如果数据库文件不存在,会自动创建并初始化表结构。
|
|
||||||
*/
|
|
||||||
export function createDb() {
|
|
||||||
const sqlite = new Database(DB_PATH, { create: true })
|
|
||||||
sqlite.exec('PRAGMA journal_mode = WAL;')
|
|
||||||
|
|
||||||
// 自动初始化表结构
|
|
||||||
initTables(sqlite)
|
|
||||||
|
|
||||||
return drizzle(sqlite, { schema })
|
|
||||||
}
|
|
||||||
|
|
||||||
/** 数据库实例类型 */
|
|
||||||
export type Db = ReturnType<typeof createDb>
|
|
||||||
@@ -1,33 +0,0 @@
|
|||||||
/**
|
|
||||||
* Todo 表 Schema
|
|
||||||
*
|
|
||||||
* 使用 SQLite 数据类型:
|
|
||||||
* - text: 字符串类型
|
|
||||||
* - integer: 整数类型 (可配置为 boolean/timestamp 模式)
|
|
||||||
*/
|
|
||||||
import { sql } from 'drizzle-orm'
|
|
||||||
import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
|
|
||||||
|
|
||||||
export const todoTable = sqliteTable('todo', {
|
|
||||||
/** 主键 UUID */
|
|
||||||
id: text('id')
|
|
||||||
.primaryKey()
|
|
||||||
.$defaultFn(() => crypto.randomUUID()),
|
|
||||||
|
|
||||||
/** 待办事项标题 */
|
|
||||||
title: text('title').notNull(),
|
|
||||||
|
|
||||||
/** 是否已完成 (SQLite 用 0/1 表示布尔值) */
|
|
||||||
completed: integer('completed', { mode: 'boolean' }).notNull().default(false),
|
|
||||||
|
|
||||||
/** 创建时间 (Unix 时间戳) */
|
|
||||||
createdAt: integer('created_at', { mode: 'timestamp' })
|
|
||||||
.notNull()
|
|
||||||
.default(sql`(unixepoch())`),
|
|
||||||
|
|
||||||
/** 更新时间 (Unix 时间戳,自动更新) */
|
|
||||||
updatedAt: integer('updated_at', { mode: 'timestamp' })
|
|
||||||
.notNull()
|
|
||||||
.default(sql`(unixepoch())`)
|
|
||||||
.$onUpdateFn(() => new Date()),
|
|
||||||
})
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
import type { TanStackDevtoolsReactPlugin } from '@tanstack/react-devtools'
|
|
||||||
import { ReactQueryDevtoolsPanel } from '@tanstack/react-query-devtools'
|
|
||||||
|
|
||||||
export const devtools = {
|
|
||||||
name: 'TanStack Query',
|
|
||||||
render: <ReactQueryDevtoolsPanel />,
|
|
||||||
} satisfies TanStackDevtoolsReactPlugin
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
export * from './devtools'
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
import type { TanStackDevtoolsReactPlugin } from '@tanstack/react-devtools'
|
|
||||||
import { TanStackRouterDevtoolsPanel } from '@tanstack/react-router-devtools'
|
|
||||||
|
|
||||||
export const devtools = {
|
|
||||||
name: 'TanStack Router',
|
|
||||||
render: <TanStackRouterDevtoolsPanel />,
|
|
||||||
} satisfies TanStackDevtoolsReactPlugin
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
export * from './devtools'
|
|
||||||
@@ -1,84 +0,0 @@
|
|||||||
/**
|
|
||||||
* ORPC 同构客户端
|
|
||||||
*
|
|
||||||
* 根据运行环境自动选择最优调用方式:
|
|
||||||
* - SSR (服务端): 直接调用 router,无 HTTP 开销
|
|
||||||
* - CSR (客户端): 通过 /api/rpc 端点 HTTP 调用
|
|
||||||
*
|
|
||||||
* 同时配置了 TanStack Query 集成,mutation 成功后自动刷新相关查询。
|
|
||||||
*/
|
|
||||||
import { createORPCClient } from '@orpc/client'
|
|
||||||
import { RPCLink } from '@orpc/client/fetch'
|
|
||||||
import { createRouterClient } from '@orpc/server'
|
|
||||||
import { createTanstackQueryUtils } from '@orpc/tanstack-query'
|
|
||||||
import { createIsomorphicFn } from '@tanstack/react-start'
|
|
||||||
import { getRequestHeaders } from '@tanstack/react-start/server'
|
|
||||||
import { router } from './router'
|
|
||||||
import type { RouterClient } from './types'
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 创建同构 ORPC 客户端
|
|
||||||
*
|
|
||||||
* 服务端: 直接调用路由处理器
|
|
||||||
* 客户端: 通过 HTTP 调用 /api/rpc 端点
|
|
||||||
*/
|
|
||||||
const getORPCClient = createIsomorphicFn()
|
|
||||||
.server(() =>
|
|
||||||
createRouterClient(router, {
|
|
||||||
context: () => ({
|
|
||||||
headers: getRequestHeaders(),
|
|
||||||
}),
|
|
||||||
}),
|
|
||||||
)
|
|
||||||
.client(() => {
|
|
||||||
const link = new RPCLink({
|
|
||||||
url: `${window.location.origin}/api/rpc`,
|
|
||||||
})
|
|
||||||
return createORPCClient<RouterClient>(link)
|
|
||||||
})
|
|
||||||
|
|
||||||
const client: RouterClient = getORPCClient()
|
|
||||||
|
|
||||||
/**
|
|
||||||
* ORPC + TanStack Query 工具
|
|
||||||
*
|
|
||||||
* 使用方式:
|
|
||||||
* ```tsx
|
|
||||||
* // 查询
|
|
||||||
* const { data } = useSuspenseQuery(orpc.todo.list.queryOptions())
|
|
||||||
*
|
|
||||||
* // 变更
|
|
||||||
* const mutation = useMutation(orpc.todo.create.mutationOptions())
|
|
||||||
* mutation.mutate({ title: '新任务' })
|
|
||||||
* ```
|
|
||||||
*
|
|
||||||
* 配置了自动缓存失效: 创建/更新/删除操作后自动刷新列表
|
|
||||||
*/
|
|
||||||
export const orpc = createTanstackQueryUtils(client, {
|
|
||||||
// 配置 mutation 成功后自动刷新相关查询
|
|
||||||
experimental_defaults: {
|
|
||||||
todo: {
|
|
||||||
create: {
|
|
||||||
mutationOptions: {
|
|
||||||
onSuccess: (_, __, ___, ctx) => {
|
|
||||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
update: {
|
|
||||||
mutationOptions: {
|
|
||||||
onSuccess: (_, __, ___, ctx) => {
|
|
||||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
remove: {
|
|
||||||
mutationOptions: {
|
|
||||||
onSuccess: (_, __, ___, ctx) => {
|
|
||||||
ctx.client.invalidateQueries({ queryKey: orpc.todo.list.key() })
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
},
|
|
||||||
})
|
|
||||||
@@ -1,5 +0,0 @@
|
|||||||
import * as todo from './contracts/todo'
|
|
||||||
|
|
||||||
export const contract = {
|
|
||||||
todo,
|
|
||||||
}
|
|
||||||
@@ -1,2 +0,0 @@
|
|||||||
export { orpc } from './client'
|
|
||||||
export * from './types'
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
/**
|
|
||||||
* 数据库中间件
|
|
||||||
*
|
|
||||||
* 为 ORPC 处理器提供数据库连接。使用单例模式管理连接,
|
|
||||||
* 避免每次请求都创建新连接。
|
|
||||||
*/
|
|
||||||
import { os } from '@orpc/server'
|
|
||||||
import { createDb, type Db } from '@/db'
|
|
||||||
|
|
||||||
/** 全局数据库实例 (单例模式) */
|
|
||||||
let globalDb: Db | null = null
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取数据库实例
|
|
||||||
*
|
|
||||||
* 首次调用时创建连接,后续调用返回同一实例。
|
|
||||||
* 这种模式适合长时间运行的服务器进程。
|
|
||||||
*/
|
|
||||||
function getDb(): Db {
|
|
||||||
if (!globalDb) {
|
|
||||||
globalDb = createDb()
|
|
||||||
}
|
|
||||||
return globalDb
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 数据库提供者中间件
|
|
||||||
*
|
|
||||||
* 使用方式:
|
|
||||||
* ```ts
|
|
||||||
* export const list = os.todo.list
|
|
||||||
* .use(dbProvider)
|
|
||||||
* .handler(async ({ context }) => {
|
|
||||||
* // context.db 可用
|
|
||||||
* return context.db.query.todoTable.findMany()
|
|
||||||
* })
|
|
||||||
* ```
|
|
||||||
*/
|
|
||||||
export const dbProvider = os.middleware(async ({ context, next }) => {
|
|
||||||
const db = getDb()
|
|
||||||
|
|
||||||
return next({
|
|
||||||
context: {
|
|
||||||
...context,
|
|
||||||
db,
|
|
||||||
},
|
|
||||||
})
|
|
||||||
})
|
|
||||||
@@ -1 +0,0 @@
|
|||||||
export * from './db'
|
|
||||||
@@ -1,6 +0,0 @@
|
|||||||
import * as todo from './handlers/todo'
|
|
||||||
import { os } from './server'
|
|
||||||
|
|
||||||
export const router = os.router({
|
|
||||||
todo,
|
|
||||||
})
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
import { implement } from '@orpc/server'
|
|
||||||
import { contract } from './contract'
|
|
||||||
|
|
||||||
// biome-ignore lint/complexity/noBannedTypes: 暂无 context
|
|
||||||
export type ORPCContext = {}
|
|
||||||
|
|
||||||
export const os = implement(contract).$context<ORPCContext>()
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
{
|
|
||||||
"compilerOptions": {
|
|
||||||
// Environment setup & latest features
|
|
||||||
"lib": ["ESNext", "DOM", "DOM.Iterable"],
|
|
||||||
"target": "ESNext",
|
|
||||||
"module": "Preserve",
|
|
||||||
"moduleDetection": "force",
|
|
||||||
"jsx": "react-jsx",
|
|
||||||
"allowJs": true,
|
|
||||||
|
|
||||||
// Bundler mode
|
|
||||||
"moduleResolution": "bundler",
|
|
||||||
"allowImportingTsExtensions": true,
|
|
||||||
"verbatimModuleSyntax": true,
|
|
||||||
"noEmit": true,
|
|
||||||
|
|
||||||
// Best practices
|
|
||||||
"strict": true,
|
|
||||||
"skipLibCheck": true,
|
|
||||||
"noFallthroughCasesInSwitch": true,
|
|
||||||
"noUncheckedIndexedAccess": true,
|
|
||||||
"noImplicitOverride": true,
|
|
||||||
|
|
||||||
// Some stricter flags (disabled by default)
|
|
||||||
"noUnusedLocals": false,
|
|
||||||
"noUnusedParameters": false,
|
|
||||||
"noPropertyAccessFromIndexSignature": false,
|
|
||||||
|
|
||||||
"baseUrl": ".",
|
|
||||||
"paths": {
|
|
||||||
"@/*": ["./src/*"]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||