130 lines
3.6 KiB
Markdown
130 lines
3.6 KiB
Markdown
# 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)
|