auto-sync: 2026-04-18 15:40:01
This commit is contained in:
@@ -25,6 +25,7 @@
|
||||
- Если работа не укладывается в существующий проект, сначала создаётся новый `Project`, затем задачи внутри него.
|
||||
- У `Task` есть уникальный идентификатор и отдельная папка внутри папки проекта.
|
||||
- У `Project` есть общая документация на уровне всей папки проекта.
|
||||
- Человеческое имя объекта хранится в `name` / `title`; машинный `id` остаётся внутренним и не должен быть частью читаемого названия в документации и папках.
|
||||
|
||||
---
|
||||
|
||||
@@ -52,9 +53,9 @@
|
||||
### Project
|
||||
| Поле | Тип | Обязательно | Описание |
|
||||
|------|-----|-------------|----------|
|
||||
| `name` | string | ✅ | Название проекта |
|
||||
| `name` | string | ✅ | Человеческое название проекта |
|
||||
| `status` | enum | ✅ | planning, active, paused, completed, archived |
|
||||
| `folder` | string | ✅ | Папка проекта: `tasks/{project}/` |
|
||||
| `folder` | string | ✅ | Папка проекта: `tasks/{project-slug}/` |
|
||||
| `doc_path` | string | ✅ | Главный файл проекта, обычно `PROJECT.md` |
|
||||
| `description` | string | — | Краткое описание |
|
||||
| `start_date` | date | — | Дата старта |
|
||||
@@ -63,8 +64,8 @@
|
||||
### Task
|
||||
| Поле | Тип | Обязательно | Описание |
|
||||
|------|-----|-------------|----------|
|
||||
| `title` | string | ✅ | Название задачи |
|
||||
| `project` | string | ✅ | ID проекта (proj_xxx) |
|
||||
| `title` | string | ✅ | Человеческое название задачи |
|
||||
| `project` | string | ✅ | ID проекта |
|
||||
| `folder` | string | ✅ | Папка задачи внутри проекта |
|
||||
| `doc_path` | string | ✅ | Главный файл задачи, обычно `TASK.md` |
|
||||
| `assignee` | string | — | Исполнитель |
|
||||
@@ -184,11 +185,12 @@ tasks/<project-slug>/TASKS/<status>/<task-id>/
|
||||
```
|
||||
|
||||
### Правило путей
|
||||
- `Project.folder` — папка проекта.
|
||||
- `Project.folder` — папка проекта, всегда читаемый slug.
|
||||
- `Project.doc_path` — главный документ проекта.
|
||||
- `Task.folder` — папка задачи внутри папки проекта.
|
||||
- `Task.folder` — папка задачи внутри папки проекта, всегда читаемый slug.
|
||||
- `Task.doc_path` — главный документ задачи.
|
||||
- `Task` всегда связан с `Project` и живёт внутри его структуры.
|
||||
- В именах папок и документов не использовать внутренние `id` как часть человекочитаемого названия; внутренний `id` хранится только в онтологии.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user