# V1 Documentation (Deprecated)

!!! warning "V1 is Legacy"
    Changemaker Lite V1 is deprecated and no longer actively maintained. These docs are preserved for reference only.

## Migrating to V2

Changemaker Lite V2 is a complete architectural rebuild with significant improvements:

A quick test because why not. 

### Why Upgrade to V2?

**Modern Stack**
- TypeScript throughout (V1 was JavaScript)
- Prisma ORM (V1 used NocoDB REST API)
- JWT auth (V1 used session cookies)
- React admin (V1 used server-rendered HTML)

**Better Performance**
- Direct database access (no NocoDB middleware)
- Redis-backed caching and rate limiting
- BullMQ job queues for async operations
- Optimized queries with Prisma

**Enhanced Security**
- Security audit completed (Feb 2026)
- Password policy enforcement (12+ chars, complexity)
- Refresh token rotation in transactions
- XSS/injection prevention throughout
- Rate limiting on all sensitive endpoints

**New Features**
- Volunteer canvassing system with GPS tracking
- Landing page builder (GrapesJS)
- Email template management
- Media library (video management)
- Observability dashboard (Prometheus + Grafana)
- NAR 2025 data import (Canadian electoral data)

[View complete V2 documentation →](../v2/index.md){ .md-button .md-button--primary }

## Migration Guide

Ready to migrate? Follow our step-by-step guide:

[→ V1 to V2 Migration Guide](../v2/migration/index.md){ .md-button }

The migration guide covers:

1. **Breaking Changes** - NocoDB → Prisma, API endpoint changes
2. **Data Migration** - Export V1 data, transform, import to V2
3. **Configuration Changes** - Environment variables, service names
4. **Feature Parity** - V1 vs V2 feature comparison

## V1 Documentation Archive

These docs are preserved for existing V1 installations:

### Build Guides
- [Build Overview](build/index.md)
- [Build Server](build/server.md)
- [Build Map](build/map.md)
- [Build Influence](build/influence.md)
- [Build Site](build/site.md)

### Services
- [Services Overview](services/index.md)
- [Homepage](services/homepage.md)
- [Code Server](services/code-server.md)
- [MKDocs](services/mkdocs.md)
- [Listmonk](services/listmonk.md)
- [PostgreSQL](services/postgresql.md)
- [n8n](services/n8n.md)
- [NocoDB](services/nocodb.md)
- [Gitea](services/gitea.md)
- [Map](services/map.md)
- [Mini QR](services/mini-qr.md)

### Configuration
- [Config Overview](config/index.md)
- [Cloudflare](config/cloudflare-config.md)
- [MKdocs](config/mkdocs.md)
- [Code Server](config/coder.md)
- [Map](config/map.md)

### Manuals
- [Manual Overview](manual/index.md)
- [Map Manual](manual/map.md)

### Advanced
- [Advanced Overview](adv/index.md)
- [SSH + Tailscale + Ansible](adv/ansible.md)
- [SSH + VScode](adv/vscode-ssh.md)

## V1 Architecture (Reference)

V1 used a two-app architecture with NocoDB as the data layer:

**Influence App** (port 3333)
- Express.js server with server-rendered HTML
- NocoDB REST API for database operations
- Session-based authentication (Redis)
- Bull job queues for emails

**Map App** (port 3000)
- Express.js server with Leaflet.js maps
- NocoDB REST API for database operations
- QR code generation
- Volunteer shift management

**Shared Infrastructure**
- NocoDB (data layer)
- Redis (sessions, cache, queues)
- PostgreSQL (via NocoDB)
- Cloudflare tunnels

## Support for V1

V1 is no longer under active development. We recommend migrating to V2.

For critical V1 issues:
- Check existing V1 documentation
- Review V1 code in `/influence` and `/map` directories
- Consider migrating to V2

---

**Ready to upgrade?** [Start with the V2 Quick Start Guide →](../v2/getting-started/quick-start.md)