# SCHAFWASCHENER SEGELVEREIN Voting System

A secure web application for conducting online votes for SCHAFWASCHENER SEGELVEREIN club members.

## Features

- **Secure One-Time Voting Links**: Admin can generate unique, one-time use voting links that are cryptographically signed.
- **Simple Voting Interface**: Members can easily vote Yes, No, or Abstain on proposed statute amendments.
- **Optional Comments**: Members can provide anonymous feedback or suggestions.
- **Results Dashboard**: Admin can view real-time voting statistics.
- **Dark Mode Support**: Automatically adapts to user's system preferences.
- **WYSIWYG Text Editor**: Admin can edit text content using a rich text editor.
- **JWT Authentication**: Admin authentication using JWT tokens stored in cookies.
- **Secure Key Management**: JWT keys are randomly generated and stored securely.

## Technical Implementation

- Built with Next.js 15 and React 19
- Styled with Tailwind CSS
- JWT-like token system for secure, one-time voting links
- File-based storage for vote data

## Getting Started

### Prerequisites

- Node.js 18+ and npm

### Installation

1. Clone the repository
2. Install dependencies:
   ```
   npm install
   ```
3. Run the development server:
   ```
   npm run dev
   ```
4. Open [http://localhost:3000](http://localhost:3000) in your browser

### Admin Access

The default admin password is `schafwaschener-segelverein-admin`. This can be changed by setting the `ADMIN_PASSWORD` environment variable.

Once logged in, the admin session is maintained using JWT tokens, so you don't need to enter the password for each action.

## Usage

### Admin

1. Navigate to `/admin` and enter the admin password
2. Generate voting links and share them with club members
3. View voting statistics in real-time

### Voters

1. Click on the unique voting link received
2. Select your vote (Yes, No, or Abstain)
3. Optionally add comments or suggestions
4. Submit your vote

## Environment Variables

- `ADMIN_PASSWORD`: Password for admin access (default: "schafwaschener-segelverein-admin")
- `NEXT_PUBLIC_BASE_URL`: Base URL for generating voting links (default: auto-detected)
- `JWT_SECRET_KEY`: Secret key for JWT signing (default: randomly generated)

## Production Deployment

### Standard Deployment

For production deployment, consider the following:

1. Set a secure admin password using the `ADMIN_PASSWORD` environment variable
2. Set a secure JWT secret key using the `JWT_SECRET_KEY` environment variable
3. Use a database instead of file-based storage
4. Set up HTTPS for secure communication

### Docker Deployment

The application can be easily deployed using Docker:

#### Using Docker Compose (Recommended)

1. Make sure you have Docker and Docker Compose installed
2. Run the application:
   ```
   docker-compose up -d
   ```
   Or with a custom admin password:
   ```
   ADMIN_PASSWORD=your-secure-password docker-compose up -d
   ```
3. Access the application at [http://localhost:3000](http://localhost:3000)
4. To stop the application:
   ```
   docker-compose down
   ```

#### Using Docker Directly

1. Build the Docker image:
   ```
   ./build-docker.sh
   ```
   or manually:
   ```
   docker build -t ssvc-rimsting-vote:latest .
   ```

2. Run the container:
   ```
   docker run -p 3000:3000 ssvc-rimsting-vote:latest
   ```

3. For persistent data storage and custom admin password:
   ```
   docker run -p 3000:3000 -v $(pwd)/data:/app/data -e ADMIN_PASSWORD=your-secure-password ssvc-rimsting-vote:latest
   ```

## License

This project is proprietary and confidential. Unauthorized copying, distribution, or use is strictly prohibited.

© SCHAFWASCHENER SEGELVEREIN