Brohammad / Brohammad/VoxForge

Schedule enterprise audit-log exports for self-hosted operators

Open
#48 0 comments 0 reactions 0 assignees View on GitHub
enhancement help wanted
Dominant language
Python
Stars
4
Forks
1
Avg merge
5d 13m
Merged PRs (30d)
10

Description

## Summary

On-demand export exists (`GET /api/v1/orgs/{id}/audit-logs/export`). Roadmap v1.2 wants scheduled export. Self-hosted pilots still copy CSVs by hand.

## Context

- `tests/integration/test_audit_export.py`
- `src/voxforge/api/v1/orgs.py`
- `docs/ROADMAP.md`

## Scope

Start small: cron-friendly script + docs (org-scoped, existing CSV/JSON), not a SaaS email product.

## Acceptance criteria

- [ ] `scripts/audit_export_cron.sh` (or equivalent) documented for VPS cron
- [ ] Uses existing export API + operator token/API key
- [ ] RBAC respected (cannot export another org)
- [ ] Integration or script test for payload shape
- [ ] No object-storage vendor required for v1

Contributor guide

Open the contributing guide

Research direction

Start with src/voxforge/api/v1/orgs.py and tests/integration/test_audit_export.py to understand the existing export endpoint, payload formats, and organization access checks. Then review docs/ROADMAP.md and document a VPS cron-friendly script using an operator token or API key; done means the script, documentation, and a payload-shape or integration test cover CSV/JSON export without requiring object storage.

Written by the indexing model from the issue text.

Assessment

Tech stack
fastapi, python, shell
Domain
api, backend, devops, documentation, testing
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
74/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.