Initial commit: HOA Financial Intelligence Platform MVP

Multi-tenant financial management platform for homeowner associations featuring:
- NestJS backend with 16 modules (auth, accounts, transactions, budgets, units,
  invoices, payments, vendors, reserves, investments, capital projects, reports)
- React + Mantine frontend with dashboard, CRUD pages, and financial reports
- Schema-per-tenant PostgreSQL isolation with JWT-based tenant resolution
- Docker Compose infrastructure (nginx, backend, frontend, postgres, redis)
- Comprehensive seed data for Sunrise Valley HOA demo
- 39 API endpoints with Swagger documentation
- Double-entry bookkeeping with journal entries
- Budget vs actual reporting and Sankey cash flow visualization

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

backend/src/modules/vendors/vendors.controller.ts

@@ -0,0 +1,29 @@
+import { Controller, Get, Post, Put, Body, Param, Query, UseGuards } from '@nestjs/common';
+import { ApiTags, ApiBearerAuth } from '@nestjs/swagger';
+import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard';
+import { VendorsService } from './vendors.service';
+
+@ApiTags('vendors')
+@Controller('vendors')
+@ApiBearerAuth()
+@UseGuards(JwtAuthGuard)
+export class VendorsController {
+  constructor(private vendorsService: VendorsService) {}
+
+  @Get()
+  findAll() { return this.vendorsService.findAll(); }
+
+  @Get('1099-data')
+  get1099Data(@Query('year') year: string) {
+    return this.vendorsService.get1099Data(parseInt(year) || new Date().getFullYear());
+  }
+
+  @Get(':id')
+  findOne(@Param('id') id: string) { return this.vendorsService.findOne(id); }
+
+  @Post()
+  create(@Body() dto: any) { return this.vendorsService.create(dto); }
+
+  @Put(':id')
+  update(@Param('id') id: string, @Body() dto: any) { return this.vendorsService.update(id, dto); }
+}

backend/src/modules/vendors/vendors.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { VendorsController } from './vendors.controller';
+import { VendorsService } from './vendors.service';
+
+@Module({
+  controllers: [VendorsController],
+  providers: [VendorsService],
+  exports: [VendorsService],
+})
+export class VendorsModule {}

backend/src/modules/vendors/vendors.service.ts

@@ -0,0 +1,61 @@
+import { Injectable, NotFoundException, BadRequestException } from '@nestjs/common';
+import { TenantService } from '../../database/tenant.service';
+
+@Injectable()
+export class VendorsService {
+  constructor(private tenant: TenantService) {}
+
+  async findAll() {
+    return this.tenant.query('SELECT * FROM vendors WHERE is_active = true ORDER BY name');
+  }
+
+  async findOne(id: string) {
+    const rows = await this.tenant.query('SELECT * FROM vendors WHERE id = $1', [id]);
+    if (!rows.length) throw new NotFoundException('Vendor not found');
+    return rows[0];
+  }
+
+  async create(dto: any) {
+    const rows = await this.tenant.query(
+      `INSERT INTO vendors (name, contact_name, email, phone, address_line1, city, state, zip_code, tax_id, is_1099_eligible, default_account_id)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11) RETURNING *`,
+      [dto.name, dto.contact_name, dto.email, dto.phone, dto.address_line1, dto.city, dto.state, dto.zip_code,
+       dto.tax_id, dto.is_1099_eligible || false, dto.default_account_id || null],
+    );
+    return rows[0];
+  }
+
+  async update(id: string, dto: any) {
+    await this.findOne(id);
+    const rows = await this.tenant.query(
+      `UPDATE vendors SET name = COALESCE($2, name), contact_name = COALESCE($3, contact_name),
+       email = COALESCE($4, email), phone = COALESCE($5, phone), address_line1 = COALESCE($6, address_line1),
+       city = COALESCE($7, city), state = COALESCE($8, state), zip_code = COALESCE($9, zip_code),
+       tax_id = COALESCE($10, tax_id), is_1099_eligible = COALESCE($11, is_1099_eligible),
+       default_account_id = COALESCE($12, default_account_id), updated_at = NOW()
+       WHERE id = $1 RETURNING *`,
+      [id, dto.name, dto.contact_name, dto.email, dto.phone, dto.address_line1, dto.city, dto.state,
+       dto.zip_code, dto.tax_id, dto.is_1099_eligible, dto.default_account_id],
+    );
+    return rows[0];
+  }
+
+  async get1099Data(year: number) {
+    return this.tenant.query(`
+      SELECT v.*, COALESCE(SUM(p_amounts.amount), 0) as total_paid
+      FROM vendors v
+      LEFT JOIN (
+        SELECT jel.account_id, jel.debit as amount, je.entry_date
+        FROM journal_entry_lines jel
+        JOIN journal_entries je ON je.id = jel.journal_entry_id
+        WHERE je.is_posted = true AND je.is_void = false
+          AND EXTRACT(YEAR FROM je.entry_date) = $1
+          AND jel.debit > 0
+      ) p_amounts ON p_amounts.account_id = v.default_account_id
+      WHERE v.is_1099_eligible = true
+      GROUP BY v.id
+      HAVING COALESCE(SUM(p_amounts.amount), 0) >= 600
+      ORDER BY v.name
+    `, [year]);
+  }
+}