Карта модулей
Это краткая карта backend-модулей CRM RMS: за что отвечает каждый пакет, какие endpoint-группы он открывает и где читать подробный бизнес-контекст.
Общая схема
Доменные модули находятся в internal/modules/*. Большинство модулей имеют одинаковую структуру: model.go, service.go, repository_pg.go, transport_http.go, тесты.
CRM
companies / contacts / requisites / entitylinks
Projects
projects / projectteam / teamrequests / tasks / timeentries
Operations
locations / equipment / equipmentrequests / logistics / trips / suppliers
Finance
finance / budget / payments / contracts / payroll
Content
files / documents / chats / notifications
Platform
auth / users / rbac / audit / departments / org / directory / dashboard / reports / kpi / searchCRM-контур
| Модуль | API | Назначение |
|---|---|---|
companies | /api/v1/companies | Компании, карточки, Dadata-подсказки, PDF-карточка |
contacts | /api/v1/contacts | Контактные лица |
companycontacts | /api/v1/companies/:id/contacts, /api/v1/contacts/:id/companies | M:M-связь контактов и компаний |
companybankaccounts | /api/v1/companies/:id/bank-accounts | Банковские счета компании |
requisites | /api/v1/requisites, /api/v1/settings/my-company/requisites | Реквизиты компаний, контактов и собственной организации |
entitylinks | /api/v1/entities/:type/:id/related, /api/v1/entity-links | Навигационный хаб и произвольные связи |
Подробнее: Клиенты, контакты и связи.
Проектный контур
| Модуль | API | Назначение |
|---|---|---|
projects | /api/v1/projects | Карточка проекта, статусы, спецификации, экспорт |
projectteam | /api/v1/project-team, /api/v1/projects/:id/team-history | Состав команды, проектные роли, история |
teamrequests | /api/v1/projects/:id/team-requests, /api/v1/team-requests/:id | Запрос ресурсов из отделов |
tasks | /api/v1/tasks, /api/v1/projects/:id/tasks | Задачи, статусы, рабочие сессии, комментарии |
timeentries | /api/v1/time-entries | Учет времени и reminders |
Подробнее: Жизненный цикл проекта, Управление командой.
Операционный контур
| Модуль | API | Назначение |
|---|---|---|
locations | /api/v1/locations | Склады, площадки, офисы, города, маршруты |
equipment | /api/v1/equipment | Каталог оборудования, stock snapshot |
suppliers | /api/v1/suppliers | Поставщики |
equipmentrequests | /api/v1/equipment-requests, /api/v1/projects/:id/equipment-requests | Фасад заявки PM -> финансы -> закупки/логистика |
logistics | /api/v1/logistics | Низкоуровневые операции, маршруты, финсогласование, закрытие |
trips | /api/v1/trips | Командировки, согласование, попутные задачи, travel cost items |
Подробнее: Логистический контур, Командировки.
Финансовый, бухгалтерский и юридический контуры
| Модуль | API | Назначение |
|---|---|---|
finance | /api/v1/finance | Cost items, проектная финансовая сводка, экспорт |
budget | /api/v1/projects/:id/budget | Смета проекта, наценка, итог |
payments | /api/v1/accounts, /api/v1/payments, /api/v1/counterparties, /api/v1/reports/... | Кассы/счета, платежи, сверка, ДДС, дебиторка, НДС |
contracts | /api/v1/contracts | Юридический реестр, сроки, legal card |
payroll | /api/v1/compensation-profiles, /api/v1/payroll | Условия оплаты, ведомости, выплаты |
Подробнее: Система бюджета, Касса и платежи, Юридический реестр, Зарплата.
Контент и документы
| Модуль | API | Назначение |
|---|---|---|
files | /api/v1/files, /api/v1/projects/:id/files, /api/v1/tasks/:id/files, /api/v1/folders/:id/files | Загрузка, хранение, папки, превью |
documents | /api/v1/documents, /api/v1/document-templates, /api/v1/projects/:id/documents/... | Generated documents, шаблоны, статусы, скачивание |
reports | /api/v1/reports/... | Агрегированные отчеты |
dashboard | /api/v1/dashboard/overview | Операционный обзор |
kpi | /api/v1/kpi/time-logging | KPI учета времени |
Подробнее: Система документов, Система бюджета.
Коммуникации
| Модуль | API | Назначение |
|---|---|---|
chats | /api/v1/chats, /api/v1/tasks/:id/chat, /ws/chat | Direct/group/project/task chats, сообщения, реакции, файлы |
notifications | /api/v1/notifications, /ws/notifications | Notification center, unread state, email outbox |
Подробнее: Система чатов, Система уведомлений.
Пользователи, оргструктура и доступы
| Модуль | API | Назначение |
|---|---|---|
auth | /api/v1/auth | Login, refresh, logout, register, password reset, email verification |
audit | /api/v1/entities/:type/:id/timeline, /api/v1/audit/events | История действий по сущностям, auth/security события, outbox worker |
users | /api/v1/users | Пользователи, профиль, avatar, security, profile tabs |
rbac | /api/v1/rbac, /api/v1/users/:id/roles, /api/v1/users/:id/permissions | Роли, permissions, policies, user overrides |
departments | /api/v1/departments | Отделы, руководители отделов |
org | /api/v1/org | Должности, руководители, дерево, цепочки, подчиненные |
directory | /api/v1/directory/users | Легкий справочник пользователей для форм |
search | /api/v1/search | Глобальный поиск |
Подробнее: Security & RBAC, Audit Timeline, Оргструктура и админский UI, Глобальный поиск.
Межмодульные связи
Project -> Tasks -> Time Entries
Задачи создают рабочие сессии и auto time entries при pause/finish. Автосинхронизация задач может переводить проект в in_progress и done.
Logistics -> Finance -> Budget
Логистическая операция после финансового решения или закрытия обновляет finance.cost_items, а budget уже агрегирует эти строки.
Trips -> Tasks + Finance
Командировка создает попутные задачи и синхронизирует travel cost item.
Documents -> Files + Finance + Payments
Generated documents создают файлы, участвуют в выручке/статусах и закрываются платежами через allocations.
Chats -> Notifications
Обычные chat events идут через /ws/chat; важные события и badge создаются в notifications и доставляются через /ws/notifications.