VELCLAW · CONTROL CENTER

Một trang quản trị thống nhất cho dự án, tài nguyên và triển khai.

Repository chính · Control Center UI · Kế hoạch triển khai · Danh mục hệ sinh thái

Giới thiệu

VELCLAW là hệ sinh thái phát triển phần mềm AI-native dành cho agent, developer và nhóm kỹ thuật. VELCLAW Control Center là lớp quản trị thống nhất để liên kết mã nguồn, môi trường triển khai, domain, database và các tích hợp trong cùng một góc nhìn.

Mục tiêu không phải ép tất cả source code vào một repository duy nhất. Mỗi sản phẩm có thể tiếp tục giữ repo, lịch sử Git, quyền truy cập và vòng đời phát hành riêng; Control Center kết nối chúng qua một registry có thể kiểm chứng.

Kiến trúc tổng thể

• GitHub: repositories, branches, pull requests và CI.
• Render / Vercel: dịch vụ ứng dụng, deployments và URLs.
• Cloudflare: DNS, TLS, Access/WAF, Workers và routes.
• PostgreSQL / Supabase: dữ liệu bền vững, migrations và health.
• OAuth / AI providers / MCP: danh tính, mô hình AI và mở rộng agent.

Module

Module	Chức năng
Overview	Tổng quan dự án, dịch vụ, trạng thái và cảnh báo
Repositories	Danh mục repo theo owner, quyền và vai trò
Deployments	Ánh xạ repo, branch, commit, dịch vụ và URL
Domains & DNS	Kiểm kê DNS, TLS, Access/WAF và origin routes
Databases	Theo dõi PostgreSQL/Supabase, migrations và health
Integrations	GitHub, Render, Vercel, Cloudflare, OAuth, AI providers, MCP
Security	Kiểm tra cấu hình quyền truy cập và quản lý secrets an toàn
Audit log	Lịch sử quét, nguồn dữ liệu, thời điểm và kết quả

Trạng thái hiện tại

• Giao diện ban đầu được thêm tại app/control-center/page.tsx.
• Kế hoạch triển khai và nguyên tắc vận hành tại docs/CONTROL-CENTER.md.
• Danh mục kiến trúc tại docs/ECOSYSTEM.md.
• Đã phát hiện một phần GitHub repositories, Render services và Vercel projects qua các kết nối hiện có.
• Quét hoàn chỉnh mọi trang repository của từng tài khoản/tổ chức được cấp quyền.
• Đồng bộ registry từ API thật thay vì dữ liệu mẫu/tĩnh.
• Hoàn tất kiểm kê Cloudflare DNS/Access/Workers, database và OAuth.
• Chạy type-check, tests, build và xác minh deployment production.

Minh bạch: giao diện đã được commit nhưng chưa có bằng chứng xác nhận route đã deploy thành công hoặc production health đạt. Danh mục hiện tại chỉ là một phần của cuộc kiểm kê, không phải snapshot đầy đủ của toàn bộ tài khoản.

Chạy local

Yêu cầu: Node.js tương thích với phiên bản khai báo trong package.json. Trong terminal:

git clone https://github.com/Velclaw/VELCLAW.git
cd VELCLAW
npm install
npm run dev

Mở http://localhost:3000/control-center.

Các lệnh kiểm tra có sẵn trong project: npm run type-check, npm test và npm run build. Dùng package manager và lockfile đã được commit; không tạo nhiều lockfile cạnh tranh.

Nguyên tắc bảo mật

1. Không commit API keys, OAuth secrets, database URLs hoặc deployment tokens.
2. Chỉ gọi API nhà cung cấp từ server-side routes; xác thực session và phân quyền trước khi trả dữ liệu.
3. Chỉ hiển thị tên biến secrets và trạng thái cấu hình; không trả giá trị secrets ra trình duyệt.
4. Không tự động xóa/chuyển repository, sửa DNS, đổi production routes hay chạy migration phá hủy khi chưa có kế hoạch rollback.
5. Mọi trạng thái phải có nguồn, thời điểm kiểm tra và kết quả health check.
6. Chỉ đánh dấu tích hợp là hoạt động khi có bằng chứng API hoặc health check thực tế.

Nhà cung cấp và nhà tài trợ

GitHub, Render, Vercel, Cloudflare, PostgreSQL/Supabase và AI providers được xem là hệ thống tích hợp. Không tuyên bố họ là nhà tài trợ chính thức nếu không có xác nhận tài trợ riêng. Tôn trọng giấy phép, thông báo bản quyền và attribution của mọi thư viện/tài nguyên bên ngoài.

Giấy phép

Kiểm tra file LICENSE trước khi tuyên bố giấy phép phân phối của dự án.

---

Velclaw

AI-native software workspace for agents, developers, and teams.

Build, inspect, test, deploy, and operate software from one developer-focused workspace.

Get started · Architecture · Capabilities · Ecosystem · Development

Ecosystem master document: docs/ECOSYSTEM.md — project registry, deployment map, domain policy, integration contracts, and verification checklist.

---

What is Velclaw?

Velclaw is an AI-native software workspace focused on the full software lifecycle: agents, code, projects, builds, runtime, storage, services, review, and deployment.

The goal is to give coding agents and developers one coherent environment instead of forcing every workflow through disconnected tools.

Build software. Give agents context. Keep the workflow together.

Architecture

                         ┌─────────────────────────┐
                         │       AI AGENTS         │
                         │ models · tools · tasks  │
                         └────────────┬────────────┘
                                      │
                                      ▼
┌──────────────────┐       ┌─────────────────────────┐       ┌──────────────────┐
│ Projects & Files │ ◄──── │    VELCLAW WORKSPACE    │ ────► │ Build & Runtime  │
│ code · context   │       │ projects · code · state │       │ build · execute  │
└──────────────────┘       └────────────┬────────────┘       └──────────────────┘
                                        │
                         ┌──────────────┼──────────────┐
                         ▼              ▼              ▼
                    ┌─────────┐   ┌──────────┐   ┌─────────────┐
                    │ Storage │   │ GitHub   │   │ Deployment  │
                    │ data    │   │ review   │   │ delivery    │
                    └─────────┘   └──────────┘   └─────────────┘

Capabilities

Area	Purpose
AI Agents	Agent-driven development workflows and tool execution
Workspace	Projects, files, code, persistent context and state
Build	Build, validate and package software
Runtime	Execute workloads and development processes
Storage	Persist application data and files
GitHub	Repository integration, code review and delivery workflows
Deployment	Move validated software toward production
Developer UI	A single workspace for the software lifecycle

Authentication

Authentication is separated into the dedicated Velclaw OAuth repository.

Surface	Repository	Purpose
Workspace	Velclaw/VELCLAW	Product UI, projects, agents, builds and deployment
Identity	Velclaw/Oauth	OAuth entry point, provider callbacks and session boundary

OAuth deployment status: hostname and routing are not yet verified. Use https://velclaw.dev as the only canonical Velclaw domain. Do not register OAuth callbacks or assume /auth routing works until the OAuth service is deployed and HTTPS, callback URLs, and path/reverse-proxy routing have been verified.

Product Domains

Velclaw uses https://velclaw.dev as its single canonical product domain for the platform, developer workspace, application, documentation, and API origin. Product code must use velclaw.dev as the default origin. This change does not provision DNS, HTTPS, OAuth callbacks, or reverse-proxy routes; those must be verified in the hosting provider before claiming production readiness.

Technology stack

Quick start

git clone https://github.com/Velclaw/VELCLAW.git
cd VELCLAW
npm install
npm run dev

Open http://localhost:3000.

Validation:

npm run type-check
npm run build

Project structure

VELCLAW/
├── app/                 # Next.js application routes
├── components/          # UI and workspace components
├── lib/                 # application services and integrations
├── public/              # public assets
├── server/              # server-side runtime pieces
├── drizzle/             # database schema/migrations
├── .github/             # CI and automation
└── README.md

GitHub workflow

Issue / Task
     │
     ▼
Agent + Developer
     │
     ▼
Workspace → Code → Build → Typecheck
     │
     ▼
GitHub branch
     │
     ▼
Pull Request → Review → Merge
     │
     ▼
Deployment

Technology ecosystem

These are open-source ecosystem references, tooling, inspiration, or attribution links. They are not presented as sponsors unless a separate sponsorship relationship is formally established.

Core ecosystem

• Vercel
• Next.js
• tsx
• Tenderdash
• Dash Platform

Icons, assets and developer tooling

• Simple Icons
• VectorLogoZone
• thesvg
• developer-icons
• vscode-icons-svg
• profile-readme-generator
• GitAscii
• GitHub Profile README Generator

Credits and attribution

Velclaw references open-source software and community tooling. Each external project remains the property of its respective authors and maintainers; applicable licenses and attribution requirements should be preserved.

Documentation

• Velclaw repository
• Issues
• Pull requests
• Official documentation: https://velclaw.dev/docs

Contributing

1. Create a branch.
2. Make the smallest coherent change.
3. Run typecheck/build where applicable.
4. Open a pull request.
5. Address review feedback.
6. Merge after required checks pass.

Security

Do not commit credentials, API keys, OAuth secrets, database URLs or private deployment tokens.

Roadmap

The roadmap should reflect shipped work rather than fictional dates or commitments.

• Core workspace
• GitHub integration foundation
• Build/runtime workflow foundation
• Expand agent workflows — auditable workflow state machine and operations control plane
• Expand deployment automation — queue/reconciliation contracts retained and surfaced through operations
• Production-grade observability — persistent event store, health checks and 24h summaries
• Broader ecosystem integrations — GitHub, MCP, Vercel, GitLab, Slack and Ollama adapter registry

License

The repository is publicly visible, but the current project configuration does not declare an open-source license. Do not claim an open-source license until a LICENSE file and public licensing decision are present.

Visual identity

The repository includes the official Velclaw mark and a lightweight product-introduction GIF so the project identity remains visible throughout the README rather than only in the hero.

---

Velclaw
Code. Innovate. Elevate.

AI Agent Skills and Vercel Plugin

• Vercel Platform Agent Skill — Vercel deployment diagnostics, pnpm monorepos, safe configuration changes, and production verification.
• Installation guide — install the Velclaw skill, the official Vercel plugin, or Vercel-maintained Agent Skills.