# pnd

**Repository Path**: palagend/pnd

## Basic Information

- **Project Name**: pnd
- **Description**: Palagend个人工作台
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Palgend（帕兰德）

> **个人自用的数字工作台** —— 基于 Vue 技术栈、移动端优先的极简云端管理工具

---

## 愿景

为自己打造的效率工具，不是商业产品。既要技术学习，也要解决真实问题。

### 核心特点

- 📱 **移动端优先** — 随时随地，手机搞定一切
- 🎯 **极简干净** — 功能克制，拒绝臃肿
- 🔒 **数据自主** — 云端存储，来去自由
- ☁️ **零运维** — Supabase 托管，无需自建服务器
- 🌙 **暗黑模式** — 护眼设计，全天候舒适

### 项目属性

| 维度 | 定位 |
|------|------|
| **首要目标** | 学习项目 —— 实践 Vue3/Nuxt4/Supabase 技术栈 |
| **实用价值** | 自用工具 —— 解决个人记账、客户管理、项目管理等需求 |
| **潜在收益** | 佛系变现 —— 如有余力，小范围分享，有余则喜 |
| **迭代节奏** | 不设 deadline，质量优先，佛系迭代 |

---

## 快速开始

```bash
# 安装依赖
cd apps/web && pnpm install

# 启动开发
pnpm dev
```

访问 `http://localhost:3000`

---

## 项目结构

```
pnd/
├── apps/
│   └── web/                    # Nuxt 4 应用
│       └── app/
│           ├── pages/          # 路由页面
│           ├── components/     # 组件
│           ├── composables/    # 可组合函数
│           ├── layouts/        # 布局
│           └── stores/        # Pinia 状态
├── docs/                       # 技术文档
├── scripts/                    # 脚本
└── .trae/                     # 规范配置
```

**未来扩展**：
- `apps/mobile/` — 移动端 App
- `apps/api/` — 后端 API 服务
- `packages/ui/` — 共享 UI 组件库

---

## 10 条关键原则

1. **自己先用，再给别人用** — 功能必须自己先用起来，验证有价值再保留
2. **功能做减法，体验做加法** — 宁可少而精，不要多而杂
3. **不设 deadline，质量优先** — 佛系迭代，不赶进度，保证代码质量
4. **云端优先，零运维** — 使用 Supabase/Vercel，不自建服务器
5. **移动优先，极致体验** — 移动端是主入口，体验必须流畅
6. **数据自主，来去自由** — 支持数据导出，用户完全掌控自己的数据
7. **技术驱动，学习优先** — 把项目当作学习 Vue3/Nuxt4 的实践场
8. **佛系变现，有余则喜** — 不指望赚钱，有收益是意外之喜
9. **持续分享，建立连接** — 记录开发过程，分享技术经验
10. **保持开放，随时调整** — 根据实际情况灵活调整方向

---

## 技术栈

| 层级 | 技术 | 用途 |
|------|------|------|
| **前端框架** | Nuxt 4 + Vue 3 | SSR/SSG、文件路由 |
| **UI 组件库** | Vant 4 | 移动端组件 |
| **样式方案** | Tailwind CSS + CSS 变量 | 原子化 CSS + 主题系统 |
| **状态管理** | Pinia | 状态管理 |
| **后端服务** | Supabase | PostgreSQL + Auth + Realtime |
| **部署平台** | Vercel | 前端托管 + PWA |

---

## 相关文档

| 文档 | 说明 |
|------|------|
| [快速开始](./docs/getting-started.md) | 环境准备、安装启动、开发规范 |
| [架构设计](./docs/architecture.md) | 技术栈、项目结构、数据层设计 |
| [数据库设计](./docs/database.md) | 表结构、命名规范、RLS 策略 |
| [Vercel 部署](./docs/vercel.md) | Vercel 部署配置、环境变量 |

**规范配置**：
- `.trae/rules/project_rules.md` — 项目规范
- `.trae/rules/coding_rules.md` — 编码规范

---

> **最后提醒**：这是一个为自己打造的工具，先让自己满意，其他的都是锦上添花。