madava/avaaz
1
0
Fork 0
Code Pull Requests Actions Releases Activity

Add PRD and Norwegian resources
All checks were successful
Continuous Integration / Validate and test changes (push) Successful in 4s
Details

Browse Source
This commit is contained in:
Madava
2025-12-03 08:22:36 +01:00
parent 73fd4d26a5
commit 5a8b773e40
7 changed files with 567 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/architecture.md
View File

@@ -5,7 +5,7 @@ Below is a summary of the **Production VPS** and **Development Laptop** architec
```mermaid
flowchart LR
%% Client
A(Browser / PWA)
A(Browser)
Y(iOS App / Android App)
subgraph User
@@ -27,7 +27,7 @@ flowchart LR
I(Gitea + Actions + Repositories)
J(Gitea Runner)
D(Next.js Frontend)
D(React/Next.js/Tailwind Frontend)
E(FastAPI Backend + Agent Runtime)
G(LiveKit Server)
H[(PostgreSQL + pgvector)]
@@ -129,7 +129,7 @@ Docker Compose from `./app/docker-compose.yml` is cloned to `/srv/app/docker-com
| Container | Description |
| ---------- | ----------------------------------------------------------------------------------------- |
| `frontend` | **Next.js Frontend** – SPA/PWA interface served from a Node.js-based Next.js server. |
| `frontend` | **React/Next.js/Tailwind Frontend** – SPA interface served from a Node.js-based Next.js server. |
| `backend` | **FastAPI + Uvicorn Backend** – API, auth, business logic, LiveKit orchestration, agent. |
| `postgres` | **PostgreSQL + pgvector** – Persistent relational database with vector search. |
| `livekit` | **LiveKit Server** – WebRTC signaling plus UDP media for real-time audio and data. |
@@ -152,7 +152,7 @@ The `backend` uses several Python packages such as UV, Ruff, FastAPI, FastAPI Us
| -------------------- | :---------: | -------------- | -------------------------------- |
| **www\.avaaz\.ai** | CNAME | avaaz.ai | Marketing / landing site |
| **avaaz.ai** | A | 217.154.51.242 | Root domain |
| **app.avaaz.ai** | A | 217.154.51.242 | Next.js frontend (SPA/PWA) |
| **app.avaaz.ai** | A | 217.154.51.242 | React/Next.js/Tailwind frontend (SPA) |
| **api.avaaz.ai** | A | 217.154.51.242 | FastAPI backend |
| **rtc.avaaz.ai** | A | 217.154.51.242 | LiveKit signaling + media |
| **git.avaaz.ai** | A | 217.154.51.242 | Gitea (HTTPS + SSH) |
@@ -448,7 +448,7 @@ The user experiences this as a **continuous, ongoing session** with seamless rec
#### App Stack (local Docker)
- `frontend` (Next.js SPA)
- `frontend` (React/Next.js/Tailwind SPA)
- `backend` (FastAPI)
- `postgres` (PostgreSQL + pgvector)
- `livekit` (local LiveKit Server)
@@ -465,7 +465,7 @@ No Caddy is deployed locally; the browser talks directly to the mapped container
Local development uses:
- `http://localhost:3000` → frontend (Next.js dev/server container)
- `http://localhost:3000` → frontend (React/Next.js/Tailwind dev/server container)
- `http://localhost:8000` → backend API (FastAPI)
- Example auth/session endpoints:
- `POST http://localhost:8000/auth/login`
@@ -480,7 +480,7 @@ No `/etc/hosts` changes or TLS certificates are required; `localhost` acts as a
| Port | Protocol | Purpose |
|-------------:|:--------:|------------------------------------|
| 3000 | TCP | Frontend (Next.js) |
| 3000 | TCP | Frontend (React/Next.js/Tailwind) |
| 8000 | TCP | Backend API (FastAPI) |
| 5432 | TCP | Postgres + pgvector |
| 7880 | TCP | LiveKit HTTP + WS signaling |