Home

Welcome to the FlossPay Wiki! 🏦🐧

FlossPay is a kernel-inspired, enterprise-grade Free/Libre Open Source Payments Aggregator built for maximum auditability, transparency, and reliability. This wiki serves as the living knowledge base for FlossPay’s design, operation, security, and contributor onboarding.

---

📑 Table of Contents

• Project Overview
• Solution Architecture
• API Reference
• Deployment & Ops
• Security & Compliance
• Contributor Guide
• Governance & Process
• FAQ & Troubleshooting
• Roadmap & RFCs

---

Project Overview

FlossPay brings Linux governance and Oracle Financials discipline to payments infrastructure:

• Strict peer review & meritocratic maintainers
• Immutable audit trails, idempotency, and forensic logging
• Modular, plug-and-play “rails” for UPI, cards, wallets, and more
• Full compliance mapping (PCI-DSS, SOC2, ISO 27001)

---

Solution Architecture

• Detailed diagrams and sequence flows (add links to subpages as you create them)
• API-first, microservice modularity, Redis async, Postgres ledger

---

API Reference

• Full OpenAPI spec (add or link the spec file here)
• Auth, idempotency, audit events, error handling, versioning

---

Deployment & Ops

• Quickstart for local dev, cloud-ready guides (Kubernetes, Helm, Terraform)
• Observability: Prometheus, Grafana dashboards, SLOs

---

Security & Compliance

• HMAC, mTLS, audit partitioning, encrypted credentials
• Threat model, pen-test notes, compliance coverage

---

Contributor Guide

• Branching, PR process, code style (Java 21/Spring Boot idioms)
• Review gates, staging/production workflows
• Issue templates, discussions, RFCs

---

Governance & Process

• Code of Conduct, Maintainer list, escalation paths
• Release process, long-term support, security policy

---

FAQ & Troubleshooting

• Common setup/usage errors, debug recipes, platform-specific notes

---

Roadmap & RFCs

• Milestones, proposals, and feature requests
• How to contribute to direction and planning

---

Want to contribute?
Start at Contributor Guide or join Discussions.

---

🏁 This wiki is always evolving.

PRs, edits, and new pages are welcome—help us make FLOSS payments infra even stronger!