CODEX_ADK/FRONTEND/README.md
jean-philippe 3fae2fcbe1 Initial commit: CODEX_ADK (Svrnty Console) MVP v1.0.0
This is the initial commit for the CODEX_ADK project, a full-stack AI agent
management platform featuring:

BACKEND (ASP.NET Core 8.0):
- CQRS architecture with 6 commands and 7 queries
- 16 API endpoints (all working and tested)
- PostgreSQL database with 5 entities
- AES-256 encryption for API keys
- FluentValidation on all commands
- Rate limiting and CORS configured
- OpenAPI/Swagger documentation
- Docker Compose setup (PostgreSQL + Ollama)

FRONTEND (Flutter 3.x):
- Dark theme with Svrnty branding
- Collapsible sidebar navigation
- CQRS API client with Result<T> error handling
- Type-safe endpoints from OpenAPI schema
- Multi-platform support (Web, iOS, Android, macOS, Linux, Windows)

DOCUMENTATION:
- Comprehensive API reference
- Architecture documentation
- Development guidelines for Claude Code
- API integration guides
- context-claude.md project overview

Status: Backend ready (Grade A-), Frontend integration pending

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 18:32:38 -04:00

78 lines
1.8 KiB
Markdown

# Svrnty Console
**Sovereign AI Solutions - Control Panel**
A Flutter-based management console for the Svrnty AI platform, providing a modern interface for monitoring, configuring, and controlling AI agents and infrastructure.
## Features
- **Dashboard**: Real-time status monitoring of backend services, agents, and system health
- **The Architech**: AI infrastructure design and visualization (coming soon)
- **Agent Management**: Configure and monitor AI agents
- **Analytics**: Metrics and performance monitoring
- **Dark Theme**: Professional dark mode with Svrnty brand colors
## Tech Stack
- **Flutter 3.x** - Cross-platform UI framework
- **GetWidget** - Modern UI component library
- **Iconsax** - Clean, modern icon set
- **Animate Do** - Smooth animations
- **Custom Theming** - Svrnty brand colors (Crimson Red #C44D58, Slate Blue #475C6C)
## Project Structure
```
lib/
├── main.dart # App entry point
├── console_landing_page.dart # Main console UI
├── theme.dart # Material theme configuration
├── components/
│ └── navigation_sidebar.dart # Collapsible navigation
└── pages/
└── architech_page.dart # The Architech module
```
## Getting Started
### Prerequisites
- Flutter SDK 3.9.2 or higher
- Dart SDK 3.9.2 or higher
### Installation
```bash
# Clone the repository
git clone [repository-url]
cd Console
# Install dependencies
flutter pub get
# Run the application
flutter run
```
### Development
```bash
# Run tests
flutter test
# Analyze code
flutter analyze
# Build for production
flutter build macos # or ios, web, etc.
```
## Brand Fonts
- **Montserrat** - Primary UI font
- **IBM Plex Mono** - Code and technical content
## License
Private - Svrnty AI Solutions