Skip to content

Release Notes

This document provides a chronological record of all releases and major changes for the FastAPI RBAC project. Each release entry includes version information, release date, and a summary of features, bug fixes, and breaking changes.

This file serves as the single source of truth for release history and versioning across the entire monorepo.

Version History

v0.0.3-beta (2025-07-02)

New Features:

  • Release automation scripts for streamlined publishing and changelog management
  • Dry-run option for release scripts to enable safe testing before actual release
  • Enhanced documentation with new index page, logo assets, and favicon for improved branding
  • Comprehensive documentation for the FastAPI RBAC project
  • Contributing guidelines to support community collaboration
  • Troubleshooting agent prompt for user support
  • Prompt templates for architect, implementor, and manager roles
  • Comprehensive testing suite for authentication and basic functionality
  • Enhanced admin user creation process with configurable verification settings
  • CSRF token management added to API service
  • Comprehensive tests for PermissionGroups, RoleGroupList, RoleList, and UsersList components
  • Frontend Testing Framework implementation (P0 Item #1)
  • Rate Limiting implementation (P0 Item #2)
  • Complete separation of Docker environments for development, testing, and production

Bug Fixes:

  • Correct Docker check logic in create-release.sh
  • Improved release scripts with better Docker handling, changelog management, and cleanup
  • Added changelog.txt to .gitignore and fixed path resolution in release scripts
  • Removed server-dir from FTP deployment configuration and updated documentation links to point to the live site
  • Fixed frontend build, type, and linting issues
  • Resolved authentication tests to accept 429 status code for rate limiting scenarios

Breaking Changes:

  • None

Technical Details:

  • Updated linting and formatting processes to use PowerShell scripts for consistency
  • Enhanced demo suite to include integration tests
  • Updated test environment configuration and improved coverage reporting
  • Improved test runner and fixtures for parallel execution
  • Enhanced documentation and best practices for dependency management, environment variables, and test runner usage
  • Updated user and role handling in tests
  • Removed Docker build job from CI workflow
  • Removed obsolete scripts for fixing CRUD and factory method calls, test issues, imports, and password requirements
  • Comprehensive test suite refactor and API-driven integration test alignment
  • Complete test suite restructuring and fixed all 125 unit tests
  • Started test suite refactor for comprehensive API/integration testing
  • Restructured Docker environment files and enhanced database initialization scripts
  • Added troubleshooting scripts for CORS and Docker configuration
  • Updated Docker configurations for production and testing environments
  • Refactored code for improved readability and consistency
  • Comprehensive updates to documentation and frontend security integration
  • Updated documentation and security features across the project

v0.0.2-beta (2025-07-02)

Pre-release Beta Version

New Features:

  • Enhanced FastAPI RBAC backend with comprehensive role and permission management
  • React frontend with TypeScript and modern UI components
  • Improved Docker containerization and development workflow
  • Enhanced testing infrastructure with unit and integration tests

Bug Fixes:

  • Resolved authentication flow issues
  • Fixed permission validation logic
  • Improved error handling across the application

Breaking Changes:

  • None (pre-release version)

Technical Details:

  • Backend: FastAPI with SQLModel/SQLAlchemy, PostgreSQL, Redis
  • Frontend: React 18+ with TypeScript, Redux Toolkit, ShadCN UI
  • Infrastructure: Docker Compose, GitHub Actions CI/CD

v0.0.1-beta (2025-07-01)

Initial Pre-release Beta Version

New Features:

  • Initial release of FastAPI RBAC monorepo
  • Basic authentication and authorization system
  • User management with role-based access control
  • REST API endpoints for user, role, and permission management
  • React frontend with authentication flows
  • Docker containerization for development and production

Technical Details:

  • Monorepo structure with backend and frontend separation
  • JWT-based authentication with refresh token support
  • PostgreSQL database with SQLModel ORM
  • Redis for session management and caching
  • Comprehensive test suite setup

Known Issues:

  • Beta version - not recommended for production use
  • Some advanced RBAC features still in development

Release Process

For information about the release process, including how to create releases and generate release notes, see the Release Process Documentation.

Semantic Versioning

This project follows Semantic Versioning:

  • MAJOR.MINOR.PATCH (e.g., 1.0.0)
  • Pre-releases: MAJOR.MINOR.PATCH-pre.N (e.g., 1.0.0-beta.1, 1.0.0-rc.1)

Version Types:

  • Major: Breaking changes that require migration
  • Minor: New features that are backward compatible
  • Patch: Bug fixes and minor improvements
  • Pre-release: Beta, alpha, or release candidate versions