Import remaining project documentation and reference notes

Import the existing local project snapshot. This commit organizes existing files; it does not represent newly developed functionality.
This commit is contained in:
arsam
2026-09-18 23:33:04 +03:30
parent 4791bc2da0
commit e9cd12dda6
43 changed files with 20604 additions and 0 deletions
+31
View File
@@ -0,0 +1,31 @@
# Project: Teknav-X
Teknav-X is a full-stack Persian RTL publication stack. The frontend is Vite/React, the backend is Fastify/TypeScript, and production runs natively on Linux with PostgreSQL, Redis, nginx, and systemd.
Current state: Phase 15 is implemented; Phase 14 Linux production validation remains the main launch gate. The live surface includes SEO topic hubs, glossary pages, Q&A, reader retention flows, auth trust features, jobs/courses pages, monetization foundations, push notifications, revision history, web stories, comparison pages, company directory pages, embeddable widgets, and production-readiness preflight checks.
## Start Here
- `ARCH.md` for current work and next steps
- `PHASE10.md` for the active roadmap
- `DEPLOY.md` for native Debian production setup
- `SECURITY.md` for hardening and safety rules
- `AGENTS.md` for agent-facing file guidance
## Core Layout
- Frontend: repo root `*.jsx` files plus `src/`
- Backend: `backend/`
- Static assets: `public/`
- Generated SEO artifacts: `public/sitemap.xml`, `public/robots.txt`, `public/feed.xml`
## Main Commands
- `npm run dev`
- `npm run build`
- `npm run preflight:prod`
- `npm run seo:sitemap`
- `npm run og:images`
- `cd backend && npm run dev`
- `cd backend && npm run build`
- `cd backend && npm test`