feat(deploy): production deployment setup and fixes
- Debian-based api image (bookworm-slim), docker/debian mirrors, prisma binaryTargets for openssl 3.0 - nginx: admin SPA under /admin, TLS via acme.sh (ZeroSSL) + auto-renewal cron, http->https redirect - prisma: add origin_goods.delisted migration, sync missing schema (good_image/tag_font_color/good_tags), fix users.createdAt Timestamptz - api: CORS wildcard reflection, helmet CORP cross-origin, price backfill in persistProductDetail, categoryIcon ancestor fallback, mediaByColor per-color gallery in public goods detail - admin: /admin base path (vite + router) - import-data.mjs: udt_name casting, serial sequence advance fix
This commit is contained in:
yeuimu
@@ -1,125 +1,125 @@
|
||||
---
|
||||
name: tresjs
|
||||
description: Use when building 3D scenes with TresJS (Vue Three.js) - provides TresCanvas, composables (useTres, useLoop), Cientos helpers (OrbitControls, useGLTF, Environment), and post-processing effects
|
||||
license: MIT
|
||||
---
|
||||
|
||||
# TresJS
|
||||
|
||||
Vue 3 framework for building 3D scenes with Three.js. Declarative components that wrap Three.js objects.
|
||||
|
||||
**Packages:** `@tresjs/core` (required), `@tresjs/cientos` (helpers), `@tresjs/post-processing` (effects)
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Core (required)
|
||||
pnpm add three @tresjs/core
|
||||
|
||||
# Helpers - controls, loaders, materials, staging
|
||||
pnpm add @tresjs/cientos
|
||||
|
||||
# Post-processing effects
|
||||
pnpm add @tresjs/post-processing
|
||||
```
|
||||
|
||||
## Quick Reference
|
||||
|
||||
| Working on... | Load file |
|
||||
| ---------------------------- | ---------------------- |
|
||||
| TresCanvas, useTres, useLoop | references/core.md |
|
||||
| Controls, loaders, materials | references/cientos.md |
|
||||
| Bloom, glitch, DOF effects | references/effects.md |
|
||||
| Common patterns, recipes | references/cookbook.md |
|
||||
|
||||
## Loading Files
|
||||
|
||||
**Load based on your task:**
|
||||
|
||||
- [ ] [references/core.md](references/core.md) - TresCanvas setup, composables, events, primitives
|
||||
- [ ] [references/cientos.md](references/cientos.md) - OrbitControls, useGLTF, Environment, materials
|
||||
- [ ] [references/effects.md](references/effects.md) - EffectComposer, bloom, glitch, DOF
|
||||
- [ ] [references/cookbook.md](references/cookbook.md) - Load models, camera setup, animations
|
||||
|
||||
**DO NOT load all files at once.** Load only what's relevant.
|
||||
|
||||
## Core Concepts
|
||||
|
||||
### TresCanvas
|
||||
|
||||
Root component that creates WebGL renderer and scene:
|
||||
|
||||
```vue
|
||||
<script setup lang="ts">
|
||||
import { TresCanvas } from '@tresjs/core'
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<TresCanvas shadows alpha>
|
||||
<TresPerspectiveCamera :position="[5, 5, 5]" />
|
||||
<TresMesh>
|
||||
<TresBoxGeometry />
|
||||
<TresMeshStandardMaterial color="orange" />
|
||||
</TresMesh>
|
||||
<TresAmbientLight :intensity="0.5" />
|
||||
<TresDirectionalLight :position="[3, 3, 3]" :intensity="1" />
|
||||
</TresCanvas>
|
||||
</template>
|
||||
```
|
||||
|
||||
### Component Naming
|
||||
|
||||
All Three.js classes available as Vue components with `Tres` prefix:
|
||||
|
||||
- `THREE.PerspectiveCamera` → `<TresPerspectiveCamera />`
|
||||
- `THREE.Mesh` → `<TresMesh />`
|
||||
- `THREE.BoxGeometry` → `<TresBoxGeometry />`
|
||||
- `THREE.MeshStandardMaterial` → `<TresMeshStandardMaterial />`
|
||||
|
||||
Constructor arguments via `:args` prop:
|
||||
|
||||
```vue
|
||||
<TresPerspectiveCamera :args="[75, 1, 0.1, 1000]" />
|
||||
```
|
||||
|
||||
### Reactivity
|
||||
|
||||
Props are reactive - changes update the 3D scene:
|
||||
|
||||
```vue
|
||||
<script setup>
|
||||
const color = ref('orange')
|
||||
const position = ref([0, 0, 0])
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<TresMesh :position="position">
|
||||
<TresMeshStandardMaterial :color="color" />
|
||||
</TresMesh>
|
||||
</template>
|
||||
```
|
||||
|
||||
### Primitive Component
|
||||
|
||||
Inject existing Three.js objects directly:
|
||||
|
||||
```vue
|
||||
<script setup>
|
||||
import { useGLTF } from '@tresjs/cientos'
|
||||
const { scene } = await useGLTF('/model.glb')
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<primitive :object="scene" />
|
||||
</template>
|
||||
```
|
||||
|
||||
## Available Guidance
|
||||
|
||||
**[references/core.md](references/core.md)** - TresCanvas props, useTres, useLoop, useGraph, events, performance
|
||||
|
||||
**[references/cientos.md](references/cientos.md)** - OrbitControls, useGLTF, useTexture, Environment, Sky, materials, shapes
|
||||
|
||||
**[references/effects.md](references/effects.md)** - EffectComposer vs EffectComposerPmndrs, bloom, glitch, DOF, effect stacking
|
||||
|
||||
**[references/cookbook.md](references/cookbook.md)** - Load 3D model, camera with controls, animation loop, post-processing
|
||||
---
|
||||
name: tresjs
|
||||
description: Use when building 3D scenes with TresJS (Vue Three.js) - provides TresCanvas, composables (useTres, useLoop), Cientos helpers (OrbitControls, useGLTF, Environment), and post-processing effects
|
||||
license: MIT
|
||||
---
|
||||
|
||||
# TresJS
|
||||
|
||||
Vue 3 framework for building 3D scenes with Three.js. Declarative components that wrap Three.js objects.
|
||||
|
||||
**Packages:** `@tresjs/core` (required), `@tresjs/cientos` (helpers), `@tresjs/post-processing` (effects)
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
# Core (required)
|
||||
pnpm add three @tresjs/core
|
||||
|
||||
# Helpers - controls, loaders, materials, staging
|
||||
pnpm add @tresjs/cientos
|
||||
|
||||
# Post-processing effects
|
||||
pnpm add @tresjs/post-processing
|
||||
```
|
||||
|
||||
## Quick Reference
|
||||
|
||||
| Working on... | Load file |
|
||||
| ---------------------------- | ---------------------- |
|
||||
| TresCanvas, useTres, useLoop | references/core.md |
|
||||
| Controls, loaders, materials | references/cientos.md |
|
||||
| Bloom, glitch, DOF effects | references/effects.md |
|
||||
| Common patterns, recipes | references/cookbook.md |
|
||||
|
||||
## Loading Files
|
||||
|
||||
**Load based on your task:**
|
||||
|
||||
- [ ] [references/core.md](references/core.md) - TresCanvas setup, composables, events, primitives
|
||||
- [ ] [references/cientos.md](references/cientos.md) - OrbitControls, useGLTF, Environment, materials
|
||||
- [ ] [references/effects.md](references/effects.md) - EffectComposer, bloom, glitch, DOF
|
||||
- [ ] [references/cookbook.md](references/cookbook.md) - Load models, camera setup, animations
|
||||
|
||||
**DO NOT load all files at once.** Load only what's relevant.
|
||||
|
||||
## Core Concepts
|
||||
|
||||
### TresCanvas
|
||||
|
||||
Root component that creates WebGL renderer and scene:
|
||||
|
||||
```vue
|
||||
<script setup lang="ts">
|
||||
import { TresCanvas } from '@tresjs/core'
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<TresCanvas shadows alpha>
|
||||
<TresPerspectiveCamera :position="[5, 5, 5]" />
|
||||
<TresMesh>
|
||||
<TresBoxGeometry />
|
||||
<TresMeshStandardMaterial color="orange" />
|
||||
</TresMesh>
|
||||
<TresAmbientLight :intensity="0.5" />
|
||||
<TresDirectionalLight :position="[3, 3, 3]" :intensity="1" />
|
||||
</TresCanvas>
|
||||
</template>
|
||||
```
|
||||
|
||||
### Component Naming
|
||||
|
||||
All Three.js classes available as Vue components with `Tres` prefix:
|
||||
|
||||
- `THREE.PerspectiveCamera` → `<TresPerspectiveCamera />`
|
||||
- `THREE.Mesh` → `<TresMesh />`
|
||||
- `THREE.BoxGeometry` → `<TresBoxGeometry />`
|
||||
- `THREE.MeshStandardMaterial` → `<TresMeshStandardMaterial />`
|
||||
|
||||
Constructor arguments via `:args` prop:
|
||||
|
||||
```vue
|
||||
<TresPerspectiveCamera :args="[75, 1, 0.1, 1000]" />
|
||||
```
|
||||
|
||||
### Reactivity
|
||||
|
||||
Props are reactive - changes update the 3D scene:
|
||||
|
||||
```vue
|
||||
<script setup>
|
||||
const color = ref('orange')
|
||||
const position = ref([0, 0, 0])
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<TresMesh :position="position">
|
||||
<TresMeshStandardMaterial :color="color" />
|
||||
</TresMesh>
|
||||
</template>
|
||||
```
|
||||
|
||||
### Primitive Component
|
||||
|
||||
Inject existing Three.js objects directly:
|
||||
|
||||
```vue
|
||||
<script setup>
|
||||
import { useGLTF } from '@tresjs/cientos'
|
||||
const { scene } = await useGLTF('/model.glb')
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<primitive :object="scene" />
|
||||
</template>
|
||||
```
|
||||
|
||||
## Available Guidance
|
||||
|
||||
**[references/core.md](references/core.md)** - TresCanvas props, useTres, useLoop, useGraph, events, performance
|
||||
|
||||
**[references/cientos.md](references/cientos.md)** - OrbitControls, useGLTF, useTexture, Environment, Sky, materials, shapes
|
||||
|
||||
**[references/effects.md](references/effects.md)** - EffectComposer vs EffectComposerPmndrs, bloom, glitch, DOF, effect stacking
|
||||
|
||||
**[references/cookbook.md](references/cookbook.md)** - Load 3D model, camera with controls, animation loop, post-processing
|
||||
|
||||
Reference in New Issue
Block a user