# Deepravix Technologies: project structure guide

## This website
| Path | Purpose |
| --- | --- |
| dist/index.html | Home, expertise, projects, approach, about and project brief |
| dist/assets/styles.css | Colors, layouts, components and responsive rules |
| dist/assets/app.js | Project filters and local brief download |
| dist/project-structure.md | This downloadable guide |
| docs/brand-guide.md | Naming direction and domain checks |
| .openai/hosting.json | Site ID and static deployment path |

Run locally with `python3 -m http.server 8080 --directory dist`.
No framework or build step is required for this presentation website.

## Reference Java service
This is a proposed architecture, not Java implementation included in this website.

| Package / directory | Responsibility |
| --- | --- |
| src/main/java/com/example/app/api | Controllers, request/response DTOs, validation, exception mapping |
| src/main/java/com/example/app/application | Use cases and transaction orchestration |
| src/main/java/com/example/app/domain | Business models, rules and repository interfaces |
| src/main/java/com/example/app/infrastructure | JPA adapters, messaging and external clients |
| src/main/java/com/example/app/config | Dependency configuration and security |
| src/main/resources | Application configuration and database migrations |
| src/test/java | Unit, integration and API contract tests |
| delivery | Container and CI/deployment configuration |
| docs | Architecture decisions, API contracts and operational runbooks |

For larger systems, organize these layers inside feature/domain packages. Keep domain rules independent of transport and persistence. Introduce distributed services only when ownership, independent releases or scaling justify their operational cost.

## Suggested next additions
Verified contact channel, authorized public case studies, repository/demo links and a resume approved for public distribution. For a real contact form, add a server endpoint with validation, abuse protection, delivery handling and a privacy notice.