c552199eed
- Create /docs structure (microdao, daarion, agents) - Organize 61 cursor technical docs - Add README files for each category - Copy key documents to public categories - Add GitHub setup instructions and scripts
122 lines
4.7 KiB
Markdown
122 lines
4.7 KiB
Markdown
# 📍 Інформація про проєкт MicroDAO
|
||
|
||
## 🗂️ Де зберігається проєкт
|
||
|
||
### Локальне зберігання
|
||
```
|
||
/Users/apple/Desktop/MicroDAO/MicroDAO 3
|
||
```
|
||
|
||
### Швидкий доступ
|
||
- **Символічне посилання:** `~/Desktop/MicroDAO-QuickAccess`
|
||
- **В Finder:** `⌘ + Shift + G` → вставити шлях вище
|
||
- **В Terminal:** `cd "/Users/apple/Desktop/MicroDAO/MicroDAO 3"`
|
||
|
||
## 💾 Continue / Pieces — що це?
|
||
|
||
**Continue** та **Pieces** — це розширення для IDE (Cursor/VS Code), які:
|
||
|
||
### Що вони роблять:
|
||
- ✅ Зберігають **історію розмов** з AI локально
|
||
- ✅ Запам'ятовують **контекст проєкту** для кращої роботи Cursor
|
||
- ✅ Дозволяють **швидко знаходити** попередні розмови
|
||
|
||
### Що вони НЕ роблять:
|
||
- ❌ НЕ зберігають сам проєкт (він на вашому диску)
|
||
- ❌ НЕ є хмарним сховищем
|
||
- ❌ НЕ синхронізують код між пристроями
|
||
|
||
### Де знаходиться історія Continue/Pieces:
|
||
- **Continue:** `~/.continue/` (прихована папка)
|
||
- **Pieces:** залежить від налаштувань, зазвичай в `~/Library/Application Support/`
|
||
|
||
**Ваш проєкт завжди на:** `/Users/apple/Desktop/MicroDAO/MicroDAO 3`
|
||
|
||
## 📓 Jupyter Notebook
|
||
|
||
### Чи можна зберігати проєкт в Jupyter?
|
||
|
||
**Jupyter Notebook** підходить для:
|
||
- ✅ Документації та аналізу даних
|
||
- ✅ Python скриптів та експериментів
|
||
- ✅ Візуалізацій та нотаток
|
||
- ❌ **НЕ** для React/TypeScript проєктів
|
||
|
||
### Якщо хочете використати Jupyter:
|
||
|
||
Можна створити окремі ноутбуки для:
|
||
- `docs/analysis.ipynb` — аналіз даних проєкту
|
||
- `docs/notes.ipynb` — нотатки та ідеї
|
||
- `docs/api_examples.ipynb` — приклади використання API
|
||
|
||
**Але основний код React залишається в `src/`**
|
||
|
||
## 🌐 Canvas Browser
|
||
|
||
### Чи можу я запустити проєкт в Canvas?
|
||
|
||
**Canvas Browser** — це інструмент для перегляду веб-сторінок, але:
|
||
|
||
1. **Я не можу безпосередньо запустити** React проєкт в Canvas
|
||
2. **Але можу допомогти:**
|
||
- Налаштувати проєкт для запуску
|
||
- Запустити dev server локально
|
||
- Відкрити браузер на `localhost:3000`
|
||
- Показати скріншот через Canvas
|
||
|
||
### Як запустити проєкт:
|
||
|
||
```bash
|
||
# 1. Встановити залежності (один раз)
|
||
cd "/Users/apple/Desktop/MicroDAO/MicroDAO 3"
|
||
npm install
|
||
|
||
# 2. Запустити dev server
|
||
npm run dev
|
||
|
||
# 3. Відкрити в браузері
|
||
# Автоматично відкриється http://localhost:3000
|
||
# Або відкрийте вручну: http://localhost:3000/onboarding
|
||
```
|
||
|
||
## 🔍 Швидкий пошук проєкту
|
||
|
||
### Варіант 1: Spotlight (macOS)
|
||
Натисніть `⌘ + Space` і введіть: `MicroDAO 3`
|
||
|
||
### Варіант 2: Terminal alias
|
||
Додайте в `~/.zshrc`:
|
||
```bash
|
||
alias microdao='cd "/Users/apple/Desktop/MicroDAO/MicroDAO 3"'
|
||
```
|
||
|
||
### Варіант 3: Символічне посилання
|
||
Вже створено: `~/Desktop/MicroDAO-QuickAccess`
|
||
|
||
## 📊 Структура проєкту
|
||
|
||
```
|
||
MicroDAO 3/
|
||
├── docs/cursor/ # Документація для Cursor
|
||
├── src/ # React код
|
||
│ ├── api/ # API клієнти
|
||
│ ├── components/ # React компоненти
|
||
│ ├── pages/ # Сторінки
|
||
│ └── types/ # TypeScript типи
|
||
├── package.json # Залежності
|
||
├── vite.config.ts # Vite конфігурація
|
||
└── QUICK_START.md # Інструкції запуску
|
||
```
|
||
|
||
## 🚀 Наступні кроки
|
||
|
||
1. **Встановити залежності:** `npm install`
|
||
2. **Запустити проєкт:** `npm run dev`
|
||
3. **Відкрити онбординг:** `http://localhost:3000/onboarding`
|
||
4. **Підключити Git:** див. `GIT_SETUP.md`
|
||
|
||
---
|
||
|
||
**Важливо:** Проєкт зберігається локально на вашому комп'ютері. Continue/Pieces лише допомагають Cursor згадувати контекст, але не зберігають сам код.
|
||
|