# Open-PriTime

**Repository Path**: zcic/Open-PriTime

## Basic Information

- **Project Name**: Open-PriTime
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Open-PriTime

PriTime 的开源部分：**后端 API + Web 前端**。

> [!CAUTION]
> ### ⚠️ 禁止商业用途
>
> 本项目**不支持任何形式的商业用途**，包括但不限于：
>
> - 将本项目的全部或部分代码用于商业产品、商业服务、收费功能或营利性业务；
> - 对本项目进行二次开发、修改、衍生后用于商业用途（即**二次开发的商业用途同样禁止**）；
> - 以本项目为基础搭建对外提供服务的 SaaS、托管服务或转售。
>
> 允许的范围仅限：**个人学习、研究与非商业性质的自用部署**。
>
> 如需商业授权，请先通过 Issue 联系作者另行取得书面许可。

![image.png](image.png)

PriTime 是一个多端待办任务管理应用，支持任务、清单、标签、优先级、提醒、重复、四象限视图、日历、回收站与 AI 助手等能力。本仓库以 **PolyForm Noncommercial 1.0.0**（源码可用、禁商用）开放其中的服务端与 Web 客户端，供个人学习研究与**非商业**自用部署、二次开发使用。

## 目录结构

| 目录 | 说明 |
| --- | --- |
| `todo_api/` | Ruby on Rails 8 JSON API（PostgreSQL + Puma） |
| `todo_web/` | Vue 3 + Vite + Pinia Web 前端 |

## 快速开始

### 后端 API（`todo_api/`）

环境要求：Ruby 3.2+、PostgreSQL 14+。

```bash
cd todo_api

bundle install
cp .env.example .env     # 按需修改 DB_HOST / DB_USERNAME / DB_PASSWORD
rails db:create db:migrate
bin/rails server         # 默认监听 http://localhost:3000

curl http://localhost:3000/api/health   # 健康检查
```

主要接口：

- `GET/POST/PUT/DELETE /api/tasks` — 任务 CRUD，支持 `view`、`list_id`、`tag_id`、`q` 筛选
- `PATCH /api/tasks/:id/toggle` — 切换完成状态
- `PATCH /api/tasks/:id/trash`、`restore`，`DELETE /api/tasks/trash/empty` — 回收站
- `GET/POST/PUT/DELETE /api/task_lists` — 清单
- `GET/POST/PUT/DELETE /api/tags` — 标签
- `POST /api/ai/chat`、`GET/PUT /api/ai/settings` — AI 助手（DeepSeek，可选）
- `POST /api/mcp` — MCP 接口，供支持 MCP 的 AI 客户端创建任务
- `/api/push/*` — Web Push 订阅与提醒推送

### Web 前端（`todo_web/`）

环境要求：Node.js 18+。

```bash
cd todo_web

npm install
npm run dev       # 开发模式 http://localhost:5173，/api 自动代理到后端 :3000
npm run build     # 构建生产包到 dist/
```

前后端通过 `rack-cors` 处理跨域，生产环境请在 `todo_api/config/initializers/cors.rb` 中限制允许的来源。

## 许可与商用

代码采用 **PolyForm Noncommercial 1.0.0** 授权，详见 [LICENSE](LICENSE)。

> **再次强调：本项目禁止商业用途，二次开发后用于商业用途同样禁止。**
> 该许可证只允许**非商业目的**的使用，包括个人学习、研究、实验、业余项目，以及慈善 / 教育 / 公共研究 / 政府机构的非商业使用；任何商业使用（含二次开发的商业使用）均须事先取得作者的单独书面授权。

### 允许 ✅

- 个人自用部署、学习与研究
- 修改源码、二次开发，并在**同样仅限于非商业用途**的前提下分发
- 在分发副本时保留本许可条款与版权声明

### 禁止 ❌

- 用于商业产品、商业服务、收费功能或任何以营利为目的的场景
- 二次开发、衍生后的商业使用（同样禁止）
- 基于本项目搭建对外提供服务的 SaaS / 托管服务或转售

> 本许可**不是** OSI 认证的开源许可证，而是「源码可用（source-available）」许可。请勿将本项目表述为「可自由商用」。