apps/api/src/modules/README.md

# Модули Кодекса

Сюда Кодекс кладёт файлы-плагины Fastify: `finance.js`, `tasks.js`, `social.js`, `calendar.js`.
Сервер (`src/server.js`) подхватывает их автоматически — все `*.js` отсюда.

## Шаблон модуля

```js
// src/modules/finance.js
import crypto from 'node:crypto';
import { db } from '../core/db.js';
import { bus } from '../core/bus.js';
import { requireMember } from '../core/guards.js';

export default async function financeRoutes(fastify) {
  fastify.get('/spaces/:id/transactions', async (request) => {
    await requireMember(request, request.params.id);
    const transactions = db
      .prepare('SELECT * FROM transactions WHERE space_id = ? ORDER BY created_at DESC')
      .all(request.params.id);
    return { transactions };
  });

  fastify.post('/spaces/:id/transactions', async (request, reply) => {
    await requireMember(request, request.params.id);
    // ... валидация по CONTRACT.md ...
    const tx = { /* ... */ };
    // db.prepare(...).run(...)
    bus.emit(request.params.id, { type: 'tx.created', space_id: request.params.id, payload: tx });
    return reply.code(201).send({ transaction: tx });
  });
}
```

Доступно из ядра:
- `db`           — better-sqlite3 (см. `core/db.js`)
- `bus`          — реалтайм-шина: `bus.emit(spaceId, { type, space_id, payload })`
- `requireMember(request, spaceId)` — бросает 403/404 (ядро ловит и форматирует ошибку)

Не трогай `core/`, `server.js`. Ошибки из `requireMember` ядро обрабатывает само
(глобальный errorHandler), поэтому можно просто `await requireMember(...)` без try/catch.