From f3204e108b4276d79ba15bcd7bb5edbdf99b38ad Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Tue, 26 May 2026 18:06:28 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E9=A1=B9=E7=9B=AE=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3964c23
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# Yggdrasil
+
+基于 Dioxus 0.7 的全栈博客系统，Rust 单一代码库同时编译为 WASM 前端和原生服务端。
+
+## 技术栈
+
+- **框架**: Dioxus 0.7 (fullstack)
+- **数据库**: PostgreSQL + tokio-postgres
+- **样式**: Tailwind CSS v4
+- **密码**: Argon2
+- **会话**: UUID token + cookie
+
+## 功能
+
+- 邮箱注册 / 登录（单管理员模式，首次注册后关闭）
+- 会话管理与自动过期清理
+- 暗色 / 亮色主题切换
+- 后台文章撰写（Tiptap Markdown 编辑器）
+- 文章归档与标签浏览
+
+## 开发
+
+依赖 Rust 1.95+、wasm32 目标、`dx` CLI、tailwindcss CLI v4 和 PostgreSQL。
+
+```bash
+# 配置数据库
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
+
+# 运行迁移
+psql $DATABASE_URL -f migrations/001_init.sql
+
+# 启动开发服务器
+make dev
+```
+
+## 构建
+
+```bash
+make build
+```