43 lines
1.1 KiB
Markdown
43 lines
1.1 KiB
Markdown
# Allmende Payment System
|
|
|
|
A FastAPI-based payment system for the communal living projects and similar groups.
|
|
|
|
## Prerequisites
|
|
- [uv](https://docs.astral.sh/uv/) (package and dependency manager)
|
|
|
|
## Getting Started
|
|
|
|
### 1. Install uv
|
|
Ensure `uv` is installed. If not, follow the [official installation guide](https://docs.astral.sh/uv/getting-started/installation/).
|
|
|
|
### 2. Initialize the database
|
|
|
|
```bash
|
|
make reset_db
|
|
```
|
|
Resets the database and initializes it with some mock data.
|
|
|
|
### 3. Run the Development Server
|
|
```bash
|
|
uv run fastapi dev src/allmende_payment_system/app.py
|
|
```
|
|
A demo user will be created automatically.
|
|
|
|
### Configuration
|
|
|
|
A preliminary config system exists and works via environment variables:
|
|
|
|
* APS_READ_ONLY: If set, users can make no purchases
|
|
* APS_PRODUCTION_MODE: If set, demo functionality, like adding money to an account and the demo banner are removed.
|
|
|
|
### Testing
|
|
|
|
APS uses pytest. You can run the test suite with:
|
|
|
|
```bash
|
|
uv run pytest
|
|
```
|
|
|
|
## License
|
|
This project is licensed under the [European Union Public Licence (EUPL)](https://joinup.ec.europa.eu/collection/eupl).
|