init commit

2026-03-17 23:19:28 +07:00
commit 221edcda16
58 changed files with 11938 additions and 0 deletions
@@ -0,0 +1,23 @@
+---
+description: Паттерны для React, api, utils
+globs: src/**/*.{js,jsx}
+alwaysApply: false
+---
+
+# Frontend conventions
+
+## React
+
+- Функциональные компоненты
+- Страницы в `pages/`, общие компоненты в `components/`
+- Данные загружаются в App.jsx через `loadDataSet()`, передаются в страницы как `db` и `actions`
+
+## API
+
+- `src/lib/api.js` — fetchApi, loadDataSet, createRecord, updateRecord, deleteRecord
+- Коллекции: vps, providers, providerAccounts, payments, balanceLedger, settings
+- Дополнительно: syncAccount, fetchAccountBalance, testApiConnection
+
+## Utils
+
+- `src/lib/utils.js` — форматирование (formatCurrency), конвертация валют, лейблы (paymentTypeLabel), CSV
@@ -0,0 +1,26 @@
+---
+description: Структура проекта vps-tracker и соглашения по именованию
+alwaysApply: true
+---
+
+# Структура проекта vps-tracker
+
+## Папки
+
+- `server/` — Express backend, SQLite (sql.js)
+- `src/` — React frontend (Vite)
+- `server/adapters/` — один адаптер на провайдера API (billmanager)
+- `server/routes/` — Express роутеры по сущностям
+- `server/db/` — схема, миграции, seed
+
+## Именование
+
+- Файлы: kebab-case (provider-accounts.js, row-mappers.js)
+- Роуты: `/api/vps`, `/api/provider-accounts`, `/api/sync/:accountId`
+- ID записей: `vps-bm-{accountId}-{externalId}`, `pay-bm-{accountId}-{externalId}`
+
+## Barrel exports
+
+Модули с несколькими файлами экспортируют через `index.js`:
+- `server/adapters/billmanager/index.js` — testConnection, syncFromBillmanager, fetchDashboardInfo
+- `server/db/index.js` — initDb, getDb, saveDb
@@ -0,0 +1,25 @@
+---
+description: Паттерны для Express, db, adapters
+globs: server/**/*.js
+alwaysApply: false
+---
+
+# Server conventions
+
+## Express
+
+- Роутеры в `routes/`, подключаются в `index.js` через `app.use('/api/...', router)`
+- Ошибки: `res.status(500).json({ error: err.message })`
+- 404: `res.status(404).json({ error: 'Not found' })`
+
+## Database
+
+- Доступ через `getDb()` — обёртка с `prepare().all()`, `prepare().get()`, `run()`
+- После `run()` вызывается `saveDb()` автоматически
+- Миграции в `db/migrations.js`, добавляют колонки через ALTER TABLE
+
+## Adapters
+
+- Один провайдер = папка в `adapters/` (billmanager)
+- Разделение: client (HTTP), parsers, mappers, operations, sync
+- Публичный API через `index.js`