# ✨ New Radix Nova Project — README (Final Production Version)

---

## 🚀 Overview
**New Radix Nova Project** — Next-generation intelligent application foundation. Built for **AI-assisted development**, **event-driven project tracking**, and **DevSecOps from day one**. Evolves seamlessly from prototype → MVP → enterprise.

> **Core Philosophy:** *No guessing — every status, metric, and decision comes from verifiable sources of truth.*

---

## ✨ Key Features

### 🧠 Intelligence Layer
- **Project Status Auto-Update** — Event-driven state machine; calculates progress/health **from Git/PR/CI/Tasks**, never guesses
- **Code-Document Orchestrator** — Auto-detect TSX/JSX/JS/SH/DOCX; separate executable logic from document artifacts
- **Immutable History** — Every state change logged with evidence; never lose context

### 🛡️ DevSecOps Built-In
- **CI/CD Ready** — GitHub Actions workflows, PR templates, auto-labeling
- **Security Gates** — Shell hardening, dependency scanning, approval gates
- **Least-Privilege** — Skill permissions scoped; broad access never granted

### 🧩 Developer Experience
- **Modern Stack** — React + TypeScript frontend; FastAPI/NestJS backend
- **Unified Workflow** — `commit → branch → PR → review → CI → deploy` tracked end-to-end
- **CrystalCastle Native** — Fully compatible with existing skills, standards, and ecosystem

---

## 📁 Standard Project Structure
```
new-radix-nova-project/
├── .github/
│   ├── workflows/              # CI, Status, Skills
│   ├── pull_request_template.md
│   └── labels.yml
├── src/
│   ├── frontend/               # React / TSX
│   ├── backend/                # API / Services
│   └── shared/                 # Types / Utils / Constants
├── skills/                     # 🧠 Integrated Skill Layer
│   ├── project-status-auto-update/
│   ├── code-document/
│   ├── tsx/ jsx/ js/ sh/ docx/
│   ├── patch/ check-diff/ debug-error/
│   └── pull-request-review/ comment/
├── docs/
│   ├── README.md
│   ├── API.md
│   ├── CHANGELOG.md
│   └── CONTRIBUTING.md
├── .env.example
├── package.json
├── tsconfig.json
├── pyproject.toml
└── README.md ← (This file)
```

---

## 🚀 Quick Start
```bash
# 1. Clone
git clone https://github.com/ZyntroAI/new-radix-nova-project.git
cd new-radix-nova-project

# 2. Environment
cp .env.example .env
# Edit .env with your values

# 3. Install & Setup
npm install
pip install -r requirements.txt

# 4. Develop
npm run dev
# or
uvicorn src.main:app --reload

# 5. Check Project Status (auto-computed)
python -m skills.project_status
```

---

## 📊 How It Works
```
📥 SOURCE OF TRUTH
   Git → GitHub → CI → Deploy → Tasks
        ↓
🧠 STATUS ENGINE
   Event → Analyze → State Machine → Log History
        ↓
✏️ AUTO-UPDATE
   Labels • Project Board • Dashboard • Comments
        ↓
📜 AUDIT TRAIL
   Immutable: When • What • Why • Who • Evidence
```

**Answers definitively:**
- ✅ What is the status? (calculated, not guessed)
- ✅ Why did it change? (linked to event/PR/commit)
- ✅ When? Timestamped with evidence
- ✅ What's blocking? Explicit list + duration
- ✅ What's next? State machine guides the way

---

## 🔗 Ecosystem Compatibility
| Layer | Status |
|---|---|
| CrystalCastle Skills | ✅ Full Compatibility |
| GitHub Actions / Projects | ✅ Native Integration |
| React / TypeScript | ✅ First-Class Support |
| FastAPI / Python | ✅ Backend Ready |
| Supabase / PostgreSQL | ✅ Auth + Persistence |
| AI Assistants (Copilot / Dola) | ✅ Skill-Aware |

---

## 🤝 Contributing
1. Branch off `main` → feature/xyz
2. Push → PR opened → **Status auto-computed**
3. Review → CI checks → **Labels auto-assigned**
4. Approved → Merge → **Deployed + History logged**

> All status updates are **evidence-based** — no manual status-tracking needed.

---

## 📈 Roadmap
- [x] Core Scaffold & Standards
- [x] Project Status Engine Integration
- [x] Code-Document Orchestrator
- [ ] CI/CD Workflows & Badges
- [ ] Full Documentation & Examples
- [ ] Production Hardening & Security Audit

---
## 🔗 ลิงก์สำคัญ

| รายการ | ลิงก์ |
| --- | --- |
| Organization Discussions #1 | ZyntroAI/Organization#1 |
| Organization repo | https://github.com/ZyntroAI/Organization |
| ZyntroAI org | https://github.com/ZyntroAI |

> ทะเบียนลิงก์ฉบับเต็ม: [`docs/LINKS_STATUS.md`](docs/LINKS_STATUS.md) · ทะเบียน Fig components: [`docs/fig-components.md`](docs/fig-components.md)

---

## 📄 License
[MIT License](LICENSE) — Copyright © 2025–2026 ZyntroAI

---

> Built with 💡 by ZyntroAI • Part of the **CrystalCastle Ecosystem**
>
> *"Intelligence from evidence. Progress without guesswork."*