refactor: rebrand project from Cognis to Revanios and update documentation
This commit is contained in:
poyrazavsever
@@ -1,126 +1,77 @@
|
|||||||
# Cognis - AI-Powered Strategic Productivity Dashboard
|
|
||||||
|
|
||||||
|
# Revanios - Freelancer Operating System
|
||||||
|
|
||||||
Cognis is a next-generation personal and professional productivity ecosystem designed to centralize your life's complexities into a single, high-performance interface. Built with a focus on "AI-Native" workflows, Cognis goes beyond simple tracking—it analyzes, suggests, and optimizes your strategic progress.
|
[](https://nextjs.org/)
|
||||||
|
[](https://react.dev/)
|
||||||
|
[](https://tailwindcss.com/)
|
||||||
|
[](https://supabase.com/)
|
||||||
|
[](https://sdk.vercel.ai/)
|
||||||
|
[](https://github.com/poyrazavsever)
|
||||||
|
|
||||||
## 🌌 Design Philosophy: The "Edge-to-Edge" Aesthetic
|
## Overview
|
||||||
Cognis utilizes a bespoke, premium dark-mode aesthetic centered around the color `#0A0710`.
|
|
||||||
- **Flat Design:** Minimalist, sharp-cornered elements (`rounded-sm`) for a professional corporate feel.
|
|
||||||
- **Visual Hierarchy:** Layered depth using `#150F1D` panels and subtle purple-tinted borders.
|
|
||||||
- **Fluid Interactions:** Micro-animations powered by Framer Motion for a "living" interface.
|
|
||||||
|
|
||||||
---
|
Revanios is a comprehensive, self-hosted workspace designed specifically for freelancers. It serves as a centralized operating system to manage daily operations, clients, projects, finances, and personal performance tracking.
|
||||||
|
|
||||||
## 🚀 Key Feature Modules
|
Built with a focus on simplicity, security, and edge-to-edge aesthetic design, Revanios allows a single user (the freelancer) to operate their entire business from one dashboard without relying on multiple third-party SaaS subscriptions.
|
||||||
|
|
||||||
### 1. Unified Dashboard (Command Center)
|
## Features and Modules
|
||||||
Your tactical overview of current performance.
|
|
||||||
- **KPI Visualization:** Real-time tracking of revenue, tasks completion, and deep-work hours.
|
|
||||||
- **AI Strategic Insights:** A dedicated module that analyzes your data to provide proactive suggestions for your day.
|
|
||||||
- **Activity Streams:** Visual chronological breakdown of your latest movements across all modules.
|
|
||||||
|
|
||||||
### 2. Freelance Management (Business OS)
|
### 1. Unified Dashboard
|
||||||
A professional-grade CRM and operations suite for the modern freelancer.
|
A command center providing a tactical overview of your current performance. It tracks active revenue, task completion, and upcoming deadlines, ensuring you always know what needs immediate attention.
|
||||||
- **Client Intelligence:** Manage your client base with AI-powered sentiment analysis and value-tracking.
|
|
||||||
- **Proposals & Contracts:** High-conversion Kanban pipeline for managing leads to signed deals.
|
|
||||||
- **Time Tracking:** Integrated live timers with the ability to "AI-Suggest" billable hours based on project activity.
|
|
||||||
|
|
||||||
### 3. Financial Intelligence
|
### 2. Client Management
|
||||||
A sophisticated financial tracking system that understands your cash flow.
|
A structured CRM to manage your client base. You can track client statuses, store communication notes, and link clients directly to ongoing projects and tasks.
|
||||||
- **Cashflow Analysis:** Interactive Recharts visualizations of income vs. expenses.
|
|
||||||
- **Smart Invoicing:** Draft professional invoices in seconds, with AI suggesting rates based on tracked time and market data.
|
|
||||||
- **Subscription Management:** Keep track of overhead and recurring costs effortlessly.
|
|
||||||
|
|
||||||
### 4. Personal Growth & Strategy
|
### 3. Project and Task Management
|
||||||
- **Strategic Journaling:** A distraction-free markdown editor for daily reflection.
|
A robust pipeline for tracking project milestones and individual tasks. Features include priority assignments, status tracking, deadline management, and automated project progress calculations.
|
||||||
- **Habit Alchemy:** Track daily rituals with "Streak" visualizations and trend analysis to see where you're gaining or losing momentum.
|
|
||||||
- **Goal Milestones:** Break down massive long-term goals into executable tactical milestones with progress tracking.
|
|
||||||
|
|
||||||
### 5. AI Assistant (Chat & Context)
|
### 4. Financial Tracking
|
||||||
The core "brain" of Cognis, fully integrated with your data.
|
An integrated ledger to monitor income, expenses, and cash flow. It provides graphical analysis and clear tabular data of your recent transactions, allowing you to stay on top of your financial health.
|
||||||
- **Multi-Session Chat:** Organize different AI research threads into separate sessions.
|
|
||||||
- **Provider Agnostic:** Support for Google Gemini (Pro/Flash), OpenAI (GPT-4o), Groq (Llama 3), and Local LLMs (Ollama).
|
|
||||||
- **Context Awareness:** Chat with the AI about your journals, tasks, or financial data to get specific, localized insights.
|
|
||||||
|
|
||||||
### 6. Settings & AI Governance
|
### 5. Journal and Performance Analytics
|
||||||
- **API Management:** Securely manage your AI provider keys.
|
A dedicated journaling module to record daily mood, energy levels, and work satisfaction. This data is aggregated to provide trend analysis, helping you understand how your personal well-being correlates with your professional output.
|
||||||
- **Otonomy Controls:** Configure how much control the AI has (e.g., automated invoicing, proactive rescheduling).
|
|
||||||
- **Profile Customization:** Unified profile management with Supabase-backed storage.
|
|
||||||
|
|
||||||
---
|
### 6. Built-in AI Assistant
|
||||||
|
A localized AI module integrated directly into your workspace. It connects to your choice of provider (Google Gemini, OpenAI, Groq, or local Ollama instances) and can query your existing database to provide instant summaries, insights, and answers regarding your tasks and finances.
|
||||||
|
|
||||||
## 🛠 Technical Architecture
|
### 7. Client Portal
|
||||||
|
A restricted, read-only interface that you can share with your clients. They can log in to view the progress of their specific projects and public tasks, providing transparency without compromising your internal data security.
|
||||||
|
|
||||||
Cognis is built on a cutting-edge, high-performance tech stack:
|
## Technical Architecture
|
||||||
|
|
||||||
- **Framework:** [Next.js 15+](https://nextjs.org/) (App Router, Server Components)
|
Revanios is engineered using modern, high-performance web technologies:
|
||||||
- **Database:** [Supabase](https://supabase.com/) (PostgreSQL + Realtime Subscriptions)
|
|
||||||
- **State Management:** React Hooks + Supabase Realtime + Optimistic UI Updates
|
|
||||||
- **Styling:** Vanilla CSS + Tailwind CSS (Bespoke configuration)
|
|
||||||
- **AI Integration:** Google Generative AI, OpenAI SDK, and Custom REST Bridges
|
|
||||||
- **Charts:** [Recharts](https://recharts.org/) (Customized for Dark Corporate theme)
|
|
||||||
- **Icons:** [Lucide React](https://lucide.dev/)
|
|
||||||
|
|
||||||
---
|
- **Frontend:** Next.js (App Router) combined with React Server Components.
|
||||||
|
- **Styling:** Tailwind CSS with a custom, bespoke design system via Poyraz UI.
|
||||||
|
- **Backend and Database:** Supabase (PostgreSQL) handling authentication, Row Level Security (RLS), and database migrations.
|
||||||
|
- **AI Integration:** Vercel AI SDK for streaming responses and tool-calling capabilities.
|
||||||
|
- **Deployment:** Fully containerized with Docker, optimized for standalone builds.
|
||||||
|
|
||||||
## 📦 Kurulum & Local Geliştirme
|
## Installation and Deployment
|
||||||
|
|
||||||
Projeyi kendi bilgisayarınızda çalıştırmak için aşağıdaki adımları izleyin:
|
Revanios is designed to be easily self-hosted. Follow these steps to deploy the application on your own infrastructure.
|
||||||
|
|
||||||
1. **Depoyu Klonlayın:**
|
### Prerequisites
|
||||||
```bash
|
- Docker and Docker Compose
|
||||||
git clone https://github.com/yourusername/cognis-dashboard.git
|
- Node.js (for local development)
|
||||||
cd cognis-dashboard
|
- A Supabase instance (Cloud or Self-Hosted)
|
||||||
```
|
|
||||||
|
|
||||||
2. **Bağımlılıkları Yükleyin:**
|
### Setup Instructions
|
||||||
```bash
|
|
||||||
pnpm install
|
|
||||||
```
|
|
||||||
|
|
||||||
3. **Çevresel Değişkenleri Ayarlayın:**
|
1. Clone the repository to your local machine or server.
|
||||||
`.env.example` dosyasını kopyalayarak `.env.local` oluşturun:
|
2. Copy the `.env.example` file to `.env.local` and populate the variables with your Supabase credentials.
|
||||||
```bash
|
3. Run the database migrations located in `supabase/migrations` against your PostgreSQL database to set up the schemas, policies, and functions.
|
||||||
cp .env.example .env.local
|
4. Build and start the Docker container using the provided `docker-compose.yml` or `Dockerfile`.
|
||||||
```
|
|
||||||
*Not: Eğer Supabase Cloud kullanıyorsanız bilgilerinizi buraya girin.*
|
|
||||||
|
|
||||||
4. **Veritabanı Kurulumu ve Örnek Veri (Local Supabase):**
|
Example deployment command:
|
||||||
Eğer projeyi tamamen lokalde denemek istiyorsanız Supabase CLI kullanabilirsiniz:
|
```bash
|
||||||
```bash
|
docker-compose up -d --build
|
||||||
npx supabase start
|
```
|
||||||
```
|
|
||||||
Local veritabanınızı örnek verilerle doldurmak için:
|
|
||||||
```bash
|
|
||||||
npx supabase db reset
|
|
||||||
```
|
|
||||||
*Bu komut, `supabase/seed.sql` dosyasını çalıştırarak `demo@cognis.com` şifre `demo123456` olan örnek bir kullanıcı ve sahte finans/proje verileri ekler.*
|
|
||||||
|
|
||||||
5. **Uygulamayı Başlatın:**
|
### First Administrator Account
|
||||||
```bash
|
To ensure data security, Revanios is locked to a single administrator. Upon launching the application for the first time, navigate to the `/register` route to create the initial admin account. Once this account is created, public registration is permanently disabled.
|
||||||
pnpm dev
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
## License
|
||||||
|
|
||||||
## 🐳 Self-Hosting (VPS & Docker)
|
This project is proprietary and intended for personal self-hosting.
|
||||||
|
|
||||||
Cognis'i kendi sunucunuzda barındırmak (Self-host) için Docker altyapısı hazır durumdadır:
|
|
||||||
|
|
||||||
1. Sunucunuzda projeyi klonlayın ve `.env.local` dosyanızı oluşturun.
|
|
||||||
2. Production imajını inşa edip başlatmak için:
|
|
||||||
```bash
|
|
||||||
docker-compose up -d --build
|
|
||||||
```
|
|
||||||
*Uygulama `http://localhost:3000` portundan yayın yapmaya başlayacaktır. Bir reverse proxy (Nginx, Traefik, Caddy) ile dışarıya açabilirsiniz.*
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🛡 Security & Privacy
|
|
||||||
- **RLS Policies:** Row Level Security ensures that every user only has access to their own data at the database level.
|
|
||||||
- **Local Fallback:** Support for local Ollama models ensures that sensitive strategic data can stay on your own hardware if required.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Cognis** — *Design the life you want, strategize the steps to get there.*
|
|
||||||
|
|||||||
Reference in New Issue
Block a user