Initial digitCRM project with backend and frontend
This commit is contained in:
181
DIGITCRM_SETUP.md
Normal file
181
DIGITCRM_SETUP.md
Normal file
@@ -0,0 +1,181 @@
|
||||
# digitCRM - Setup Instructions
|
||||
|
||||
## Стъпка 1: Распакуване
|
||||
|
||||
```bash
|
||||
unzip digitCRM.zip
|
||||
cd digitCRM
|
||||
```
|
||||
|
||||
## Стъпка 2: Инициализирайте Git репозиторий
|
||||
|
||||
```bash
|
||||
git init
|
||||
git config user.email "sabo@inex-project.net"
|
||||
git config user.name "Sabo"
|
||||
git add -A
|
||||
git commit -m "Initial digitCRM project with backend and frontend"
|
||||
```
|
||||
|
||||
## Стъпка 3: Добавете remote и push-нете
|
||||
|
||||
```bash
|
||||
git remote add origin https://git.inex-project.net/sabo/digitCRM.git
|
||||
git branch -M main
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
**Когато ви поиска пароля, вставете вашия Personal Access Token.**
|
||||
|
||||
## Стъпка 4: Проверете на Git
|
||||
|
||||
Отидете на: https://git.inex-project.net/sabo/digitCRM
|
||||
|
||||
Трябва да видите:
|
||||
- `backend/` папка
|
||||
- `frontend/` папка
|
||||
- `docker-compose.yml`
|
||||
- `README.md`
|
||||
|
||||
## Стъпка 5: Деплойване на Coolify
|
||||
|
||||
### Опция 1: Docker Compose (препоръчано)
|
||||
|
||||
1. Отворете Coolify
|
||||
2. Натиснете "New Resource" → "Docker Compose"
|
||||
3. В "Source" изберете "Git"
|
||||
4. Въведете: `https://git.inex-project.net/sabo/digitCRM.git`
|
||||
5. Branch: `main`
|
||||
6. Docker Compose File: `docker-compose.yml`
|
||||
7. Натиснете "Deploy"
|
||||
|
||||
### Опция 2: Отделни контейнери
|
||||
|
||||
#### Backend
|
||||
1. "New Resource" → "Docker"
|
||||
2. Source: "Git"
|
||||
3. Repository: `https://git.inex-project.net/sabo/digitCRM.git`
|
||||
4. Branch: `main`
|
||||
5. Dockerfile: `backend/Dockerfile` (ако го има)
|
||||
6. Port: `3001`
|
||||
7. Environment:
|
||||
- `NODE_ENV=production`
|
||||
- `PORT=3000`
|
||||
- `DB_SERVER=cw.inex-project.net`
|
||||
- `DB_PORT=14333`
|
||||
- `DB_USER=inex`
|
||||
- `DB_PASSWORD=inex123!@#`
|
||||
- `JWT_SECRET=your-secret-key`
|
||||
- `CORS_ORIGIN=http://localhost:3000`
|
||||
|
||||
#### Frontend
|
||||
1. "New Resource" → "Docker"
|
||||
2. Source: "Git"
|
||||
3. Repository: `https://git.inex-project.net/sabo/digitCRM.git`
|
||||
4. Branch: `main`
|
||||
5. Dockerfile: `frontend/Dockerfile` (ако го има)
|
||||
6. Port: `3000`
|
||||
7. Environment:
|
||||
- `VITE_API_URL=http://localhost:3001/api`
|
||||
|
||||
## Локално тестване
|
||||
|
||||
### Backend
|
||||
```bash
|
||||
cd backend
|
||||
npm install
|
||||
npm start
|
||||
```
|
||||
|
||||
Ще слуша на `http://localhost:3000`
|
||||
|
||||
### Frontend
|
||||
```bash
|
||||
cd frontend
|
||||
pnpm install
|
||||
pnpm run dev
|
||||
```
|
||||
|
||||
Ще слуша на `http://localhost:5173`
|
||||
|
||||
## Структура
|
||||
|
||||
```
|
||||
digitCRM/
|
||||
├── backend/
|
||||
│ ├── src/
|
||||
│ ├── routes/
|
||||
│ ├── controllers/
|
||||
│ ├── models/
|
||||
│ ├── package.json
|
||||
│ └── ...
|
||||
├── frontend/
|
||||
│ ├── client/
|
||||
│ │ ├── src/
|
||||
│ │ │ ├── pages/
|
||||
│ │ │ ├── components/
|
||||
│ │ │ ├── lib/
|
||||
│ │ │ └── ...
|
||||
│ │ └── index.html
|
||||
│ ├── package.json
|
||||
│ ├── vite.config.ts
|
||||
│ └── ...
|
||||
├── docker-compose.yml
|
||||
├── .gitignore
|
||||
└── README.md
|
||||
```
|
||||
|
||||
## Тестване
|
||||
|
||||
### Регистрация
|
||||
```bash
|
||||
curl -X POST http://localhost:3000/api/users/register \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"firstName": "John",
|
||||
"lastName": "Doe",
|
||||
"email": "john@example.com",
|
||||
"username": "johndoe",
|
||||
"password": "Test123!@#"
|
||||
}'
|
||||
```
|
||||
|
||||
### Логин
|
||||
```bash
|
||||
curl -X POST http://localhost:3000/api/users/login \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"username": "johndoe",
|
||||
"password": "Test123!@#"
|
||||
}'
|
||||
```
|
||||
|
||||
## Проблеми и решения
|
||||
|
||||
### Git push не работи
|
||||
Използвайте SSH вместо HTTPS:
|
||||
```bash
|
||||
git remote set-url origin git@git.inex-project.net:sabo/digitCRM.git
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
### Coolify не може да build-ва
|
||||
Убедете се че:
|
||||
1. Git репозиторият е публичен или имате достъп
|
||||
2. Docker е инсталиран на машината
|
||||
3. Има достатъчно място на диска
|
||||
|
||||
### Frontend не се свързва с backend
|
||||
Проверете:
|
||||
1. Backend е работещ на `http://localhost:3001`
|
||||
2. CORS е конфигуриран правилно
|
||||
3. `VITE_API_URL` е правилен
|
||||
|
||||
## Следващи стъпки
|
||||
|
||||
1. ✅ Качване на Git
|
||||
2. ✅ Деплойване на Coolify
|
||||
3. Тестване на всички функции
|
||||
4. Конфигуриране на email (SendGrid/Mailgun)
|
||||
5. Добавяне на SMS функционалност
|
||||
6. Production deployment
|
||||
Reference in New Issue
Block a user