126 lines
2.4 KiB
Markdown
126 lines
2.4 KiB
Markdown
# Socialize
|
|
|
|
Socialize is an organization-owned, workspace-based workflow application for social media content review, revision, approval, and publication readiness.
|
|
|
|
It is not a public social network. The product is for internal teams, providers, and client approvers coordinating content work before publication.
|
|
|
|
## Monorepo
|
|
|
|
- Backend: .NET 10 Web API in `backend/src/Socialize.Api`
|
|
- Backend tests: `backend/tests/Socialize.Tests`
|
|
- Frontend: Vue 3 + Vite + Vuetify + Pinia in `frontend`
|
|
- API contract: OpenAPI snapshot in `shared/openapi`
|
|
- Deployment: Docker Compose + Caddy
|
|
- Agentic workflow: specs, task files, and prompt templates under `docs`
|
|
|
|
## Local Development
|
|
|
|
Terminal 1:
|
|
|
|
```bash
|
|
./scripts/start-infrastructure.sh
|
|
./scripts/dev-backend.sh
|
|
```
|
|
|
|
Terminal 2:
|
|
|
|
```bash
|
|
./scripts/dev-frontend.sh
|
|
```
|
|
|
|
Frontend:
|
|
|
|
```txt
|
|
http://localhost:5173
|
|
http://<this-machine-lan-ip>:5173
|
|
```
|
|
|
|
Backend:
|
|
|
|
```txt
|
|
http://localhost:5080
|
|
http://<this-machine-lan-ip>:5080
|
|
```
|
|
|
|
Swagger UI:
|
|
|
|
```txt
|
|
http://localhost:5080/api
|
|
```
|
|
|
|
## Update Frontend API Types
|
|
|
|
The backend must be running first.
|
|
|
|
```bash
|
|
./scripts/update-openapi.sh
|
|
```
|
|
|
|
This writes:
|
|
|
|
```txt
|
|
shared/openapi/openapi.json
|
|
frontend/src/api/schema.d.ts
|
|
```
|
|
|
|
## Docker Compose
|
|
|
|
```bash
|
|
docker compose up --build
|
|
```
|
|
|
|
Then open:
|
|
|
|
```txt
|
|
http://localhost:8080
|
|
http://<this-machine-lan-ip>:8080
|
|
```
|
|
|
|
For preprod deployment, configure the `POSTGRES_PASSWORD`, `RESEND_API_KEY`,
|
|
`RESEND_FROM_EMAIL`, and `JWT_SIGNING_KEY` Gitea secrets.
|
|
The deploy workflow writes the remote `.env` file and syncs `deploy/compose.yml`
|
|
before running the server deploy script.
|
|
Use the raw Resend API key value for `RESEND_API_KEY`, without a `Bearer ` prefix.
|
|
|
|
## Solution
|
|
|
|
```bash
|
|
dotnet build backend/Socialize.slnx
|
|
dotnet test backend/Socialize.slnx
|
|
```
|
|
|
|
## Frontend Build
|
|
|
|
```bash
|
|
cd frontend
|
|
npm run build
|
|
```
|
|
|
|
## Database Diagram
|
|
|
|
Start PostgreSQL, then generate a local schema diagram:
|
|
|
|
```bash
|
|
./scripts/generate-db-diagram.sh
|
|
```
|
|
|
|
The script writes an HTML viewer, SVG, PNG, and Graphviz source under:
|
|
|
|
```txt
|
|
.artifacts/db-diagrams/
|
|
```
|
|
|
|
Use `DATABASE_URL`, `PGPASSWORD`, or `~/.pgpass` to provide local database credentials.
|
|
When using the repository infrastructure script, the diagram script can read from the
|
|
running `socialize-postgres` container directly.
|
|
|
|
## Agentic Workflow
|
|
|
|
Start here:
|
|
|
|
```txt
|
|
docs/AGENTIC_WORKFLOW.md
|
|
```
|
|
|
|
Use feature specs, task files, and prompt templates instead of asking agents to work from vague chat history.
|