first commit
This commit is contained in:
@@ -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?
|
||||||
Vendored
+3
@@ -0,0 +1,3 @@
|
|||||||
|
{
|
||||||
|
"recommendations": ["Vue.volar"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
# Vue 3 + TypeScript + Vite
|
||||||
|
|
||||||
|
This template should help get you started developing with Vue 3 and TypeScript in Vite. The template uses Vue 3 `<script setup>` SFCs, check out the [script setup docs](https://v3.vuejs.org/api/sfc-script-setup.html#sfc-script-setup) to learn more.
|
||||||
|
|
||||||
|
Learn more about the recommended Project Setup and IDE Support in the [Vue Docs TypeScript Guide](https://vuejs.org/guide/typescript/overview.html#project-setup).
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="en">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8" />
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
<title>backend</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="app"></div>
|
||||||
|
<script type="module" src="/src/main.ts"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Generated
+1163
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,22 @@
|
|||||||
|
{
|
||||||
|
"name": "backend",
|
||||||
|
"private": true,
|
||||||
|
"version": "0.0.0",
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"dev": "vite",
|
||||||
|
"build": "vue-tsc -b && vite build",
|
||||||
|
"preview": "vite preview"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"vue": "^3.5.40"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "^24.13.3",
|
||||||
|
"@vitejs/plugin-vue": "^6.0.8",
|
||||||
|
"@vue/tsconfig": "^0.9.1",
|
||||||
|
"typescript": "~6.0.2",
|
||||||
|
"vite": "^8.2.0",
|
||||||
|
"vue-tsc": "^3.3.8"
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 9.3 KiB |
@@ -0,0 +1,24 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<symbol id="bluesky-icon" viewBox="0 0 16 17">
|
||||||
|
<g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
|
||||||
|
<defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="discord-icon" viewBox="0 0 20 19">
|
||||||
|
<path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="documentation-icon" viewBox="0 0 21 20">
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="github-icon" viewBox="0 0 19 19">
|
||||||
|
<path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="social-icon" viewBox="0 0 20 20">
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
|
||||||
|
<path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
|
||||||
|
</symbol>
|
||||||
|
<symbol id="x-icon" viewBox="0 0 19 19">
|
||||||
|
<path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
|
||||||
|
</symbol>
|
||||||
|
</svg>
|
||||||
|
After Width: | Height: | Size: 4.9 KiB |
@@ -0,0 +1,7 @@
|
|||||||
|
<script setup lang="ts">
|
||||||
|
import HelloWorld from './components/HelloWorld.vue'
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<template>
|
||||||
|
<HelloWorld />
|
||||||
|
</template>
|
||||||
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 8.5 KiB |
@@ -0,0 +1 @@
|
|||||||
|
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="37.07" height="36" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 198"><path fill="#41B883" d="M204.8 0H256L128 220.8L0 0h97.92L128 51.2L157.44 0h47.36Z"></path><path fill="#41B883" d="m0 0l128 220.8L256 0h-51.2L128 132.48L50.56 0H0Z"></path><path fill="#35495E" d="M50.56 0L128 133.12L204.8 0h-47.36L128 51.2L97.92 0H50.56Z"></path></svg>
|
||||||
|
After Width: | Height: | Size: 496 B |
@@ -0,0 +1,95 @@
|
|||||||
|
<script setup lang="ts">
|
||||||
|
import { ref } from 'vue'
|
||||||
|
import viteLogo from '../assets/vite.svg'
|
||||||
|
import heroImg from '../assets/hero.png'
|
||||||
|
import vueLogo from '../assets/vue.svg'
|
||||||
|
|
||||||
|
const count = ref(0)
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<template>
|
||||||
|
<section id="center">
|
||||||
|
<div class="hero">
|
||||||
|
<img :src="heroImg" class="base" width="170" height="179" alt="" />
|
||||||
|
<img :src="vueLogo" class="framework" alt="Vue logo" />
|
||||||
|
<img :src="viteLogo" class="vite" alt="Vite logo" />
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<h1>Get started</h1>
|
||||||
|
<p>Edit <code>src/App.vue</code> and save to test <code>HMR</code></p>
|
||||||
|
</div>
|
||||||
|
<button type="button" class="counter" @click="count++">
|
||||||
|
Count is {{ count }}
|
||||||
|
</button>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<div class="ticks"></div>
|
||||||
|
|
||||||
|
<section id="next-steps">
|
||||||
|
<div id="docs">
|
||||||
|
<svg class="icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#documentation-icon"></use>
|
||||||
|
</svg>
|
||||||
|
<h2>Documentation</h2>
|
||||||
|
<p>Your questions, answered</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://vite.dev/" target="_blank">
|
||||||
|
<img class="logo" :src="viteLogo" alt="" />
|
||||||
|
Explore Vite
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a href="https://vuejs.org/" target="_blank">
|
||||||
|
<img class="button-icon" :src="vueLogo" alt="" />
|
||||||
|
Learn more
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<div id="social">
|
||||||
|
<svg class="icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#social-icon"></use>
|
||||||
|
</svg>
|
||||||
|
<h2>Connect with us</h2>
|
||||||
|
<p>Join the Vite community</p>
|
||||||
|
<ul>
|
||||||
|
<li>
|
||||||
|
<a href="https://github.com/vitejs/vite" target="_blank">
|
||||||
|
<svg class="button-icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#github-icon"></use>
|
||||||
|
</svg>
|
||||||
|
GitHub
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a href="https://chat.vite.dev/" target="_blank">
|
||||||
|
<svg class="button-icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#discord-icon"></use>
|
||||||
|
</svg>
|
||||||
|
Discord
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a href="https://x.com/vite_js" target="_blank">
|
||||||
|
<svg class="button-icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#x-icon"></use>
|
||||||
|
</svg>
|
||||||
|
X.com
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
<li>
|
||||||
|
<a href="https://bsky.app/profile/vite.dev" target="_blank">
|
||||||
|
<svg class="button-icon" role="presentation" aria-hidden="true">
|
||||||
|
<use href="/icons.svg#bluesky-icon"></use>
|
||||||
|
</svg>
|
||||||
|
Bluesky
|
||||||
|
</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<div class="ticks"></div>
|
||||||
|
<section id="spacer"></section>
|
||||||
|
</template>
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
import { createApp } from 'vue'
|
||||||
|
import './style.css'
|
||||||
|
import App from './App.vue'
|
||||||
|
|
||||||
|
createApp(App).mount('#app')
|
||||||
@@ -0,0 +1,296 @@
|
|||||||
|
:root {
|
||||||
|
--text: #6b6375;
|
||||||
|
--text-h: #08060d;
|
||||||
|
--bg: #fff;
|
||||||
|
--border: #e5e4e7;
|
||||||
|
--code-bg: #f4f3ec;
|
||||||
|
--accent: #aa3bff;
|
||||||
|
--accent-bg: rgba(170, 59, 255, 0.1);
|
||||||
|
--accent-border: rgba(170, 59, 255, 0.5);
|
||||||
|
--social-bg: rgba(244, 243, 236, 0.5);
|
||||||
|
--shadow:
|
||||||
|
rgba(0, 0, 0, 0.1) 0 10px 15px -3px, rgba(0, 0, 0, 0.05) 0 4px 6px -2px;
|
||||||
|
|
||||||
|
--sans: system-ui, 'Segoe UI', Roboto, sans-serif;
|
||||||
|
--heading: system-ui, 'Segoe UI', Roboto, sans-serif;
|
||||||
|
--mono: ui-monospace, Consolas, monospace;
|
||||||
|
|
||||||
|
font: 18px/145% var(--sans);
|
||||||
|
letter-spacing: 0.18px;
|
||||||
|
color-scheme: light dark;
|
||||||
|
color: var(--text);
|
||||||
|
background: var(--bg);
|
||||||
|
font-synthesis: none;
|
||||||
|
text-rendering: optimizeLegibility;
|
||||||
|
-webkit-font-smoothing: antialiased;
|
||||||
|
-moz-osx-font-smoothing: grayscale;
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
font-size: 16px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (prefers-color-scheme: dark) {
|
||||||
|
:root {
|
||||||
|
--text: #9ca3af;
|
||||||
|
--text-h: #f3f4f6;
|
||||||
|
--bg: #16171d;
|
||||||
|
--border: #2e303a;
|
||||||
|
--code-bg: #1f2028;
|
||||||
|
--accent: #c084fc;
|
||||||
|
--accent-bg: rgba(192, 132, 252, 0.15);
|
||||||
|
--accent-border: rgba(192, 132, 252, 0.5);
|
||||||
|
--social-bg: rgba(47, 48, 58, 0.5);
|
||||||
|
--shadow:
|
||||||
|
rgba(0, 0, 0, 0.4) 0 10px 15px -3px, rgba(0, 0, 0, 0.25) 0 4px 6px -2px;
|
||||||
|
}
|
||||||
|
|
||||||
|
#social .button-icon {
|
||||||
|
filter: invert(1) brightness(2);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
h1,
|
||||||
|
h2 {
|
||||||
|
font-family: var(--heading);
|
||||||
|
font-weight: 500;
|
||||||
|
color: var(--text-h);
|
||||||
|
}
|
||||||
|
|
||||||
|
h1 {
|
||||||
|
font-size: 56px;
|
||||||
|
letter-spacing: -1.68px;
|
||||||
|
margin: 32px 0;
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
font-size: 36px;
|
||||||
|
margin: 20px 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
h2 {
|
||||||
|
font-size: 24px;
|
||||||
|
line-height: 118%;
|
||||||
|
letter-spacing: -0.24px;
|
||||||
|
margin: 0 0 8px;
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
font-size: 20px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
p {
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
code,
|
||||||
|
.counter {
|
||||||
|
font-family: var(--mono);
|
||||||
|
display: inline-flex;
|
||||||
|
border-radius: 4px;
|
||||||
|
color: var(--text-h);
|
||||||
|
}
|
||||||
|
|
||||||
|
code {
|
||||||
|
font-size: 15px;
|
||||||
|
line-height: 135%;
|
||||||
|
padding: 4px 8px;
|
||||||
|
background: var(--code-bg);
|
||||||
|
}
|
||||||
|
|
||||||
|
.counter {
|
||||||
|
font-size: 16px;
|
||||||
|
padding: 5px 10px;
|
||||||
|
border-radius: 5px;
|
||||||
|
color: var(--accent);
|
||||||
|
background: var(--accent-bg);
|
||||||
|
border: 2px solid transparent;
|
||||||
|
transition: border-color 0.3s;
|
||||||
|
margin-bottom: 24px;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
border-color: var(--accent-border);
|
||||||
|
}
|
||||||
|
&:focus-visible {
|
||||||
|
outline: 2px solid var(--accent);
|
||||||
|
outline-offset: 2px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero {
|
||||||
|
position: relative;
|
||||||
|
|
||||||
|
.base,
|
||||||
|
.framework,
|
||||||
|
.vite {
|
||||||
|
inset-inline: 0;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.base {
|
||||||
|
width: 170px;
|
||||||
|
position: relative;
|
||||||
|
z-index: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.framework,
|
||||||
|
.vite {
|
||||||
|
position: absolute;
|
||||||
|
}
|
||||||
|
|
||||||
|
.framework {
|
||||||
|
z-index: 1;
|
||||||
|
top: 34px;
|
||||||
|
height: 28px;
|
||||||
|
transform: perspective(2000px) rotateZ(300deg) rotateX(44deg) rotateY(39deg)
|
||||||
|
scale(1.4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.vite {
|
||||||
|
z-index: 0;
|
||||||
|
top: 107px;
|
||||||
|
height: 26px;
|
||||||
|
width: auto;
|
||||||
|
transform: perspective(2000px) rotateZ(300deg) rotateX(40deg) rotateY(39deg)
|
||||||
|
scale(0.8);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#app {
|
||||||
|
width: 1126px;
|
||||||
|
max-width: 100%;
|
||||||
|
margin: 0 auto;
|
||||||
|
text-align: center;
|
||||||
|
border-inline: 1px solid var(--border);
|
||||||
|
min-height: 100svh;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
|
||||||
|
#center {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 25px;
|
||||||
|
place-content: center;
|
||||||
|
place-items: center;
|
||||||
|
flex-grow: 1;
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
padding: 32px 20px 24px;
|
||||||
|
gap: 18px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#next-steps {
|
||||||
|
display: flex;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
text-align: left;
|
||||||
|
|
||||||
|
& > div {
|
||||||
|
flex: 1 1 0;
|
||||||
|
padding: 32px;
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
padding: 24px 20px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.icon {
|
||||||
|
margin-bottom: 16px;
|
||||||
|
width: 22px;
|
||||||
|
height: 22px;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
flex-direction: column;
|
||||||
|
text-align: center;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#docs {
|
||||||
|
border-right: 1px solid var(--border);
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
border-right: none;
|
||||||
|
border-bottom: 1px solid var(--border);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#next-steps ul {
|
||||||
|
list-style: none;
|
||||||
|
padding: 0;
|
||||||
|
display: flex;
|
||||||
|
gap: 8px;
|
||||||
|
margin: 32px 0 0;
|
||||||
|
|
||||||
|
.logo {
|
||||||
|
height: 18px;
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
color: var(--text-h);
|
||||||
|
font-size: 16px;
|
||||||
|
border-radius: 6px;
|
||||||
|
background: var(--social-bg);
|
||||||
|
display: flex;
|
||||||
|
padding: 6px 12px;
|
||||||
|
align-items: center;
|
||||||
|
gap: 8px;
|
||||||
|
text-decoration: none;
|
||||||
|
transition: box-shadow 0.3s;
|
||||||
|
|
||||||
|
&:hover {
|
||||||
|
box-shadow: var(--shadow);
|
||||||
|
}
|
||||||
|
.button-icon {
|
||||||
|
height: 18px;
|
||||||
|
width: 18px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
margin-top: 20px;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
justify-content: center;
|
||||||
|
|
||||||
|
li {
|
||||||
|
flex: 1 1 calc(50% - 8px);
|
||||||
|
}
|
||||||
|
|
||||||
|
a {
|
||||||
|
width: 100%;
|
||||||
|
justify-content: center;
|
||||||
|
box-sizing: border-box;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#spacer {
|
||||||
|
height: 88px;
|
||||||
|
border-top: 1px solid var(--border);
|
||||||
|
@media (max-width: 1024px) {
|
||||||
|
height: 48px;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.ticks {
|
||||||
|
position: relative;
|
||||||
|
width: 100%;
|
||||||
|
|
||||||
|
&::before,
|
||||||
|
&::after {
|
||||||
|
content: '';
|
||||||
|
position: absolute;
|
||||||
|
top: -4.5px;
|
||||||
|
border: 5px solid transparent;
|
||||||
|
}
|
||||||
|
|
||||||
|
&::before {
|
||||||
|
left: 0;
|
||||||
|
border-left-color: var(--border);
|
||||||
|
}
|
||||||
|
&::after {
|
||||||
|
right: 0;
|
||||||
|
border-right-color: var(--border);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
{
|
||||||
|
"extends": "@vue/tsconfig/tsconfig.dom.json",
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
||||||
|
"types": ["vite/client"],
|
||||||
|
"allowArbitraryExtensions": true,
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"files": [],
|
||||||
|
"references": [
|
||||||
|
{ "path": "./tsconfig.app.json" },
|
||||||
|
{ "path": "./tsconfig.node.json" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
||||||
|
"target": "es2023",
|
||||||
|
"lib": ["ES2023"],
|
||||||
|
"types": ["node"],
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"module": "nodenext",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["vite.config.ts"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
import { defineConfig } from 'vite'
|
||||||
|
import vue from '@vitejs/plugin-vue'
|
||||||
|
|
||||||
|
// https://vite.dev/config/
|
||||||
|
export default defineConfig({
|
||||||
|
plugins: [vue()],
|
||||||
|
})
|
||||||
+555
@@ -0,0 +1,555 @@
|
|||||||
|
# 文件存储系统 (FileStorageSystem)
|
||||||
|
|
||||||
|
一个类似七牛云的文件存储系统，提供用户注册、项目隔离存储、API文件操作等功能。
|
||||||
|
|
||||||
|
## 功能概述
|
||||||
|
|
||||||
|
### 1. 用户系统
|
||||||
|
- **用户注册/登录**：支持邮箱/手机号注册，JWT认证
|
||||||
|
- **API密钥管理**：每个用户可生成多个API Key，用于程序化访问
|
||||||
|
- **用户信息管理**：个人资料、密码修改、账户设置
|
||||||
|
- **角色权限**：基于角色的访问控制(RBAC)，灵活配置权限
|
||||||
|
- **账户安全**：登录失败锁定、密码强度要求
|
||||||
|
|
||||||
|
### 2. 项目管理
|
||||||
|
- **项目创建**：用户可创建多个独立项目（如项目A、项目B）
|
||||||
|
- **项目隔离**：每个项目拥有独立的存储空间和文件命名空间
|
||||||
|
- **项目配额**：可设置每个项目的存储容量限制
|
||||||
|
- **项目成员**（可选）：支持项目级别的权限管理
|
||||||
|
|
||||||
|
### 3. 文件管理
|
||||||
|
- **文件上传**：支持单文件/批量上传，断点续传
|
||||||
|
- **文件下载**：直接下载或生成临时下载链接
|
||||||
|
- **文件删除**：软删除/硬删除，回收站机制
|
||||||
|
- **文件元数据**：文件名、大小、类型、上传时间、MD5校验
|
||||||
|
- **文件目录**：支持虚拟目录结构组织文件
|
||||||
|
- **文件访问控制**：公开/私有文件设置，访问密码保护
|
||||||
|
- **临时链接**：生成带过期时间的临时访问URL
|
||||||
|
- **文件预览**：图片、视频、文档在线预览（可选）
|
||||||
|
|
||||||
|
### 4. API接口
|
||||||
|
- **RESTful API**：标准REST风格接口
|
||||||
|
- **认证方式**：API Key + Secret签名认证
|
||||||
|
- **SDK支持**：提供Go/Python/JavaScript SDK（后期）
|
||||||
|
|
||||||
|
### 5. 存储引擎
|
||||||
|
- **本地存储**：文件存储在本地文件系统
|
||||||
|
- **元数据存储**：SQLite数据库存储文件元数据、用户信息等
|
||||||
|
- **文件去重**：基于MD5的文件去重，节省存储空间
|
||||||
|
- **存储统计**：项目/用户级别的存储使用统计
|
||||||
|
- **流量统计**：记录上传/下载流量，便于计费分析
|
||||||
|
- **自定义域名**：支持绑定自定义域名访问文件（可选）
|
||||||
|
|
||||||
|
### 6. 安全特性
|
||||||
|
- **API认证**：HMAC-SHA256签名认证
|
||||||
|
- **访问控制**：项目级别的文件访问隔离
|
||||||
|
- **文件限制**：可配置的文件大小、类型限制
|
||||||
|
|
||||||
|
### 7. 系统管理
|
||||||
|
- **系统设置**：站点名称、站点描述、Logo配置、备案信息等
|
||||||
|
- **注册开关**：控制是否开放用户注册功能
|
||||||
|
- **站点开关**：站点维护模式，临时关闭站点访问
|
||||||
|
- **操作日志**：记录用户关键操作（登录、文件操作、项目管理等）
|
||||||
|
- **系统日志**：记录系统运行日志（错误、警告、调试信息）
|
||||||
|
- **存储配置**：默认存储配额、文件大小限制、允许的文件类型
|
||||||
|
- **邮件配置**：SMTP设置，用于发送通知邮件（可选）
|
||||||
|
- **用户管理**：用户列表、封禁/解封、角色分配、密码重置
|
||||||
|
- **角色管理**：创建/编辑/删除角色，配置角色权限
|
||||||
|
- **权限管理**：查看系统权限点，按模块分组
|
||||||
|
- **API限流**：请求频率限制，防止滥用
|
||||||
|
- **Webhook回调**：文件上传/删除等事件的HTTP回调通知
|
||||||
|
- **数据备份**：数据库和文件的手动/自动备份
|
||||||
|
|
||||||
|
## 技术架构
|
||||||
|
|
||||||
|
### 后端技术栈
|
||||||
|
- **语言**：Go 1.21+
|
||||||
|
- **Web框架**：Gin (高性能HTTP框架)
|
||||||
|
- **数据库**：SQLite (嵌入式数据库)
|
||||||
|
- **ORM**：GORM (Go ORM库)
|
||||||
|
- **配置管理**：Viper
|
||||||
|
- **日志**：Zap (高性能日志库)
|
||||||
|
- **认证**：JWT + API Key签名
|
||||||
|
- **限流**：golang.org/x/time/rate (令牌桶限流)
|
||||||
|
|
||||||
|
### 项目结构
|
||||||
|
```
|
||||||
|
filestoragesystem/
|
||||||
|
├── docs/ # 文档目录
|
||||||
|
├── go/ # Go后端代码
|
||||||
|
│ ├── cmd/ # 主程序入口
|
||||||
|
│ ├── internal/ # 内部包
|
||||||
|
│ │ ├── config/ # 配置管理
|
||||||
|
│ │ ├── controller/ # 控制器层
|
||||||
|
│ │ │ ├── admin.go # 系统管理控制器
|
||||||
|
│ │ │ ├── auth.go # 认证控制器
|
||||||
|
│ │ │ ├── file.go # 文件控制器
|
||||||
|
│ │ │ ├── project.go # 项目控制器
|
||||||
|
│ │ │ ├── role.go # 角色权限控制器
|
||||||
|
│ │ │ ├── stats.go # 统计控制器
|
||||||
|
│ │ │ ├── user.go # 用户管理控制器
|
||||||
|
│ │ │ └── webhook.go # Webhook控制器
|
||||||
|
│ │ ├── middleware/ # 中间件
|
||||||
|
│ │ │ ├── auth.go # 认证中间件(JWT/API Key)
|
||||||
|
│ │ │ ├── permission.go # 权限检查中间件
|
||||||
|
│ │ │ ├── logger.go # 日志中间件
|
||||||
|
│ │ │ ├── cors.go # 跨域中间件
|
||||||
|
│ │ │ ├── rate_limit.go # 限流中间件
|
||||||
|
│ │ │ └── site.go # 站点状态中间件
|
||||||
|
│ │ ├── model/ # 数据模型
|
||||||
|
│ │ ├── repository/ # 数据访问层
|
||||||
|
│ │ ├── service/ # 业务逻辑层
|
||||||
|
│ │ └── utils/ # 工具函数
|
||||||
|
│ ├── pkg/ # 公共包
|
||||||
|
│ ├── storage/ # 文件存储目录
|
||||||
|
│ ├── go.mod # Go模块文件
|
||||||
|
│ └── main.go # 程序入口
|
||||||
|
├── backend/ # 前端项目（现有）
|
||||||
|
└── README.md # 项目说明
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据库设计
|
||||||
|
|
||||||
|
### 用户表 (users)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE users (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
username VARCHAR(50) UNIQUE NOT NULL,
|
||||||
|
email VARCHAR(100) UNIQUE NOT NULL,
|
||||||
|
password_hash VARCHAR(255) NOT NULL,
|
||||||
|
role_id INTEGER DEFAULT 1, -- 关联角色表
|
||||||
|
status INTEGER DEFAULT 1, -- 1:正常 0:禁用
|
||||||
|
storage_used BIGINT DEFAULT 0, -- 已用存储空间(字节)
|
||||||
|
storage_limit BIGINT DEFAULT 10737418240, -- 存储限制(默认10GB)
|
||||||
|
last_login_at DATETIME,
|
||||||
|
last_login_ip VARCHAR(50),
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (role_id) REFERENCES roles(id)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 角色表 (roles)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE roles (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
name VARCHAR(50) UNIQUE NOT NULL, -- 角色名称
|
||||||
|
code VARCHAR(50) UNIQUE NOT NULL, -- 角色编码：super_admin/admin/user
|
||||||
|
description VARCHAR(255), -- 角色描述
|
||||||
|
is_system INTEGER DEFAULT 0, -- 是否系统内置角色(不可删除)
|
||||||
|
status INTEGER DEFAULT 1, -- 1:启用 0:禁用
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 默认角色
|
||||||
|
INSERT INTO roles (name, code, description, is_system) VALUES
|
||||||
|
('超级管理员', 'super_admin', '系统超级管理员，拥有所有权限', 1),
|
||||||
|
('管理员', 'admin', '系统管理员，可管理用户和内容', 1),
|
||||||
|
('普通用户', 'user', '普通用户，管理自己的项目和文件', 1);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 权限表 (permissions)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE permissions (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
name VARCHAR(50) NOT NULL, -- 权限名称
|
||||||
|
code VARCHAR(100) UNIQUE NOT NULL, -- 权限编码
|
||||||
|
module VARCHAR(50) NOT NULL, -- 所属模块：user/project/file/system
|
||||||
|
description VARCHAR(255), -- 权限描述
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 默认权限
|
||||||
|
INSERT INTO permissions (name, code, module, description) VALUES
|
||||||
|
-- 用户管理
|
||||||
|
('查看用户列表', 'user:list', 'user', '查看所有用户列表'),
|
||||||
|
('查看用户详情', 'user:detail', 'user', '查看用户详细信息'),
|
||||||
|
('创建用户', 'user:create', 'user', '创建新用户'),
|
||||||
|
('编辑用户', 'user:edit', 'user', '编辑用户信息'),
|
||||||
|
('删除用户', 'user:delete', 'user', '删除用户'),
|
||||||
|
('禁用用户', 'user:disable', 'user', '禁用/启用用户'),
|
||||||
|
('分配角色', 'user:assign_role', 'user', '修改用户角色'),
|
||||||
|
('重置密码', 'user:reset_password', 'user', '重置用户密码'),
|
||||||
|
-- 项目管理
|
||||||
|
('查看项目列表', 'project:list', 'project', '查看项目列表'),
|
||||||
|
('创建项目', 'project:create', 'project', '创建新项目'),
|
||||||
|
('编辑项目', 'project:edit', 'project', '编辑项目信息'),
|
||||||
|
('删除项目', 'project:delete', 'project', '删除项目'),
|
||||||
|
-- 文件管理
|
||||||
|
('上传文件', 'file:upload', 'file', '上传文件'),
|
||||||
|
('下载文件', 'file:download', 'file', '下载文件'),
|
||||||
|
('删除文件', 'file:delete', 'file', '删除文件'),
|
||||||
|
('查看文件列表', 'file:list', 'file', '查看文件列表'),
|
||||||
|
-- 系统管理
|
||||||
|
('查看系统设置', 'system:settings:view', 'system', '查看系统设置'),
|
||||||
|
('修改系统设置', 'system:settings:edit', 'system', '修改系统设置'),
|
||||||
|
('查看操作日志', 'system:logs:operation', 'system', '查看操作日志'),
|
||||||
|
('查看系统日志', 'system:logs:system', 'system', '查看系统日志'),
|
||||||
|
('清理日志', 'system:logs:cleanup', 'system', '清理历史日志');
|
||||||
|
```
|
||||||
|
|
||||||
|
### 角色权限关联表 (role_permissions)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE role_permissions (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
role_id INTEGER NOT NULL,
|
||||||
|
permission_id INTEGER NOT NULL,
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (role_id) REFERENCES roles(id) ON DELETE CASCADE,
|
||||||
|
FOREIGN KEY (permission_id) REFERENCES permissions(id) ON DELETE CASCADE,
|
||||||
|
UNIQUE(role_id, permission_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 超级管理员拥有所有权限
|
||||||
|
INSERT INTO role_permissions (role_id, permission_id)
|
||||||
|
SELECT 1, id FROM permissions;
|
||||||
|
|
||||||
|
-- 管理员权限
|
||||||
|
INSERT INTO role_permissions (role_id, permission_id)
|
||||||
|
SELECT 2, id FROM permissions WHERE code NOT IN ('user:delete', 'user:assign_role', 'system:settings:edit');
|
||||||
|
|
||||||
|
-- 普通用户权限
|
||||||
|
INSERT INTO role_permissions (role_id, permission_id)
|
||||||
|
SELECT 3, id FROM permissions WHERE code IN ('project:list', 'project:create', 'project:edit', 'project:delete', 'file:upload', 'file:download', 'file:delete', 'file:list');
|
||||||
|
```
|
||||||
|
|
||||||
|
### API密钥表 (api_keys)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE api_keys (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
access_key VARCHAR(32) UNIQUE NOT NULL,
|
||||||
|
secret_key VARCHAR(64) NOT NULL,
|
||||||
|
name VARCHAR(50), -- 密钥名称
|
||||||
|
status INTEGER DEFAULT 1,
|
||||||
|
last_used_at DATETIME,
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 项目表 (projects)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE projects (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
name VARCHAR(100) NOT NULL,
|
||||||
|
description TEXT,
|
||||||
|
storage_used BIGINT DEFAULT 0,
|
||||||
|
storage_limit BIGINT DEFAULT 5368709120, -- 默认5GB
|
||||||
|
status INTEGER DEFAULT 1,
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id),
|
||||||
|
UNIQUE(user_id, name)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 文件表 (files)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE files (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
project_id INTEGER NOT NULL,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
filename VARCHAR(255) NOT NULL, -- 原始文件名
|
||||||
|
stored_path VARCHAR(500) NOT NULL, -- 存储路径
|
||||||
|
size BIGINT NOT NULL,
|
||||||
|
mime_type VARCHAR(100),
|
||||||
|
md5 VARCHAR(32),
|
||||||
|
storage_type INTEGER DEFAULT 1, -- 1:本地存储
|
||||||
|
visibility INTEGER DEFAULT 1, -- 1:私有 2:公开
|
||||||
|
download_count BIGINT DEFAULT 0, -- 下载次数
|
||||||
|
status INTEGER DEFAULT 1, -- 1:正常 0:已删除
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
deleted_at DATETIME, -- 软删除时间
|
||||||
|
FOREIGN KEY (project_id) REFERENCES projects(id),
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 临时链接表 (temp_links)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE temp_links (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
file_id INTEGER NOT NULL,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
token VARCHAR(64) UNIQUE NOT NULL, -- 访问令牌
|
||||||
|
password VARCHAR(50), -- 访问密码(可选)
|
||||||
|
max_count INTEGER DEFAULT 0, -- 最大访问次数，0为不限
|
||||||
|
used_count INTEGER DEFAULT 0, -- 已访问次数
|
||||||
|
expires_at DATETIME NOT NULL, -- 过期时间
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (file_id) REFERENCES files(id),
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 流量统计表 (traffic_logs)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE traffic_logs (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
project_id INTEGER,
|
||||||
|
file_id INTEGER,
|
||||||
|
type INTEGER NOT NULL, -- 1:上传 2:下载
|
||||||
|
size BIGINT NOT NULL, -- 流量大小(字节)
|
||||||
|
ip VARCHAR(50),
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idx_traffic_logs_user ON traffic_logs(user_id);
|
||||||
|
CREATE INDEX idx_traffic_logs_created ON traffic_logs(created_at);
|
||||||
|
```
|
||||||
|
|
||||||
|
### Webhook配置表 (webhooks)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE webhooks (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
user_id INTEGER NOT NULL,
|
||||||
|
project_id INTEGER, -- 为空则为用户级别
|
||||||
|
url VARCHAR(500) NOT NULL,
|
||||||
|
secret VARCHAR(64), -- 签名密钥
|
||||||
|
events VARCHAR(255) NOT NULL, -- 触发事件：file.upload,file.delete等
|
||||||
|
status INTEGER DEFAULT 1, -- 1:启用 0:禁用
|
||||||
|
last_triggered_at DATETIME,
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 系统设置表 (system_settings)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE system_settings (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
key VARCHAR(100) UNIQUE NOT NULL, -- 设置键名
|
||||||
|
value TEXT, -- 设置值
|
||||||
|
description VARCHAR(255), -- 设置描述
|
||||||
|
group_name VARCHAR(50) DEFAULT 'general', -- 设置分组
|
||||||
|
updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
-- 默认设置数据
|
||||||
|
INSERT INTO system_settings (key, value, description, group_name) VALUES
|
||||||
|
('site_name', '文件存储系统', '站点名称', 'site'),
|
||||||
|
('site_description', '高效、安全的文件存储服务', '站点描述', 'site'),
|
||||||
|
('site_logo', '/assets/logo.png', '站点Logo路径', 'site'),
|
||||||
|
('site_icp', '', 'ICP备案号', 'site'),
|
||||||
|
('site_copyright', '© 2024 FileStorageSystem', '版权信息', 'site'),
|
||||||
|
('register_enabled', 'true', '是否开放注册', 'feature'),
|
||||||
|
('site_enabled', 'true', '站点是否启用', 'feature'),
|
||||||
|
('site_maintenance_msg', '系统维护中，请稍后再访问', '维护提示信息', 'feature'),
|
||||||
|
('default_storage_limit', '10737418240', '默认用户存储配额(字节)', 'storage'),
|
||||||
|
('default_project_limit', '5368709120', '默认项目存储配额(字节)', 'storage'),
|
||||||
|
('max_file_size', '104857600', '单文件最大限制(字节)', 'storage'),
|
||||||
|
('allowed_file_types', '*', '允许的文件类型(*表示所有)', 'storage'),
|
||||||
|
('api_rate_limit', '100', 'API请求频率限制(次/分钟)', 'api'),
|
||||||
|
('temp_link_max_age', '3600', '临时链接默认有效期(秒)', 'api'),
|
||||||
|
('webhook_enabled', 'true', '是否启用Webhook回调', 'api');
|
||||||
|
```
|
||||||
|
|
||||||
|
### 操作日志表 (operation_logs)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE operation_logs (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
user_id INTEGER, -- 操作用户ID，系统操作为NULL
|
||||||
|
username VARCHAR(50), -- 用户名，便于查询
|
||||||
|
action VARCHAR(50) NOT NULL, -- 操作类型：login/logout/upload/download/delete/create/update
|
||||||
|
resource_type VARCHAR(50), -- 资源类型：user/project/file/apikey
|
||||||
|
resource_id INTEGER, -- 资源ID
|
||||||
|
resource_name VARCHAR(255), -- 资源名称
|
||||||
|
ip VARCHAR(50), -- 操作IP
|
||||||
|
user_agent VARCHAR(500), -- 用户代理
|
||||||
|
request_path VARCHAR(500), -- 请求路径
|
||||||
|
request_method VARCHAR(10), -- 请求方法
|
||||||
|
status INTEGER DEFAULT 1, -- 1:成功 0:失败
|
||||||
|
error_message TEXT, -- 错误信息
|
||||||
|
extra_data TEXT, -- 额外数据(JSON)
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
FOREIGN KEY (user_id) REFERENCES users(id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idx_operation_logs_user ON operation_logs(user_id);
|
||||||
|
CREATE INDEX idx_operation_logs_action ON operation_logs(action);
|
||||||
|
CREATE INDEX idx_operation_logs_created ON operation_logs(created_at);
|
||||||
|
```
|
||||||
|
|
||||||
|
### 系统日志表 (system_logs)
|
||||||
|
```sql
|
||||||
|
CREATE TABLE system_logs (
|
||||||
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
||||||
|
level VARCHAR(10) NOT NULL, -- 日志级别：debug/info/warn/error/fatal
|
||||||
|
module VARCHAR(50), -- 模块名称：server/database/storage/auth
|
||||||
|
message TEXT NOT NULL, -- 日志内容
|
||||||
|
stack_trace TEXT, -- 堆栈信息
|
||||||
|
request_id VARCHAR(50), -- 请求ID，用于链路追踪
|
||||||
|
ip VARCHAR(50), -- 相关IP
|
||||||
|
extra_data TEXT, -- 额外数据(JSON)
|
||||||
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX idx_system_logs_level ON system_logs(level);
|
||||||
|
CREATE INDEX idx_system_logs_module ON system_logs(module);
|
||||||
|
CREATE INDEX idx_system_logs_created ON system_logs(created_at);
|
||||||
|
```
|
||||||
|
|
||||||
|
## API设计
|
||||||
|
|
||||||
|
### 认证相关
|
||||||
|
- `POST /api/v1/auth/register` - 用户注册
|
||||||
|
- `POST /api/v1/auth/login` - 用户登录
|
||||||
|
- `POST /api/v1/auth/apikeys` - 生成API密钥
|
||||||
|
- `GET /api/v1/auth/apikeys` - 获取API密钥列表
|
||||||
|
- `DELETE /api/v1/auth/apikeys/:id` - 删除API密钥
|
||||||
|
|
||||||
|
### 项目管理
|
||||||
|
- `POST /api/v1/projects` - 创建项目
|
||||||
|
- `GET /api/v1/projects` - 获取项目列表
|
||||||
|
- `GET /api/v1/projects/:id` - 获取项目详情
|
||||||
|
- `PUT /api/v1/projects/:id` - 更新项目信息
|
||||||
|
- `DELETE /api/v1/projects/:id` - 删除项目
|
||||||
|
|
||||||
|
### 文件操作 (需要API Key认证)
|
||||||
|
- `POST /api/v1/files/upload` - 上传文件
|
||||||
|
- `GET /api/v1/files/:id` - 获取文件信息
|
||||||
|
- `GET /api/v1/files/:id/download` - 下载文件
|
||||||
|
- `DELETE /api/v1/files/:id` - 删除文件
|
||||||
|
- `GET /api/v1/files` - 获取文件列表
|
||||||
|
- `POST /api/v1/files/:id/temp-link` - 生成临时访问链接
|
||||||
|
- `GET /api/v1/files/temp/:token` - 通过临时链接访问文件
|
||||||
|
|
||||||
|
### 用户管理 (需要管理员权限)
|
||||||
|
- `GET /api/v1/admin/users` - 获取用户列表
|
||||||
|
- `GET /api/v1/admin/users/:id` - 获取用户详情
|
||||||
|
- `POST /api/v1/admin/users` - 创建用户
|
||||||
|
- `PUT /api/v1/admin/users/:id` - 编辑用户信息
|
||||||
|
- `DELETE /api/v1/admin/users/:id` - 删除用户
|
||||||
|
- `PUT /api/v1/admin/users/:id/status` - 启用/禁用用户
|
||||||
|
- `PUT /api/v1/admin/users/:id/role` - 修改用户角色
|
||||||
|
- `POST /api/v1/admin/users/:id/reset-password` - 重置用户密码
|
||||||
|
|
||||||
|
### 角色权限管理 (需要超级管理员权限)
|
||||||
|
- `GET /api/v1/admin/roles` - 获取角色列表
|
||||||
|
- `GET /api/v1/admin/roles/:id` - 获取角色详情(含权限)
|
||||||
|
- `POST /api/v1/admin/roles` - 创建角色
|
||||||
|
- `PUT /api/v1/admin/roles/:id` - 编辑角色
|
||||||
|
- `DELETE /api/v1/admin/roles/:id` - 删除角色(系统角色不可删)
|
||||||
|
- `PUT /api/v1/admin/roles/:id/permissions` - 配置角色权限
|
||||||
|
- `GET /api/v1/admin/permissions` - 获取权限列表(按模块分组)
|
||||||
|
|
||||||
|
### 存储统计
|
||||||
|
- `GET /api/v1/stats/user` - 用户存储统计
|
||||||
|
- `GET /api/v1/stats/project/:id` - 项目存储统计
|
||||||
|
- `GET /api/v1/stats/traffic` - 流量统计
|
||||||
|
|
||||||
|
### 系统管理 (需要管理员权限)
|
||||||
|
- `GET /api/v1/admin/settings` - 获取系统设置
|
||||||
|
- `PUT /api/v1/admin/settings` - 更新系统设置
|
||||||
|
- `GET /api/v1/admin/settings/:group` - 获取分组设置
|
||||||
|
- `PUT /api/v1/admin/settings/:group` - 更新分组设置
|
||||||
|
|
||||||
|
### 日志管理 (需要管理员权限)
|
||||||
|
- `GET /api/v1/admin/logs/operation` - 获取操作日志列表
|
||||||
|
- `GET /api/v1/admin/logs/operation/:id` - 获取操作日志详情
|
||||||
|
- `GET /api/v1/admin/logs/system` - 获取系统日志列表
|
||||||
|
- `GET /api/v1/admin/logs/system/:id` - 获取系统日志详情
|
||||||
|
- `DELETE /api/v1/admin/logs/cleanup` - 清理历史日志
|
||||||
|
|
||||||
|
### 站点状态 (公开接口)
|
||||||
|
- `GET /api/v1/status` - 获取站点状态（维护模式、注册开关等）
|
||||||
|
|
||||||
|
## 开发计划
|
||||||
|
|
||||||
|
### 阶段一：基础框架
|
||||||
|
1. 初始化Go项目，配置依赖
|
||||||
|
2. 实现基础路由和中间件
|
||||||
|
3. SQLite数据库连接和迁移
|
||||||
|
4. 用户注册/登录功能
|
||||||
|
|
||||||
|
### 阶段二：核心功能
|
||||||
|
1. API密钥管理
|
||||||
|
2. 项目CRUD操作
|
||||||
|
3. 文件上传功能
|
||||||
|
4. 文件下载功能
|
||||||
|
|
||||||
|
### 阶段三：系统管理
|
||||||
|
1. 系统设置管理（站点信息、注册开关、站点开关）
|
||||||
|
2. 操作日志记录和查询
|
||||||
|
3. 系统日志记录和查询
|
||||||
|
4. 角色权限管理（RBAC）
|
||||||
|
5. 用户管理（列表、封禁、角色分配、密码重置）
|
||||||
|
6. 权限检查中间件
|
||||||
|
|
||||||
|
### 阶段四：完善功能
|
||||||
|
1. 文件删除和回收站
|
||||||
|
2. 存储统计和流量统计
|
||||||
|
3. 临时访问链接
|
||||||
|
4. API限流
|
||||||
|
5. 错误处理和日志
|
||||||
|
6. 配置文件支持
|
||||||
|
|
||||||
|
### 阶段五：优化和测试
|
||||||
|
1. 单元测试
|
||||||
|
2. 性能优化
|
||||||
|
3. API文档生成
|
||||||
|
4. 部署脚本
|
||||||
|
|
||||||
|
## 快速开始
|
||||||
|
|
||||||
|
### 环境要求
|
||||||
|
- Go 1.21+
|
||||||
|
- SQLite 3
|
||||||
|
|
||||||
|
### 安装和运行
|
||||||
|
```bash
|
||||||
|
# 进入Go后端目录
|
||||||
|
cd go
|
||||||
|
|
||||||
|
# 安装依赖
|
||||||
|
go mod tidy
|
||||||
|
|
||||||
|
# 运行程序
|
||||||
|
go run main.go
|
||||||
|
```
|
||||||
|
|
||||||
|
### 配置文件
|
||||||
|
```yaml
|
||||||
|
# config.yaml
|
||||||
|
server:
|
||||||
|
port: 8080
|
||||||
|
mode: debug # debug/release
|
||||||
|
|
||||||
|
database:
|
||||||
|
driver: sqlite
|
||||||
|
source: ./storage/data.db
|
||||||
|
|
||||||
|
storage:
|
||||||
|
root: ./storage/files
|
||||||
|
max_size: 100MB # 单文件最大限制
|
||||||
|
|
||||||
|
admin:
|
||||||
|
username: admin
|
||||||
|
password: admin123 # 首次运行后请修改
|
||||||
|
email: admin@example.com
|
||||||
|
role: super_admin # 默认角色
|
||||||
|
|
||||||
|
jwt:
|
||||||
|
secret: your-secret-key # 请修改为随机密钥
|
||||||
|
expire: 24h # Token过期时间
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **安全性**：生产环境需要修改JWT密钥，启用HTTPS
|
||||||
|
2. **性能**：大量文件建议使用对象存储服务（如MinIO、阿里云OSS）
|
||||||
|
3. **备份**：定期备份SQLite数据库和文件存储目录
|
||||||
|
4. **监控**：建议添加Prometheus监控指标
|
||||||
|
5. **日志管理**：定期清理过期日志，避免数据库过大
|
||||||
|
6. **站点维护**：开启维护模式时，确保管理员仍可访问后台
|
||||||
|
7. **权限控制**：管理员账户需在配置文件中预设，避免权限滥用
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
MIT License
|
||||||
Reference in New Issue
Block a user