kamaskandClaude Opus 5.5
82e097f876
- playwright.config.ts: test PocketBase (port 8190) and ng serve (port 4300) as webServers, SIGTERM shutdown so the stand removes its temp dir - fixtures: user via open registration, api SDK client, signedInPage with pb_auth cookie - expectNoA11yViolations runs all axe rules (WCAG and best-practice) - render home route on the server; main and h1 placeholder in app shell - config tests for playwright.config.ts in test:lint; docs updated Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.4 KiB
Pchelpcrm
CRM для частных мастеров: учёт клиентов и заявок для компьютерной помощи, мелкого ремонта, сборки мебели, сантехники, электрики и любых других работ «клиент обратился — работа выполнена».
Система многопользовательская: каждый мастер регистрируется сам и работает только со своими данными.
Возможности
- Регистрация и вход по email и паролю.
- Клиенты: телефоны, контакты, адрес, ссылки на профили на площадках, заметка; поиск по имени и телефону; история заявок клиента.
- Заявки: статус, дата визита, адрес, сумма, что сделано, примечания мастера, отзыв клиента, ссылка на заказ на площадке, фото и аудио.
- Метки вместо категорий и источников: мастер сам заводит «Установка Windows», «YouDo», «Сарафан» и вешает на заявку сколько угодно.
- Поиск и фильтры заявок по тексту, статусу, меткам и периоду.
- Публичная ссылка на заявку для клиента: суть работы без данных клиента и вложений.
- Серверный рендер главной, карточки заявки и публичной страницы.
Понятия
| Понятие | Что это |
|---|---|
| Пользователь | мастер, владелец аккаунта |
| Клиент | заказчик мастера |
Заявка (Order) |
заказ; принадлежит одному клиенту, у клиента может быть много заявок |
Метка (Tag) |
ярлык заявки, который мастер создаёт сам |
| Публичная ссылка | страница заявки для клиента по случайному токену |
Стек
- Angular 22 с SSR, чистый CSS
- PocketBase 0.40 — база данных, аутентификация, файлы и API
- pnpm
- Vitest и Playwright — тесты
Быстрый старт
Нужны Node.js 22+, pnpm и бинарник pocketbase 0.40.x в PATH.
pnpm install
cp .env.example .env # заполнить PB_SUPERUSER_EMAIL и PB_SUPERUSER_PASSWORD
pnpm pb:superuser # создать суперпользователя PocketBase
pnpm pb:serve # PocketBase на http://127.0.0.1:8090, админка — /_/
pnpm start # приложение на http://localhost:4200/
В разработке браузер обращается к PocketBase по пути /pb/*, его проксирует dev-сервер Angular.
Команды
| Команда | Что делает |
|---|---|
pnpm start |
dev-сервер приложения |
pnpm build |
production-сборка в dist/ |
pnpm lint |
ESLint |
pnpm test |
unit-тесты |
pnpm test:api |
API-тесты PocketBase: схема, правила доступа, изоляция пользователей |
pnpm test:integration |
репозитории приложения против тестового PocketBase |
pnpm test:lint |
тесты конфигов ESLint, dev-прокси и Playwright; первый шаг test, test:api, test:integration, e2e |
pnpm e2e |
сценарии в браузере и проверка доступности (axe) |
pnpm e2e:prod |
сценарии на production-сборке |
pnpm pb:serve |
PocketBase для разработки |
pnpm pb:migrate |
применить миграции |
pnpm pb:superuser |
создать суперпользователя или сбросить его пароль |
Тесты, которым нужен PocketBase, сами поднимают временный экземпляр и не трогают pocketbase/pb_data. Перед первым запуском e2e установите браузер: pnpm exec playwright install chromium. Стенд e2e использует свои порты (PocketBase — 8190, приложение — 4300), поэтому не мешает pnpm pb:serve и pnpm start.
Структура репозитория
src/
app/ приложение Angular, по папке на фичу (auth, clients, orders, tags, share, …)
server.ts Node SSR-сервер
pocketbase/
pb_migrations/ схема базы данных (JS-миграции)
pb_hooks/ кастомные маршруты и хуки PocketBase
pb_data/ локальная база (не в git)
tests/
api/ API-тесты PocketBase
e2e/ браузерные тесты
support/ тестовый PocketBase и хелперы
scripts/ служебные скрипты
docs/ документация разработчика
Документация
Документация разработчика лежит в docs/:
- architecture.md — общая схема, слои, DI, SSR и изоляция данных, nginx, принципы UI;
- data-model.md — коллекции PocketBase, поля и правила доступа;
- testing.md — уровни тестов и тестовый PocketBase;
docs/guide/— руководство по каждой части приложения: где лежит код, как им пользоваться и как его расширить. Пополняется вместе с кодом.
Production
Схема: nginx отдаёт /pb/* в PocketBase (префикс /pb срезается), всё остальное — в Node SSR-сервер. Пример конфигурации nginx — в docs/architecture.md.
pnpm build
pocketbase serve --dir /path/to/pb_data --migrationsDir pocketbase/pb_migrations --hooksDir pocketbase/pb_hooks --automigrate=false --http 127.0.0.1:8090
PB_DIR=/path/to/pb_data node --env-file=.env scripts/pb-superuser.mjs
PB_URL=http://127.0.0.1:8090 PORT=4000 node dist/pchelpcrm/server/server.mjs
| Переменная | Назначение |
|---|---|
PB_URL |
внутренний адрес PocketBase для SSR-сервера и dev-прокси, по умолчанию http://127.0.0.1:8090 |
PORT |
порт Node SSR-сервера, по умолчанию 4000 |
PB_DIR |
папка данных PocketBase для скрипта pb:superuser |
PB_SUPERUSER_EMAIL, PB_SUPERUSER_PASSWORD |
суперпользователь PocketBase (скрипт pb:superuser) |
Резервная копия — копирование папки pb_data. После первого релиза приложение планируется поставлять одним Docker-контейнером (SSR-сервер и PocketBase вместе).