feat: Implement DMARC report parser with Vue.js dashboard (#1)

* feat: Implement DMARC report parser with Vue.js dashboard

This commit introduces a complete DMARC aggregate report parsing and visualization system, built as a single binary similar to listmonk.

## Backend (Go)

- **IMAP Client**: Connects to email servers and fetches DMARC reports
  - TLS support for secure connections
  - Automatic decompression (gzip/zip)
  - Filters for DMARC report attachments

- **RFC 7489 Compliant Parser**: Parses DMARC XML aggregate reports
  - Full schema support (metadata, policy, records)
  - DKIM and SPF authentication results
  - Policy evaluation and disposition tracking

- **SQLite Storage**: Embedded database with no external dependencies
  - Report metadata and detailed records
  - Efficient indexing for queries
  - Statistics aggregation

- **REST API**: Clean endpoints for dashboard data
  - /api/statistics - Overall compliance metrics
  - /api/reports - Paginated report listing
  - /api/reports/:id - Detailed report view
  - /api/top-sources - Top sending source IPs

## Frontend (Vue.js 3)

- **Modern SPA Dashboard**: Responsive, delightful UI
  - Real-time statistics cards
  - Top sending sources with pass/fail visualization
  - Recent reports table with compliance badges
  - Detailed modal view for individual reports
  - Auto-refresh every 5 minutes

- **Embedded in Binary**: Built frontend served from Go
  - Single binary deployment
  - No external static file server needed

## Features

- Minimal dependencies (only Go stdlib + 3 packages)
- Multiple operation modes (continuous, fetch-once, serve-only)
- Configurable fetch intervals
- Complete RFC 7489 compliance
- Production-ready deployment options

## Infrastructure

- Makefile for easy building
- Dockerfile for containerized deployment
- docker-compose.yml for quick start
- Systemd service template
- Comprehensive documentation

## Testing

- Unit tests for parser
- Manual API verification
- End-to-end build validation

Closes the initial implementation requirements for DMARC report parsing and visualization.

* Update internal/config/config.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.gitignore

@@ -27,6 +27,27 @@ go.work.sum
 # env file
 .env
 
+# Build artifacts
+bin/
+internal/api/dist/
+
+# Database
+*.db
+
+# Config files (sensitive)
+config.json
+
+# Node.js
+node_modules/
+frontend/node_modules/
+frontend/dist/
+
 # Editor/IDE
-# .idea/
-# .vscode/
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

CONTRIBUTING.md

@@ -0,0 +1,163 @@
+# Contributing to Parse DMARC
+
+Thank you for your interest in contributing to Parse DMARC! This document provides guidelines and instructions for contributing.
+
+## Development Setup
+
+### Prerequisites
+
+- Go 1.21 or higher
+- Node.js 18+ and npm
+- Git
+
+### Getting Started
+
+1. Fork and clone the repository:
+```bash
+git clone https://github.com/meysam81/parse-dmarc.git
+cd parse-dmarc
+```
+
+2. Install dependencies:
+```bash
+make install-deps
+```
+
+3. Build the project:
+```bash
+make build
+```
+
+## Project Structure
+
+```
+parse-dmarc/
+├── cmd/parse-dmarc/       # Main application entry point
+├── internal/
+│   ├── api/               # REST API and web server
+│   ├── config/            # Configuration management
+│   ├── imap/              # IMAP client for fetching emails
+│   ├── parser/            # DMARC XML parser
+│   └── storage/           # SQLite database layer
+├── frontend/              # Vue.js 3 dashboard
+│   ├── src/
+│   │   ├── components/
+│   │   ├── views/
+│   │   └── App.vue
+│   └── package.json
+├── Makefile
+├── Dockerfile
+└── README.md
+```
+
+## Development Workflow
+
+### Backend Development
+
+Run the application in development mode:
+```bash
+make dev
+```
+
+Run tests:
+```bash
+go test ./...
+```
+
+Add tests for new features in `*_test.go` files.
+
+### Frontend Development
+
+Start the frontend dev server with hot reload:
+```bash
+cd frontend
+npm run dev
+```
+
+Build the frontend:
+```bash
+cd frontend
+npm run build
+```
+
+### Making Changes
+
+1. Create a new branch:
+```bash
+git checkout -b feature/your-feature-name
+```
+
+2. Make your changes and commit:
+```bash
+git add .
+git commit -m "Description of changes"
+```
+
+3. Push and create a pull request:
+```bash
+git push origin feature/your-feature-name
+```
+
+## Code Style
+
+### Go Code
+
+- Follow standard Go formatting (`gofmt`)
+- Add comments for exported functions and types
+- Keep functions small and focused
+- Use meaningful variable names
+
+### Vue.js Code
+
+- Use Vue 3 Composition API
+- Follow Vue style guide
+- Keep components modular and reusable
+
+## Testing
+
+### Go Tests
+
+Add tests for all new functionality:
+```bash
+go test -v ./...
+```
+
+### Manual Testing
+
+1. Generate a config file:
+```bash
+./bin/parse-dmarc -gen-config
+```
+
+2. Edit config.json with test credentials
+
+3. Run in serve-only mode for UI testing:
+```bash
+./bin/parse-dmarc -serve-only
+```
+
+## Pull Request Guidelines
+
+- Ensure all tests pass
+- Update documentation if needed
+- Keep PRs focused on a single feature/fix
+- Write clear commit messages
+- Reference any related issues
+
+## Areas for Contribution
+
+- **Forensic Reports**: Add support for DMARC forensic reports (RUF)
+- **OAuth2**: Implement OAuth2 for IMAP authentication
+- **Export**: Add CSV/JSON export functionality
+- **Alerts**: Email alerts for compliance issues
+- **Analytics**: Historical trend analysis
+- **Documentation**: Improve docs and examples
+- **Tests**: Increase test coverage
+
+## Questions?
+
+Open an issue for questions or discussions.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

Dockerfile

@@ -0,0 +1,41 @@
+# Build stage
+FROM node:18-alpine AS frontend-builder
+
+WORKDIR /build/frontend
+COPY frontend/package*.json ./
+RUN npm install
+COPY frontend/ ./
+RUN npm run build
+
+# Go build stage
+FROM golang:1.21-alpine AS backend-builder
+
+RUN apk add --no-cache gcc musl-dev sqlite-dev
+
+WORKDIR /build
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY . .
+COPY --from=frontend-builder /build/internal/api/dist ./internal/api/dist
+
+RUN go build -o parse-dmarc ./cmd/parse-dmarc
+
+# Final stage
+FROM alpine:latest
+
+RUN apk add --no-cache ca-certificates sqlite-libs
+
+WORKDIR /app
+
+COPY --from=backend-builder /build/parse-dmarc .
+
+# Create directory for database
+RUN mkdir -p /data
+
+# Expose port
+EXPOSE 8080
+
+# Run the application
+ENTRYPOINT ["/app/parse-dmarc"]
+CMD ["-config=/data/config.json"]

Makefile

@@ -0,0 +1,55 @@
+.PHONY: all build frontend backend clean install-deps run dev test
+
+all: build
+
+# Install all dependencies
+install-deps:
+	@echo "Installing Go dependencies..."
+	go mod tidy
+	@echo "Installing Node.js dependencies..."
+	cd frontend && npm install
+
+# Build frontend
+frontend:
+	@echo "Building frontend..."
+	cd frontend && npm run build
+
+# Build backend (with embedded frontend)
+backend: frontend
+	@echo "Building Go binary..."
+	go build -o bin/parse-dmarc ./cmd/parse-dmarc
+
+# Full build
+build: frontend backend
+	@echo "Build complete! Binary available at ./bin/parse-dmarc"
+
+# Run in development mode
+dev:
+	@echo "Starting development server..."
+	go run ./cmd/parse-dmarc -config=config.json
+
+# Generate sample config
+config:
+	go run ./cmd/parse-dmarc -gen-config
+
+# Clean build artifacts
+clean:
+	@echo "Cleaning build artifacts..."
+	rm -rf bin/
+	rm -rf internal/api/dist/
+	rm -rf frontend/node_modules/
+	rm -f dmarc.db
+	rm -f config.json
+
+# Run tests
+test:
+	go test -v ./...
+
+# Install binary to system
+install: build
+	@echo "Installing to /usr/local/bin..."
+	sudo cp bin/parse-dmarc /usr/local/bin/
+
+# Development frontend server
+frontend-dev:
+	cd frontend && npm run dev