# Dusty Marble - RPNAB Invoicing Portal

This is a Rust-based single-page web application for Rent & Petroleum Nordic AB, designed to streamline internal operations and provide customers with access to their invoice documents.

## 🎯 Project Goal

The primary goal is to make invoicing more efficient by:
- Allowing internal users to upload structured transaction lists (CSV)
- Converting those transactions into a format suitable for invoice attachments
- Giving customers secure access to view/download their invoices

The application will include both a web UI and a command-line interface for administrative tasks.

---

## 🧰 Tech Stack

### Core Technologies

| Layer         | Tool            | Notes                                      |
|---------------|------------------|--------------------------------------------|
| Frontend      | [Leptos](https://github.com/leptos-rs/leptos)       | Rust SPA framework with reactive UI        |
| Backend       | [Axum](https://github.com/tokio-rs/axum)           | Lightweight async Rust web framework       |
| Database      | MariaDB + [`sqlx`](https://github.com/launchbadge/sqlx) | Compile-time checked queries               |
| Migrations    | [Goose](https://github.com/sifrr/goose)            | Simple SQL-based migration tool            |
| CLI Tooling   | Rust + [`clap`](https://github.com/clap-rs/clap)   | For admin-only workflows                   |
| CSV Parsing   | [`csv`](https://docs.rs/csv/latest/csv/)           | Robust parser with `serde` integration     |
| PDF Generation| HTML + `wkhtmltopdf` or `weasyprint`               | For generating styled invoice documents    |
| Styling       | Tailwind CSS (optional)                            | Utility-first styling                      |

---

## 🗺️ Development Plan

### Phase 1: Project Setup
- [x] Set up Git repository
- [ ] Initialize Cargo workspace
- [ ] Create initial `README.md`
- [ ] Set up Gitea repository

### Phase 2: Core Infrastructure
- [ ] Set up `frontend/` and `backend/` crates
- [ ] Configure `sqlx` and `Goose` for MariaDB
- [ ] Define initial DB schema
- [ ] Add `.env` for local secrets

### Phase 3: Admin Interface
- [ ] Implement login system for internal user
- [ ] Create CLI for uploading CSV files
- [ ] Parse CSV and store transactions in DB
- [ ] Implement basic web UI for uploading and verifying CSV data

### Phase 4: Customer Portal
- [ ] Implement customer login system
- [ ] Create UI for listing invoices
- [ ] Render invoices as HTML
- [ ] Enable download of invoices as PDF

### Phase 5: Polish and Deployment
- [ ] Add basic access logging
- [ ] Add error handling and input validation
- [ ] Set up reverse proxy (e.g., Caddy) for HTTPS
- [ ] Package and deploy to FreeBSD jail

---

## 📁 Project Structure (planned)
    rpnab-invoicing/
    ├── frontend/       # Leptos SPA
    ├── backend/        # Axum web API
    ├── cli/            # CSV import + admin commands
    ├── shared/         # Models, helpers, reused logic
    ├── migrations/     # Goose SQL migration files
    ├── static/         # Public files (PDF template, CSS)
    ├── .env            # DB and secret configs (local only)
    └── Cargo.toml

---

## 🚧 Status

> Project is in early planning and infrastructure phase.  
> Active development begins Q4 2025.